.. _bpy.types.Object.layers: .. _bpy.ops.object.move_to_layer: ****** Layers ****** .. admonition:: Reference :class: refbox :Mode: Object Mode :Panel: :menuselection:`Object --> Relations` :Menu: :menuselection:`Object --> Move to Layer...` :Hotkey: :kbd:`M` 3D scenes often become exponentially more confusing as they grow more complex. Sometimes the artist also needs precise control over how individual objects are lit, and does not want lights for one object to affect nearby objects. For this and other reasons below, objects can be placed into one or more "layers". Using object layers, you can: - Selectively display objects from certain layers in your 3D View, by selecting those layers in the *3D View* header. This allows you to speed up interface redrawing, reduce virtual-world clutter, and help improve your workflow. - Control :ref:`which lights illuminate an object `, by making a light illuminate only the objects on its own layer(s). - Control which forces affect which :doc:`particle systems `, since particles are only affected by forces and effects on the same layer. - Control which layers are rendered (and hence, which objects), and which properties/channels are made available for compositing by using :doc:`render layers `. Armatures can also become very complex, with different types of bones, controllers, solvers, custom shapes, and so on. Since armatures are usually located close together, this can quickly become cluttered. Therefore, Blender also provides layers just for armatures. Armature layers are very similar to object layers, in that you can divide up an armature (rig) across layers and only display those layers you wish to work on. .. seealso:: :ref:`armature-layers` Working with Layers =================== 3D layers differ from the layers you may know from 2D graphics applications as they have no influence on the drawing order and are there (except for the special functions listed above) mainly to allow you to organize your scene. When rendering, Blender only renders the selected layers. If all your lights are on a layer that is *not selected*, you will not see anything in your render except for objects lit by ambient lighting. :doc:`Groups ` and :doc:`Parents ` are other ways to logically group related sets of objects. Viewing Layers -------------- Blender provides twenty layers whose visibility can be toggled with the small unlabeled buttons in the header (see *3D View layer buttons*). To select a single layer, click the appropriate button with :kbd:`LMB`; to select more than one, use :kbd:`Shift-LMB` -- doing this on an already active layer will deselect it. .. figure:: /images/editors_3dview_object_properties_relations_layers_buttons.png 3D View layer buttons. To select layers via the keyboard, press :kbd:`1` to :kbd:`0` (on the main area of the keyboard) for layers 1 through 10 (the top row of buttons), and :kbd:`Alt-1` to :kbd:`Alt-0` for layers 11 through 20 (the bottom row). Use :kbd:`Shift` for multiple (de)selection works for these shortcuts too. You can select or deselect all Scene Layer buttons at once by pressing :kbd:`Backtick`. Locking to the Scene -------------------- By default, the lock button directly to the right of the layer buttons is enabled. This means that changes to the viewed layers affect all other 3D Views locked to the scene. See the :doc:`navigating the 3D View options page ` for more information. Multiple Layers --------------- An object can exist on multiple layers. For example, a lamp that only lights objects on a shared layer could "be" on layers 1, 2, and 3. An object on layers 3 and 4 would be lit, whereas an object on layers 4 and 5 would not. There are many places where layer-specific effects come into play, especially lights and particles. Moving Objects between Layers ----------------------------- .. figure:: /images/editors_3dview_object_properties_relations_layers_move-menu.png Layer selection. To move selected objects to a different layer, press :kbd:`M` and then select the layer you want from the pop-up menu. Objects can also be on more than one layer at a time. To have an object on multiple layers, hold :kbd:`Shift` while clicking. .. figure:: /images/editors_3dview_object_properties_relations_layers_object-tab.png Selection in the Object tab. Another way to view or change a selected object layer is via the *Relations* panel, in the *Object* tab. .. figure:: /images/editors_3dview_object_properties_relations_layers_relations-panel.png Layers in Object tab, Relations panel. You will then see the layer buttons in the *Relations* panel -- as before -- the object can be displayed on more than one layer by clicking :kbd:`Shift-LMB`.