XDECAL™ ****User-guide
Chapters
⭐ Home / Support
Getting started
Basics
Popup
Shader Editor
Decal Gizmo
Decal Palette
Default Material Library
Decal Assets & Texture Library
Tutorials
Changelog
Testimonials ◤◢
Additional info
Table of contents
Decal palette

Decal palette is the main place where you can browse files to make decals from, and manage the decal templates you've already created. It can be accessed in the 3D viewport via the XDECAL™
tab in the sidebar, via the dropdown icon in the menu bar (or by pressing Ctrl+Alt+D
), and by enabling the Gizmo palette (either via a toggle or the Ctrl+D
shortcut).

Actions

Some common actions you can do with the items of the palette are:
Left Click
if the item under the mouse is not selected, it becomes selected while others get deselected. If it is already selected, other items don't get deselected.
Ctrl + Left Click
toggle selection of the item under the mouse.
Shift + Left Click
select all items between the clicked item and the previously clicked one.
Right Click
show a context menu with some decal-specific actions.
Double Click
customizable action (defined in preferences).
Ctrl + Double Click
customizable action (defined in preferences).
Alt + Double Click
customizable action (defined in preferences).
Decals can be created from the palette items via the corresponding context menu operation or an equivalent double-click action. If multiple items are selected, more than one decal can be instantiated at the same time; in this case, they will be arranged around the 3D cursor in a grid pattern. For more convenient management, decal instances are also added to a hidden collection named ".Decals".
The top row of the UI panel contains the following items:

- Mode switch: toggles the palette between the file browser and the template manager modes.
- Settings toggle: shows/hides the palette settings.
- Items toggle: shows/hides the palette items (files or templates).
- Gizmo palette toggle: shows/hides the Gizmo palette in the 3D viewport.
What's displayed below depends on the palette mode
Decal Import (file browser mode)
Options tabs

Option tabs: selects which category of decal importing options to show below
File

- Paths: defines whether/how paths are converted to absolute or relative style on import.
- Reuse: defines how the already loaded images should be reused:
- No: new image datablocks will be created even if the same files have already been loaded.
- Yes: already loaded images will be used when possible.
- Reload: use already loaded images + force reload them.
Frames

- Auto refresh: whether the imported images should always refresh on frame changes.
- Start frame: the starting frame for movies and image sequences.
- Image sequences: the method for automatically detecting image sequences:
- None: don't detect image sequences.
- Without gaps: gaps in frame numbers will result in separate sequences.
- With gaps: gaps in frame numbers won't result in separate sequences.
Decal

- Default Dynamic/Baked: whether new decals should be dynamic or baked.
- Default Intersect: whether new decals should have Intersect option enabled.
- Scale: default scale of new decals.
- Orientation: what should new decals be aligned to (world, active object, view or 3D cursor).
- Alpha: how to interpret the alpha channel:
Material

- Material: the prototype material on which new template material(s) will be based. The dropdown allows you to select any material from the material libraries as the prototype.
- Material libraries: this popup allows you to configure the list of material libraries from which you can select prototype materials. Each entry is expected to be a path to a .blend file containing the materials. You can add new entries (via the
+
button), edit existing ones (by clicking on their name), change their order (via the ▴
/▾
buttons), and remove them (via the x
button).
- Overwrite: if enabled, existing materials will be overwritten (replaced) when new materials have the same names.