Skip to content

Layers and Groups

A decal is a stack of layers. The Layers & Groups section of the editing panel lists them, lets you reorder, hide, lock and group them, and decides how each layer combines with the ones below.


The layer list

The top row of the list is the top of the stack. It is evaluated last and sits above the rows below it.

The layer list

Each row shows, from left to right:

Element What it does
Folder arrow (groups) Expands or collapses the group
Checkbox Selects the layer for group, align and boolean actions
Eye Shows or hides the layer
Lock Protects the layer: it can no longer be picked or edited in the viewport, but stays selectable in the list so you can unlock it
Star Solo: isolates the layer in the preview only
Name Double-click to rename
Operation symbol + Add, − Cut, and the cover symbols
Chain The layer or group is a linked instance

The buttons on the right of the list:

Button Action
Up / Down arrows Move the active layer in the stack
Duplicate Copy the selected layers and groups (Ctrl+D)
Group Group the selected layers (Ctrl+G)
Add to Group menu Move the active layer into an existing group
Remove from Group Move the active layer out of its group
X Delete the selected layers and groups
Exit Group Shown while you are working inside a group

Drag to reorder

Drag a row to move it: it takes the place of the row it lands on, inside that row's group. Drop it on a group header to join that group (or to leave it if it is already a member). Hold Shift while dropping a group to put it inside the group under the cursor. Dropping outside the sidebar takes the layer out of its group without moving it.

Selecting layers

  • Click a row or a shape in the viewport to select it.
  • Shift + click adds to the selection. The checkboxes do the same.
  • Click empty space to deselect. Alt + click cycles through overlapping shapes.
  • Ctrl + click is left to Blender (rename) and to snapping.

Solo is a preview tool

Solo does not change the stored visibility and never affects an export. Click the star again, or press Exit Solo (preview only) under the list, to see everything.


How a layer combines with the layers below

At the top of the Active Shape section, the Operation rows decide how the layer meets the shapes beneath it.

Operation Effect
Add Raises the layer on top of the shapes below, which stay visible
Cut Digs into the shapes below, which stay visible. It can go below the zero plane
Cover + Hides the shapes below and raises this layer from the base
Cover - Hides the shapes below and sinks this layer from the base
Cover On Top Hides the shapes below and raises this layer from the highest point beneath it
Cover Into Top Hides the shapes below and sinks this layer from the highest point beneath it

On the shape itself, the Add / Cut button cycles the operation when you click it, and Shift + click opens the full chooser. See Selecting and Transforming.

Blend

In Shape Parameters > Relief, Blend fuses the layer with the one just below it, like a smooth union. Overlaps merge instead of adding up. It is available for Add and Cut on most shapes.

Clip to Below

In Shape Parameters > Mask, Clip to Below shows a layer only inside the layer directly below it in the list.

  • Consecutive clipped layers share the same base.
  • Masks are skipped.
  • A hidden base hides the clipped layers too.

Use As: Relief, Color, Relief + Color, Mask

The Use As row decides what the layer produces. See Create Decal and the Canvas for the first three.

A layer set to Mask is not drawn. It cuts the rows below it, or keeps only its own area, depending on Mask Effect:

Mask Effect Result
Cut Removes the mask area from every row below it, inside its group if it has one
Keep Keeps only the mask area on every row below it
Picked Only Acts only on layers that choose this mask in their own Mask box
Target Only Affects exactly one layer or group, chosen in Target, whatever the stack order. Cut or Keep sets its effect

Cut Bevel softens the edge of the cut. Hiding a mask turns its effect off.

A normal shape that also masks

Tick Also Mask on a regular layer to keep it drawn and let it mask other layers with the same settings.


Boolean and alignment tools

Select two or more layers with Shift + click. A Selected Shapes box appears under the list.

Tool Needs Effect
Union, Cut, Intersect, Smooth Union Exactly two layers The active layer keeps its relief and color. The other becomes an editable mask, and both stay in the list
Left / Center X / Right, Bottom / Center Y / Top Two or more Aligns the layers to the active one
Move to Active Two or more Centers the layers on the active one
Equal Gaps X / Y Three or more Spreads the layers evenly, keeping the two outer ones fixed

For Smooth Union, Blend Width rounds the junction. To remove a boolean, set the result's mask mode to Off, or turn off Use Only as Mask on the operand to draw it normally again.


Groups

A group moves, scales, hides and locks several layers as one.

How to make a group

  1. Select the layers (checkboxes or Shift + click).
  2. Click Group or press Ctrl+G.

The selected layers must share the same parent and must not be locked.

Working with a group

  • Click a group row, or any member in the viewport, to select the whole group.
  • Drag the group or press G to move it. The corner handles, S and the Width / Height fields resize every member uniformly around their shared center. Spacing, bevels, corner radii and relief scale with it.
  • Select a member row to edit it alone. While a group is the editing context, the list shows only its layers and new shapes join it. Press Exit Group, or Esc when nothing is in progress, to go back.
  • Hiding a group hides its members without touching their own visibility flags.
  • Ungroup (in the Active Group section) removes the group and keeps every layer, position and relief. Turn off group modifiers and group bevel first.

The Active Group section has its own Group Parameters (position, size, rotation, group bevel with profile and edge softness, member offset and contour), a Shading tab and a Modifiers tab. See Modifiers and Materials and Finishes.

Keep beveled groups together

Members of a group with a bevel must stay next to each other in the stack. Do not interleave unrelated layers between them.

Nested groups

A group can contain other groups. Select groups and layers that share a parent and click Group again. Parent effects, visibility and locks apply to every descendant, and ungrouping a parent keeps its child groups. Nested group effects apply from the inside out.


Duplicates and instances

Command Key Result
Duplicate Ctrl+D or the button An independent copy of the selected layers and groups, nested groups included
Duplicate and move Shift+D Copies, then starts moving the copy. Esc cancels the move
Duplicate as instance Alt+D A linked copy, then starts moving it

Linked copies form a family. Shape, material, path and modifier edits apply to every member of the family, while position, rotation and size stay independent. This works for groups and nested groups too, and each copy keeps its own placement and size.

The Active Shape section tells you whether the layer is Independent or Linked with the number of instances. A chain icon marks linked layers in the list.

Make Independent detaches the active layer from its family. For a group it also detaches its members and nested groups, keeping their current look. Undo restores the link.

Regular duplicates are independent

A normal duplicate never shares parameters with the original. Use Alt+D when you want edits to follow.


Merge Down

Merge Down freezes the active layer and the one directly below it into a single Merged Image layer, at the current export resolution.

  • Both layers must be visible, adjacent, not masks, and either in the same group or both ungrouped.
  • Locked layers, and layers that other layers depend on as masks or booleans, cannot be merged.
  • The result can still be moved, rotated, scaled, hidden, locked and masked, and merged again. It no longer has shape or modifier parameters.
  • Ordinary Undo brings back both original layers.

Choose the resolution first

A merge is exact at its own resolution and approximate after resampling or transforms. Set the export resolution before merging if small details matter. The default comes from the add-on Preferences, and the Save As dialog of the Library lets you change it.


Next steps