silhouette-2025.5 : Nodes : Cryptomatte
Cryptomatte
Description
Cryptomatte is a tool created at Psyop by Jonah Friedman and Andy Jones designed to create ID mattes using organizational information available at render time. Cryptomatte generated images are very colorful, assigning each layer or shape a different random color.
See Cryptomatte for more information.
Go to the Cryptomatte tutorial to see how it works.
Node Group
Key.
Controls
Type
Determines whether layer or object Cryptomatte data is displayed.
Layers
Displays Roto layers.
Objects
Displays Roto shapes or Face ML / Mask ML / Matte Assist ML objects.
Overlay
Overlay (enabled by default) composites a colored overlay of selectable mattes over the RGB channels. Disabling this parameter allows RGBA to flow correctly to downstream nodes.
Using Cryptomatte
Creating
Cryptomatte data is produced by the following nodes: Face ML, Mask ML, Matte Assist ML and Roto.
Roto layers and shapes are automatically assigned unique IDs and ranks. Layers and shapes represent two distinct sets of Cryptomatic data:
Layers receive their ID based on the layer name.
Shapes are assigned IDs according to their shape name and layer hierarchy.
Machine Learning–based objects--such as Face ML, Mask ML, and Matte Assist ML--are each assigned their own ID based on the object name.
Visualizing
The Data output of a Cryptomatte-capable node transmits Cryptomatte data to the Data input of the Cryptomatte node for visual display and selection. Each individual layer or object is assigned a distinct hue for easy differentiation.
Selection
To enable mattes, select them from the viewer--this makes them available for use in other nodes and adds them to the Selection list. Hovering over the image highlights selectable mattes; clicking confirms your selection. To adjust the selection, use shortcut keys: Ctrl/Cmd-click or Shift-click adds mattes, Ctrl/Cmd-click removes them, and dragging over an area selects multiple mattes simultaneously.
Rendering
The Data output of a Cryptomatte-capable node transmits Cryptomatte data to the Data input of the Output Multi-Part Data input where layer and object Cryptomatte data are written into their own EXR channel.