< Previous | Contents | Next >

List of known Metadata

This is a list of some of the metadata attributes that you might encounter, either because they come with certain image files or because they allow you to do nice things with them inside Fusion.


Metadata field name

Source

Description

Filename

Loader

This metadata is added by every Loader and contains the full path, frame number and extension of the currently loaded file.

FrameFilename

Loader

If the Loader points to an IFL file (text files, where each line contains the name of a file to be loaded), this variable will be added and contains the frame’s actual filename while the Filename field will contain the (unchanging) path to the IFL file.

OriginalFilename

dpx files

Contains the "Filename" metadata of the source image that was subsequently saved as the dpx file you’re currently viewing.

Project

dpx files

Contains the path and file name of the comp that rendered the current dpx file.

TimeCode

dpx files, mov exr

Contains the current frame’s time code.

For DPX this is usually generated by the camera and subsequently carried along through the pipeline unchanged.

For Quicktime movies it depends on the mov’s timecode track. You can use the SetTimeCode Fuse to set this manually. Format is HH:MM:SS:FF

FrameRate

mov

Contains the Quicktime movie’s frame rate. SetTimeCode will also set this parameter but it may not be written to the output file.

CreationTime

dpx exr

Contains the real world’s time when this frame was recorded by the camera.

Creator UserBits FramePosition Offset

Center OriginalSize FilmFormat FrameID SlateInfo


Dpx exr


Various attributes you may encounter in dpx files

InputDevice InputSerial

dpx files and Saver tool

Fusion writes this to every dpx file.


Metadata field name

Source

Description

screenWindowWidth screenWindowCenter

exr files

These properties are part of the exr file standard and contain the position of the image’s DoD

Gamma

dpx & png files

The image’s gamma. Written to PNG files by the Saver tool but encountered in logarithmic dpx files as well where it might denote the conversion gamma (unconfirmed).

ColorSpace

Gamut tool

Contains the name of the output color space that has been selected in Fusion’s Gamut tool.

WhitePointX WhitePointY RedChromaX RedChromaY GreenChromaX GreenChromaY BlueChromaX BlueChromaY

Gamut tool

These variables contain the coordinates of white point and color primaries as converted by the Gamut tool since the previously mentioned ColorSpace variable is just a user-friendly label (e.g. "sRGB") that contains little information for applications that deal with color science. These parameters can’t be written to DPX files. Use OpenEXR instead. PNG files are also able to save this information.

Stereo.Method

Combiner tool

If Add Metadata is enabled in the Combiner tool, Fusion will attach this attribute to the output image to denote the stacking method of the current image. Valid values are "hstack" and "vstack" for horizontal and vertical stacking.

Stereo.Swap

manual

This property, if set to "true", will override the viewer’s stereo display option. It’s useful if you need to temporarily swap eyes somewhere inside your comp but you don’t want to toggle the "swap eyes" option in the viewer by hand.

Stereo.Offset

manual

This "hidden" property needs to be set to an X and Y offset in pixels (e.g. {10, 0}) and will shift left and right eye when the viewer’s stereo mode is enabled. It’s very useful to add this property if

your footage was shot with parallel cameras where zero disparity would occur on the horizon and everything would end up sticking out of the screen. Often, a preliminary per-shot depth grading value is supplied with the source footage to push the image back. Instead of actually transforming your left

and right eye images and reverting this before the Saver, use Stereo.Offset like a viewer LUT: you’ll be able to work on your raw footage while previewing the desired depth grade in the viewers.

nuke/node_hash

Nuke (exr files)

This is a checksum of the script that generated the image and is written to EXR files by Nuke.