## SetCurrentReferencePlane

### Introduced

v1.5

### Description

Sets the current reference plane (the plane used for transformations/drawing). Appropriate reference planes can be found in the RefPlanes folder, under Project > Data

### Scripting Syntax

    SetCurrentReferencePlane( Value );

### Parameters

Parameter | Type | Description
--- | --- | ---
Value | String | Name of reference plane to use.
Possible Values: | Description:
RefPlanes.View | View plane
RefPlanes.XY | XY plane
RefPlanes.XZ | XZ plane
RefPlanes.YZ | YZ plane
RefPlanes.Transform | Transform plane

### Examples

#### VBScript Example

    '
    '       This example shows how to set the reference plane from the
    '       data stored in the refplane transform
    '
    NewScene
    TranslateTool
    'Create a sphere
    CreatePrim "Sphere", "MeshSurface"
    'Use reference plane XZ
    SetCurrentReferencePlane "RefPlanes.XZ"
    '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
    MsgBox "Translate the sphere - note it is locked to the XZ reference plane."
    'NOTE: you can set back the current reference plane to
    'the one created from CreateReferencePlane or SetTransientReferencePlane
    'by doing SetCurrentReferencePlane "RefPlanes.Transform"

### See Also

SetCurrentPass SetCurrentLayer SetTransientReferencePlane SetReferencePlane CreateReferencePlane