Cryptomatte
Decodes Cryptomatte ID matte data baked into a render engine’s EXR into a pickable object matte, selected by clicking directly in the preview.
Cryptomatte turns per-pixel object, material, or asset ID data from a 3D render into a matte you build by picking, with no re-rendering. Point Cryptomatte File at a Cryptomatte-enabled EXR, or drag the file from your file manager onto the field.
The node finds the manifest whether it is embedded in the layers or saved as a sidecar JSON next to the file, and reads multipart renders, including files whose Cryptomatte layers span several EXR parts. When the file has more than one layer, such as one per object and one per material, choose which to decode with Crypto Type.
Blender renders
Section titled “Blender renders”Blender names each Cryptomatte pass after its view layer, so a render’s Crypto Type reads ViewLayer.CryptoObject, ViewLayer.CryptoMaterial, or ViewLayer.CryptoAsset (with your view layer’s name in place of ViewLayer). Pick one and the node decodes it like any other. With nothing wired into Beauty, Highlight uses the Combined pass of that same view layer, so a Blender multilayer EXR is enough on its own to see the pick against the render.
A file that declares a Cryptomatte but carries none of its passes says which type has no passes, rather than reporting that nothing is declared.
Picking objects
Section titled “Picking objects”Pick directly in the preview. A hover tooltip names the object under the cursor before you click.
| To | Do this |
|---|---|
| Add one object | Arm Add in the panel and click, or Ctrl+Click |
| Remove one object | Arm Remove and click, or Ctrl+Alt+Click |
| Add every object a rectangle touches | Ctrl+Shift+drag |
| Remove every object a rectangle touches | Ctrl+Alt+Shift+drag |
| Cancel an armed pick or a sweep | Escape or right-click |
A sweep is a single undo step however many objects it picks up. While a pick is armed, the preview switches to Colored IDs so you can see exactly what you are clicking.
The Matte List shows every selection as a removable entry, with an add-by-name field that autocompletes from the file’s manifest. With no manifest, picking still works and entries show as raw hex IDs instead of names.
Output modes
Section titled “Output modes”Output picks what the Image output shows. The separate Matte output always carries the selection, whatever the mode.
- Colored IDs (the default): a stable random color per object, with picked objects highlighted yellow and the rest dimmed. It shows everything in the file before you start picking.
- Matte: the selection as a grayscale matte.
- Highlight: the beauty image’s brightness with the selection highlighted the same way. It uses a wired Beauty input, or the beauty layer inside the same EXR when nothing is wired, so it works standalone on a production render.
- Premultiplied: the beauty image cut out by the selection. It needs a wired Beauty input for a correct, color-managed cutout, and stays unavailable until one is connected.
Invert flips the Matte and Premultiplied results and the Matte output, never the yellow selection highlights, so picking stays legible either way.
Parameters
Section titled “Parameters”Pins
File
Path to the source EXR carrying Cryptomatte layers (cryptomatte/<key>/name plus rank-layer header attributes)
Automatically reload when the file changes on disk. Checks once per second
Cryptomatte
Which declared Cryptomatte layer to decode (CryptoObject / CryptoMaterial / CryptoAsset / ...).
Leave it empty to take the first layer found in the file.
Selection
JSON array of selected object names (from the manifest) and/or raw "<hexid>" entries, for example ["bench","character"].
Edit by hand here, or with the picking UI on the Parameters panel and the preview canvas.
Output
What the Image output emits, independent of the Matte pin (always the selection coverage, Invert-applied):
- Matte: the accumulated selection as a grayscale matte.
- Colored IDs: a stable pseudo-random color per object (the default, useful for picking); selected objects highlight yellow and unselected objects dim.
- Highlight: the beauty image's brightness (a connected Beauty input, OVERRIDING the file's own beauty layer when one carries it, else the file's own beauty); selected objects highlight yellow and unselected areas dim.
- Premultiplied: the connected Beauty input multiplied by the selection matte (wire one for a color-managed result); with nothing wired, falls back to the matte itself.
Invert the matte: the Matte and Premultiplied outputs and the Matte pin.
Selection highlights are never inverted.
Usage Tips
Section titled “Usage Tips”- Ctrl+Click and Ctrl+Alt+Click work whenever the node is selected, with no need to arm a pick first.
- Turn on Watch File to reload the EXR automatically when a re-render overwrites it.
- Feed the Matte output to Mask Boolean or Mask Refine to combine or clean up selections.