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