CreateReferencePlane

Introduced

1.5

Description

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

Scripting Syntax

CreateReferencePlane( [InputObjs] )

Parameters

Parameter

Type

Description

InputObjs

String

List of objects.

Default Value: Current selection.

Return Value

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

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



SOFTIMAGE|XSI v6.01     

Return to Softimage XSI Index