MoveToLayer

Description

Moves the selected objects to a layer.

A large and complex scene can significantly slow down the refresh rate and clutter the display with many objects. Creating scene layers is useful when you wish to concentrate on only a few objects in a crowded scene or to save time refreshing the display when applying rendering options and effects.

Layers help you organize, view, and edit the contents in your scene, but they do not affect the final render (unless you want them to) because they are not associated with render passes. You can put different objects into each layer and you can hide a particular layer if you don't want to see that part of your scene. You can also make a layer's objects unselectable. Layer definitions are saved with the scene file.

You can move objects from one layer to another using the Layers menu or an explorer. Each object in your scene can belong to only one layer at a time. It is possible for different objects within a given hierarchy or group to be assigned to different layers.

Scripting Syntax

    MoveToLayer( Target, [InputObjs] )

Parameters

Parameter | Type | Description
Target [in/out] | String | List to move the objects to Default Value: The selected layer
InputObjs | String | List of objects to move to the layer Default Value: Selected objects

Examples

VBScript Example

    'Open an explorer window

    'Create a new layer called MyLayerExample
    'The current layer is now MyLayerExample
    CreateLayer , "Layers.MyLayerExample"

    'Create a cone object in the current layer
    CreatePrim "Cone", "NurbsSurface"

    'The command moves the cone to the default layer
    MoveToLayer "Layers.Layer_Default", "cone"

See Also

MoveToPartition

Autodesk Softimage v7.5