In earlier versions of just:in Macmac, 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.
...
To effectively follow the instructions, it is necessary to have a functioning just:in Mac mac setup with at least one channel. The setup should include a valid signal, which can either be SDI or NDINDI®.
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.
...
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”).
Info |
---|
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 how to create Metadata Presets, we recommend referring to the relevant section in the User Manual. It will provide you with the necessary guidance and instructions. |
StartUpXML:
Code Block | ||
---|---|---|
| ||
<?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:
Code Block | ||
---|---|---|
| ||
<?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 more profound 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 mac Presets, can be conveniently created within the Just Control Configuration Panel 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.
Info |
---|
Please note that this particular page does not provide detailed instructions on creating how to create 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 above, 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 Just Control 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 file name 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 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.
...
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 Just Control Configuration Panel panel once again, navigate to the “Capture Presets TabPresets” tab, and proceed to create a new Preset based on the h“H.264 264” codec (Custom Overlay feature is not enabled yet).
...
Info |
---|
Please note that this particular page does not provide detailed instructions on creating Capture Presets. For comprehensive information on creating how to create Capture Presets, we recommend referring to the relevant section in the User Manual. It will provide you with the necessary guidance and instructions. |
The Custom Overlay feature relies on a specially formatted JSON file, typically created by ToolsOnAir and shared with customers to align with their specific workflows. Below is an example of such a JSON file, which enables the selected Capture Preset to overlay the two Metadata values mentioned earlier.
...
After creating the JSON file, you can enable it for the desired Capture Preset within the Just Control Configuration Panelpanel. To do so, simply enable the Custom Overlay Checkbox and choose the respective JSON file.
...
Once this step is completed, return to the Just Control user interface and proceed to create a second Capture ID. Select the newly created h“H.264 Capture Preset” and choose select a specific Destination Preset. Adjust the Metadata values as needed, and finally, initiate the recording Recording process.
...
At this point, you can stop the recording process and proceed to verify the presence of Custom Overlays in the Proxy file. To do so, open the recorded MP4 file using Apple’s QuickTime Player.
...
Please take note that it is also possible to export the provided Metadata to a dedicated sidecar file. For more detailed instructions on this functionality, please refer to the appropriate pages in the User Manual.