Skip to content

Export

A decal can leave Decal Workshop in two ways: saved in the library with its maps, or exported in bulk for other tools with Export Library.


Maps written with every library save

When you use Save As, Replace Entry or Save Asset, the entry folder holds the editable decal and its maps. This is the decal export. You pick the resolution (512, 1024 or 2048) and the anti-aliasing in the save dialog. See The Library.

File Content
decal.json The editable layers and settings. It makes the decal editable again, and tells other tools how to read the maps
normal.png 16-bit RGB normal map, tangent space, OpenGL (+Y)
ao_curv_height.png 16-bit RGB. R = ambient occlusion, a neutral placeholder. G = curvature, a neutral placeholder. B = height, 0.5 is neutral
masks.png 16-bit RGB. R = footprint of the visible shapes. G and B = weights of the first and second material
color.png 8-bit sRGB color with alpha, written only when a layer paints
materials_N.png Weights of the third material and up, three per file, written when a layer paints
decal.png A 256 x 256 thumbnail used by the library

Keep the whole folder

A decal folder may also contain image and font files the editable layers need. When you copy or move a decal, copy the whole folder, not only the PNG maps. An exported bitmap alone cannot be edited again.


Export Library

Export Library converts a whole library folder for other tools, in one go.

Click the Export button, at the bottom of the icon column beside the library thumbnail. It exports the folder you are browsing.

The Export Library dialog

How to export

  1. In the library, browse the folder you want to export (or All).
  2. Click the Export button.
  3. In the dialog, check the Library Folder and choose a new Export Folder.
  4. Pick what to export with the four buttons: PBR, DECALmachine, Atlas or All.
  5. Set the Map Resolution and Anti-aliasing.
  6. Confirm.
Option Default Notes
Library Folder The browsed folder Folders inside it are included
Export Folder A new DecalWorkshop_Exports folder next to your library Must be new or empty, and outside the library folder
Export (mode) All See below
Map Resolution 1024 512, 1024 or 2048
Anti-aliasing 2 x 2 1 x 1, 2 x 2 or 4 x 4
Atlas Size 4096 2048, 4096 or 8192. Only for Atlas and All
Padding 16 px Border around each decal in an atlas page
Trim Transparent Borders On Crops empty borders before packing

It runs in the background

The export runs in a separate Blender process, so Blender stays usable. The panel and the status bar show the current step and a progress bar.

Cancel with Esc

Press Esc to cancel. The files already written are kept in the export folder. Your library is never modified.

When it finishes, a message tells you where the files are. If it fails, the message gives the reason and points to the log file in the export folder.


The four modes

Mode What you get
PBR Generic material textures for every decal, for use in any tool. The editable sources are kept next to them
DECALmachine Native DECALmachine assets built from its installed template
Atlas PBR atlases: many decals packed into pages of textures
All Individual PBR decals, the DECALmachine library and the atlases

What each output contains

PBR (PBR/<decal>/)

File Content
basecolor.png Real base color, 8-bit sRGB with straight (not premultiplied) alpha
normal.png OpenGL normal map that includes the material's detail
roughness.png, metallic.png, opacity.png Linear 16-bit maps
ao_curv_height.png Encoded height in the blue channel. AO and curvature are neutral placeholders, marked as such
emission.png Only when the decal glows
pbr.json Describes every channel, color space and how to decode the height
source/ A copy of the original library entry, untouched

DECALmachine (DECALmachine/Decals/.../<decal>/)

  • A native asset built with your installed DECALmachine, with its PBR image links kept through insertion, material matching and projection.
  • The parallax Amount is converted for DECALmachine, so there is no stepped distortion at oblique angles.

Atlas (Atlases/)

  • atlas_000_<channel>.png, one image per channel and page, and atlas.json describing every decal in them (identifiers, UV bounds, how to decode the height).
  • Deterministic pages, with transparent-border trimming and padding. Tiles are never rotated or downscaled.

At the root of the export folder, report.json and conversion.json list what was exported.


Limits and things to know

DECALmachine must be installed

DECALmachine and All modes need the DECALmachine add-on installed and enabled. Without it, the export stops with an error.

DECALmachine and PBR links

The extra PBR image links in a DECALmachine export are an extension from Decal Workshop. DECALmachine's own Add to Library, rebuild, update or atlas operations can replace them. To keep every PBR map, use the Decal Workshop Atlas output, and keep the PBR folder as your master copy.

  • The atlas needs the Pillow Python module. If it is missing, an error says so.
  • Atlas PNGs are 8-bit per channel. The manifest records any reduction from 16-bit source maps.
  • Atlas data is Decal Workshop's own format. It is not a claim of DECALmachine atlas import compatibility.
  • AO and curvature are placeholders: they are not baked.
  • An entry too large for the atlas size (with padding) stops the export. Raise Atlas Size, since images are never downsampled.
  • Only editable Decal Workshop entries are exported. Image-only entries are skipped. A folder with none stops with No editable Decal Workshop decals found in this folder.
  • Shader-specific features (coat, specular) are not fully reproduced by the basic PBR channels.
  • Ready-made Unreal and Unity importers are not part of the export yet. You get portable textures and atlas data.

Next steps