In earlier versions of just:in Mac, it was already feasible to merge Metadata and Naming Presets. However, with the introduction of Custom Overlays in version 6.0, metadata values can now be accessed within Overlays. This enhancement allows for a seamless integration of all elements in a single workflow.
This Workflow Description offers valuable guidance for integrating these elements effectively. The provided examples can serve as a helpful starting point for tailoring the integration to suit individual use cases.
To effectively follow the instructions, it is necessary to have a functioning just:in Mac setup with at least one channel. The setup should include a valid signal, which can either be SDI or NDI.
The initial step in this use case is to create a Metadata Preset, which serves as the primary entry point for data. The Naming Preset will then be derived from the selected Metadata values and may include additional static variables. Furthermore, the Custom Overlay will have access to the Metadata values, allowing for seamless integration.
Metadata Preset
Below is an illustrative example of the Metadata Preset, providing a visual representation of how it appears in the user interface (StartUpXML) and the actual exported metadata sidecar file (ExportXML).
Please note that this particular page does not provide detailed instructions on creating Metadata Presets or the specific rules to follow. For comprehensive information on creating Metadata Presets, we recommend referring to the relevant section in the User Manual. It will provide you with the necessary guidance and instructions.
StartUpXML:
<?xml version="1.0"?>
<metadataSet>
<name>Workflow_User_Manual</name>
<extension>xml</extension>
<control resetAfterRecord="1" default="">
<name>quality</name>
<label>Quality</label>
<type class="Selection">
<item>Low</item>
<item>Medium</item>
<item>High</item>
</type>
</control>
<control resetAfterRecord="1" default="">
<name>customText</name>
<label>Text</label>
<type class="Text" default=""></type>
</control>
</metadataSet>
It is important to pay special attention to the two name XML attributes (“quality” and “customText”) mentioned above, as they will be utilised in subsequent steps of this Workflow description.
ExportXML:
<?xml version="1.0" encoding="UTF-8" ?>
<file name="%Just_In_Clipname" path="%Just_In_Full_Clipname" duration="%Just_In_Capture_Duration">
<quality>%quality</quality>
<text>%customText</text>
</file>
The provided StartUpXML generates two elements, namely a selection box and a text field, within the Inspector of the Just Control. To get a better understanding of their appearance in the user interface, please refer to the image below.
Once the Metadata Preset has been configured and set up, the next step is to create a Naming Preset based on the selected Metadata Preset.
Naming Preset
Naming Presets, like all other just:in Mac Presets, can be conveniently created within the Just Control Configuration Panel. In this panel, you have the option to configure a new Naming Preset that is based on the Metadata values. Moreover, you can also include static variables, such as the Channel Name. To connect Metadata variables, simply use the exclamation mark "!". For more specific instructions and visual guidance, please refer to the screenshot below.
Please note that this particular page does not provide detailed instructions on creating Naming Presets. For comprehensive information on creating Naming Presets, we recommend referring to the relevant section in the User Manual. It will provide you with the necessary guidance and instructions.
As previously mentioned, you can reference a Metadata value by its specific name within the StartUpXML. By using the exclamation mark, you can indicate that a Naming Preset value corresponds to a Metadata value. Now, let's explore how this functionality operates within the user interface.
Upon selecting the new Naming Preset, it automatically verifies whether the corresponding Metadata fields have been properly configured. If the Metadata fields are adjusted accordingly, the resulting filename will be displayed as a confirmation.
This workflow enables the utilization of Metadata Presets to automate the file naming process for recordings. In the final step, custom Overlays will have access to the dedicated Metadata values as well. Additionally, the Proxy file will be utilised to visualise and facilitate this process.
Custom Overlays
Lastly, we will create a new Capture Preset to facilitate the creation of Proxy files and enable the Custom Overlay feature. To accomplish this, open the Configuration Panel once again, navigate to the Capture Presets Tab, and proceed to create a new Preset based on the h.264 codec.
The Custom Overlay feature is based on specific formatted JSON files, which are normally created by ToolsOnAir and then shared with customers for their workflows.