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.

MoveToLayer( Target, [InputObjs] );

Parameter	Type	Description
Target	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

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"

MoveToPartition