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