Share

Burn-in Metadata

Use the Burn-in Metadata tool to burn clip information in the image.

Access To access the Burn-in Metadata menu, use:
  • Batch, then select the node from the All Nodes bin.
  • Timeline, then add the Timeline FX from the Effects ribbon. See Adding Timeline FX.
  • Timeline, then use Batch FX. See Creating Batch FX.
  • The Tools tab, then select Burn-in Metadata from the Utilities menu. See Accessing Tools.
Inputs Front - The clip to burn the metadata on.
Outputs Result - The Front clip with the metadata burned-in.

Batch Workflow

By default, the metadata read by the Burn-In Metadata node comes from the Batch Group/Setup, not from the clip connected to the node.

To burn the information from a clip, you need to propagate its metadata to the Burn-In Metadata node using one of these methods:

  • With the Burn-In Metadata node selected, T+Click on the node you want to read the metadata from.
  • Add the clip node to the clipboard using the Copy function and then select the metadata to paste from the Paste Special submenu in the Burn-In Metadata node's context menu.



Timeline FX Workflow

The Burn-In Metadata Timeline FX reads the metadata from the timeline segment it has been added to. If the Timeline FX has been added to a Gap segment, then the metadata from the first video segment below is read. However, the source of the metadata can be modified using the Custom Metadata Track.



Note: There can only ever be one Custom Metadata Track for a sequence version: changing it for one Burn-In Metadata FX changes it for all Burn-In Metadata FX in that sequence version.

If audio tracks are present in a sequence, the Audio tracks drop-down button can be used to selected from which Audio Track the metadata is read from. Contrary to the Video control, the Audio Track selection can be made on a Timeline FX basis.

Each Layer added to a Burn-In Metada Timeline FX can read the metadata from four different sources:

  • Back: The video segment on the bottom track of the version.
  • Current: The video segment on which the Timeline FX is on (or the segment below in the case of a gap).
  • Custom: The video segment on the Video Custom Metadata Track.
  • Audio: The audio segment on the Audio Customer Metadata Track.

To set the source for the metadata displayed by a layer:

  1. Select the Information layer from the Add drop-down button at the bottom of the Information list.
  2. In the Text section, select a Track option.
  3. If you set Track to Custom, use Custom Metadata Track to select the layer to be the source of that metadata.

To set the source for the colour of the text:

  1. Select the Information layer from the Information list.
  2. In the Text section, select a Colour Source option.
    • Timeline / Clip: Use the clip's colour.
    • Segment: Use the segment's colour.
    • Custom: Use the colour button.

To set the source for the colour of the text background:

  1. Select the Information layer from the Information list.
  2. In the Background section, select a Background Colour Source option.
    • Off: Disable the background colour.
    • Timeline / Clip: Use the clip's colour.
    • Segment: Use the segment's colour.
    • Custom: Use the colour button.



Settings

Note that some tokens and layers are either not available for display, or display different information, depending where Burn-in Metadata is being used.

Settings for the Burn-In Metadata tool differ between Batch and the Timeline. The following documentation presents the controls for the Batch node and for the Timeline FX, as presented in the Effects environment. It is also possible to modify the Burn-In Metadata controls from the Timeline ribbon, on the Timeline tab.

The Burn-In Metadata settings in Batch

The Burn-In Metadata settings in the Effects environment



General

Rendering Mode optiom

Select Automatic to render using the scan format of the input, or render in Progressive or Interlaced mode.

On-Screen Icons Active

Enable to display layer widgets in the viewport. Use the widgets to move the layer in X and Y, or rotate in Z. Alignment options allow you to affect only the selected layer or every layers.

Information list

Lists all of the added information layers. Use the buttons below to populate the list with the information layers you want. Use the eye icon to mute a layer. Click a layer to display its Layer Specific options.



Common Attributes



Apply to All

Enable to have the Common Attributes applied to every layer in the Displayed Information list. Disable to apply the attributes only to the currently selected layer.

Text Colour option

Select the source for the colour of the text: Segment to use the colour of the segment, Timeline/Clip to use the colour of the clip, or Custom to use the Text colour pot.

Text Custom Colour

Sets the custom colour of the burned-in text.

Text Opacity field

Sets the opacity of the burned-in text.

Text Size field

Sets the font size of the burned-in text.

Metadata Source Track option

Select the source of the metadata used by the current layer: Custom to use the Custom Metadata Track, Current to use the current segment (or the segment below in the case of a gap), Back to use the background track, or Audio for the audio track.

Note: This option is only available in the Timeline FX.

Shadow Active

Enable to add a drop shadow to the burned-in text.

Shadow Colour

Sets the drop shadow colour.

Shadow Opacity field

Sets the opacity of the drop shadow.

Background Colour option

Select whether to add a rectangular background to the burn-in text or not. Select Segment to use the colour of the segment, Timeline/Clip to use the colour of the clip (Timeline FX only), or Custom to use the Background colour pot.

Background Colour

Sets the background colour.

Background Opacity field

Sets the opacity of the background.

Font field

The font currently in use.

Change Font button

Open the font browser to load a font.

Bold

Bold the current layer.

Italic

Italicize the current layer.

Underline

Underline the current layer.



Alignment



Layer Selection option

Use Selected Layer to modify only the selected layer. All Layers modifies all the layers at once, but the modifications are treated as offsets for each individual layer. Global Axis modifies the layers in one block keeping their relative positions.

Alignment Selection option

Select how the layer is positioned: custom position, or relative to Safe Action or Title margins.

When Align to Safe Title or Align to Safe Action is selected, use the on-screen buttons to align the layers to a side or a corner.



Text Alignment box

Select the text justification relative to its layer's axis. Disabled when the Layer Selection box is set to Global Axis.

X Position field

Sets the X position of the selected layers.

Y Position field

Sets the Y position of the selected layers.

Rotation field

Sets the Z rotation of the selected layers.



Layer Specific Options

The following section details what the different layers are used for.

To display and edit the options for a layer, select it in the Informaton list.

Common Options

Each Layer has a label used to identify the information burned in the image. It is possible to hide the label or to modify it.



Label

Enable to display as a label the contents of the Label field below.

Label field

Sets the layer's label to burn-in.



Name

  • Batch / Batch FX: Displays the node's name.
  • Timeline FX: Displays the clip's name.



Segment Name

Displays the timeline segment's name.

Note: This layer is Not available in Batch and Batch FX.

Show Version ID

Enable to display the timeline segment's version ID. Displays v0 if none is set.

Note: This layer is Not available in Batch and Batch FX.

Show Version Name button

Enable to display the timeline segment's version name.

Note: This layer is Not available in Batch and Batch FX.



Shot Name

  • Batch / Batch FX: The shot name of a clip, render, or write file node can be propagated.
  • Timeline FX: Displays the timeline segment's shot name.



Source Name

Displays the timeline segment's original source's name.

Note: This layer is Not available in Batch and Batch FX.

Source Name option

Select to display the name of the source, or that of the RGB or Matte channels.

Note: This layer is Not available in Batch and Batch FX.



Source Version Name

Displays the timeline segment's source version name.

Note: This layer is Not available in Batch and Batch FX.



Source Version ID

Displays the timeline segment's source version ID.

Note: This layer is Not available in Batch and Batch FX.



Segment Index

Displays the timeline segment's Segment Index.

Note: This layer is Not available in Batch and Batch FX.

Padding field

Sets the padding for the display of the segment index.



Tape/Reel/Source

  • Batch / Batch FX: The tape/reel/source of a clip, render, or write file node can be propagated.
  • Timeline FX: Displays the clip's tape/reel/source.



File Location

Displays the location of the source media file.

Note: This layer is Not available in Batch and Batch FX.

Include Filename

Enable to display the name of the media file.

Custom Level

Enable to truncate the displayed file path.

Truncate option

Select the directory levels to keep in the displayed path. Keep Last preserves the end of the file path. Remove First removes the beginning of the file path.

Directory Levels field

Sets the number of directory levels to preserve or remove, according to the Truncate box.



Comment

Displays the contents of the timeline segment's comment field.

Note: This layer is Not available in Batch and Batch FX.



Polarity

Displays the polarity of a timeline segment located on a stereo version.

Note: This layer is Not available in Batch and Batch FX.



Timeline FX

Displays the Timeline FX applied to the timeline segment.

Note: This layer is Not available in Batch and Batch FX.

Show Timewarp Only

Displays only the Timewarp FX. All other Timeline FXs are ignored.

Show Timewarp Speed

Displays the Timewarp's speed, in the unit specified in the Timewarp FX.



Tags

Displays the tags from the clip or timeline segment.

Note: This layer is Not available in Batch and Batch FX.

Stacking option

Select how multiple tags are displayed.

Select: To:
Line Up Display all tags on the same line.
Stack Down Display each tag its own line. New tags are added at the bottom while existing tags do not change position.
Stack Up Display each tag its own line. New tags are added to the bottom while existing tags are pushed one row toward the top.

Display option

Select whether to display the tags from the clip or timeline / segment.



Marker

Displays the name or comment of a markers and segments markers.

Note: This layer is Not available in Batch and Batch FX.

Marker Type option

Select whether to display the information from Markers or Segment Markers.

Tip: Use multiple layers to display both the Markers and Segments Markers.

Stacking option

Select how multiple Markers located on a same frame are displayed.

Select: To:
Stack Down Add new markers at the bottom while existing markers do not change position.
Stack Up Add new markers to the bottom while existing markers are pushed one row toward the top.

Show Name

Enable to burn-in Marker names to the clip.

Show Comment

Enable to burn-in Marker comments to the clip.

Use Marker Colour

Enable to burn-in the names and comments using the colour of each marker.



Handles

Displays the amount of handles of a timeline segment.

Note: This layer is Not available in Batch and Batch FX.

Display option

Select whether to display the amount of head, tail, or both.



Frame

  • Batch / Batch FX: Displays the current frame from the Batch Group. The frame of a clip or render node can be propagated.
  • Timeline FX: Displays the current frame number, determined by the selection in the First Frame option.

First Frame option

Sets how frames are counted. Segment (Relative) restarts the count at each segment, setting End Frame to the segment duration. Segment (Absolute) displays the record frame Start/End of a segment as seen in the Information box. Timeline / Clip count starts with the timeline or clip, with End Frame as the duration.

Note: This layer is not available in Batch and Batch FX.

Duration option

Batch sets the End field to the Batch duration. Custom makes the End field editable.

Note: Not available in Timeline FX.

Frame Information option

Select the scope for the information displayed, from only the current frame to start, current, and end frames.

Consider Head

Enable to start the frame count from the head frame instead of the segment start.

Note: This layer is not available in Batch and Batch FX.

Padding field

Sets the padding for the frame number display.

Custom Start Frame

Enable to define the value of the start frame for the clip.

Count Direction option

Select the direction of the count.

Custom Start field

Sets the start value of the custom start frame

End Frame field

Displays the end frame when custom start frame is enabled.



Duration

  • Batch / Batch FX: Displays the duration from the Batch Group. The duration of a clip of a clip, render, or write file node can be propagated.
  • Timeline FX: Displays the duration of the source media, timeline / clip, timeline segment, or in to out marks span.

Duration Source option

The source of the duration. In to Out for the duration of the segment between marks. Segment for the duration of the segment. Timeline / Clip for the duration of the entire timeline/clip. Source Media for the duration of the source media, including head and tail.

If you export the clip using the export option Export Between Marks, the duration displayed by the Duration layer is updated to display the duration of what is actually exported.

Note: This layer is not available in Batch and Batch FX.

Ignore Segment

Enable to exclude the timeline segment on which the Burn-In Metadata Timeline FX is located from the calculation of the sequence's duration.

Note: This layer is not available in Batch and Batch FX.

Duration Format option

Select whether to display the duration in frames or timeline.

Frame Padding field

Sets the padding for the display in frames.

Frame Rate option

Select the frame rate display for the customized duration in timecode.

Note: Not available in Timeline FX.



Record Timecode

  • Batch / Batch FX: The record timecode of a clip, render, or write file node can be propagated.
  • Timeline FX: Displays the record timecode of the sequence.

Timecode Information option

Select the scope for the information displayed, from only the current frame to start, current, and end frames.

Custom Start

Enable to define a custom start value.

Custom Start field

Sets the custom start value.

Custom End

Enable to define a custom End value.

Custom End field

Sets the custom end value.

Frame Rate option

Select the frame rate display for the customized record timecode.



Source Timecode

  • Batch / Batch FX: The source timecode of a clip can be propagated.
  • Timeline FX: Displays the timeline segment's source timecode.

Custom Start

Enable to define a custom start value.

Custom Start field

Sets the custom start value.

Custom End

Enable to define a custom End value.

Custom End Value field

Sets the custom end value.

Frame Rate option

Select the frame rate display for the customized source timecode.



Keycode

  • Batch / Batch FX: The keycode of a clip can be propagated.
  • Timeline FX: Displays the timeline segment's keycode.

Custom Start

Enable to define a custom start keycode.

Custom Keycode field

Sets the custom keycode start.



Custom Text

Used to display a custom string of text.

Text field

Sets the customized text.



Media Status

Shows an indication when the current media is unlinked (Unlinked Media) or missing (No Media).



Batch / BFX

  • Batch / Batch FX: Displays the name of the Batch Group, Iteration, or both.
  • Timeline FX: Displays the name of the Batch FX, Iteration, or both.

Display option

Select whether to display the Batch name, Iteration name, or both.



Project

Displays the project's name.



Project Nickname

Displays the project's nickname.



User

Displays the user's name.



User Nickname

Displays the user's nickname.



Workstation

Displays the workstation's name.



Frame Rate

  • Batch / Batch FX: Displays the project's frame rate. The frame rate of a clip, render, or write file node can be propagated.
  • Timeline FX: Displays the frame rate of the clip or source media.

Numeric Only

Enable to remove the 'fps' units from the frame rate display.

Display option

Select whether to display the frame rate of the clip or source media.

Note: This layer is not available in Batch and Batch FX.



Colour Space

  • Batch / Batch FX: The colour space of a clip, render, or write file node can be propagated.
  • Timeline FX: Displays the colour space of the clip or source media.

Colour Space option

Select whether to display the colour space, file colour space, or input colour space.

Display option

Select whether to display the colour space of the clip or source media.

Note: This layer is not available in Batch and Batch FX.



Resolution

  • Batch / Batch FX: Displays the project's resolution. The resolution of a clip, render, or write file node can be propagated.
  • Timeline FX: Displays the resolution of the clip or source media.

Resolution Text field

Sets the resolution information to burn-in. Use the Add Token drop-down button to insert predefined information for the width, height, depth, depth precison, and aspect ratio.

Add Token

Click to add a token to the Text field at the insertion point.

Display option

Select whether to display the resolution of the clip or source media.

Note: This layer is not available in Batch and Batch FX.

Precision field

Sets the amount of digits after the decimal for the aspect ratio.

Note: This layer is not available in Batch and Batch FX.



Date/Time

  • Batch / Batch FX: Displays a custom date/time. The creation date of a clip node can be propagated.
  • Timeline FX: Displays the creation date/time of timeline segment.

Date/Time Text field

Sets the date/time information to burn-in. Use the Add Token drop-down button to insert predefined date/time tokens. Values of the tokens only update when Update is clicked.

Add Token

Click to add a token to the Text field at the insertion point.

Update

Update the tokens in the text field to current values.



Was this information helpful?