CreateReferencePlane
 
 
 

CreateReferencePlane

Introduced

v1.5

Description

Creates a new reference plane based on the selection and makes it the active reference plane.

Scripting Syntax

oReturn = CreateReferencePlane( [InputObjs] );

Return Value

Returns an XSICollection object that contains the list of created reference planes.

Parameters

Parameter Type Description
InputObjs String List of objects.

Default Value: Current selection.

Examples

VBScript Example

'
'       This example shows how to create a reference plane
'
NewScene
'Create a sphere
'Create a grid that will serve to define the reference plane
CreatePrim "Sphere", "MeshSurface"
CreatePrim "Grid", "MeshSurface"
TranslateTool
'Position and create reference plane from grid
Rotate , 45, 0, 0, siAbsolute, siParent, siObj, siX
CreateReferencePlane "grid"
SelectObj "sphere", , True
'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

See Also

SetReferencePlane SetCurrentReferencePlane SetTransientReferencePlane