Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . mediaconvert ]

create-preset

Description

Create a new preset. For information about job templates see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  create-preset
[--category <value>]
[--description <value>]
[--name <value>]
[--settings <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--category (string) Optional. A category for the preset you are creating.

--description (string) Optional. A description of the preset you are creating.

--name (string) The name of the preset you are creating.

--settings (structure) Settings for preset

JSON Syntax:

{
  "AudioDescriptions": [
    {
      "AudioNormalizationSettings": {
        "Algorithm": "ITU_BS_1770_1"|"ITU_BS_1770_2",
        "AlgorithmControl": "CORRECT_AUDIO"|"MEASURE_ONLY",
        "CorrectionGateLevel": integer,
        "LoudnessLogging": "LOG"|"DONT_LOG",
        "PeakCalculation": "TRUE_PEAK"|"NONE",
        "TargetLkfs": double
      },
      "AudioSourceName": "string",
      "AudioType": integer,
      "AudioTypeControl": "FOLLOW_INPUT"|"USE_CONFIGURED",
      "CodecSettings": {
        "AacSettings": {
          "AudioDescriptionBroadcasterMix": "BROADCASTER_MIXED_AD"|"NORMAL",
          "Bitrate": integer,
          "CodecProfile": "LC"|"HEV1"|"HEV2",
          "CodingMode": "AD_RECEIVER_MIX"|"CODING_MODE_1_0"|"CODING_MODE_1_1"|"CODING_MODE_2_0"|"CODING_MODE_5_1",
          "RateControlMode": "CBR"|"VBR",
          "RawFormat": "LATM_LOAS"|"NONE",
          "SampleRate": integer,
          "Specification": "MPEG2"|"MPEG4",
          "VbrQuality": "LOW"|"MEDIUM_LOW"|"MEDIUM_HIGH"|"HIGH"
        },
        "Ac3Settings": {
          "Bitrate": integer,
          "BitstreamMode": "COMPLETE_MAIN"|"COMMENTARY"|"DIALOGUE"|"EMERGENCY"|"HEARING_IMPAIRED"|"MUSIC_AND_EFFECTS"|"VISUALLY_IMPAIRED"|"VOICE_OVER",
          "CodingMode": "CODING_MODE_1_0"|"CODING_MODE_1_1"|"CODING_MODE_2_0"|"CODING_MODE_3_2_LFE",
          "Dialnorm": integer,
          "DynamicRangeCompressionProfile": "FILM_STANDARD"|"NONE",
          "LfeFilter": "ENABLED"|"DISABLED",
          "MetadataControl": "FOLLOW_INPUT"|"USE_CONFIGURED",
          "SampleRate": integer
        },
        "AiffSettings": {
          "BitDepth": integer,
          "Channels": integer,
          "SampleRate": integer
        },
        "Codec": "AAC"|"MP2"|"WAV"|"AIFF"|"AC3"|"EAC3"|"PASSTHROUGH",
        "Eac3Settings": {
          "AttenuationControl": "ATTENUATE_3_DB"|"NONE",
          "Bitrate": integer,
          "BitstreamMode": "COMPLETE_MAIN"|"COMMENTARY"|"EMERGENCY"|"HEARING_IMPAIRED"|"VISUALLY_IMPAIRED",
          "CodingMode": "CODING_MODE_1_0"|"CODING_MODE_2_0"|"CODING_MODE_3_2",
          "DcFilter": "ENABLED"|"DISABLED",
          "Dialnorm": integer,
          "DynamicRangeCompressionLine": "NONE"|"FILM_STANDARD"|"FILM_LIGHT"|"MUSIC_STANDARD"|"MUSIC_LIGHT"|"SPEECH",
          "DynamicRangeCompressionRf": "NONE"|"FILM_STANDARD"|"FILM_LIGHT"|"MUSIC_STANDARD"|"MUSIC_LIGHT"|"SPEECH",
          "LfeControl": "LFE"|"NO_LFE",
          "LfeFilter": "ENABLED"|"DISABLED",
          "LoRoCenterMixLevel": double,
          "LoRoSurroundMixLevel": double,
          "LtRtCenterMixLevel": double,
          "LtRtSurroundMixLevel": double,
          "MetadataControl": "FOLLOW_INPUT"|"USE_CONFIGURED",
          "PassthroughControl": "WHEN_POSSIBLE"|"NO_PASSTHROUGH",
          "PhaseControl": "SHIFT_90_DEGREES"|"NO_SHIFT",
          "SampleRate": integer,
          "StereoDownmix": "NOT_INDICATED"|"LO_RO"|"LT_RT"|"DPL2",
          "SurroundExMode": "NOT_INDICATED"|"ENABLED"|"DISABLED",
          "SurroundMode": "NOT_INDICATED"|"ENABLED"|"DISABLED"
        },
        "Mp2Settings": {
          "Bitrate": integer,
          "Channels": integer,
          "SampleRate": integer
        },
        "WavSettings": {
          "BitDepth": integer,
          "Channels": integer,
          "SampleRate": integer
        }
      },
      "LanguageCode": "ENG"|"SPA"|"FRA"|"DEU"|"GER"|"ZHO"|"ARA"|"HIN"|"JPN"|"RUS"|"POR"|"ITA"|"URD"|"VIE"|"KOR"|"PAN"|"ABK"|"AAR"|"AFR"|"AKA"|"SQI"|"AMH"|"ARG"|"HYE"|"ASM"|"AVA"|"AVE"|"AYM"|"AZE"|"BAM"|"BAK"|"EUS"|"BEL"|"BEN"|"BIH"|"BIS"|"BOS"|"BRE"|"BUL"|"MYA"|"CAT"|"KHM"|"CHA"|"CHE"|"NYA"|"CHU"|"CHV"|"COR"|"COS"|"CRE"|"HRV"|"CES"|"DAN"|"DIV"|"NLD"|"DZO"|"ENM"|"EPO"|"EST"|"EWE"|"FAO"|"FIJ"|"FIN"|"FRM"|"FUL"|"GLA"|"GLG"|"LUG"|"KAT"|"ELL"|"GRN"|"GUJ"|"HAT"|"HAU"|"HEB"|"HER"|"HMO"|"HUN"|"ISL"|"IDO"|"IBO"|"IND"|"INA"|"ILE"|"IKU"|"IPK"|"GLE"|"JAV"|"KAL"|"KAN"|"KAU"|"KAS"|"KAZ"|"KIK"|"KIN"|"KIR"|"KOM"|"KON"|"KUA"|"KUR"|"LAO"|"LAT"|"LAV"|"LIM"|"LIN"|"LIT"|"LUB"|"LTZ"|"MKD"|"MLG"|"MSA"|"MAL"|"MLT"|"GLV"|"MRI"|"MAR"|"MAH"|"MON"|"NAU"|"NAV"|"NDE"|"NBL"|"NDO"|"NEP"|"SME"|"NOR"|"NOB"|"NNO"|"OCI"|"OJI"|"ORI"|"ORM"|"OSS"|"PLI"|"FAS"|"POL"|"PUS"|"QUE"|"QAA"|"RON"|"ROH"|"RUN"|"SMO"|"SAG"|"SAN"|"SRD"|"SRB"|"SNA"|"III"|"SND"|"SIN"|"SLK"|"SLV"|"SOM"|"SOT"|"SUN"|"SWA"|"SSW"|"SWE"|"TGL"|"TAH"|"TGK"|"TAM"|"TAT"|"TEL"|"THA"|"BOD"|"TIR"|"TON"|"TSO"|"TSN"|"TUR"|"TUK"|"TWI"|"UIG"|"UKR"|"UZB"|"VEN"|"VOL"|"WLN"|"CYM"|"FRY"|"WOL"|"XHO"|"YID"|"YOR"|"ZHA"|"ZUL"|"ORJ"|"QPC"|"TNG",
      "LanguageCodeControl": "FOLLOW_INPUT"|"USE_CONFIGURED",
      "RemixSettings": {
        "ChannelMapping": {
          "OutputChannels": [
            {
              "InputChannels": [integer, ...]
            }
            ...
          ]
        },
        "ChannelsIn": integer,
        "ChannelsOut": integer
      },
      "StreamName": "string"
    }
    ...
  ],
  "CaptionDescriptions": [
    {
      "DestinationSettings": {
        "BurninDestinationSettings": {
          "Alignment": "CENTERED"|"LEFT",
          "BackgroundColor": "NONE"|"BLACK"|"WHITE",
          "BackgroundOpacity": integer,
          "FontColor": "WHITE"|"BLACK"|"YELLOW"|"RED"|"GREEN"|"BLUE",
          "FontOpacity": integer,
          "FontResolution": integer,
          "FontSize": integer,
          "OutlineColor": "BLACK"|"WHITE"|"YELLOW"|"RED"|"GREEN"|"BLUE",
          "OutlineSize": integer,
          "ShadowColor": "NONE"|"BLACK"|"WHITE",
          "ShadowOpacity": integer,
          "ShadowXOffset": integer,
          "ShadowYOffset": integer,
          "TeletextSpacing": "FIXED_GRID"|"PROPORTIONAL",
          "XPosition": integer,
          "YPosition": integer
        },
        "DestinationType": "BURN_IN"|"DVB_SUB"|"EMBEDDED"|"SCC"|"SRT"|"TELETEXT"|"TTML"|"WEBVTT",
        "DvbSubDestinationSettings": {
          "Alignment": "CENTERED"|"LEFT",
          "BackgroundColor": "NONE"|"BLACK"|"WHITE",
          "BackgroundOpacity": integer,
          "FontColor": "WHITE"|"BLACK"|"YELLOW"|"RED"|"GREEN"|"BLUE",
          "FontOpacity": integer,
          "FontResolution": integer,
          "FontSize": integer,
          "OutlineColor": "BLACK"|"WHITE"|"YELLOW"|"RED"|"GREEN"|"BLUE",
          "OutlineSize": integer,
          "ShadowColor": "NONE"|"BLACK"|"WHITE",
          "ShadowOpacity": integer,
          "ShadowXOffset": integer,
          "ShadowYOffset": integer,
          "TeletextSpacing": "FIXED_GRID"|"PROPORTIONAL",
          "XPosition": integer,
          "YPosition": integer
        },
        "SccDestinationSettings": {
          "Framerate": "FRAMERATE_23_97"|"FRAMERATE_24"|"FRAMERATE_29_97_DROPFRAME"|"FRAMERATE_29_97_NON_DROPFRAME"
        },
        "TeletextDestinationSettings": {
          "PageNumber": "string"
        },
        "TtmlDestinationSettings": {
          "StylePassthrough": "ENABLED"|"DISABLED"
        }
      },
      "LanguageCode": "ENG"|"SPA"|"FRA"|"DEU"|"GER"|"ZHO"|"ARA"|"HIN"|"JPN"|"RUS"|"POR"|"ITA"|"URD"|"VIE"|"KOR"|"PAN"|"ABK"|"AAR"|"AFR"|"AKA"|"SQI"|"AMH"|"ARG"|"HYE"|"ASM"|"AVA"|"AVE"|"AYM"|"AZE"|"BAM"|"BAK"|"EUS"|"BEL"|"BEN"|"BIH"|"BIS"|"BOS"|"BRE"|"BUL"|"MYA"|"CAT"|"KHM"|"CHA"|"CHE"|"NYA"|"CHU"|"CHV"|"COR"|"COS"|"CRE"|"HRV"|"CES"|"DAN"|"DIV"|"NLD"|"DZO"|"ENM"|"EPO"|"EST"|"EWE"|"FAO"|"FIJ"|"FIN"|"FRM"|"FUL"|"GLA"|"GLG"|"LUG"|"KAT"|"ELL"|"GRN"|"GUJ"|"HAT"|"HAU"|"HEB"|"HER"|"HMO"|"HUN"|"ISL"|"IDO"|"IBO"|"IND"|"INA"|"ILE"|"IKU"|"IPK"|"GLE"|"JAV"|"KAL"|"KAN"|"KAU"|"KAS"|"KAZ"|"KIK"|"KIN"|"KIR"|"KOM"|"KON"|"KUA"|"KUR"|"LAO"|"LAT"|"LAV"|"LIM"|"LIN"|"LIT"|"LUB"|"LTZ"|"MKD"|"MLG"|"MSA"|"MAL"|"MLT"|"GLV"|"MRI"|"MAR"|"MAH"|"MON"|"NAU"|"NAV"|"NDE"|"NBL"|"NDO"|"NEP"|"SME"|"NOR"|"NOB"|"NNO"|"OCI"|"OJI"|"ORI"|"ORM"|"OSS"|"PLI"|"FAS"|"POL"|"PUS"|"QUE"|"QAA"|"RON"|"ROH"|"RUN"|"SMO"|"SAG"|"SAN"|"SRD"|"SRB"|"SNA"|"III"|"SND"|"SIN"|"SLK"|"SLV"|"SOM"|"SOT"|"SUN"|"SWA"|"SSW"|"SWE"|"TGL"|"TAH"|"TGK"|"TAM"|"TAT"|"TEL"|"THA"|"BOD"|"TIR"|"TON"|"TSO"|"TSN"|"TUR"|"TUK"|"TWI"|"UIG"|"UKR"|"UZB"|"VEN"|"VOL"|"WLN"|"CYM"|"FRY"|"WOL"|"XHO"|"YID"|"YOR"|"ZHA"|"ZUL"|"ORJ"|"QPC"|"TNG",
      "LanguageDescription": "string"
    }
    ...
  ],
  "ContainerSettings": {
    "Container": "F4V"|"ISMV"|"M2TS"|"M3U8"|"MOV"|"MP4"|"MPD"|"MXF"|"RAW",
    "F4vSettings": {
      "MoovPlacement": "PROGRESSIVE_DOWNLOAD"|"NORMAL"
    },
    "M2tsSettings": {
      "AudioBufferModel": "DVB"|"ATSC",
      "AudioFramesPerPes": integer,
      "AudioPids": [integer, ...],
      "Bitrate": integer,
      "BufferModel": "MULTIPLEX"|"NONE",
      "DvbNitSettings": {
        "NetworkId": integer,
        "NetworkName": "string",
        "NitInterval": integer
      },
      "DvbSdtSettings": {
        "OutputSdt": "SDT_FOLLOW"|"SDT_FOLLOW_IF_PRESENT"|"SDT_MANUAL"|"SDT_NONE",
        "SdtInterval": integer,
        "ServiceName": "string",
        "ServiceProviderName": "string"
      },
      "DvbSubPids": [integer, ...],
      "DvbTdtSettings": {
        "TdtInterval": integer
      },
      "DvbTeletextPid": integer,
      "EbpAudioInterval": "VIDEO_AND_FIXED_INTERVALS"|"VIDEO_INTERVAL",
      "EbpPlacement": "VIDEO_AND_AUDIO_PIDS"|"VIDEO_PID",
      "EsRateInPes": "INCLUDE"|"EXCLUDE",
      "FragmentTime": double,
      "MaxPcrInterval": integer,
      "MinEbpInterval": integer,
      "NielsenId3": "INSERT"|"NONE",
      "NullPacketBitrate": double,
      "PatInterval": integer,
      "PcrControl": "PCR_EVERY_PES_PACKET"|"CONFIGURED_PCR_PERIOD",
      "PcrPid": integer,
      "PmtInterval": integer,
      "PmtPid": integer,
      "PrivateMetadataPid": integer,
      "ProgramNumber": integer,
      "RateMode": "VBR"|"CBR",
      "Scte35Pid": integer,
      "Scte35Source": "PASSTHROUGH"|"NONE",
      "SegmentationMarkers": "NONE"|"RAI_SEGSTART"|"RAI_ADAPT"|"PSI_SEGSTART"|"EBP"|"EBP_LEGACY",
      "SegmentationStyle": "MAINTAIN_CADENCE"|"RESET_CADENCE",
      "SegmentationTime": double,
      "TimedMetadataPid": integer,
      "TransportStreamId": integer,
      "VideoPid": integer
    },
    "M3u8Settings": {
      "AudioFramesPerPes": integer,
      "AudioPids": [integer, ...],
      "NielsenId3": "INSERT"|"NONE",
      "PatInterval": integer,
      "PcrControl": "PCR_EVERY_PES_PACKET"|"CONFIGURED_PCR_PERIOD",
      "PcrPid": integer,
      "PmtInterval": integer,
      "PmtPid": integer,
      "PrivateMetadataPid": integer,
      "ProgramNumber": integer,
      "Scte35Pid": integer,
      "Scte35Source": "PASSTHROUGH"|"NONE",
      "TimedMetadata": "PASSTHROUGH"|"NONE",
      "TimedMetadataPid": integer,
      "TransportStreamId": integer,
      "VideoPid": integer
    },
    "MovSettings": {
      "ClapAtom": "INCLUDE"|"EXCLUDE",
      "CslgAtom": "INCLUDE"|"EXCLUDE",
      "Mpeg2FourCCControl": "XDCAM"|"MPEG",
      "PaddingControl": "OMNEON"|"NONE",
      "Reference": "SELF_CONTAINED"|"EXTERNAL"
    },
    "Mp4Settings": {
      "CslgAtom": "INCLUDE"|"EXCLUDE",
      "FreeSpaceBox": "INCLUDE"|"EXCLUDE",
      "MoovPlacement": "PROGRESSIVE_DOWNLOAD"|"NORMAL",
      "Mp4MajorBrand": "string"
    }
  },
  "VideoDescription": {
    "AfdSignaling": "NONE"|"AUTO"|"FIXED",
    "AntiAlias": "DISABLED"|"ENABLED",
    "CodecSettings": {
      "Codec": "FRAME_CAPTURE"|"H_264"|"H_265"|"MPEG2"|"PRORES",
      "FrameCaptureSettings": {
        "FramerateDenominator": integer,
        "FramerateNumerator": integer,
        "MaxCaptures": integer,
        "Quality": integer
      },
      "H264Settings": {
        "AdaptiveQuantization": "OFF"|"LOW"|"MEDIUM"|"HIGH"|"HIGHER"|"MAX",
        "Bitrate": integer,
        "CodecLevel": "AUTO"|"LEVEL_1"|"LEVEL_1_1"|"LEVEL_1_2"|"LEVEL_1_3"|"LEVEL_2"|"LEVEL_2_1"|"LEVEL_2_2"|"LEVEL_3"|"LEVEL_3_1"|"LEVEL_3_2"|"LEVEL_4"|"LEVEL_4_1"|"LEVEL_4_2"|"LEVEL_5"|"LEVEL_5_1"|"LEVEL_5_2",
        "CodecProfile": "BASELINE"|"HIGH"|"HIGH_10BIT"|"HIGH_422"|"HIGH_422_10BIT"|"MAIN",
        "EntropyEncoding": "CABAC"|"CAVLC",
        "FieldEncoding": "PAFF"|"FORCE_FIELD",
        "FlickerAdaptiveQuantization": "DISABLED"|"ENABLED",
        "FramerateControl": "INITIALIZE_FROM_SOURCE"|"SPECIFIED",
        "FramerateConversionAlgorithm": "DUPLICATE_DROP"|"INTERPOLATE",
        "FramerateDenominator": integer,
        "FramerateNumerator": integer,
        "GopBReference": "DISABLED"|"ENABLED",
        "GopClosedCadence": integer,
        "GopSize": double,
        "GopSizeUnits": "FRAMES"|"SECONDS",
        "HrdBufferInitialFillPercentage": integer,
        "HrdBufferSize": integer,
        "InterlaceMode": "PROGRESSIVE"|"TOP_FIELD"|"BOTTOM_FIELD"|"FOLLOW_TOP_FIELD"|"FOLLOW_BOTTOM_FIELD",
        "MaxBitrate": integer,
        "MinIInterval": integer,
        "NumberBFramesBetweenReferenceFrames": integer,
        "NumberReferenceFrames": integer,
        "ParControl": "INITIALIZE_FROM_SOURCE"|"SPECIFIED",
        "ParDenominator": integer,
        "ParNumerator": integer,
        "QualityTuningLevel": "SINGLE_PASS"|"SINGLE_PASS_HQ"|"MULTI_PASS_HQ",
        "RateControlMode": "VBR"|"CBR",
        "RepeatPps": "DISABLED"|"ENABLED",
        "SceneChangeDetect": "DISABLED"|"ENABLED",
        "Slices": integer,
        "SlowPal": "DISABLED"|"ENABLED",
        "Softness": integer,
        "SpatialAdaptiveQuantization": "DISABLED"|"ENABLED",
        "Syntax": "DEFAULT"|"RP2027",
        "Telecine": "NONE"|"SOFT"|"HARD",
        "TemporalAdaptiveQuantization": "DISABLED"|"ENABLED",
        "UnregisteredSeiTimecode": "DISABLED"|"ENABLED"
      },
      "H265Settings": {
        "AdaptiveQuantization": "OFF"|"LOW"|"MEDIUM"|"HIGH"|"HIGHER"|"MAX",
        "AlternateTransferFunctionSei": "DISABLED"|"ENABLED",
        "Bitrate": integer,
        "CodecLevel": "AUTO"|"LEVEL_1"|"LEVEL_2"|"LEVEL_2_1"|"LEVEL_3"|"LEVEL_3_1"|"LEVEL_4"|"LEVEL_4_1"|"LEVEL_5"|"LEVEL_5_1"|"LEVEL_5_2"|"LEVEL_6"|"LEVEL_6_1"|"LEVEL_6_2",
        "CodecProfile": "MAIN_MAIN"|"MAIN_HIGH"|"MAIN10_MAIN"|"MAIN10_HIGH"|"MAIN_422_8BIT_MAIN"|"MAIN_422_8BIT_HIGH"|"MAIN_422_10BIT_MAIN"|"MAIN_422_10BIT_HIGH",
        "FlickerAdaptiveQuantization": "DISABLED"|"ENABLED",
        "FramerateControl": "INITIALIZE_FROM_SOURCE"|"SPECIFIED",
        "FramerateConversionAlgorithm": "DUPLICATE_DROP"|"INTERPOLATE",
        "FramerateDenominator": integer,
        "FramerateNumerator": integer,
        "GopBReference": "DISABLED"|"ENABLED",
        "GopClosedCadence": integer,
        "GopSize": double,
        "GopSizeUnits": "FRAMES"|"SECONDS",
        "HrdBufferInitialFillPercentage": integer,
        "HrdBufferSize": integer,
        "InterlaceMode": "PROGRESSIVE"|"TOP_FIELD"|"BOTTOM_FIELD"|"FOLLOW_TOP_FIELD"|"FOLLOW_BOTTOM_FIELD",
        "MaxBitrate": integer,
        "MinIInterval": integer,
        "NumberBFramesBetweenReferenceFrames": integer,
        "NumberReferenceFrames": integer,
        "ParControl": "INITIALIZE_FROM_SOURCE"|"SPECIFIED",
        "ParDenominator": integer,
        "ParNumerator": integer,
        "QualityTuningLevel": "SINGLE_PASS"|"SINGLE_PASS_HQ"|"MULTI_PASS_HQ",
        "RateControlMode": "VBR"|"CBR",
        "SampleAdaptiveOffsetFilterMode": "DEFAULT"|"ADAPTIVE"|"OFF",
        "SceneChangeDetect": "DISABLED"|"ENABLED",
        "Slices": integer,
        "SlowPal": "DISABLED"|"ENABLED",
        "SpatialAdaptiveQuantization": "DISABLED"|"ENABLED",
        "Telecine": "NONE"|"SOFT"|"HARD",
        "TemporalAdaptiveQuantization": "DISABLED"|"ENABLED",
        "TemporalIds": "DISABLED"|"ENABLED",
        "Tiles": "DISABLED"|"ENABLED",
        "UnregisteredSeiTimecode": "DISABLED"|"ENABLED"
      },
      "Mpeg2Settings": {
        "AdaptiveQuantization": "OFF"|"LOW"|"MEDIUM"|"HIGH",
        "Bitrate": integer,
        "CodecLevel": "AUTO"|"LOW"|"MAIN"|"HIGH1440"|"HIGH",
        "CodecProfile": "MAIN"|"PROFILE_422",
        "FramerateControl": "INITIALIZE_FROM_SOURCE"|"SPECIFIED",
        "FramerateConversionAlgorithm": "DUPLICATE_DROP"|"INTERPOLATE",
        "FramerateDenominator": integer,
        "FramerateNumerator": integer,
        "GopClosedCadence": integer,
        "GopSize": double,
        "GopSizeUnits": "FRAMES"|"SECONDS",
        "HrdBufferInitialFillPercentage": integer,
        "HrdBufferSize": integer,
        "InterlaceMode": "PROGRESSIVE"|"TOP_FIELD"|"BOTTOM_FIELD"|"FOLLOW_TOP_FIELD"|"FOLLOW_BOTTOM_FIELD",
        "IntraDcPrecision": "AUTO"|"INTRA_DC_PRECISION_8"|"INTRA_DC_PRECISION_9"|"INTRA_DC_PRECISION_10"|"INTRA_DC_PRECISION_11",
        "MaxBitrate": integer,
        "MinIInterval": integer,
        "NumberBFramesBetweenReferenceFrames": integer,
        "ParControl": "INITIALIZE_FROM_SOURCE"|"SPECIFIED",
        "ParDenominator": integer,
        "ParNumerator": integer,
        "QualityTuningLevel": "SINGLE_PASS"|"MULTI_PASS",
        "RateControlMode": "VBR"|"CBR",
        "SceneChangeDetect": "DISABLED"|"ENABLED",
        "SlowPal": "DISABLED"|"ENABLED",
        "Softness": integer,
        "SpatialAdaptiveQuantization": "DISABLED"|"ENABLED",
        "Syntax": "DEFAULT"|"D_10",
        "Telecine": "NONE"|"SOFT"|"HARD",
        "TemporalAdaptiveQuantization": "DISABLED"|"ENABLED"
      },
      "ProresSettings": {
        "CodecProfile": "APPLE_PRORES_422"|"APPLE_PRORES_422_HQ"|"APPLE_PRORES_422_LT"|"APPLE_PRORES_422_PROXY",
        "FramerateControl": "INITIALIZE_FROM_SOURCE"|"SPECIFIED",
        "FramerateConversionAlgorithm": "DUPLICATE_DROP"|"INTERPOLATE",
        "FramerateDenominator": integer,
        "FramerateNumerator": integer,
        "InterlaceMode": "PROGRESSIVE"|"TOP_FIELD"|"BOTTOM_FIELD"|"FOLLOW_TOP_FIELD"|"FOLLOW_BOTTOM_FIELD",
        "ParControl": "INITIALIZE_FROM_SOURCE"|"SPECIFIED",
        "ParDenominator": integer,
        "ParNumerator": integer,
        "SlowPal": "DISABLED"|"ENABLED",
        "Telecine": "NONE"|"HARD"
      }
    },
    "ColorMetadata": "IGNORE"|"INSERT",
    "Crop": {
      "Height": integer,
      "Width": integer,
      "X": integer,
      "Y": integer
    },
    "DropFrameTimecode": "DISABLED"|"ENABLED",
    "FixedAfd": integer,
    "Height": integer,
    "Position": {
      "Height": integer,
      "Width": integer,
      "X": integer,
      "Y": integer
    },
    "RespondToAfd": "NONE"|"RESPOND"|"PASSTHROUGH",
    "ScalingBehavior": "DEFAULT"|"STRETCH_TO_OUTPUT",
    "Sharpness": integer,
    "TimecodeInsertion": "DISABLED"|"PIC_TIMING_SEI",
    "VideoPreprocessors": {
      "ColorCorrector": {
        "Brightness": integer,
        "ColorSpaceConversion": "NONE"|"FORCE_601"|"FORCE_709"|"FORCE_HDR10"|"FORCE_HLG_2020",
        "Contrast": integer,
        "Hdr10Metadata": {
          "BluePrimaryX": integer,
          "BluePrimaryY": integer,
          "GreenPrimaryX": integer,
          "GreenPrimaryY": integer,
          "MaxContentLightLevel": integer,
          "MaxFrameAverageLightLevel": integer,
          "MaxLuminance": integer,
          "MinLuminance": integer,
          "RedPrimaryX": integer,
          "RedPrimaryY": integer,
          "WhitePointX": integer,
          "WhitePointY": integer
        },
        "Hue": integer,
        "Saturation": integer
      },
      "Deinterlacer": {
        "Algorithm": "INTERPOLATE"|"INTERPOLATE_TICKER"|"BLEND"|"BLEND_TICKER",
        "Control": "FORCE_ALL_FRAMES"|"NORMAL",
        "Mode": "DEINTERLACE"|"INVERSE_TELECINE"|"ADAPTIVE"
      },
      "ImageInserter": {
        "InsertableImages": [
          {
            "Duration": integer,
            "FadeIn": integer,
            "FadeOut": integer,
            "Height": integer,
            "ImageInserterInput": "string",
            "ImageX": integer,
            "ImageY": integer,
            "Layer": integer,
            "Opacity": integer,
            "StartTime": "string",
            "Width": integer
          }
          ...
        ]
      },
      "NoiseReducer": {
        "Filter": "BILATERAL"|"MEAN"|"GAUSSIAN"|"LANCZOS"|"SHARPEN"|"CONSERVE"|"SPATIAL",
        "FilterSettings": {
          "Strength": integer
        },
        "SpatialFilterSettings": {
          "PostFilterSharpenStrength": integer,
          "Speed": integer,
          "Strength": integer
        }
      },
      "TimecodeBurnin": {
        "FontSize": integer,
        "Position": "TOP_CENTER"|"TOP_LEFT"|"TOP_RIGHT"|"MIDDLE_LEFT"|"MIDDLE_CENTER"|"MIDDLE_RIGHT"|"BOTTOM_LEFT"|"BOTTOM_CENTER"|"BOTTOM_RIGHT",
        "Prefix": "string"
      }
    },
    "Width": integer
  }
}

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

Preset -> (structure)

A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process.

Arn -> (string)

An identifier for this resource that is unique within all of AWS.

Category -> (string)

An optional category you create to organize your presets.

CreatedAt -> (timestamp)

The timestamp in epoch seconds for preset creation.

Description -> (string)

An optional description you create for each preset.

LastUpdated -> (timestamp)

The timestamp in epoch seconds when the preset was last updated.

Name -> (string)

A name you create for each preset. Each name must be unique within your account.

Settings -> (structure)

Settings for preset

AudioDescriptions -> (list)

(AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.

(structure)

Description of audio output

AudioNormalizationSettings -> (structure)

Advanced audio normalization settings.

Algorithm -> (string)

Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification.

AlgorithmControl -> (string)

When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.

CorrectionGateLevel -> (integer)

Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.

LoudnessLogging -> (string)

If set to LOG, log each output's audio track loudness to a CSV file.

PeakCalculation -> (string)

If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness.

TargetLkfs -> (double)

Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.

AudioSourceName -> (string)

Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.

AudioType -> (integer)

Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.

AudioTypeControl -> (string)

When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD.

CodecSettings -> (structure)

Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3Settings

AacSettings -> (structure)

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC.

AudioDescriptionBroadcasterMix -> (string)

Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType.

Bitrate -> (integer)

Average bitrate in bits/second. Valid values depend on rate control mode and profile.

CodecProfile -> (string)

AAC Profile.

CodingMode -> (string)

Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E.

RateControlMode -> (string)

Rate Control Mode.

RawFormat -> (string)

Enables LATM/LOAS AAC output. Note that if you use LATM/LOAS AAC in an output, you must choose "No container" for the output container.

SampleRate -> (integer)

Sample rate in Hz. Valid values depend on rate control mode and profile.

Specification -> (string)

Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers.

VbrQuality -> (string)

VBR Quality Level - Only used if rate_control_mode is VBR.

Ac3Settings -> (structure)

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.

Bitrate -> (integer)

Average bitrate in bits/second. Valid bitrates depend on the coding mode.

BitstreamMode -> (string)

Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values.

CodingMode -> (string)

Dolby Digital coding mode. Determines number of channels.

Dialnorm -> (integer)

Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.

DynamicRangeCompressionProfile -> (string)

If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification.

LfeFilter -> (string)

Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode.

MetadataControl -> (string)

When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used.

SampleRate -> (integer)

Sample rate in hz. Sample rate is always 48000.

AiffSettings -> (structure)

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.

BitDepth -> (integer)

Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.

Channels -> (integer)

Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.

SampleRate -> (integer)

Sample rate in hz.

Codec -> (string)

Type of Audio codec.

Eac3Settings -> (structure)

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.

AttenuationControl -> (string)

If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode.

Bitrate -> (integer)

Average bitrate in bits/second. Valid bitrates depend on the coding mode.

BitstreamMode -> (string)

Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values.

CodingMode -> (string)

Dolby Digital Plus coding mode. Determines number of channels.

DcFilter -> (string)

Activates a DC highpass filter for all input channels.

Dialnorm -> (integer)

Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.

DynamicRangeCompressionLine -> (string)

Enables Dynamic Range Compression that restricts the absolute peak level for a signal.

DynamicRangeCompressionRf -> (string)

Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels.

LfeControl -> (string)

When encoding 3/2 audio, controls whether the LFE channel is enabled

LfeFilter -> (string)

Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode.

LoRoCenterMixLevel -> (double)

Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60

LoRoSurroundMixLevel -> (double)

Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60

LtRtCenterMixLevel -> (double)

Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60

LtRtSurroundMixLevel -> (double)

Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60

MetadataControl -> (string)

When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used.

PassthroughControl -> (string)

When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding.

PhaseControl -> (string)

Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode.

SampleRate -> (integer)

Sample rate in hz. Sample rate is always 48000.

StereoDownmix -> (string)

Stereo downmix preference. Only used for 3/2 coding mode.

SurroundExMode -> (string)

When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels.

SurroundMode -> (string)

When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels.

Mp2Settings -> (structure)

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.

Bitrate -> (integer)

Average bitrate in bits/second.

Channels -> (integer)

Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.

SampleRate -> (integer)

Sample rate in hz.

WavSettings -> (structure)

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.

BitDepth -> (integer)

Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.

Channels -> (integer)

Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.

SampleRate -> (integer)

Sample rate in Hz.

LanguageCode -> (string)

Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.

LanguageCodeControl -> (string)

Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input.

RemixSettings -> (structure)

Advanced audio remixing settings.

ChannelMapping -> (structure)

Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).

OutputChannels -> (list)

List of output channels

(structure)

OutputChannel mapping settings.

InputChannels -> (list)

List of input channels

(integer)

ChannelsIn -> (integer)

Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.

ChannelsOut -> (integer)

Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8

StreamName -> (string)

Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.

CaptionDescriptions -> (list)

Caption settings for this preset. There can be multiple caption settings in a single output.

(structure)

Caption Description for preset

DestinationSettings -> (structure)

Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.

BurninDestinationSettings -> (structure)

Burn-In Destination Settings.

Alignment -> (string)

If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

BackgroundColor -> (string)

Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match.

BackgroundOpacity -> (integer)

Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.

FontColor -> (string)

Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

FontOpacity -> (integer)

Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.

FontResolution -> (integer)

Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.

FontSize -> (integer)

A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.

OutlineColor -> (string)

Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

OutlineSize -> (integer)

Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

ShadowColor -> (string)

Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match.

ShadowOpacity -> (integer)

Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.

ShadowXOffset -> (integer)

Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.

ShadowYOffset -> (integer)

Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.

TeletextSpacing -> (string)

Controls whether a fixed grid size or proportional font spacing will be used to generate the output subtitles bitmap. Only applicable for Teletext inputs and DVB-Sub/Burn-in outputs.

XPosition -> (integer)

Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

YPosition -> (integer)

Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

DestinationType -> (string)

Type of Caption output, including Burn-In, Embedded, SCC, SRT, TTML, WebVTT, DVB-Sub, Teletext.

DvbSubDestinationSettings -> (structure)

DVB-Sub Destination Settings

Alignment -> (string)

If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

BackgroundColor -> (string)

Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match.

BackgroundOpacity -> (integer)

Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.

FontColor -> (string)

Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

FontOpacity -> (integer)

Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.

FontResolution -> (integer)

Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.

FontSize -> (integer)

A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.

OutlineColor -> (string)

Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

OutlineSize -> (integer)

Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

ShadowColor -> (string)

Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match.

ShadowOpacity -> (integer)

Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.

ShadowXOffset -> (integer)

Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.

ShadowYOffset -> (integer)

Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.

TeletextSpacing -> (string)

Controls whether a fixed grid size or proportional font spacing will be used to generate the output subtitles bitmap. Only applicable for Teletext inputs and DVB-Sub/Burn-in outputs.

XPosition -> (integer)

Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

YPosition -> (integer)

Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.

SccDestinationSettings -> (structure)

Settings for SCC caption output.

Framerate -> (string)

Set Framerate (SccDestinationFramerate) to make sure that the captions and the video are synchronized in the output. Specify a framerate that matches the framerate of the associated video. If the video framerate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME).

TeletextDestinationSettings -> (structure)

Settings for Teletext caption output

PageNumber -> (string)

Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.

TtmlDestinationSettings -> (structure)

Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).

StylePassthrough -> (string)

Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output.

LanguageCode -> (string)

Indicates the language of the caption output track.

LanguageDescription -> (string)

Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.

ContainerSettings -> (structure)

Container specific settings.

Container -> (string)

Container for this output. Some containers require a container settings object. If not specified, the default object will be created.

F4vSettings -> (structure)

Settings for F4v container

MoovPlacement -> (string)

If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end.

M2tsSettings -> (structure)

Settings for M2TS Container.

AudioBufferModel -> (string)

Selects between the DVB and ATSC buffer models for Dolby Digital audio.

AudioFramesPerPes -> (integer)

The number of audio frames to insert for each PES packet.

AudioPids -> (list)

Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.

(integer)

Bitrate -> (integer)

The output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.

BufferModel -> (string)

Controls what buffer model to use for accurate interleaving. If set to MULTIPLEX, use multiplex buffer model. If set to NONE, this can lead to lower latency, but low-memory devices may not be able to play back the stream without interruptions.

DvbNitSettings -> (structure)

Inserts DVB Network Information Table (NIT) at the specified table repetition interval.

NetworkId -> (integer)

The numeric value placed in the Network Information Table (NIT).

NetworkName -> (string)

The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.

NitInterval -> (integer)

The number of milliseconds between instances of this table in the output transport stream.

DvbSdtSettings -> (structure)

Inserts DVB Service Description Table (NIT) at the specified table repetition interval.

OutputSdt -> (string)

Selects method of inserting SDT information into output stream. "Follow input SDT" copies SDT information from input stream to output stream. "Follow input SDT if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information.

SdtInterval -> (integer)

The number of milliseconds between instances of this table in the output transport stream.

ServiceName -> (string)

The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.

ServiceProviderName -> (string)

The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.

DvbSubPids -> (list)

Packet Identifier (PID) for input source DVB Subtitle data to this output. Multiple values are accepted, and can be entered in ranges and/or by comma separation.

(integer)

DvbTdtSettings -> (structure)

Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.

TdtInterval -> (integer)

The number of milliseconds between instances of this table in the output transport stream.

DvbTeletextPid -> (integer)

Packet Identifier (PID) for input source DVB Teletext data to this output.

EbpAudioInterval -> (string)

When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY).

EbpPlacement -> (string)

Selects which PIDs to place EBP markers on. They can either be placed only on the video PID, or on both the video PID and all audio PIDs. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY).

EsRateInPes -> (string)

Controls whether to include the ES Rate field in the PES header.

FragmentTime -> (double)

The length in seconds of each fragment. Only used with EBP markers.

MaxPcrInterval -> (integer)

Maximum time in milliseconds between Program Clock References (PCRs) inserted into the transport stream.

MinEbpInterval -> (integer)

When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.

NielsenId3 -> (string)

If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.

NullPacketBitrate -> (double)

Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.

PatInterval -> (integer)

The number of milliseconds between instances of this table in the output transport stream.

PcrControl -> (string)

When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream.

PcrPid -> (integer)

Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.

PmtInterval -> (integer)

The number of milliseconds between instances of this table in the output transport stream.

PmtPid -> (integer)

Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.

PrivateMetadataPid -> (integer)

Packet Identifier (PID) of the private metadata stream in the transport stream.

ProgramNumber -> (integer)

The value of the program number field in the Program Map Table.

RateMode -> (string)

When set to CBR, inserts null packets into transport stream to fill specified bitrate. When set to VBR, the bitrate setting acts as the maximum bitrate, but the output will not be padded up to that bitrate.

Scte35Pid -> (integer)

Packet Identifier (PID) of the SCTE-35 stream in the transport stream.

Scte35Source -> (string)

Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output.

SegmentationMarkers -> (string)

Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format.

SegmentationStyle -> (string)

The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule.

SegmentationTime -> (double)

The length in seconds of each segment. Required unless markers is set to _none_.

TimedMetadataPid -> (integer)

Packet Identifier (PID) of the timed metadata stream in the transport stream.

TransportStreamId -> (integer)

The value of the transport stream ID field in the Program Map Table.

VideoPid -> (integer)

Packet Identifier (PID) of the elementary video stream in the transport stream.

M3u8Settings -> (structure)

Settings for TS segments in HLS

AudioFramesPerPes -> (integer)

The number of audio frames to insert for each PES packet.

AudioPids -> (list)

Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.

(integer)

NielsenId3 -> (string)

If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.

PatInterval -> (integer)

The number of milliseconds between instances of this table in the output transport stream.

PcrControl -> (string)

When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream.

PcrPid -> (integer)

Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.

PmtInterval -> (integer)

The number of milliseconds between instances of this table in the output transport stream.

PmtPid -> (integer)

Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.

PrivateMetadataPid -> (integer)

Packet Identifier (PID) of the private metadata stream in the transport stream.

ProgramNumber -> (integer)

The value of the program number field in the Program Map Table.

Scte35Pid -> (integer)

Packet Identifier (PID) of the SCTE-35 stream in the transport stream.

Scte35Source -> (string)

Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output.

TimedMetadata -> (string)

If PASSTHROUGH, inserts ID3 timed metadata from the timed_metadata REST command into this output.

TimedMetadataPid -> (integer)

Packet Identifier (PID) of the timed metadata stream in the transport stream.

TransportStreamId -> (integer)

The value of the transport stream ID field in the Program Map Table.

VideoPid -> (integer)

Packet Identifier (PID) of the elementary video stream in the transport stream.

MovSettings -> (structure)

Settings for MOV Container.

ClapAtom -> (string)

When enabled, include 'clap' atom if appropriate for the video output settings.

CslgAtom -> (string)

When enabled, file composition times will start at zero, composition times in the 'ctts' (composition time to sample) box for B-frames will be negative, and a 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools.

Mpeg2FourCCControl -> (string)

When set to XDCAM, writes MPEG2 video streams into the QuickTime file using XDCAM fourcc codes. This increases compatibility with Apple editors and players, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2.

PaddingControl -> (string)

If set to OMNEON, inserts Omneon-compatible padding

Reference -> (string)

A value of 'external' creates separate media files and the wrapper file (.mov) contains references to these media files. A value of 'self_contained' creates only a wrapper (.mov) file and this file contains all of the media.

Mp4Settings -> (structure)

Settings for MP4 Container

CslgAtom -> (string)

When enabled, file composition times will start at zero, composition times in the 'ctts' (composition time to sample) box for B-frames will be negative, and a 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools.

FreeSpaceBox -> (string)

Inserts a free-space box immediately after the moov box.

MoovPlacement -> (string)

If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end.

Mp4MajorBrand -> (string)

Overrides the "Major Brand" field in the output file. Usually not necessary to specify.

VideoDescription -> (structure)

(VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.

AfdSignaling -> (string)

This setting only applies to H.264 and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to whether there are AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.

AntiAlias -> (string)

Enable Anti-alias (AntiAlias) to enhance sharp edges in video output when your input resolution is much larger than your output resolution. Default is enabled.

CodecSettings -> (structure)

Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettings

Codec -> (string)

Type of video codec

FrameCaptureSettings -> (structure)

Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.

FramerateDenominator -> (integer)

Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.

FramerateNumerator -> (integer)

Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.

MaxCaptures -> (integer)

Maximum number of captures (encoded jpg output files).

Quality -> (integer)

JPEG Quality - a higher value equals higher quality.

H264Settings -> (structure)

Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.

AdaptiveQuantization -> (string)

Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.

Bitrate -> (integer)

Average bitrate in bits/second. Required for VBR, CBR, and ABR. Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.

CodecLevel -> (string)

H.264 Level.

CodecProfile -> (string)

H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License.

EntropyEncoding -> (string)

Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC.

FieldEncoding -> (string)

Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs.

FlickerAdaptiveQuantization -> (string)

Adjust quantization within each frame to reduce flicker or 'pop' on I-frames.

FramerateControl -> (string)

Using the API, set FramerateControl to INITIALIZE_FROM_SOURCE if you want the service to use the framerate from the input. Using the console, do this by choosing INITIALIZE_FROM_SOURCE for Framerate.

FramerateConversionAlgorithm -> (string)

When set to INTERPOLATE, produces smoother motion during framerate conversion.

FramerateDenominator -> (integer)

When you use the API for transcode jobs that use framerate conversion, specify the framerate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use framerate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

FramerateNumerator -> (integer)

Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps.

GopBReference -> (string)

If enable, use reference B frames for GOP structures that have B frames > 1.

GopClosedCadence -> (integer)

Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.

GopSize -> (double)

GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.

GopSizeUnits -> (string)

Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time.

HrdBufferInitialFillPercentage -> (integer)

Percentage of the buffer that should initially be filled (HRD buffer model).

HrdBufferSize -> (integer)

Size of buffer (HRD buffer model). Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m.

InterlaceMode -> (string)

Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOw_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose.

MaxBitrate -> (integer)

Maximum bitrate in bits/second (for VBR mode only). Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m.

MinIInterval -> (integer)

Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1

NumberBFramesBetweenReferenceFrames -> (integer)

Number of B-frames between reference frames.

NumberReferenceFrames -> (integer)

Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.

ParControl -> (string)

Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio.

ParDenominator -> (integer)

Pixel Aspect Ratio denominator.

ParNumerator -> (integer)

Pixel Aspect Ratio numerator.

QualityTuningLevel -> (string)

Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding.

RateControlMode -> (string)

Rate control mode. CQ uses constant quantizer (qp), ABR (average bitrate) does not write HRD parameters.

RepeatPps -> (string)

Places a PPS header on each encoded picture, even if repeated.

SceneChangeDetect -> (string)

Scene change detection (inserts I-frames on scene changes).

Slices -> (integer)

Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.

SlowPal -> (string)

Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.

Softness -> (integer)

Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.

SpatialAdaptiveQuantization -> (string)

Adjust quantization within each frame based on spatial variation of content complexity.

Syntax -> (string)

Produces a bitstream compliant with SMPTE RP-2027.

Telecine -> (string)

This field applies only if the Streams > Advanced > Framerate (framerate) field is set to 29.970. This field works with the Streams > Advanced > Preprocessors > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i.

TemporalAdaptiveQuantization -> (string)

Adjust quantization within each frame based on temporal variation of content complexity.

UnregisteredSeiTimecode -> (string)

Inserts timecode for each frame as 4 bytes of an unregistered SEI message.

H265Settings -> (structure)

Settings for H265 codec

AdaptiveQuantization -> (string)

Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.

AlternateTransferFunctionSei -> (string)

Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF).

Bitrate -> (integer)

Average bitrate in bits/second. Required for VBR, CBR, and ABR. Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.

CodecLevel -> (string)

H.265 Level.

CodecProfile -> (string)

Represents the Profile and Tier, per the HEVC (H.265) specification. Selections are grouped as [Profile] / [Tier], so "Main/High" represents Main Profile with High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License.

FlickerAdaptiveQuantization -> (string)

Adjust quantization within each frame to reduce flicker or 'pop' on I-frames.

FramerateControl -> (string)

Using the API, set FramerateControl to INITIALIZE_FROM_SOURCE if you want the service to use the framerate from the input. Using the console, do this by choosing INITIALIZE_FROM_SOURCE for Framerate.

FramerateConversionAlgorithm -> (string)

When set to INTERPOLATE, produces smoother motion during framerate conversion.

FramerateDenominator -> (integer)

Framerate denominator.

FramerateNumerator -> (integer)

Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps.

GopBReference -> (string)

If enable, use reference B frames for GOP structures that have B frames > 1.

GopClosedCadence -> (integer)

Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.

GopSize -> (double)

GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.

GopSizeUnits -> (string)

Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time.

HrdBufferInitialFillPercentage -> (integer)

Percentage of the buffer that should initially be filled (HRD buffer model).

HrdBufferSize -> (integer)

Size of buffer (HRD buffer model). Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m.

InterlaceMode -> (string)

Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOw_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose.

MaxBitrate -> (integer)

Maximum bitrate in bits/second (for VBR mode only). Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m.

MinIInterval -> (integer)

Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1

NumberBFramesBetweenReferenceFrames -> (integer)

Number of B-frames between reference frames.

NumberReferenceFrames -> (integer)

Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.

ParControl -> (string)

Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio.

ParDenominator -> (integer)

Pixel Aspect Ratio denominator.

ParNumerator -> (integer)

Pixel Aspect Ratio numerator.

QualityTuningLevel -> (string)

Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding.

RateControlMode -> (string)

Rate control mode. CQ uses constant quantizer (qp), ABR (average bitrate) does not write HRD parameters.

SampleAdaptiveOffsetFilterMode -> (string)

Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content

SceneChangeDetect -> (string)

Scene change detection (inserts I-frames on scene changes).

Slices -> (integer)

Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.

SlowPal -> (string)

Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.

SpatialAdaptiveQuantization -> (string)

Adjust quantization within each frame based on spatial variation of content complexity.

Telecine -> (string)

This field applies only if the Streams > Advanced > Framerate (framerate) field is set to 29.970. This field works with the Streams > Advanced > Preprocessors > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i.

TemporalAdaptiveQuantization -> (string)

Adjust quantization within each frame based on temporal variation of content complexity.

TemporalIds -> (string)

Enables temporal layer identifiers in the encoded bitstream. Up to 3 layers are supported depending on GOP structure: I- and P-frames form one layer, reference B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output.

Tiles -> (string)

Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures.

UnregisteredSeiTimecode -> (string)

Inserts timecode for each frame as 4 bytes of an unregistered SEI message.

Mpeg2Settings -> (structure)

Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.

AdaptiveQuantization -> (string)

Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.

Bitrate -> (integer)

Average bitrate in bits/second. Required for VBR, CBR, and ABR. Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.

CodecLevel -> (string)

Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output.

CodecProfile -> (string)

Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output.

FramerateControl -> (string)

Using the API, set FramerateControl to INITIALIZE_FROM_SOURCE if you want the service to use the framerate from the input. Using the console, do this by choosing INITIALIZE_FROM_SOURCE for Framerate.

FramerateConversionAlgorithm -> (string)

When set to INTERPOLATE, produces smoother motion during framerate conversion.

FramerateDenominator -> (integer)

Framerate denominator.

FramerateNumerator -> (integer)

Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps.

GopClosedCadence -> (integer)

Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.

GopSize -> (double)

GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.

GopSizeUnits -> (string)

Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time.

HrdBufferInitialFillPercentage -> (integer)

Percentage of the buffer that should initially be filled (HRD buffer model).

HrdBufferSize -> (integer)

Size of buffer (HRD buffer model). Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m.

InterlaceMode -> (string)

Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOw_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose.

IntraDcPrecision -> (string)

Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio.

MaxBitrate -> (integer)

Maximum bitrate in bits/second (for VBR mode only). Five megabits can be entered as 5000000 or 5m. Five hundred kilobits can be entered as 500000 or 0.5m.

MinIInterval -> (integer)

Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1

NumberBFramesBetweenReferenceFrames -> (integer)

Number of B-frames between reference frames.

ParControl -> (string)

Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio.

ParDenominator -> (integer)

Pixel Aspect Ratio denominator.

ParNumerator -> (integer)

Pixel Aspect Ratio numerator.

QualityTuningLevel -> (string)

Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding.

RateControlMode -> (string)

Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr).

SceneChangeDetect -> (string)

Scene change detection (inserts I-frames on scene changes).

SlowPal -> (string)

Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.

Softness -> (integer)

Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.

SpatialAdaptiveQuantization -> (string)

Adjust quantization within each frame based on spatial variation of content complexity.

Syntax -> (string)

Produces a Type D-10 compatible bitstream (SMPTE 356M-2001).

Telecine -> (string)

Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player.

TemporalAdaptiveQuantization -> (string)

Adjust quantization within each frame based on temporal variation of content complexity.

ProresSettings -> (structure)

Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.

CodecProfile -> (string)

Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output.

FramerateControl -> (string)

Using the API, set FramerateControl to INITIALIZE_FROM_SOURCE if you want the service to use the framerate from the input. Using the console, do this by choosing INITIALIZE_FROM_SOURCE for Framerate.

FramerateConversionAlgorithm -> (string)

When set to INTERPOLATE, produces smoother motion during framerate conversion.

FramerateDenominator -> (integer)

Framerate denominator.

FramerateNumerator -> (integer)

When you use the API for transcode jobs that use framerate conversion, specify the framerate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.

InterlaceMode -> (string)

Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOw_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose.

ParControl -> (string)

Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator).

ParDenominator -> (integer)

Pixel Aspect Ratio denominator.

ParNumerator -> (integer)

Pixel Aspect Ratio numerator.

SlowPal -> (string)

Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.

Telecine -> (string)

Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player.

ColorMetadata -> (string)

Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default.

Crop -> (structure)

Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. Do not use this setting if you have enabled Stretch to output (stretchToOutput) in your output settings.

Height -> (integer)

Height of rectangle in pixels.

Width -> (integer)

Width of rectangle in pixels.

X -> (integer)

The distance, in pixels, between the rectangle and the left edge of the video frame.

Y -> (integer)

The distance, in pixels, between the rectangle and the top edge of the video frame.

DropFrameTimecode -> (string)

Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled.

FixedAfd -> (integer)

Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.

Height -> (integer)

Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.

Position -> (structure)

Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.

Height -> (integer)

Height of rectangle in pixels.

Width -> (integer)

Width of rectangle in pixels.

X -> (integer)

The distance, in pixels, between the rectangle and the left edge of the video frame.

Y -> (integer)

The distance, in pixels, between the rectangle and the top edge of the video frame.

RespondToAfd -> (string)

Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input. * Choose Respond to clip the input video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output.

ScalingBehavior -> (string)

Applies only if your input aspect ratio is different from your output aspect ratio. Enable Stretch to output (StretchToOutput) to have the service stretch your video image to fit. Leave this setting disabled to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job.

Sharpness -> (integer)

Use Sharpness (Sharpness)setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution, and if you set Anti-alias (AntiAlias) to ENABLED. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.

TimecodeInsertion -> (string)

Enable Timecode insertion to include timecode information in this output. Do this in the API by setting (VideoTimecodeInsertion) to (PIC_TIMING_SEI). To get timecodes to appear correctly in your output, also set up the timecode configuration for your job in the input settings. Only enable Timecode insertion when the input framerate is identical to output framerate. Disable this setting to remove the timecode from the output. Default is disabled.

VideoPreprocessors -> (structure)

Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.

ColorCorrector -> (structure)

Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.

Brightness -> (integer)

Brightness level.

ColorSpaceConversion -> (string)

Determines if colorspace conversion will be performed. If set to _None_, no conversion will be performed. If _Force 601_ or _Force 709_ are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary.

Contrast -> (integer)

Contrast level.

Hdr10Metadata -> (structure)

Use the HDR master display (Hdr10Metadata) settings to provide values for HDR color. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

BluePrimaryX -> (integer)

HDR Master Display Information comes from the color grader and the color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

BluePrimaryY -> (integer)

HDR Master Display Information comes from the color grader and the color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

GreenPrimaryX -> (integer)

HDR Master Display Information comes from the color grader and the color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

GreenPrimaryY -> (integer)

HDR Master Display Information comes from the color grader and the color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

MaxContentLightLevel -> (integer)

Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.

MaxFrameAverageLightLevel -> (integer)

Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.

MaxLuminance -> (integer)

Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.

MinLuminance -> (integer)

Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meter

RedPrimaryX -> (integer)

HDR Master Display Information comes from the color grader and the color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

RedPrimaryY -> (integer)

HDR Master Display Information comes from the color grader and the color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

WhitePointX -> (integer)

HDR Master Display Information comes from the color grader and the color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

WhitePointY -> (integer)

HDR Master Display Information comes from the color grader and the color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate.

Hue -> (integer)

Hue in degrees.

Saturation -> (integer)

Saturation level.

Deinterlacer -> (structure)

Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.

Algorithm -> (string)

Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame.

Control -> (string)

  • When set to NORMAL (default), the deinterlacer does not convert frames that are tagged in metadata as progressive. It will only convert those that are tagged as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video.

Mode -> (string)

Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive.

ImageInserter -> (structure)

Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.

InsertableImages -> (list)

Image to insert. Must be 32 bit windows BMP, PNG, or TGA file. Must not be larger than the output frames.

(structure)

Settings for Insertable Image

Duration -> (integer)

Use Duration (Duration) to set the time, in milliseconds, for the image to remain on the output video.

FadeIn -> (integer)

Use Fade in (FadeIut) to set the length, in milliseconds, of the inserted image fade in. If you don't specify a value for Fade in, the image will appear abruptly at the Start time.

FadeOut -> (integer)

Use Fade out (FadeOut) to set the length, in milliseconds, of the inserted image fade out. If you don't specify a value for Fade out, the image will disappear abruptly at the end of the inserted image duration.

Height -> (integer)

Specify the Height (Height) of the inserted image. Use a value that is less than or equal to the video resolution height. Leave this setting blank to use the native height of the image.

ImageInserterInput -> (string)

Use Image location (imageInserterInput) to specify the Amazon S3 location of the image to be inserted into the output. Use a 32 bit BMP, PNG, or TGA file that fits inside the video frame.

ImageX -> (integer)

Use Left (ImageX) to set the distance, in pixels, between the inserted image and the left edge of the frame. Required for BMP, PNG and TGA input.

ImageY -> (integer)

Use Top (ImageY) to set the distance, in pixels, between the inserted image and the top edge of the video frame. Required for BMP, PNG and TGA input.

Layer -> (integer)

Use Layer (Layer) to specify how overlapping inserted images appear. Images with higher values of layer appear on top of images with lower values of layer.

Opacity -> (integer)

Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.

StartTime -> (string)

Use Start time (StartTime) to specify the video timecode when the image is inserted in the output. This must be in timecode format (HH:MM:SS:FF)

Width -> (integer)

Specify the Width (Width) of the inserted image. Use a value that is less than or equal to the video resolution width. Leave this setting blank to use the native width of the image.

NoiseReducer -> (structure)

Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.

Filter -> (string)

Use Noise reducer filter (NoiseReducerFilter) to select one of the following spatial image filtering functions. To use this setting, you must also enable Noise reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters * Conserve is a min/max noise reduction filter * Spatial is frequency-domain filter based on JND principles.

FilterSettings -> (structure)

Settings for a noise reducer filter

Strength -> (integer)

Relative strength of noise reducing filter. Higher values produce stronger filtering.

SpatialFilterSettings -> (structure)

Noise reducer filter settings for spatial filter.

PostFilterSharpenStrength -> (integer)

Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.

Speed -> (integer)

The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.

Strength -> (integer)

Relative strength of noise reducing filter. Higher values produce stronger filtering.

TimecodeBurnin -> (structure)

Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.

FontSize -> (integer)

Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.

Position -> (string)

Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video.

Prefix -> (string)

Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.

Width -> (integer)

Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.

Type -> (string)

A preset can be of two types: system or custom. System or built-in preset can't be modified or deleted by the user.