Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 (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 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 is based relies on specific a specially formatted JSON filesfile, which are normally typically created by ToolsOnAir and then shared with customers for 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.

Code Block
languagejson
{
  "components": [
    {
      "insets": {
        "bottom": 0,
        "top": 0,
        "left": 0,
        "right": 0
      },
      "w": 500,
      "h": 50,
      "font": {
        "name": ".SFNS-Regular",
        "size": 40
      },
      "x": 50,
      "outline-width": -1,
      "y": 50,
      "draws-background": false,
      "hidden-when-empty": false,
      "background-colour": {
        "r": 0,
        "b": 0,
        "g": 0,
        "a": 0.5
      },
      "metadata-value": {
        "prefix": "",
        "accepts-number": true,
        "key": "quality",
        "type": "datavalue",
        "accepts-string": true,
        "retain-previous-on-empty": true,
        "minimum-integer-digits": 0,
        "maximum-integer-digits": 42,
        "minimum-fraction-digits": 0,
        "maximum-fraction-digits": 1
      },
      "type": "text",
      "corner-radius": 0,
      "alpha": 1,
      "layer": 1,
      "hidden": false,
      "outline-colour": {
        "r": 0,
        "b": 0,
        "g": 0,
        "a": 1
      },
      "text-colour": {
        "r": 1,
        "b": 1,
        "g": 1,
        "a": 1
      },
      "alignment": 0
    },
    {
      "insets": {
        "bottom": 0,
        "top": 0,
        "left": 0,
        "right": 0
      },
      "w": 1500,
      "h": 50,
      "font": {
        "name": ".SFNS-Regular",
        "size": 40
      },
      "x": 50,
      "outline-width": -1,
      "y": 110,
      "draws-background": false,
      "hidden-when-empty": false,
      "background-colour": {
        "r": 0,
        "b": 0,
        "g": 0,
        "a": 0.5
      },
      "metadata-value": {
        "prefix": "",
        "accepts-number": true,
        "key": "customText",
        "type": "datavalue",
        "accepts-string": true,
        "retain-previous-on-empty": true,
        "minimum-integer-digits": 0,
        "maximum-integer-digits": 42,
        "minimum-fraction-digits": 0,
        "maximum-fraction-digits": 1
      },
      "type": "text",
      "corner-radius": 0,
      "alpha": 1,
      "layer": 1,
      "hidden": false,
      "outline-colour": {
        "r": 0,
        "b": 0,
        "g": 0,
        "a": 1
      },
      "text-colour": {
        "r": 1,
        "b": 1,
        "g": 1,
        "a": 1
      },
      "alignment": 0
    }
  ],
  "async-data-updates": false
}

After creating the JSON file, you can enable it for the desired Capture Preset within the Configuration Panel. To do so, simply enable the Custom Overlay Checkbox and choose the respective JSON file.

...

Once this step is completed, return to the user interface and proceed to create a second Capture ID. Select the newly created h.264 Capture Preset and choose a specific Destination Preset. Adjust the Metadata values as needed, and finally, initiate the 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 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.