---
agentTools:
  projectIndex: https://api.encoding.com/llms.txt
---

# 11 April 2024

## Clean aperture metadata management

Added new force\_clap parameter for [Apple ProRes output format](https://api.encoding.com/reference/output-apple-prores)

```xml
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required -->
    <userkey>[UserKey]</userkey> <!-- required -->
    <action>[Action]</action> <!-- required -->
    <source>[SourceFile]</source> <!-- required -->
    <format>
        <output>apple_prores</output> <!-- required -->
        <force_clap>[yes|no]</force_clap>
        <!-- format parameters -->
    </format>
</query>
```
```json
{
  "query": {
    "userid": "[UserID]", // required
    "userkey": "[UserKey]", // required
    "action": "[Action]", // required
    "source": "[SourceFile]", // required
    "format": {
      "output": "apple_prores", // required
      "force_clap": "[yes|no]"
      // format parameters
    }
  }
}
```

| Parameter       | Description                           | Allowed Values | Default Value |
| :-------------- | :------------------------------------ | :------------- | :------------ |
| **force\_clap** | Force insert clean aperture parameter | yes, no        | *none*        |

## Audio frame wrapping mode control for MXF OP-1a outputs

Added new [frame\_wrapping parameter](https://api.encoding.com/reference/output-audiomultitrack) for MXF OP-1a output format

```xml
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required -->
    <userkey>[UserKey]</userkey> <!-- required -->
    <action>[Action]</action> <!-- required -->
    <source>[SourceFile]</source> <!-- required -->
    <format>
        <output>mxf_op1a</output> <!-- required -->
        <audio_stream>
            <frame_wrapping>[aes3|bwf]</frame_wrapping>
            <!-- audio stream parameters -->
        </audio_stream>
        <!-- format parameters -->
    </format>
</query>
```
```json
{
  "query": {
    "userid": "[UserID]", // required
    "userkey": "[UserKey]", // required
    "action": "[Action]", // required
    "source": "[SourceFile]", // required
    "format": {
      "output": "mxf_op1a", // required
      "audio_stream": [
        {
          "frame_wrapping": "[aes3|bwf]"
          // audio stream parameters
        }
      ]
      // format parameters
    }
  }
}
```

| Parameter           | Description               | Allowed Values | Default Value |
| :------------------ | :------------------------ | :------------- | :------------ |
| **frame\_wrapping** | Audio frame wrapping mode | aes3, bwf      | *none*        |

## Merge 2 CC files to a single SCC

Added support of merging 2 CC files to a single SCC for [closed\_captions](https://api.encoding.com/reference/closed-captions-conversion) output format.\
Sources are mapped to CC1 and CC2 channels in the output SCC file.

```xml
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>AddMedia</action> <!-- required-->
    <source>[ClosedCaptionsSourceFile1]</source>
    <source>[ClosedCaptionsSourceFile2]</source>
    <format>
        <output>closed_captions</output> <!-- required-->
        <destination>[DestinationURL]</destination> <!-- required-->
        <type>scc</type>
    </format>
</query>
```
```json JSON
{
  "query": {
    "userid": "[UserID]", // required
    "userkey": "[UserKey]", // required
    "action": "AddMedia", // required
    "source": "[ClosedCaptionsSourceFile1]", // required
    "source": "[ClosedCaptionsSourceFile2]", // required
    "format": {
      "output": "closed_captions", // required
      "destination": "DestinationURL", // required
      "type": "scc"
    }
  }
}
```

## OMMQ data format parameter

Added new [OMMQ data format parameter](https://api.encoding.com/reference/output-other)

```xml
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required -->
    <userkey>[UserKey]</userkey> <!-- required -->
    <action>[Action]</action> <!-- required -->
    <source>[SourceFile]</source> <!-- required -->
    <format>
        <output>mxf_op1a</output> <!-- required -->
        <ommq_data>[name=value]</ommq_data>
        <!-- format parameters -->
    </format>
</query>
```
```json
{
  "query": {
    "userid": "[UserID]", // required
    "userkey": "[UserKey]", // required
    "action": "[Action]", // required
    "source": "[SourceFile]", // required
    "format": {
      "output": "mxf_op1a", // required
      "ommq_data": "[name=value]"
      // format parameters
    }
  }
}
```

| Parameter      | Description                                                              | Allowed Values  | Default Value |
| :------------- | :----------------------------------------------------------------------- | :-------------- | :------------ |
| **ommq\_data** | Make the output pass through ommq tool (to add specific omneon metadata) | \[N:]name=value | *none*        |