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.