## 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