MoveToLayer
 
 
 

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