09 April 2020

CEA-608 data field extraction

Added option to set CEA-608 data field ID to extract from source in captions conversion and captions muxing.

<?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-->
        <!-- Format params -->
        <closed_captions>
            <!-- closed captions params -->
            <cea_data_field>[0|1]</cea_data_field>
        </closed_captions>
        <!-- Multiple closed captions params may be included in output format -->
        <closed_captions>
            <!-- closed captions params -->
        </closed_captions>
    </format></query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[OutputFormat]", // required
          	// Format params
            "closed_captions": [
                {
                    // closed_captions params
                    "cea_data_field": "[0|1]"
                },
                {
                    // closed captions params
                }
            ]
        }
    }
}
<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>AddMedia</action> <!-- required-->
    <source>[CLOSED_CAPTIONS_SOURCE]</source> <!-- required-->
    <format>
        <output>closed_captions</output> <!-- required-->
        <destination>[DestinationURL]</destination> <!-- required-->
        <!-- closed captions params -->
        <cea_data_field>[0|1]</cea_data_field>
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "AddMedia", // required
        "source": "[CLOSED_CAPTIONS_SOURCE]", // required
        "format": {
            "output": "closed_captions", // required
            "destination": "[DestinationURL]", // required
            // closed captions params
            "cea_data_field": "[0|1]"
        }
    }
}

Parameter

Description

Allowed Values

Default Value

cea_data_field

CEA-608 data field id (data type) to be extracted from cea-608 CC data.

  • 0* – NTSC_CC_FIELD_1
  • 1* – NTSC_CC_FIELD_2

0

New video parameters

Added support of non_linear_quant, intra_vlc, drop_frame_timecode <video_codec_parameters />.
Added support of color_range, dc, lmin, lmax, rc_min_vbv_use, and rc_max_vbv_use video settings.

<?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-->
        <color_range>[ColorRange]</color_range>
        <dc>[DCPrecision]</dc>
        <lmin>[MinLF]</lmin>
        <lmax>[MaxLF]</lmax>
        <rc_min_vbv_use>[MinRC]</rc_min_vbv_use>
        <rc_max_vbv_use>[MaxRC]</rc_max_vbv_use>
        <video_codec>mpeg2video</video_codec>
        <video_codec_parameters>
            <non_linear_quant>[0|1]</non_linear_quant>
            <intra_vlc>[0|1]</intra_vlc>
            <drop_frame_timecode>[0|1]</drop_frame_timecode>
        </video_codec_parameters>
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[OutputFormat]", // required
            "color_range": "[ColorRange]",
            "dc": "[DCPrecision]",
            "lmin": "[MinLF]",
            "lmax": "[MaxLF]",
            "rc_min_vbv_use": "[MinRC]",
            "rc_max_vbv_use": "[MaxRC]",
            "video_codec": "[mpeg2video]",
            "video_codec_parameters": {
                "non_linear_quant": "[0|1]",
                "intra_vlc": "[0|1]",
                "drop_frame_timecode": "[0|1]"
            }
        }
    }
}

Parameter

Description

Allowed Values

Default Values

Format Parameters

color_range

Color range

  • 0 – unknown
  • 1 – tv
  • 2 – pc
  • 3 – unspecified
  • 4 – mpeg
  • 5 – jpeg

0

dc

Intra DC precision

Positive integer number

none

lmin

Minimum lagrange factor (VBR)

Positive integer number

none

lmax

Maximum lagrange factor (VBR)

Positive integer number

none

rc_min_vbv_use

Minimum Rate Control VBV factor

Positive integer number

none

rc_max_vbv_use

Maximum Rate Control VBV factor

Positive integer number

none

Video Codec Parameters

non_linear_quant

Use nonlinear quantizer

  • 0 – Disabled
  • 1 – Enabled

none

intra_vlc

Use MPEG-2 intra VLC table

  • 0 – Disabled
  • 1 – Enabled

none

drop_frame_timecode

Timecode is in drop frame format

  • 0 – Disabled
  • 1 – Enabled

none