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