Scripting: SetTransientReferencePlane

SetTransientReferencePlane

Introduced

v1.5

Description

Creates a transient reference plane based on the selection, and makes it the active reference plane. Transient reference planes are stored in the Transform reference plane.

Scripting Syntax

SetTransientReferencePlane( [InputObjs] );

Parameters

Parameter	Type	Description
InputObjs	String	List of objects. Default Value: Current selection.

Examples

VBScript Example

'
'       This example shows how to set the transient reference plane: refplanes.transform
'
NewScene
CreatePrim "Grid", "MeshSurface"
Rotate , 45, 0, 0, siAbsolute, siParent, siObj, siX
CreatePrim "Sphere", "MeshSurface"
SelectObj "grid", , True
'Set transient reference plane
SetTransientReferencePlane "grid"
' Make sure that plane  mode is selected (alt+6) in the SRT panel section.
SelectObj "sphere", , True
SetUserPref "3D_TRANSFO_REFERENTIAL_CHANGED", 7
' Interactively translate the sphere it will move parallel 
'to the plane defined by the grid.
'NOTE: Please make sure that plane reference mode in MCP is ON
'when moving the sphere... Sometimes it snaps back to view mode.