03 September 2020

Color Space and GOP structure for XDCAM video codec

Added Color Space and GOP structure parameters for xdcam video codec.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[OutputFormat]</output> <!-- required-->
        <video_codec>xdcam</video_codec> <!-- required-->
        <video_codec_parameters>
            <sc_threshold>[Threshold]</sc_threshold>
            <b-pyramid>[0|1]</b-pyramid>
            <b_strategy>[0|1|2]</b_strategy>
            <bf>[BFrames]</bf>
            <colorprim>[ColorPrimaries]</colorprim>
            <transfer>[ColorTransfer]</transfer>
            <colorspace>[ColorSpace]</colorspace>
        </video_codec_parameters>
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[OutputFormat]", // required
            "video_codec": "xdcam",
            "video_codec_parameters": {
                "sc_threshold": "[Threshold]",
                "b-pyramid": "[0|1]",
                "b_strategy": "[0|1|2]",
                "bf": "[BFrames]",
                "colorprim": "[ColorPrimaries]",
                "transfer": "[ColorTransfer]",
                "colorspace": "[ColorSpace]"
            }
        }
    }
}
ParameterDescriptionAllowed Values
sc_thresholdScene change thresholdPositive integer number
b-pyramidApply B-pyramid method0 – Disabled
1 – Enabled
b_strategyB-Frames Strategy0, 1, 2
bfB-Frames numberPositive integer number
colorprimColor Primariesbt709, bt470m, bt470bg, smpte170m, smpte240m, film, bt2020, undef
transferColor Transferbt709, bt470m, bt470bg, smpte170m, smpte240m, linear, log100, log316, iec61966-2-4, bt1361e, iec61966-2-1, bt2020-10, bt2020-12, undef
colorspaceColor Spacergb, bt709, fcc, bt470bg, smpte170m, smpte240m, ycocg, bt2020_ncl, bt2020_cl, smpte2085

Color Space for MOV output format

Added Color Space parameters for mov output format.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>addMedia</action>
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>[output]</output> <!-- REQUIRED -->
        <color_range>[ColorRange]</color_range>
        <color_primaries>[ColorPrimaries]</color_primaries>
        <transfer_characteristics>[TransferCharacteristics]</transfer_characteristics>
        <matrix_coefficients>[MatrixCoefficients]</matrix_coefficients>
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "addMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "[output]", // required
            "color_range": "[ColorRange]",
            "color_primaries": "[ColorPrimaries]",
            "transfer_characteristics": "[TransferCharacteristics]",
            "matrix_coefficients": "[MatrixCoefficients]"
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Values
color_rangeColor range0 – unknown
1 – tv
2 – pc
3 – unspecified
4 – mpeg
5 – jpeg
0
color_primariesColor Primaries2 – auto
1 – ITU-R BT.709
5 – ITU-R BT.601 625-line
6 – ITU-R BT.601 525-line
9 – ITU-R BT.2020
copy
2
transfer_characteristicsTransfer Characteristics2 – auto
1 – ITU-R BT.709 / BT.601 / BT.2020
16 – SMPTE ST 2084 (PQ)
18 – BT.2100 Hybrid Log Gamma
copy
2
matrix_coefficientsMatrix Coefficients2 – auto
1 – ITU-R BT.709, 6 – ITU-R BT.601
9 – ITU-R BT.2020
copy
2

🚧

For color_primaries, transfer_characteristics, and matrix_coefficients parameters

<color_primaries />, <transfer_characteristics />, and <matrix_coefficients /> parameters supported only in mov, cablelabs_mpegts, mxf, andapple_prores output formats.