CryptoMatte-Write Node

The software is capable of writing EXRs with CryptoMatte information. These EXRs can be used as image sources in Harmony scenes and in other software. Scenes composed with labeled Port Names on output images can be rendered with custom CryptoMatte information.

Once the CryptoMatte-Write Node is linked to the composite, you are ready to adjust the export settings. You can access the settings by clicking on the yellow square on the CryptoMatte-Write Node.

Properties

Inputs

The Input tab will display all the input connections that are linked to the CryptoMatte-Write Node. The input ports will be listed from right to left. When exporting an EXR, the right-most port will compile all the layers to create the CryptoMatte for the EXR file.

The layers will be named in the output file as they appear in the Name column. By default, each layer is named after their respective input node. If you prefer, you can customize the name of each layer. Simply double-click on a layer's name to be prompted to type a new name.

A coloured square appears to the left of each name to indicate whether the name is based on the node or is a custom name. If the square is yellow, the name is based on the node. If it is green, it is a custom name. Once a layer name has been customized, it will no longer automatically update based on the connected node's name.

Output Tab

The output tab can be used to configure the path, file naming pattern and file type of frames exported by the Write node. The CryptoMatte node only supports the EXR output format, and it cannot be used to export movies.

Properties

Parameter Description
Colour Space

The colour space in which to render your scene’s frames. When a specific colour space is selected for a Write node, frames rendered by this Write node will be converted from the project’s working colour space to the Write node’s colour space.

The following colour spaces are supported in Harmony:

  • Scene Working Colour Space: The same colour space as the one selected in the Colour Space tab of the Scene Settings dialog.
  • ACES2065-1:An ACES linear colour space that uses the AP0 colour primaries and is intended for image file interchange.
  • ACEScg:An ACES linear colour space that uses the AP1 colour primaries and is intended for CGI rendering and compositing.
  • Linear Rec.709 (sRGB): The colour space that uses the same primaries and white point as sRGB and Rec. 709, but with no gamma transfer curve applied to the colour values.
  • Linear Rec. 2020: A colour space used for Ultra High Definition TV (UHDTV). It has a complex gamma transfer curve and primaries that cover more of the human-perceivable colour space than other colour spaces, especially in the area of human-perceivable greens.
  • Linear P3-D65: The same as Display P3, except with no gamma transfer curve. This colour space is useful for compositing intermediary images that are meant to be rendered in Display P3.
  • Display P3: A colour space commonly used for digital projection. It has the same primaries as DCI-P3, the same white point as sRGB and the same gamma transfer curve as sRGB.
  • Rec. 709: The colour space used for HDTV. It has the same primaries and white point as sRGB, but has a different gamma transfer curve.
  • Rec. 709 2.4: The same colour space as Rec. 709 or sRGB, except with a gamma transfer curve of 2.4 (per ITU-R BT.1886). This colour space exists because some editing systems use a gamma transfer curve of 2.4 instead of the standard gamma curve for Rec. 709.
  • Rec. 2020: A colour space used for Ultra High Definition TV (UHDTV). It has a complex gamma transfer curve and primaries that cover more of the human-perceivable colour space than other colour spaces, especially in the area of human-perceivable greens.
  • Rec. 2020 2.4: The same colour space as Rec. 2020, except with a simple gamma transfer curve of 2.4 (per ITU-R BT.1886). This colour space exists because some editing systems use a gamma transfer curve of 2.4 instead of the standard gamma curve for Rec. 2020.
  • sRGB: A colour space typically used for standard computer monitors. It has the same primaries and white point as Rec. 709, but has a different gamma transfer curve.
NOTES
  • When rendering a movie in a specific colour space in QuickTime Movie (*.mov) format on macOS, the movie buffer data will be tagged with the corresponding ICC colour profile.

  • When rendering a movie in a specific colour space in QuickTime Prores Movie (*mov) format, the movie colour space ‘nclc’ tag will be only set as:

    • HD (1-1-1) if using “Rec. 709” colour space

    • BT.2020 (9-1-9) if using “Rec. 2020” colour space

    • P3 D65 (12-1-1) if using “Display P3” colour space

  • When rendering frames in a specific colour space, the following file formats will be tagged with their colour space information:

    • Portable Network Graphic (.png)
    • Photoshop Document (.psd)

    • OpenEXR (.exr)

    OpenEXR files are only tagged with the coordinates for their white point and primaries.

Image Folder The path to the folder in which to save the rendered frames. This path can be absolute or relative to the scene's folder. For example, the default path for rendered frames is frames, which means the images are saved in the frames subfolder of the scene folder. If you want to select an absolute path, you can click on the Choose button at the right of the text field and select the folder in which your scenes should export their frames. You can also click on the Default button to set the export path to the default value.
Image Filename The prefix for the file name of each exported frame. Frames will be named with this value, followed by the frame number and their image type extension. It is recommended to leave the hyphen (-) at the end of the prefix to separate the prefix from the frame number.You can define a custom file name and path using variables. For a list of possible variables, hover your mouse over the Image Filename textbox.
Start

Select the starting number for the image sequence.

Leading Zeros Allows you to select the number of digits in the number used to identify each frame.
Image Format

OpenEXR (*.exr)

A highly capable deep image format. Each pixel in an EXR file is exported with its Z-depth information. Additionally, if a pixel is semi-transparent, the color and depth information of pixels further back is stored along with it. If your scene has multiplane or 3D elements, this format can be used for compositing your animation with other graphical elements in 3D animation software.

NOTES
  • OpenEXR files exported from Harmony are tagged with the white point and primaries coordinates for their colour space.

  • OpenEXR files are always exported by Harmony always have 1 line Zip compression if they contain a 3D image.

Colours

Drop list with colour modes.

  • Colour + Alpha
Depth (bits/channel)

Drop list with bit depth value and a label next to it "bits/channel". Available bit depth depends on the selected file type.

  • 16
  • 32
Compression

Drop list that appears for EXR and TIF formats only.

  • Zip (per scanline)
  • Zip (16 scanlines)
Movie Folder Only available when the Movie option is enabled. The folder in which to export the movie file. You can click Choose to the right of the text field to browse for the directory where you want the movie to be exported, or click Default to set the export path to the default value. You can also type a path relative to the scene's directory. For example, the default value is frames, which exports the movie to the scene's frames subdirectory.
Movie Filename Only available when the Movie option is enabled. The name of the movie file to export. Do not enter the file's extension.
CryptoMatte Name

Refers to the name of the CryptoMatte. Will be how the CryptoMatte is Named in the EXR file upon export.

To change the name of the CryptoMatte, enter a new name into the Name bar.

CryptoMatte Image Count

Corresponds to the coverage of pixels that separate images.

Each count defines a CryptoMatte image containing RGBA channels. These channels correspond to the IDs and coverage of the rendered content. As a result, a count of three will provide six-levels of ID and coverage information.

NOTE It may be useful to increase the CryptoMatte Image Count if the scene is very busy and has a lot of overlapping translucent areas.

A higher value will offer more coverage and support more distinct layers.

Enabling Tab

You can create several Write nodes for a single scene and, by default, when a scene is rendered, all of its Write nodes will perform their render. However, using the options in the Enabling tab, you can set up some Write nodes to only perform their render if the scene is rendered at a specific resolution. This is mostly useful on Harmony Server, as Harmony Server allows you to select the resolution at which to render a scene when sending a scene for rendering by the Harmony database's render farm.

A good example of how this can be useful is if your scene has storyboard thumbnails in the corner, and a Write node connected to a composite that crops the picture to only include the storyboard thumbnail, so that your scene can export both the final animation and the animated storyboard when rendered. You can set up your scene's main Write node to only work when exporting the scene at the scene's original resolution, and the storyboard thumbnails Write node to only work when exporting at the desired resolution for an animated storyboard.

This option allows you to filter with either resolution presets, or by specifying the width and height of the chosen resolution in pixels. You can hence create custom resolution presets named after their Write node's purpose, to make it easier to choose the resolution when rendering a scene.

Parameter Description

Always Enabled

Makes this Write node render every time the scene is rendered. This is the default option.

Enabled when Resolution Name is

Makes this Write node render only when the scene is rendered at the specified resolution preset.

Filter Name

Select the resolution preset at which to render the scene to activate this Write node.

Enabled when Resolution is

Make this Write node render only when the scene is rendered at the resolution with the specified width and height, in pixels.

X Resolution

The width (in pixels) of the resolution at which to render the scene to activate this Write node.

Y Resolution

The height (in pixels) of the resolution at which to render the scene to activate this Write node.