Moves one object 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.

VBScript Example

CreateLayer , "MyLayerExample"
SetCurrentLayer "Layers.Layer_Default"
'Create a cone object in the current layer
CreatePrim "Cone", "NurbsSurface"
'The command moves the cone to the default layer
MoveObjectToLayer "Layers.MyLayerExample", "cone"