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