SetCurrentReferencePlane

Sets the current reference plane (the plane used for transformations/drawing). Appropriate reference planes can be found in the RefPlanes folder, under Project > Data

Scripting Syntax

Parameters

Parameter Type Description

Value String Name of reference plane to use.

Possible Values:

Description:

RefPlanes.View View plane

RefPlanes.XY XY plane

RefPlanes.XZ XZ plane

RefPlanes.YZ YZ plane

RefPlanes.Transform Transform plane

Examples

VBScript Example

'

'	This example shows how to set the reference plane from the  

'	data stored in the refplane transform 

'

NewScene

TranslateTool

'Create a sphere 

CreatePrim "Sphere", "MeshSurface" 

'Use reference plane XZ

SetCurrentReferencePlane "RefPlanes.XZ" 

'Set-up snapping to the reference plane 

'Set plane reference mode in MCP 

SetValue "Preferences.SnapProperties.Enable", True 

SetValue "Preferences.SnapProperties.EnableGrid", True 

SetUserPref "3D_TRANSFO_REFERENTIAL_CHANGED", 7 

MsgBox "Translate the sphere - note it is locked to the XZ reference plane."

'NOTE: you can set back the current reference plane to  

'the one created from CreateReferencePlane or SetTransientReferencePlane 

'by doing SetCurrentReferencePlane "RefPlanes.Transform"

SetCurrentReferencePlane

Introduced

Description

Scripting Syntax

Parameters

Examples

VBScript Example

See Also