openapi: 3.0.0 info: version: 2017-08-29 x-release: v4 title: AWS Elemental MediaConvert Certificates Presets API description: AWS Elemental MediaConvert x-logo: url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: mediaconvert x-aws-signingName: mediaconvert x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/mediaconvert-2017-08-29.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://mediaconvert.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The MediaConvert multi-region endpoint - url: https://mediaconvert.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The MediaConvert multi-region endpoint - url: http://mediaconvert.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The MediaConvert endpoint for China (Beijing) and China (Ningxia) - url: https://mediaconvert.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The MediaConvert endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: Presets paths: /2017-08-29/presets: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CreatePreset 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 responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/CreatePresetResponse' examples: CreatePreset201Example: summary: Default CreatePreset 201 response x-microcks-default: true value: Preset: example-value '480': description: BadRequestException content: application/json: schema: $ref: '#/components/schemas/BadRequestException' examples: CreatePreset480Example: summary: Default CreatePreset 480 response x-microcks-default: true value: {} '481': description: InternalServerErrorException content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorException' examples: CreatePreset481Example: summary: Default CreatePreset 481 response x-microcks-default: true value: {} '482': description: ForbiddenException content: application/json: schema: $ref: '#/components/schemas/ForbiddenException' examples: CreatePreset482Example: summary: Default CreatePreset 482 response x-microcks-default: true value: {} '483': description: NotFoundException content: application/json: schema: $ref: '#/components/schemas/NotFoundException' examples: CreatePreset483Example: summary: Default CreatePreset 483 response x-microcks-default: true value: {} '484': description: TooManyRequestsException content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsException' examples: CreatePreset484Example: summary: Default CreatePreset 484 response x-microcks-default: true value: {} '485': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' examples: CreatePreset485Example: summary: Default CreatePreset 485 response x-microcks-default: true value: {} parameters: [] requestBody: required: true content: application/json: schema: type: object required: - name - settings properties: category: description: Optional. A category for the preset you are creating. type: string description: description: Optional. A description of the preset you are creating. type: string name: description: The name of the preset you are creating. type: string settings: description: Settings for preset type: object properties: AudioDescriptions: allOf: - $ref: '#/components/schemas/__listOfAudioDescription' - xml: name: audioDescriptions description: (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. CaptionDescriptions: allOf: - $ref: '#/components/schemas/__listOfCaptionDescriptionPreset' - xml: name: captionDescriptions description: This object holds groups of settings related to captions for one output. For each output that has captions, include one instance of CaptionDescriptions. ContainerSettings: allOf: - $ref: '#/components/schemas/ContainerSettings' - xml: name: containerSettings description: Container specific settings. VideoDescription: allOf: - $ref: '#/components/schemas/VideoDescription' - xml: name: videoDescription description: VideoDescription contains a group of video encoding settings. The specific video settings depend on the video codec that you choose for the property codec. Include one instance of VideoDescription per output. tags: description: The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key. type: object additionalProperties: $ref: '#/components/schemas/__string' summary: Amazon MediaConvert Create Preset x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Presets get: operationId: ListPresets description: Retrieve a JSON array of up to twenty of your presets. This will return the presets themselves, not just a list of them. To retrieve the next twenty presets, use the nextToken string returned with the array. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ListPresetsResponse' examples: ListPresets200Example: summary: Default ListPresets 200 response x-microcks-default: true value: NextToken: example-value Presets: example-value '480': description: BadRequestException content: application/json: schema: $ref: '#/components/schemas/BadRequestException' examples: ListPresets480Example: summary: Default ListPresets 480 response x-microcks-default: true value: {} '481': description: InternalServerErrorException content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorException' examples: ListPresets481Example: summary: Default ListPresets 481 response x-microcks-default: true value: {} '482': description: ForbiddenException content: application/json: schema: $ref: '#/components/schemas/ForbiddenException' examples: ListPresets482Example: summary: Default ListPresets 482 response x-microcks-default: true value: {} '483': description: NotFoundException content: application/json: schema: $ref: '#/components/schemas/NotFoundException' examples: ListPresets483Example: summary: Default ListPresets 483 response x-microcks-default: true value: {} '484': description: TooManyRequestsException content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsException' examples: ListPresets484Example: summary: Default ListPresets 484 response x-microcks-default: true value: {} '485': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' examples: ListPresets485Example: summary: Default ListPresets 485 response x-microcks-default: true value: {} parameters: - name: category in: query required: false description: Optionally, specify a preset category to limit responses to only presets from that category. schema: type: string - name: listBy in: query required: false description: Optional. When you request a list of presets, you can choose to list them alphabetically by NAME or chronologically by CREATION_DATE. If you don't specify, the service will list them by name. schema: type: string enum: - NAME - CREATION_DATE - SYSTEM description: Optional. When you request a list of presets, you can choose to list them alphabetically by NAME or chronologically by CREATION_DATE. If you don't specify, the service will list them by name. - name: maxResults in: query required: false description: Optional. Number of presets, up to twenty, that will be returned at one time schema: type: integer minimum: 1 maximum: 20 - name: nextToken in: query required: false description: Use this string, provided with the response to a previous request, to request the next batch of presets. schema: type: string - name: order in: query required: false description: Optional. When you request lists of resources, you can specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource. schema: type: string enum: - ASCENDING - DESCENDING description: Optional. When you request lists of resources, you can specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource. - name: MaxResults in: query schema: type: string description: Pagination limit required: false - name: NextToken in: query schema: type: string description: Pagination token required: false summary: Amazon MediaConvert List Presets x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Presets /2017-08-29/presets/{name}: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' delete: operationId: DeletePreset description: Permanently delete a preset you have created. responses: '202': description: Success content: application/json: schema: $ref: '#/components/schemas/DeletePresetResponse' examples: DeletePreset202Example: summary: Default DeletePreset 202 response x-microcks-default: true value: {} '480': description: BadRequestException content: application/json: schema: $ref: '#/components/schemas/BadRequestException' examples: DeletePreset480Example: summary: Default DeletePreset 480 response x-microcks-default: true value: {} '481': description: InternalServerErrorException content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorException' examples: DeletePreset481Example: summary: Default DeletePreset 481 response x-microcks-default: true value: {} '482': description: ForbiddenException content: application/json: schema: $ref: '#/components/schemas/ForbiddenException' examples: DeletePreset482Example: summary: Default DeletePreset 482 response x-microcks-default: true value: {} '483': description: NotFoundException content: application/json: schema: $ref: '#/components/schemas/NotFoundException' examples: DeletePreset483Example: summary: Default DeletePreset 483 response x-microcks-default: true value: {} '484': description: TooManyRequestsException content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsException' examples: DeletePreset484Example: summary: Default DeletePreset 484 response x-microcks-default: true value: {} '485': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' examples: DeletePreset485Example: summary: Default DeletePreset 485 response x-microcks-default: true value: {} parameters: - name: name in: path required: true description: The name of the preset to be deleted. schema: type: string summary: Amazon MediaConvert Delete Preset x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Presets get: operationId: GetPreset description: Retrieve the JSON for a specific preset. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GetPresetResponse' examples: GetPreset200Example: summary: Default GetPreset 200 response x-microcks-default: true value: Preset: example-value '480': description: BadRequestException content: application/json: schema: $ref: '#/components/schemas/BadRequestException' examples: GetPreset480Example: summary: Default GetPreset 480 response x-microcks-default: true value: {} '481': description: InternalServerErrorException content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorException' examples: GetPreset481Example: summary: Default GetPreset 481 response x-microcks-default: true value: {} '482': description: ForbiddenException content: application/json: schema: $ref: '#/components/schemas/ForbiddenException' examples: GetPreset482Example: summary: Default GetPreset 482 response x-microcks-default: true value: {} '483': description: NotFoundException content: application/json: schema: $ref: '#/components/schemas/NotFoundException' examples: GetPreset483Example: summary: Default GetPreset 483 response x-microcks-default: true value: {} '484': description: TooManyRequestsException content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsException' examples: GetPreset484Example: summary: Default GetPreset 484 response x-microcks-default: true value: {} '485': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' examples: GetPreset485Example: summary: Default GetPreset 485 response x-microcks-default: true value: {} parameters: - name: name in: path required: true description: The name of the preset. schema: type: string summary: Amazon MediaConvert Get Preset x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Presets put: operationId: UpdatePreset description: Modify one of your existing presets. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/UpdatePresetResponse' examples: UpdatePreset200Example: summary: Default UpdatePreset 200 response x-microcks-default: true value: Preset: example-value '480': description: BadRequestException content: application/json: schema: $ref: '#/components/schemas/BadRequestException' examples: UpdatePreset480Example: summary: Default UpdatePreset 480 response x-microcks-default: true value: {} '481': description: InternalServerErrorException content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorException' examples: UpdatePreset481Example: summary: Default UpdatePreset 481 response x-microcks-default: true value: {} '482': description: ForbiddenException content: application/json: schema: $ref: '#/components/schemas/ForbiddenException' examples: UpdatePreset482Example: summary: Default UpdatePreset 482 response x-microcks-default: true value: {} '483': description: NotFoundException content: application/json: schema: $ref: '#/components/schemas/NotFoundException' examples: UpdatePreset483Example: summary: Default UpdatePreset 483 response x-microcks-default: true value: {} '484': description: TooManyRequestsException content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsException' examples: UpdatePreset484Example: summary: Default UpdatePreset 484 response x-microcks-default: true value: {} '485': description: ConflictException content: application/json: schema: $ref: '#/components/schemas/ConflictException' examples: UpdatePreset485Example: summary: Default UpdatePreset 485 response x-microcks-default: true value: {} parameters: - name: name in: path required: true description: The name of the preset you are modifying. schema: type: string requestBody: required: true content: application/json: schema: type: object properties: category: description: The new category for the preset, if you are changing it. type: string description: description: The new description for the preset, if you are changing it. type: string settings: description: Settings for preset type: object properties: AudioDescriptions: allOf: - $ref: '#/components/schemas/__listOfAudioDescription' - xml: name: audioDescriptions description: (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. CaptionDescriptions: allOf: - $ref: '#/components/schemas/__listOfCaptionDescriptionPreset' - xml: name: captionDescriptions description: This object holds groups of settings related to captions for one output. For each output that has captions, include one instance of CaptionDescriptions. ContainerSettings: allOf: - $ref: '#/components/schemas/ContainerSettings' - xml: name: containerSettings description: Container specific settings. VideoDescription: allOf: - $ref: '#/components/schemas/VideoDescription' - xml: name: videoDescription description: VideoDescription contains a group of video encoding settings. The specific video settings depend on the video codec that you choose for the property codec. Include one instance of VideoDescription per output. summary: Amazon MediaConvert Update Preset x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Presets components: schemas: TimedMetadata: type: string enum: - PASSTHROUGH - NONE description: 'Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH) to include ID3 metadata in this output. This includes ID3 metadata from the following features: ID3 timestamp period (timedMetadataId3Period), and Custom ID3 metadata inserter (timedMetadataInsertion). To exclude this ID3 metadata in this output: set ID3 metadata to None (NONE) or leave blank.' SccDestinationSettings: type: object properties: Framerate: allOf: - $ref: '#/components/schemas/SccDestinationFramerate' - xml: name: framerate description: Set Framerate (SccDestinationFramerate) to make sure that the captions and the video are synchronized in the output. Specify a frame rate that matches the frame rate of the associated video. If the video frame rate 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). description: Settings related to SCC captions. SCC is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/scc-srt-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to SCC. H265QvbrSettings: type: object properties: MaxAverageBitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1466400000' - xml: name: maxAverageBitrate description: Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value that you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output. QvbrQualityLevel: allOf: - $ref: '#/components/schemas/__integerMin1Max10' - xml: name: qvbrQualityLevel description: Use this setting only when you set Rate control mode (RateControlMode) to QVBR. Specify the target quality level for this output. MediaConvert determines the right number of bits to use for each part of the video to maintain the video quality that you specify. When you keep the default value, AUTO, MediaConvert picks a quality level for you, based on characteristics of your input video. If you prefer to specify a quality level, specify a number from 1 through 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9. Optionally, to specify a value between whole numbers, also provide a value for the setting qvbrQualityLevelFineTune. For example, if you want your QVBR quality level to be 7.33, set qvbrQualityLevel to 7 and set qvbrQualityLevelFineTune to .33. QvbrQualityLevelFineTune: allOf: - $ref: '#/components/schemas/__doubleMin0Max1' - xml: name: qvbrQualityLevelFineTune description: Optional. Specify a value here to set the QVBR quality to a level that is between whole numbers. For example, if you want your QVBR quality level to be 7.33, set qvbrQualityLevel to 7 and set qvbrQualityLevelFineTune to .33. MediaConvert rounds your QVBR quality level to the nearest third of a whole number. For example, if you set qvbrQualityLevel to 7 and you set qvbrQualityLevelFineTune to .25, your actual QVBR quality level is 7.33. description: Settings for quality-defined variable bitrate encoding with the H.265 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode). Mpeg2RateControlMode: type: string enum: - VBR - CBR description: Use Rate control mode (Mpeg2RateControlMode) to specify whether the bitrate is variable (vbr) or constant (cbr). DeinterlacerMode: type: string enum: - DEINTERLACE - INVERSE_TELECINE - ADAPTIVE description: 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. AudioNormalizationAlgorithm: type: string enum: - ITU_BS_1770_1 - ITU_BS_1770_2 - ITU_BS_1770_3 - ITU_BS_1770_4 description: 'Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.' XavcProfile: type: string enum: - XAVC_HD_INTRA_CBG - XAVC_4K_INTRA_CBG - XAVC_4K_INTRA_VBR - XAVC_HD - XAVC_4K description: Specify the XAVC profile for this output. For more information, see the Sony documentation at https://www.xavc-info.org/. Note that MediaConvert doesn't support the interlaced video XAVC operating points for XAVC_HD_INTRA_CBG. To create an interlaced XAVC output, choose the profile XAVC_HD. __integerMin384000Max1024000: type: integer minimum: 384000 maximum: 1024000 Vp9RateControlMode: type: string enum: - VBR description: With the VP9 codec, you can use only the variable bitrate (VBR) rate control mode. Vp9FramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. AacAudioDescriptionBroadcasterMix: type: string enum: - BROADCASTER_MIXED_AD - NORMAL description: 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. Mp3Settings: type: object properties: Bitrate: allOf: - $ref: '#/components/schemas/__integerMin16000Max320000' - xml: name: bitrate description: Specify the average bitrate in bits per second. Channels: allOf: - $ref: '#/components/schemas/__integerMin1Max2' - xml: name: channels description: Specify the number of channels in this output audio track. Choosing Mono on the console gives you 1 output channel; choosing Stereo gives you 2. In the API, valid values are 1 and 2. RateControlMode: allOf: - $ref: '#/components/schemas/Mp3RateControlMode' - xml: name: rateControlMode description: Specify whether the service encodes this MP3 audio output with a constant bitrate (CBR) or a variable bitrate (VBR). SampleRate: allOf: - $ref: '#/components/schemas/__integerMin22050Max48000' - xml: name: sampleRate description: Sample rate in hz. VbrQuality: allOf: - $ref: '#/components/schemas/__integerMin0Max9' - xml: name: vbrQuality description: Required when you set Bitrate control mode (rateControlMode) to VBR. Specify the audio quality of this MP3 output from 0 (highest quality) to 9 (lowest quality). description: Required when you set Codec, under AudioDescriptions>CodecSettings, to the value MP3. ProresTelecine: type: string enum: - NONE - HARD description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard telecine (HARD) to create a smoother picture. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. Mpeg2InterlaceMode: type: string enum: - PROGRESSIVE - TOP_FIELD - BOTTOM_FIELD - FOLLOW_TOP_FIELD - FOLLOW_BOTTOM_FIELD description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. H265SpatialAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (adaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.' Vc3SlowPal: type: string enum: - DISABLED - ENABLED description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output by relabeling the video frames and resampling your audio. Note that enabling this setting will slightly reduce the duration of your video. Related settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Vp8FramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. __integerMin0Max96: type: integer minimum: 0 maximum: 96 AudioDescription: type: object properties: AudioChannelTaggingSettings: allOf: - $ref: '#/components/schemas/AudioChannelTaggingSettings' - xml: name: audioChannelTaggingSettings description: When you mimic a multi-channel audio layout with multiple mono-channel tracks, you can tag each channel layout manually. For example, you would tag the tracks that contain your left, right, and center audio with Left (L), Right (R), and Center (C), respectively. When you don't specify a value, MediaConvert labels your track as Center (C) by default. To use audio layout tagging, your output must be in a QuickTime (.mov) container; your audio codec must be AAC, WAV, or AIFF; and you must set up your audio track to have only one channel. AudioNormalizationSettings: allOf: - $ref: '#/components/schemas/AudioNormalizationSettings' - xml: name: audioNormalizationSettings description: Advanced audio normalization settings. Ignore these settings unless you need to comply with a loudness standard. AudioSourceName: allOf: - $ref: '#/components/schemas/__string' - xml: name: audioSourceName description: 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: allOf: - $ref: '#/components/schemas/__integerMin0Max255' - xml: name: audioType description: '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: allOf: - $ref: '#/components/schemas/AudioTypeControl' - xml: name: audioTypeControl description: 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: allOf: - $ref: '#/components/schemas/AudioCodecSettings' - xml: name: codecSettings description: Settings related to audio encoding. The settings in this group vary depending on the value that you choose for your audio codec. CustomLanguageCode: allOf: - $ref: '#/components/schemas/__stringPatternAZaZ23AZaZ' - xml: name: customLanguageCode description: 'Specify the language for this audio output track. The service puts this language code into your output audio track when you set Language code control (AudioLanguageCodeControl) to Use configured (USE_CONFIGURED). The service also uses your specified custom language code when you set Language code control (AudioLanguageCodeControl) to Follow input (FOLLOW_INPUT), but your input file doesn''t specify a language code. For all outputs, you can use an ISO 639-2 or ISO 639-3 code. For streaming outputs, you can also use any other code in the full RFC-5646 specification. Streaming outputs are those that are in one of the following output groups: CMAF, DASH ISO, Apple HLS, or Microsoft Smooth Streaming.' LanguageCode: allOf: - $ref: '#/components/schemas/LanguageCode' - xml: name: languageCode description: 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: allOf: - $ref: '#/components/schemas/AudioLanguageCodeControl' - xml: name: languageCodeControl description: Specify which source for language code takes precedence for this audio track. When you choose Follow input (FOLLOW_INPUT), the service uses the language code from the input track if it's present. If there's no languge code on the input track, the service uses the code that you specify in the setting Language code (languageCode or customLanguageCode). When you choose Use configured (USE_CONFIGURED), the service uses the language code that you specify. RemixSettings: allOf: - $ref: '#/components/schemas/RemixSettings' - xml: name: remixSettings description: Advanced audio remixing settings. StreamName: allOf: - $ref: '#/components/schemas/__stringPatternWS' - xml: name: streamName description: Specify a label for this output audio stream. For example, "English", "Director commentary", or "track_2". For streaming outputs, MediaConvert passes this information into destination manifests for display on the end-viewer's player device. For outputs in other output groups, the service ignores this setting. description: Settings related to one audio tab on the MediaConvert console. In your job JSON, an instance of AudioDescription is equivalent to one audio tab in the console. Usually, one audio tab corresponds to one output audio track. Depending on how you set up your input audio selectors and whether you use audio selector groups, one audio tab can correspond to a group of output audio tracks. __integerMin0Max50000: type: integer minimum: 0 maximum: 50000 AacSettings: type: object properties: AudioDescriptionBroadcasterMix: allOf: - $ref: '#/components/schemas/AacAudioDescriptionBroadcasterMix' - xml: name: audioDescriptionBroadcasterMix description: 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: allOf: - $ref: '#/components/schemas/__integerMin6000Max1024000' - xml: name: bitrate description: 'Specify the average bitrate in bits per second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values that you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.' CodecProfile: allOf: - $ref: '#/components/schemas/AacCodecProfile' - xml: name: codecProfile description: AAC Profile. CodingMode: allOf: - $ref: '#/components/schemas/AacCodingMode' - xml: name: codingMode description: 'The Coding mode that you specify determines the number of audio channels and the audio channel layout metadata in your AAC output. Valid coding modes depend on the Rate control mode and Profile that you select. The following list shows the number of audio channels and channel layout for each coding mode. * 1.0 Audio Description (Receiver Mix): One channel, C. Includes audio description data from your stereo input. For more information see ETSI TS 101 154 Annex E. * 1.0 Mono: One channel, C. * 2.0 Stereo: Two channels, L, R. * 5.1 Surround: Five channels, C, L, R, Ls, Rs, LFE.' RateControlMode: allOf: - $ref: '#/components/schemas/AacRateControlMode' - xml: name: rateControlMode description: Rate Control Mode. RawFormat: allOf: - $ref: '#/components/schemas/AacRawFormat' - xml: name: rawFormat description: 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: allOf: - $ref: '#/components/schemas/__integerMin8000Max96000' - xml: name: sampleRate description: 'Specify the Sample rate in Hz. Valid sample rates depend on the Profile and Coding mode that you select. The following list shows valid sample rates for each Profile and Coding mode. * LC Profile, Coding mode 1.0, 2.0, and Receiver Mix: 8000, 12000, 16000, 22050, 24000, 32000, 44100, 48000, 88200, 96000. * LC Profile, Coding mode 5.1: 32000, 44100, 48000, 96000. * HEV1 Profile, Coding mode 1.0 and Receiver Mix: 22050, 24000, 32000, 44100, 48000. * HEV1 Profile, Coding mode 2.0 and 5.1: 32000, 44100, 48000, 96000. * HEV2 Profile, Coding mode 2.0: 22050, 24000, 32000, 44100, 48000.' Specification: allOf: - $ref: '#/components/schemas/AacSpecification' - xml: name: specification description: Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. VbrQuality: allOf: - $ref: '#/components/schemas/AacVbrQuality' - xml: name: vbrQuality description: VBR Quality Level - Only used if rate_control_mode is VBR. description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode. CmfcTimedMetadata: type: string enum: - PASSTHROUGH - NONE description: 'To include ID3 metadata in this output: Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH). Specify this ID3 metadata in Custom ID3 metadata inserter (timedMetadataInsertion). MediaConvert writes each instance of ID3 metadata in a separate Event Message (eMSG) box. To exclude this ID3 metadata: Set ID3 metadata to None (NONE) or leave blank.' DvbSubtitleShadowColor: type: string enum: - NONE - BLACK - WHITE - AUTO description: Specify the color of the shadow cast by the captions. Leave Shadow color (ShadowColor) blank and set Style passthrough (StylePassthrough) to enabled to use the shadow color data from your input captions, if present. Within your job settings, all of your DVB-Sub settings must be identical. CmfcTimedMetadataBoxVersion: type: string enum: - VERSION_0 - VERSION_1 description: 'Specify the event message box (eMSG) version for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax. Leave blank to use the default value Version 0. When you specify Version 1, you must also set ID3 metadata (timedMetadata) to Passthrough.' H264QvbrSettings: type: object properties: MaxAverageBitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1152000000' - xml: name: maxAverageBitrate description: Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value that you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output. QvbrQualityLevel: allOf: - $ref: '#/components/schemas/__integerMin1Max10' - xml: name: qvbrQualityLevel description: Use this setting only when you set Rate control mode (RateControlMode) to QVBR. Specify the target quality level for this output. MediaConvert determines the right number of bits to use for each part of the video to maintain the video quality that you specify. When you keep the default value, AUTO, MediaConvert picks a quality level for you, based on characteristics of your input video. If you prefer to specify a quality level, specify a number from 1 through 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9. Optionally, to specify a value between whole numbers, also provide a value for the setting qvbrQualityLevelFineTune. For example, if you want your QVBR quality level to be 7.33, set qvbrQualityLevel to 7 and set qvbrQualityLevelFineTune to .33. QvbrQualityLevelFineTune: allOf: - $ref: '#/components/schemas/__doubleMin0Max1' - xml: name: qvbrQualityLevelFineTune description: Optional. Specify a value here to set the QVBR quality to a level that is between whole numbers. For example, if you want your QVBR quality level to be 7.33, set qvbrQualityLevel to 7 and set qvbrQualityLevelFineTune to .33. MediaConvert rounds your QVBR quality level to the nearest third of a whole number. For example, if you set qvbrQualityLevel to 7 and you set qvbrQualityLevelFineTune to .25, your actual QVBR quality level is 7.33. description: Settings for quality-defined variable bitrate encoding with the H.264 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode). AvcIntraSettings: type: object properties: AvcIntraClass: allOf: - $ref: '#/components/schemas/AvcIntraClass' - xml: name: avcIntraClass description: Specify the AVC-Intra class of your output. The AVC-Intra class selection determines the output video bit rate depending on the frame rate of the output. Outputs with higher class values have higher bitrates and improved image quality. Note that for Class 4K/2K, MediaConvert supports only 4:2:2 chroma subsampling. AvcIntraUhdSettings: allOf: - $ref: '#/components/schemas/AvcIntraUhdSettings' - xml: name: avcIntraUhdSettings description: Optional when you set AVC-Intra class (avcIntraClass) to Class 4K/2K (CLASS_4K_2K). When you set AVC-Intra class to a different value, this object isn't allowed. FramerateControl: allOf: - $ref: '#/components/schemas/AvcIntraFramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/AvcIntraFramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max1001' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin24Max60000' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. InterlaceMode: allOf: - $ref: '#/components/schemas/AvcIntraInterlaceMode' - xml: name: interlaceMode description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. ScanTypeConversionMode: allOf: - $ref: '#/components/schemas/AvcIntraScanTypeConversionMode' - xml: name: scanTypeConversionMode description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' SlowPal: allOf: - $ref: '#/components/schemas/AvcIntraSlowPal' - xml: name: slowPal description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Telecine: allOf: - $ref: '#/components/schemas/AvcIntraTelecine' - xml: name: telecine description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard telecine (HARD) to create a smoother picture. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. description: Required when you choose AVC-Intra for your output video codec. For more information about the AVC-Intra settings, see the relevant specification. For detailed information about SD and HD in AVC-Intra, see https://ieeexplore.ieee.org/document/7290936. For information about 4K/2K in AVC-Intra, see https://pro-av.panasonic.net/en/avc-ultra/AVC-ULTRAoverview.pdf. __integerMinNegative1Max3: type: integer minimum: -1 maximum: 3 EmbeddedDestinationSettings: type: object properties: Destination608ChannelNumber: allOf: - $ref: '#/components/schemas/__integerMin1Max4' - xml: name: destination608ChannelNumber description: Ignore this setting unless your input captions are SCC format and your output captions are embedded in the video stream. Specify a CC number for each captions channel in this output. If you have two channels, choose CC numbers that aren't in the same field. For example, choose 1 and 3. For more information, see https://docs.aws.amazon.com/console/mediaconvert/dual-scc-to-embedded. Destination708ServiceNumber: allOf: - $ref: '#/components/schemas/__integerMin1Max6' - xml: name: destination708ServiceNumber description: Ignore this setting unless your input captions are SCC format and you want both 608 and 708 captions embedded in your output stream. Optionally, specify the 708 service number for each output captions channel. Choose a different number for each channel. To use this setting, also set Force 608 to 708 upconvert (Convert608To708) to Upconvert (UPCONVERT) in your input captions selector settings. If you choose to upconvert but don't specify a 708 service number, MediaConvert uses the number that you specify for CC channel number (destination608ChannelNumber) for the 708 service number. For more information, see https://docs.aws.amazon.com/console/mediaconvert/dual-scc-to-embedded. description: Settings related to CEA/EIA-608 and CEA/EIA-708 (also called embedded or ancillary) captions. Set up embedded captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/embedded-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to EMBEDDED, EMBEDDED_PLUS_SCTE20, or SCTE20_PLUS_EMBEDDED. ProresChromaSampling: type: string enum: - PRESERVE_444_SAMPLING - SUBSAMPLE_TO_422 description: 'This setting applies only to ProRes 4444 and ProRes 4444 XQ outputs that you create from inputs that use 4:4:4 chroma sampling. Set Preserve 4:4:4 sampling (PRESERVE_444_SAMPLING) to allow outputs to also use 4:4:4 chroma sampling. You must specify a value for this setting when your output codec profile supports 4:4:4 chroma sampling. Related Settings: When you set Chroma sampling to Preserve 4:4:4 sampling (PRESERVE_444_SAMPLING), you must choose an output codec profile that supports 4:4:4 chroma sampling. These values for Profile (CodecProfile) support 4:4:4 chroma sampling: Apple ProRes 4444 (APPLE_PRORES_4444) or Apple ProRes 4444 XQ (APPLE_PRORES_4444_XQ). When you set Chroma sampling to Preserve 4:4:4 sampling, you must disable all video preprocessors except for Nexguard file marker (PartnerWatermarking). When you set Chroma sampling to Preserve 4:4:4 sampling and use framerate conversion, you must set Frame rate conversion algorithm (FramerateConversionAlgorithm) to Drop duplicate (DUPLICATE_DROP).' __listOfAudioDescription: type: array items: $ref: '#/components/schemas/AudioDescription' M2tsAudioBufferModel: type: string enum: - DVB - ATSC description: Selects between the DVB and ATSC buffer models for Dolby Digital audio. Eac3CodingMode: type: string enum: - CODING_MODE_1_0 - CODING_MODE_2_0 - CODING_MODE_3_2 description: Dolby Digital Plus coding mode. Determines number of channels. H265ParControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. Vc3FramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. Eac3DcFilter: type: string enum: - ENABLED - DISABLED description: Activates a DC highpass filter for all input channels. NotFoundException: {} DvbSubtitleAlignment: type: string enum: - CENTERED - LEFT - AUTO description: Specify the alignment of your captions. If no explicit x_position is provided, setting alignment to centered will placethe captions at the bottom center of the output. Similarly, setting a left alignment willalign 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. Within your job settings, all of your DVB-Sub settings must be identical. M3u8PcrControl: type: string enum: - PCR_EVERY_PES_PACKET - CONFIGURED_PCR_PERIOD description: 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. Eac3AtmosDialogueIntelligence: type: string enum: - ENABLED - DISABLED description: Enable Dolby Dialogue Intelligence to adjust loudness based on dialogue analysis. CaptionDestinationSettings: type: object properties: BurninDestinationSettings: allOf: - $ref: '#/components/schemas/BurninDestinationSettings' - xml: name: burninDestinationSettings description: Burn-in is a captions delivery method, rather than a captions format. Burn-in writes the captions directly on your video frames, replacing pixels of video content with the captions. Set up burn-in captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/burn-in-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to BURN_IN. DestinationType: allOf: - $ref: '#/components/schemas/CaptionDestinationType' - xml: name: destinationType description: Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Note that your choice of video output container constrains your choice of output captions format. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/captions-support-tables.html. If you are using SCTE-20 and you want to create an output that complies with the SCTE-43 spec, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED). To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). DvbSubDestinationSettings: allOf: - $ref: '#/components/schemas/DvbSubDestinationSettings' - xml: name: dvbSubDestinationSettings description: Settings related to DVB-Sub captions. Set up DVB-Sub captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/dvb-sub-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to DVB_SUB. EmbeddedDestinationSettings: allOf: - $ref: '#/components/schemas/EmbeddedDestinationSettings' - xml: name: embeddedDestinationSettings description: Settings related to CEA/EIA-608 and CEA/EIA-708 (also called embedded or ancillary) captions. Set up embedded captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/embedded-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to EMBEDDED, EMBEDDED_PLUS_SCTE20, or SCTE20_PLUS_EMBEDDED. ImscDestinationSettings: allOf: - $ref: '#/components/schemas/ImscDestinationSettings' - xml: name: imscDestinationSettings description: Settings related to IMSC captions. IMSC is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/ttml-and-webvtt-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to IMSC. SccDestinationSettings: allOf: - $ref: '#/components/schemas/SccDestinationSettings' - xml: name: sccDestinationSettings description: Settings related to SCC captions. SCC is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/scc-srt-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to SCC. SrtDestinationSettings: allOf: - $ref: '#/components/schemas/SrtDestinationSettings' - xml: name: srtDestinationSettings description: Settings related to SRT captions. SRT is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to SRT. TeletextDestinationSettings: allOf: - $ref: '#/components/schemas/TeletextDestinationSettings' - xml: name: teletextDestinationSettings description: Settings related to teletext captions. Set up teletext captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/teletext-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to TELETEXT. TtmlDestinationSettings: allOf: - $ref: '#/components/schemas/TtmlDestinationSettings' - xml: name: ttmlDestinationSettings description: Settings related to TTML captions. TTML is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/ttml-and-webvtt-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to TTML. WebvttDestinationSettings: allOf: - $ref: '#/components/schemas/WebvttDestinationSettings' - xml: name: webvttDestinationSettings description: Settings related to WebVTT captions. WebVTT is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/ttml-and-webvtt-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to WebVTT. description: Settings related to one captions tab on the MediaConvert console. In your job JSON, an instance of captions DestinationSettings is equivalent to one captions tab in the console. Usually, one captions tab corresponds to one output captions track. Depending on your output captions format, one tab might correspond to a set of output captions tracks. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/including-captions.html. Ac3CodingMode: type: string enum: - CODING_MODE_1_0 - CODING_MODE_1_1 - CODING_MODE_2_0 - CODING_MODE_3_2_LFE description: Dolby Digital coding mode. Determines number of channels. AvcIntraUhdSettings: type: object properties: QualityTuningLevel: allOf: - $ref: '#/components/schemas/AvcIntraUhdQualityTuningLevel' - xml: name: qualityTuningLevel description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how many transcoding passes MediaConvert does with your video. When you choose Multi-pass (MULTI_PASS), your video quality is better and your output bitrate is more accurate. That is, the actual bitrate of your output is closer to the target bitrate defined in the specification. When you choose Single-pass (SINGLE_PASS), your encoding time is faster. The default behavior is Single-pass (SINGLE_PASS). description: Optional when you set AVC-Intra class (avcIntraClass) to Class 4K/2K (CLASS_4K_2K). When you set AVC-Intra class to a different value, this object isn't allowed. MovPaddingControl: type: string enum: - OMNEON - NONE description: 'Unless you need Omneon compatibility: Keep the default value, None. To make this output compatible with Omneon: Choose Omneon. When you do, MediaConvert increases the length of the ''elst'' edit list atom. Note that this might cause file rejections when a recipient of the output file doesn''t expect this extra padding.' __integerMin1Max10: type: integer minimum: 1 maximum: 10 M2tsBufferModel: type: string enum: - MULTIPLEX - NONE description: 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. __listOf__integerMin32Max8182: type: array items: $ref: '#/components/schemas/__integerMin32Max8182' LanguageCode: type: string enum: - 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 - SRP description: Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Xavc4kProfileBitrateClass: type: string enum: - BITRATE_CLASS_100 - BITRATE_CLASS_140 - BITRATE_CLASS_200 description: Specify the XAVC 4k (Long GOP) Bitrate Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. M3u8DataPtsControl: type: string enum: - AUTO - ALIGN_TO_VIDEO description: If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values). Keep the default value (AUTO) to allow all PTS values. CmfcSettings: type: object properties: AudioDuration: allOf: - $ref: '#/components/schemas/CmfcAudioDuration' - xml: name: audioDuration description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. AudioGroupId: allOf: - $ref: '#/components/schemas/__string' - xml: name: audioGroupId description: 'Specify the audio rendition group for this audio rendition. Specify up to one value for each audio output in your output group. This value appears in your HLS parent manifest in the EXT-X-MEDIA tag of TYPE=AUDIO, as the value for the GROUP-ID attribute. For example, if you specify "audio_aac_1" for Audio group ID, it appears in your manifest like this: #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio_aac_1". Related setting: To associate the rendition group that this audio track belongs to with a video rendition, include the same value that you provide here for that video output''s setting Audio rendition sets (audioRenditionSets).' AudioRenditionSets: allOf: - $ref: '#/components/schemas/__string' - xml: name: audioRenditionSets description: 'List the audio rendition groups that you want included with this video rendition. Use a comma-separated list. For example, say you want to include the audio rendition groups that have the audio group IDs "audio_aac_1" and "audio_dolby". Then you would specify this value: "audio_aac_1,audio_dolby". Related setting: The rendition groups that you include in your comma-separated list should all match values that you specify in the setting Audio group ID (AudioGroupId) for audio renditions in the same output group as this video rendition. Default behavior: If you don''t specify anything here and for Audio group ID, MediaConvert puts each audio variant in its own audio rendition group and associates it with every video variant. Each value in your list appears in your HLS parent manifest in the EXT-X-STREAM-INF tag as the value for the AUDIO attribute. To continue the previous example, say that the file name for the child manifest for your video rendition is "amazing_video_1.m3u8". Then, in your parent manifest, each value will appear on separate lines, like this: #EXT-X-STREAM-INF:AUDIO="audio_aac_1"... amazing_video_1.m3u8 #EXT-X-STREAM-INF:AUDIO="audio_dolby"... amazing_video_1.m3u8' AudioTrackType: allOf: - $ref: '#/components/schemas/CmfcAudioTrackType' - xml: name: audioTrackType description: Use this setting to control the values that MediaConvert puts in your HLS parent playlist to control how the client player selects which audio track to play. The other options for this setting determine the values that MediaConvert writes for the DEFAULT and AUTOSELECT attributes of the EXT-X-MEDIA entry for the audio variant. For more information about these attributes, see the Apple documentation article https://developer.apple.com/documentation/http_live_streaming/example_playlists_for_http_live_streaming/adding_alternate_media_to_a_playlist. Choose Alternate audio, auto select, default (ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT) to set DEFAULT=YES and AUTOSELECT=YES. Choose this value for only one variant in your output group. Choose Alternate audio, auto select, not default (ALTERNATE_AUDIO_AUTO_SELECT) to set DEFAULT=NO and AUTOSELECT=YES. Choose Alternate Audio, Not Auto Select to set DEFAULT=NO and AUTOSELECT=NO. When you don't specify a value for this setting, MediaConvert defaults to Alternate audio, auto select, default. When there is more than one variant in your output group, you must explicitly choose a value for this setting. DescriptiveVideoServiceFlag: allOf: - $ref: '#/components/schemas/CmfcDescriptiveVideoServiceFlag' - xml: name: descriptiveVideoServiceFlag description: Specify whether to flag this audio track as descriptive video service (DVS) in your HLS parent manifest. When you choose Flag (FLAG), MediaConvert includes the parameter CHARACTERISTICS="public.accessibility.describes-video" in the EXT-X-MEDIA entry for this track. When you keep the default choice, Don't flag (DONT_FLAG), MediaConvert leaves this parameter out. The DVS flag can help with accessibility on Apple devices. For more information, see the Apple documentation. IFrameOnlyManifest: allOf: - $ref: '#/components/schemas/CmfcIFrameOnlyManifest' - xml: name: iFrameOnlyManifest description: Choose Include (INCLUDE) to have MediaConvert generate an HLS child manifest that lists only the I-frames for this rendition, in addition to your regular manifest for this rendition. You might use this manifest as part of a workflow that creates preview functions for your video. MediaConvert adds both the I-frame only child manifest and the regular child manifest to the parent manifest. When you don't need the I-frame only child manifest, keep the default value Exclude (EXCLUDE). KlvMetadata: allOf: - $ref: '#/components/schemas/CmfcKlvMetadata' - xml: name: klvMetadata description: 'To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and writes each instance to a separate event message box in the output, according to MISB ST1910.1. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.' ManifestMetadataSignaling: allOf: - $ref: '#/components/schemas/CmfcManifestMetadataSignaling' - xml: name: manifestMetadataSignaling description: To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messages, the InbandEventStream element schemeIdUri will be same value that you specify for ID3 metadata scheme ID URI. For SCTE35 event messages, the InbandEventStream element schemeIdUri will be "urn:scte:scte35:2013:bin". To leave these elements out of your output MPD manifest, set Manifest metadata signaling to Disabled. To enable Manifest metadata signaling, you must also set SCTE-35 source to Passthrough, ESAM SCTE-35 to insert, or ID3 metadata (TimedMetadata) to Passthrough. Scte35Esam: allOf: - $ref: '#/components/schemas/CmfcScte35Esam' - xml: name: scte35Esam description: Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml). Scte35Source: allOf: - $ref: '#/components/schemas/CmfcScte35Source' - xml: name: scte35Source description: Ignore this setting unless you have SCTE-35 markers in your input video file. Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None (NONE) if you don't want those SCTE-35 markers in this output. TimedMetadata: allOf: - $ref: '#/components/schemas/CmfcTimedMetadata' - xml: name: timedMetadata description: 'To include ID3 metadata in this output: Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH). Specify this ID3 metadata in Custom ID3 metadata inserter (timedMetadataInsertion). MediaConvert writes each instance of ID3 metadata in a separate Event Message (eMSG) box. To exclude this ID3 metadata: Set ID3 metadata to None (NONE) or leave blank.' TimedMetadataBoxVersion: allOf: - $ref: '#/components/schemas/CmfcTimedMetadataBoxVersion' - xml: name: timedMetadataBoxVersion description: 'Specify the event message box (eMSG) version for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax. Leave blank to use the default value Version 0. When you specify Version 1, you must also set ID3 metadata (timedMetadata) to Passthrough.' TimedMetadataSchemeIdUri: allOf: - $ref: '#/components/schemas/__stringMax1000' - xml: name: timedMetadataSchemeIdUri description: 'Specify the event message box (eMSG) scheme ID URI (scheme_id_uri) for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. Leave blank to use the default value: https://aomedia.org/emsg/ID3 When you specify a value for ID3 metadata scheme ID URI, you must also set ID3 metadata (timedMetadata) to Passthrough.' TimedMetadataValue: allOf: - $ref: '#/components/schemas/__stringMax1000' - xml: name: timedMetadataValue description: Specify the event message box (eMSG) value for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. When you specify a value for ID3 Metadata Value, you must also set ID3 metadata (timedMetadata) to Passthrough. description: These settings relate to the fragmented MP4 container for the segments in your CMAF outputs. NexGuardFileMarkerSettings: type: object properties: License: allOf: - $ref: '#/components/schemas/__stringMin1Max100000' - xml: name: license description: Use the base64 license string that Nagra provides you. Enter it directly in your JSON job specification or in the console. Required when you include Nagra NexGuard File Marker watermarking (NexGuardWatermarkingSettings) in your job. Payload: allOf: - $ref: '#/components/schemas/__integerMin0Max4194303' - xml: name: payload description: Specify the payload ID that you want associated with this output. Valid values vary depending on your Nagra NexGuard forensic watermarking workflow. Required when you include Nagra NexGuard File Marker watermarking (NexGuardWatermarkingSettings) in your job. For PreRelease Content (NGPR/G2), specify an integer from 1 through 4,194,303. You must generate a unique ID for each asset you watermark, and keep a record of which ID you have assigned to each asset. Neither Nagra nor MediaConvert keep track of the relationship between output files and your IDs. For OTT Streaming, create two adaptive bitrate (ABR) stacks for each asset. Do this by setting up two output groups. For one output group, set the value of Payload ID (payload) to 0 in every output. For the other output group, set Payload ID (payload) to 1 in every output. Preset: allOf: - $ref: '#/components/schemas/__stringMin1Max256' - xml: name: preset description: Enter one of the watermarking preset strings that Nagra provides you. Required when you include Nagra NexGuard File Marker watermarking (NexGuardWatermarkingSettings) in your job. Strength: allOf: - $ref: '#/components/schemas/WatermarkingStrength' - xml: name: strength description: Optional. Ignore this setting unless Nagra support directs you to specify a value. When you don't specify a value here, the Nagra NexGuard library uses its default value. description: For forensic video watermarking, MediaConvert supports Nagra NexGuard File Marker watermarking. MediaConvert supports both PreRelease Content (NGPR/G2) and OTT Streaming workflows. Eac3BitstreamMode: type: string enum: - COMPLETE_MAIN - COMMENTARY - EMERGENCY - HEARING_IMPAIRED - VISUALLY_IMPAIRED description: Specify the bitstream mode for the E-AC-3 stream that the encoder emits. For more information about the EAC3 bitstream mode, see ATSC A/52-2012 (Annex E). __integerMin16000Max320000: type: integer minimum: 16000 maximum: 320000 Mp4MoovPlacement: type: string enum: - PROGRESSIVE_DOWNLOAD - NORMAL description: 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. Vc3ScanTypeConversionMode: type: string enum: - INTERLACED - INTERLACED_OPTIMIZE description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' VideoCodecSettings: type: object properties: Av1Settings: allOf: - $ref: '#/components/schemas/Av1Settings' - xml: name: av1Settings description: Required when you set Codec, under VideoDescription>CodecSettings to the value AV1. AvcIntraSettings: allOf: - $ref: '#/components/schemas/AvcIntraSettings' - xml: name: avcIntraSettings description: Required when you choose AVC-Intra for your output video codec. For more information about the AVC-Intra settings, see the relevant specification. For detailed information about SD and HD in AVC-Intra, see https://ieeexplore.ieee.org/document/7290936. For information about 4K/2K in AVC-Intra, see https://pro-av.panasonic.net/en/avc-ultra/AVC-ULTRAoverview.pdf. Codec: allOf: - $ref: '#/components/schemas/VideoCodec' - xml: name: codec description: Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. FrameCaptureSettings: allOf: - $ref: '#/components/schemas/FrameCaptureSettings' - xml: name: frameCaptureSettings description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE. H264Settings: allOf: - $ref: '#/components/schemas/H264Settings' - xml: name: h264Settings description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264. H265Settings: allOf: - $ref: '#/components/schemas/H265Settings' - xml: name: h265Settings description: Settings for H265 codec Mpeg2Settings: allOf: - $ref: '#/components/schemas/Mpeg2Settings' - xml: name: mpeg2Settings description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2. ProresSettings: allOf: - $ref: '#/components/schemas/ProresSettings' - xml: name: proresSettings description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES. Vc3Settings: allOf: - $ref: '#/components/schemas/Vc3Settings' - xml: name: vc3Settings description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value VC3 Vp8Settings: allOf: - $ref: '#/components/schemas/Vp8Settings' - xml: name: vp8Settings description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value VP8. Vp9Settings: allOf: - $ref: '#/components/schemas/Vp9Settings' - xml: name: vp9Settings description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value VP9. XavcSettings: allOf: - $ref: '#/components/schemas/XavcSettings' - xml: name: xavcSettings description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value XAVC. description: 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 that you choose for Video codec (Codec). For each codec enum that you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AV1, Av1Settings * AVC_INTRA, AvcIntraSettings * FRAME_CAPTURE, FrameCaptureSettings * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * VC3, Vc3Settings * VP8, Vp8Settings * VP9, Vp9Settings * XAVC, XavcSettings __stringMax1000: type: string maxLength: 1000 Ac3MetadataControl: type: string enum: - FOLLOW_INPUT - USE_CONFIGURED description: 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. InsertableImage: type: object properties: Duration: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: duration description: Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time. FadeIn: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: fadeIn description: Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time. FadeOut: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: fadeOut description: Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration. Height: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: height description: Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank. ImageInserterInput: allOf: - $ref: '#/components/schemas/__stringMin14PatternS3BmpBMPPngPNGTgaTGAHttpsBmpBMPPngPNGTgaTGA' - xml: name: imageInserterInput description: Specify the HTTP, HTTPS, or Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file. ImageX: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: imageX description: Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify. ImageY: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: imageY description: Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify. Layer: allOf: - $ref: '#/components/schemas/__integerMin0Max99' - xml: name: layer description: Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer. Opacity: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: opacity description: 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: allOf: - $ref: '#/components/schemas/__stringPattern01D20305D205D' - xml: name: startTime description: Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings. Width: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: width description: Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank. description: These settings apply to a specific graphic overlay. You can include multiple overlays in your job. ChannelMapping: type: object properties: OutputChannels: allOf: - $ref: '#/components/schemas/__listOfOutputChannelMapping' - xml: name: outputChannels description: In your JSON job specification, include one child of OutputChannels for each audio channel that you want in your output. Each child should contain one instance of InputChannels or InputChannelsFineTune. description: Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel, in dB. Specify remix values to indicate how much of the content from your input audio channel you want in your output audio channels. Each instance of the InputChannels or InputChannelsFineTune array specifies these values for one output channel. Use one instance of this array for each output channel. In the console, each array corresponds to a column in the graphical depiction of the mapping matrix. The rows of the graphical matrix correspond to input channels. Valid 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). Use InputChannels or InputChannelsFineTune to specify your remix values. Don't use both. ScalingBehavior: type: string enum: - DEFAULT - STRETCH_TO_OUTPUT description: Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio. Choose Stretch to output (STRETCH_TO_OUTPUT) to have the service stretch your video image to fit. Keep the setting Default (DEFAULT) to have the service letterbox your video instead. This setting overrides any value that you specify for the setting Selection placement (position) in this output. DvbSubtitlingType: type: string enum: - HEARING_IMPAIRED - STANDARD description: Specify whether your DVB subtitles are standard or for hearing impaired. Choose hearing impaired if your subtitles include audio descriptions and dialogue. Choose standard if your subtitles include only dialogue. InternalServerErrorException: {} Vc3Telecine: type: string enum: - NONE - HARD description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard telecine (HARD) to create a smoother picture. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. PartnerWatermarking: type: object properties: NexguardFileMarkerSettings: allOf: - $ref: '#/components/schemas/NexGuardFileMarkerSettings' - xml: name: nexguardFileMarkerSettings description: For forensic video watermarking, MediaConvert supports Nagra NexGuard File Marker watermarking. MediaConvert supports both PreRelease Content (NGPR/G2) and OTT Streaming workflows. description: If you work with a third party video watermarking partner, use the group of settings that correspond with your watermarking partner to include watermarks in your output. TtmlStylePassthrough: type: string enum: - ENABLED - DISABLED description: Pass through style and position information from a TTML-like input source (TTML, IMSC, SMPTE-TT) to the TTML output. H265ScanTypeConversionMode: type: string enum: - INTERLACED - INTERLACED_OPTIMIZE description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' H265CodecLevel: type: string enum: - 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 description: H.265 Level. Eac3SurroundExMode: type: string enum: - NOT_INDICATED - ENABLED - DISABLED description: When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. BurninSubtitleApplyFontColor: type: string enum: - WHITE_TEXT_ONLY - ALL_TEXT description: Ignore this setting unless Style passthrough (StylePassthrough) is set to Enabled and Font color (FontColor) set to Black, Yellow, Red, Green, Blue, or Hex. Use Apply font color (ApplyFontColor) for additional font color controls. When you choose White text only (WHITE_TEXT_ONLY), or leave blank, your font color setting only applies to white text in your input captions. For example, if your font color setting is Yellow, and your input captions have red and white text, your output captions will have red and yellow text. When you choose ALL_TEXT, your font color setting applies to all of your output captions text. __listOf__integerMinNegative60Max6: type: array items: $ref: '#/components/schemas/__integerMinNegative60Max6' AudioNormalizationPeakCalculation: type: string enum: - TRUE_PEAK - NONE description: If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. AacSpecification: type: string enum: - MPEG2 - MPEG4 description: Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. ProresScanTypeConversionMode: type: string enum: - INTERLACED - INTERLACED_OPTIMIZE description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' BurninSubtitleOutlineColor: type: string enum: - BLACK - WHITE - YELLOW - RED - GREEN - BLUE - AUTO description: Specify font outline color. Leave Outline color (OutlineColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font outline color data from your input captions, if present. XavcSettings: type: object properties: AdaptiveQuantization: allOf: - $ref: '#/components/schemas/XavcAdaptiveQuantization' - xml: name: adaptiveQuantization description: 'Keep the default value, Auto (AUTO), for this setting to have MediaConvert automatically apply the best types of quantization for your video content. When you want to apply your quantization settings manually, you must set Adaptive quantization (adaptiveQuantization) to a value other than Auto (AUTO). Use this setting to specify the strength of any adaptive quantization filters that you enable. If you don''t want MediaConvert to do any adaptive quantization in this transcode, set Adaptive quantization to Off (OFF). Related settings: The value that you choose here applies to the following settings: Flicker adaptive quantization (flickerAdaptiveQuantization), Spatial adaptive quantization (spatialAdaptiveQuantization), and Temporal adaptive quantization (temporalAdaptiveQuantization).' EntropyEncoding: allOf: - $ref: '#/components/schemas/XavcEntropyEncoding' - xml: name: entropyEncoding description: Optional. Choose a specific entropy encoding mode only when you want to override XAVC recommendations. If you choose the value auto, MediaConvert uses the mode that the XAVC file format specifies given this output's operating point. FramerateControl: allOf: - $ref: '#/components/schemas/XavcFramerateControl' - xml: name: framerateControl description: If you are using the console, use the Frame rate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list. The framerates shown in the dropdown list are decimal approximations of fractions. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate that you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/XavcFramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max1001' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Frame rate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin24Max60000' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. Profile: allOf: - $ref: '#/components/schemas/XavcProfile' - xml: name: profile description: Specify the XAVC profile for this output. For more information, see the Sony documentation at https://www.xavc-info.org/. Note that MediaConvert doesn't support the interlaced video XAVC operating points for XAVC_HD_INTRA_CBG. To create an interlaced XAVC output, choose the profile XAVC_HD. SlowPal: allOf: - $ref: '#/components/schemas/XavcSlowPal' - xml: name: slowPal description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output by relabeling the video frames and resampling your audio. Note that enabling this setting will slightly reduce the duration of your video. Related settings: You must also set Frame rate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Softness: allOf: - $ref: '#/components/schemas/__integerMin0Max128' - xml: name: softness description: Ignore this setting unless your downstream workflow requires that you specify it explicitly. Otherwise, we recommend that you adjust the softness of your output by using a lower value for the setting Sharpness (sharpness) or by enabling a noise reducer filter (noiseReducerFilter). The Softness (softness) setting specifies the quantization matrices that the encoder uses. Keep the default value, 0, for flat quantization. Choose the value 1 or 16 to use the default JVT softening quantization matricies from the H.264 specification. Choose a value from 17 to 128 to use planar interpolation. Increasing values from 17 to 128 result in increasing reduction of high-frequency data. The value 128 results in the softest video. SpatialAdaptiveQuantization: allOf: - $ref: '#/components/schemas/XavcSpatialAdaptiveQuantization' - xml: name: spatialAdaptiveQuantization description: 'The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (adaptiveQuantization). When you do so, MediaConvert automatically applies the best types of quantization for your video content. Include this setting in your JSON job specification only when you choose to change the default value for Adaptive quantization. For this setting, keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (adaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.' TemporalAdaptiveQuantization: allOf: - $ref: '#/components/schemas/XavcTemporalAdaptiveQuantization' - xml: name: temporalAdaptiveQuantization description: 'The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (adaptiveQuantization). When you do so, MediaConvert automatically applies the best types of quantization for your video content. Include this setting in your JSON job specification only when you choose to change the default value for Adaptive quantization. For this setting, keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren''t moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn''t have moving objects with sharp edges, such as sports athletes'' faces, you might choose to disable this feature. Related setting: When you enable temporal adaptive quantization, adjust the strength of the filter with the setting Adaptive quantization (adaptiveQuantization).' Xavc4kIntraCbgProfileSettings: allOf: - $ref: '#/components/schemas/Xavc4kIntraCbgProfileSettings' - xml: name: xavc4kIntraCbgProfileSettings description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_4K_INTRA_CBG. Xavc4kIntraVbrProfileSettings: allOf: - $ref: '#/components/schemas/Xavc4kIntraVbrProfileSettings' - xml: name: xavc4kIntraVbrProfileSettings description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_4K_INTRA_VBR. Xavc4kProfileSettings: allOf: - $ref: '#/components/schemas/Xavc4kProfileSettings' - xml: name: xavc4kProfileSettings description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_4K. XavcHdIntraCbgProfileSettings: allOf: - $ref: '#/components/schemas/XavcHdIntraCbgProfileSettings' - xml: name: xavcHdIntraCbgProfileSettings description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_HD_INTRA_CBG. XavcHdProfileSettings: allOf: - $ref: '#/components/schemas/XavcHdProfileSettings' - xml: name: xavcHdProfileSettings description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_HD. description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value XAVC. AudioTypeControl: type: string enum: - FOLLOW_INPUT - USE_CONFIGURED description: 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. DolbyVisionProfile: type: string enum: - PROFILE_5 - PROFILE_8_1 description: Required when you enable Dolby Vision. Use Profile 5 to include frame-interleaved Dolby Vision metadata in your output. Your input must include Dolby Vision metadata or an HDR10 YUV color space. Use Profile 8.1 to include frame-interleaved Dolby Vision metadata and HDR10 metadata in your output. Your input must include Dolby Vision metadata. FontScript: type: string enum: - AUTOMATIC - HANS - HANT description: Provide the font script, using an ISO 15924 script code, if the LanguageCode is not sufficient for determining the script type. Where LanguageCode or CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. Vp9FramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. MpdSettings: type: object properties: AccessibilityCaptionHints: allOf: - $ref: '#/components/schemas/MpdAccessibilityCaptionHints' - xml: name: accessibilityCaptionHints description: 'Optional. Choose Include (INCLUDE) to have MediaConvert mark up your DASH manifest with elements for embedded 608 captions. This markup isn''t generally required, but some video players require it to discover and play embedded 608 captions. Keep the default value, Exclude (EXCLUDE), to leave these elements out. When you enable this setting, this is the markup that MediaConvert includes in your manifest: ' AudioDuration: allOf: - $ref: '#/components/schemas/MpdAudioDuration' - xml: name: audioDuration description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. CaptionContainerType: allOf: - $ref: '#/components/schemas/MpdCaptionContainerType' - xml: name: captionContainerType description: Use this setting only in DASH output groups that include sidecar TTML or IMSC captions. You specify sidecar captions in a separate output from your audio and video. Choose Raw (RAW) for captions in a single XML file in a raw container. Choose Fragmented MPEG-4 (FRAGMENTED_MP4) for captions in XML format contained within fragmented MP4 files. This set of fragmented MP4 files is separate from your video and audio fragmented MP4 files. KlvMetadata: allOf: - $ref: '#/components/schemas/MpdKlvMetadata' - xml: name: klvMetadata description: 'To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and writes each instance to a separate event message box in the output, according to MISB ST1910.1. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.' ManifestMetadataSignaling: allOf: - $ref: '#/components/schemas/MpdManifestMetadataSignaling' - xml: name: manifestMetadataSignaling description: To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messages, the InbandEventStream element schemeIdUri will be same value that you specify for ID3 metadata scheme ID URI. For SCTE35 event messages, the InbandEventStream element schemeIdUri will be "urn:scte:scte35:2013:bin". To leave these elements out of your output MPD manifest, set Manifest metadata signaling to Disabled. To enable Manifest metadata signaling, you must also set SCTE-35 source to Passthrough, ESAM SCTE-35 to insert, or ID3 metadata (TimedMetadata) to Passthrough. Scte35Esam: allOf: - $ref: '#/components/schemas/MpdScte35Esam' - xml: name: scte35Esam description: Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml). Scte35Source: allOf: - $ref: '#/components/schemas/MpdScte35Source' - xml: name: scte35Source description: Ignore this setting unless you have SCTE-35 markers in your input video file. Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None (NONE) if you don't want those SCTE-35 markers in this output. TimedMetadata: allOf: - $ref: '#/components/schemas/MpdTimedMetadata' - xml: name: timedMetadata description: 'To include ID3 metadata in this output: Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH). Specify this ID3 metadata in Custom ID3 metadata inserter (timedMetadataInsertion). MediaConvert writes each instance of ID3 metadata in a separate Event Message (eMSG) box. To exclude this ID3 metadata: Set ID3 metadata to None (NONE) or leave blank.' TimedMetadataBoxVersion: allOf: - $ref: '#/components/schemas/MpdTimedMetadataBoxVersion' - xml: name: timedMetadataBoxVersion description: 'Specify the event message box (eMSG) version for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax. Leave blank to use the default value Version 0. When you specify Version 1, you must also set ID3 metadata (timedMetadata) to Passthrough.' TimedMetadataSchemeIdUri: allOf: - $ref: '#/components/schemas/__stringMax1000' - xml: name: timedMetadataSchemeIdUri description: 'Specify the event message box (eMSG) scheme ID URI (scheme_id_uri) for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. Leave blank to use the default value: https://aomedia.org/emsg/ID3 When you specify a value for ID3 metadata scheme ID URI, you must also set ID3 metadata (timedMetadata) to Passthrough.' TimedMetadataValue: allOf: - $ref: '#/components/schemas/__stringMax1000' - xml: name: timedMetadataValue description: Specify the event message box (eMSG) value for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. When you specify a value for ID3 Metadata Value, you must also set ID3 metadata (timedMetadata) to Passthrough. description: These settings relate to the fragmented MP4 container for the segments in your DASH outputs. F4vMoovPlacement: type: string enum: - PROGRESSIVE_DOWNLOAD - NORMAL description: 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. MpdKlvMetadata: type: string enum: - NONE - PASSTHROUGH description: 'To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and writes each instance to a separate event message box in the output, according to MISB ST1910.1. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.' Eac3DynamicRangeCompressionLine: type: string enum: - NONE - FILM_STANDARD - FILM_LIGHT - MUSIC_STANDARD - MUSIC_LIGHT - SPEECH description: 'Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the line operating mode. Related setting: When you use this setting, MediaConvert ignores any value you provide for Dynamic range compression profile (DynamicRangeCompressionProfile). For information about the Dolby Digital DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' Mpeg2AdaptiveQuantization: type: string enum: - false - LOW - MEDIUM - HIGH description: 'Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to the following settings: Spatial adaptive quantization (spatialAdaptiveQuantization), and Temporal adaptive quantization (temporalAdaptiveQuantization).' __integerMin8000Max96000: type: integer minimum: 8000 maximum: 96000 __integerMin48000Max48000: type: integer minimum: 48000 maximum: 48000 Vc3InterlaceMode: type: string enum: - INTERLACED - PROGRESSIVE description: Optional. Choose the scan line type for this output. If you don't specify a value, MediaConvert will create a progressive output. ImscDestinationSettings: type: object properties: Accessibility: allOf: - $ref: '#/components/schemas/ImscAccessibilitySubs' - xml: name: accessibility description: 'Set Accessibility subtitles to Enabled if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. When you enable this feature, MediaConvert adds the following attributes under EXT-X-MEDIA in the HLS or CMAF manifest for this track: CHARACTERISTICS="public.accessibility.describes-spoken-dialog,public.accessibility.describes-music-and-sound" and AUTOSELECT="YES". Keep the default value, Disabled, if the captions track is not intended to provide such accessibility. MediaConvert will not add the above attributes.' StylePassthrough: allOf: - $ref: '#/components/schemas/ImscStylePassthrough' - xml: name: stylePassthrough description: Keep this setting enabled to have MediaConvert use the font style and position information from the captions source in the output. This option is available only when your input captions are IMSC, SMPTE-TT, or TTML. Disable this setting for simplified output captions. description: Settings related to IMSC captions. IMSC is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/ttml-and-webvtt-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to IMSC. TooManyRequestsException: {} __doubleMin0: type: number format: double Av1BitDepth: type: string enum: - BIT_8 - BIT_10 description: Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT_8) or 10-bit (BIT_10). AudioCodecSettings: type: object properties: AacSettings: allOf: - $ref: '#/components/schemas/AacSettings' - xml: name: aacSettings description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode. Ac3Settings: allOf: - $ref: '#/components/schemas/Ac3Settings' - xml: name: ac3Settings description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3. AiffSettings: allOf: - $ref: '#/components/schemas/AiffSettings' - xml: name: aiffSettings description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF. Codec: allOf: - $ref: '#/components/schemas/AudioCodec' - xml: name: codec description: 'Choose the audio codec for this output. Note that the option Dolby Digital passthrough (PASSTHROUGH) applies only to Dolby Digital and Dolby Digital Plus audio inputs. Make sure that you choose a codec that''s supported with your output container: https://docs.aws.amazon.com/mediaconvert/latest/ug/reference-codecs-containers.html#reference-codecs-containers-output-audio For audio-only outputs, make sure that both your input audio codec and your output audio codec are supported for audio-only workflows. For more information, see: https://docs.aws.amazon.com/mediaconvert/latest/ug/reference-codecs-containers-input.html#reference-codecs-containers-input-audio-only and https://docs.aws.amazon.com/mediaconvert/latest/ug/reference-codecs-containers.html#audio-only-output' Eac3AtmosSettings: allOf: - $ref: '#/components/schemas/Eac3AtmosSettings' - xml: name: eac3AtmosSettings description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3_ATMOS. Eac3Settings: allOf: - $ref: '#/components/schemas/Eac3Settings' - xml: name: eac3Settings description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3. Mp2Settings: allOf: - $ref: '#/components/schemas/Mp2Settings' - xml: name: mp2Settings description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2. Mp3Settings: allOf: - $ref: '#/components/schemas/Mp3Settings' - xml: name: mp3Settings description: Required when you set Codec, under AudioDescriptions>CodecSettings, to the value MP3. OpusSettings: allOf: - $ref: '#/components/schemas/OpusSettings' - xml: name: opusSettings description: Required when you set Codec, under AudioDescriptions>CodecSettings, to the value OPUS. VorbisSettings: allOf: - $ref: '#/components/schemas/VorbisSettings' - xml: name: vorbisSettings description: Required when you set Codec, under AudioDescriptions>CodecSettings, to the value Vorbis. WavSettings: allOf: - $ref: '#/components/schemas/WavSettings' - xml: name: wavSettings description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV. description: Settings related to audio encoding. The settings in this group vary depending on the value that you choose for your audio codec. __integerMin1Max4: type: integer minimum: 1 maximum: 4 Mpeg2SceneChangeDetect: type: string enum: - DISABLED - ENABLED description: Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. M2tsPcrControl: type: string enum: - PCR_EVERY_PES_PACKET - CONFIGURED_PCR_PERIOD description: 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. DeletePresetResponse: type: object properties: {} Mpeg2GopSizeUnits: type: string enum: - FRAMES - SECONDS description: Specify the units for GOP size (GopSize). If you don't specify a value here, by default the encoder measures GOP size in frames. XavcHdIntraCbgProfileClass: type: string enum: - CLASS_50 - CLASS_100 - CLASS_200 description: Specify the XAVC Intra HD (CBG) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. CmfcScte35Source: type: string enum: - PASSTHROUGH - NONE description: Ignore this setting unless you have SCTE-35 markers in your input video file. Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None (NONE) if you don't want those SCTE-35 markers in this output. __string: type: string __doubleMinNegative60MaxNegative1: type: number format: double H264UnregisteredSeiTimecode: type: string enum: - DISABLED - ENABLED description: Inserts timecode for each frame as 4 bytes of an unregistered SEI message. DvbSubSubtitleFallbackFont: type: string enum: - BEST_MATCH - MONOSPACED_SANSSERIF - MONOSPACED_SERIF - PROPORTIONAL_SANSSERIF - PROPORTIONAL_SERIF description: Specify the font that you want the service to use for your burn in captions when your input captions specify a font that MediaConvert doesn't support. When you set Fallback font (FallbackFont) to best match (BEST_MATCH), or leave blank, MediaConvert uses a supported font that most closely matches the font that your input captions specify. When there are multiple unsupported fonts in your input captions, MediaConvert matches each font with the supported font that matches best. When you explicitly choose a replacement font, MediaConvert uses that font to replace all unsupported fonts from your input. DolbyVisionLevel6Mode: type: string enum: - PASSTHROUGH - RECALCULATE - SPECIFY description: Use Dolby Vision Mode to choose how the service will handle Dolby Vision MaxCLL and MaxFALL properies. MxfXavcDurationMode: type: string enum: - ALLOW_ANY_DURATION - DROP_FRAMES_FOR_COMPLIANCE description: To create an output that complies with the XAVC file format guidelines for interoperability, keep the default value, Drop frames for compliance (DROP_FRAMES_FOR_COMPLIANCE). To include all frames from your input in this output, keep the default setting, Allow any duration (ALLOW_ANY_DURATION). The number of frames that MediaConvert excludes when you set this to Drop frames for compliance depends on the output frame rate and duration. SccDestinationFramerate: type: string enum: - FRAMERATE_23_97 - FRAMERATE_24 - FRAMERATE_25 - FRAMERATE_29_97_DROPFRAME - FRAMERATE_29_97_NON_DROPFRAME description: Set Framerate (SccDestinationFramerate) to make sure that the captions and the video are synchronized in the output. Specify a frame rate that matches the frame rate of the associated video. If the video frame rate 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). Mpeg2TemporalAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren''t moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn''t have moving objects with sharp edges, such as sports athletes'' faces, you might choose to disable this feature. Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization (adaptiveQuantization).' MxfProfile: type: string enum: - D_10 - XDCAM - OP1A - XAVC description: Specify the MXF profile, also called shim, for this output. When you choose Auto, MediaConvert chooses a profile based on the video codec and resolution. For a list of codecs supported with each MXF profile, see https://docs.aws.amazon.com/mediaconvert/latest/ug/codecs-supported-with-each-mxf-profile.html. For more information about the automatic selection behavior, see https://docs.aws.amazon.com/mediaconvert/latest/ug/default-automatic-selection-of-mxf-profiles.html. Ac3DynamicRangeCompressionLine: type: string enum: - FILM_STANDARD - FILM_LIGHT - MUSIC_STANDARD - MUSIC_LIGHT - SPEECH - NONE description: 'Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the line operating mode. Related setting: When you use this setting, MediaConvert ignores any value you provide for Dynamic range compression profile (DynamicRangeCompressionProfile). For information about the Dolby Digital DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' Eac3AttenuationControl: type: string enum: - ATTENUATE_3_DB - NONE description: If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Vc3FramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. __integerMin10Max48: type: integer minimum: 10 maximum: 48 DvbddsHandling: type: string enum: - NONE - SPECIFIED - NO_DISPLAY_WINDOW description: 'Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS: Choose Specified. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate. To include the DDS, but not include display window data: Choose No display window. When you do, you can write position metadata to the page composition segment (PCS) with DDS x-coordinate and DDS y-coordinate. For video resolutions with a height of 576 pixels or less, MediaConvert doesn''t include the DDS, regardless of the value you choose for DDS handling. All burn-in and DVB-Sub font settings must match.' __listOfPreset: type: array items: $ref: '#/components/schemas/Preset' MxfSettings: type: object properties: AfdSignaling: allOf: - $ref: '#/components/schemas/MxfAfdSignaling' - xml: name: afdSignaling description: 'Optional. When you have AFD signaling set up in your output video stream, use this setting to choose whether to also include it in the MXF wrapper. Choose Don''t copy (NO_COPY) to exclude AFD signaling from the MXF wrapper. Choose Copy from video stream (COPY_FROM_VIDEO) to copy the AFD values from the video stream for this output to the MXF wrapper. Regardless of which option you choose, the AFD values remain in the video stream. Related settings: To set up your output to include or exclude AFD values, see AfdSignaling, under VideoDescription. On the console, find AFD signaling under the output''s video encoding settings.' Profile: allOf: - $ref: '#/components/schemas/MxfProfile' - xml: name: profile description: Specify the MXF profile, also called shim, for this output. When you choose Auto, MediaConvert chooses a profile based on the video codec and resolution. For a list of codecs supported with each MXF profile, see https://docs.aws.amazon.com/mediaconvert/latest/ug/codecs-supported-with-each-mxf-profile.html. For more information about the automatic selection behavior, see https://docs.aws.amazon.com/mediaconvert/latest/ug/default-automatic-selection-of-mxf-profiles.html. XavcProfileSettings: allOf: - $ref: '#/components/schemas/MxfXavcProfileSettings' - xml: name: xavcProfileSettings description: Specify the XAVC profile settings for MXF outputs when you set your MXF profile to XAVC. description: These settings relate to your MXF output container. M2tsSettings: type: object properties: AudioBufferModel: allOf: - $ref: '#/components/schemas/M2tsAudioBufferModel' - xml: name: audioBufferModel description: Selects between the DVB and ATSC buffer models for Dolby Digital audio. AudioDuration: allOf: - $ref: '#/components/schemas/M2tsAudioDuration' - xml: name: audioDuration description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. AudioFramesPerPes: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: audioFramesPerPes description: The number of audio frames to insert for each PES packet. AudioPids: allOf: - $ref: '#/components/schemas/__listOf__integerMin32Max8182' - xml: name: audioPids description: Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492. Bitrate: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: bitrate description: Specify 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: allOf: - $ref: '#/components/schemas/M2tsBufferModel' - xml: name: bufferModel description: 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. DataPTSControl: allOf: - $ref: '#/components/schemas/M2tsDataPtsControl' - xml: name: dataPTSControl description: If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values). Keep the default value (AUTO) to allow all PTS values. DvbNitSettings: allOf: - $ref: '#/components/schemas/DvbNitSettings' - xml: name: dvbNitSettings description: Use these settings to insert a DVB Network Information Table (NIT) in the transport stream of this output. When you work directly in your JSON job specification, include this object only when your job has a transport stream output and the container settings contain the object M2tsSettings. DvbSdtSettings: allOf: - $ref: '#/components/schemas/DvbSdtSettings' - xml: name: dvbSdtSettings description: Use these settings to insert a DVB Service Description Table (SDT) in the transport stream of this output. When you work directly in your JSON job specification, include this object only when your job has a transport stream output and the container settings contain the object M2tsSettings. DvbSubPids: allOf: - $ref: '#/components/schemas/__listOf__integerMin32Max8182' - xml: name: dvbSubPids description: Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479. DvbTdtSettings: allOf: - $ref: '#/components/schemas/DvbTdtSettings' - xml: name: dvbTdtSettings description: Use these settings to insert a DVB Time and Date Table (TDT) in the transport stream of this output. When you work directly in your JSON job specification, include this object only when your job has a transport stream output and the container settings contain the object M2tsSettings. DvbTeletextPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: dvbTeletextPid description: Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499. EbpAudioInterval: allOf: - $ref: '#/components/schemas/M2tsEbpAudioInterval' - xml: name: ebpAudioInterval description: 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: allOf: - $ref: '#/components/schemas/M2tsEbpPlacement' - xml: name: ebpPlacement description: 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: allOf: - $ref: '#/components/schemas/M2tsEsRateInPes' - xml: name: esRateInPes description: Controls whether to include the ES Rate field in the PES header. ForceTsVideoEbpOrder: allOf: - $ref: '#/components/schemas/M2tsForceTsVideoEbpOrder' - xml: name: forceTsVideoEbpOrder description: Keep the default value (DEFAULT) unless you know that your audio EBP markers are incorrectly appearing before your video EBP markers. To correct this problem, set this value to Force (FORCE). FragmentTime: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: fragmentTime description: The length, in seconds, of each fragment. Only used with EBP markers. KlvMetadata: allOf: - $ref: '#/components/schemas/M2tsKlvMetadata' - xml: name: klvMetadata description: 'To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and passes it through to the output transport stream. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.' MaxPcrInterval: allOf: - $ref: '#/components/schemas/__integerMin0Max500' - xml: name: maxPcrInterval description: Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream. MinEbpInterval: allOf: - $ref: '#/components/schemas/__integerMin0Max10000' - xml: name: minEbpInterval description: 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: allOf: - $ref: '#/components/schemas/M2tsNielsenId3' - xml: name: nielsenId3 description: 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: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: nullPacketBitrate description: 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: allOf: - $ref: '#/components/schemas/__integerMin0Max1000' - xml: name: patInterval description: The number of milliseconds between instances of this table in the output transport stream. PcrControl: allOf: - $ref: '#/components/schemas/M2tsPcrControl' - xml: name: pcrControl description: 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: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: pcrPid description: Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid). PmtInterval: allOf: - $ref: '#/components/schemas/__integerMin0Max1000' - xml: name: pmtInterval description: Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream. PmtPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: pmtPid description: Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480. PrivateMetadataPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: privateMetadataPid description: Specify the packet identifier (PID) of the private metadata stream. Default is 503. ProgramNumber: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: programNumber description: Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data. RateMode: allOf: - $ref: '#/components/schemas/M2tsRateMode' - xml: name: rateMode description: 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. Scte35Esam: allOf: - $ref: '#/components/schemas/M2tsScte35Esam' - xml: name: scte35Esam description: Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml). Scte35Pid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: scte35Pid description: Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream. Scte35Source: allOf: - $ref: '#/components/schemas/M2tsScte35Source' - xml: name: scte35Source description: For SCTE-35 markers from your input-- Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None (NONE) if you don't want SCTE-35 markers in this output. For SCTE-35 markers from an ESAM XML document-- Choose None (NONE). Also provide the ESAM XML as a string in the setting Signal processing notification XML (sccXml). Also enable ESAM SCTE-35 (include the property scte35Esam). SegmentationMarkers: allOf: - $ref: '#/components/schemas/M2tsSegmentationMarkers' - xml: name: segmentationMarkers description: 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: allOf: - $ref: '#/components/schemas/M2tsSegmentationStyle' - xml: name: segmentationStyle description: 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: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: segmentationTime description: Specify the length, in seconds, of each segment. Required unless markers is set to _none_. TimedMetadataPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: timedMetadataPid description: Packet Identifier (PID) of the ID3 metadata stream in the transport stream. TransportStreamId: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: transportStreamId description: Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data. VideoPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: videoPid description: Specify the packet identifier (PID) of the elementary video stream in the transport stream. description: MPEG-2 TS container settings. These apply to outputs in a File output group when the output's container (ContainerType) is MPEG-2 Transport Stream (M2TS). In these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset. MxfXavcProfileSettings: type: object properties: DurationMode: allOf: - $ref: '#/components/schemas/MxfXavcDurationMode' - xml: name: durationMode description: To create an output that complies with the XAVC file format guidelines for interoperability, keep the default value, Drop frames for compliance (DROP_FRAMES_FOR_COMPLIANCE). To include all frames from your input in this output, keep the default setting, Allow any duration (ALLOW_ANY_DURATION). The number of frames that MediaConvert excludes when you set this to Drop frames for compliance depends on the output frame rate and duration. MaxAncDataSize: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: maxAncDataSize description: 'Specify a value for this setting only for outputs that you set up with one of these two XAVC profiles: XAVC HD Intra CBG (XAVC_HD_INTRA_CBG) or XAVC 4K Intra CBG (XAVC_4K_INTRA_CBG). Specify the amount of space in each frame that the service reserves for ancillary data, such as teletext captions. The default value for this setting is 1492 bytes per frame. This should be sufficient to prevent overflow unless you have multiple pages of teletext captions data. If you have a large amount of teletext data, specify a larger number.' description: Specify the XAVC profile settings for MXF outputs when you set your MXF profile to XAVC. __listOfTeletextPageType: type: array items: $ref: '#/components/schemas/TeletextPageType' AudioNormalizationLoudnessLogging: type: string enum: - LOG - DONT_LOG description: If set to LOG, log each output's audio track loudness to a CSV file. __integerMin8Max12: type: integer minimum: 8 maximum: 12 DvbSdtSettings: type: object properties: OutputSdt: allOf: - $ref: '#/components/schemas/OutputSdt' - xml: name: outputSdt description: 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: allOf: - $ref: '#/components/schemas/__integerMin25Max2000' - xml: name: sdtInterval description: The number of milliseconds between instances of this table in the output transport stream. ServiceName: allOf: - $ref: '#/components/schemas/__stringMin1Max256' - xml: name: serviceName description: The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters. ServiceProviderName: allOf: - $ref: '#/components/schemas/__stringMin1Max256' - xml: name: serviceProviderName description: The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters. description: Use these settings to insert a DVB Service Description Table (SDT) in the transport stream of this output. When you work directly in your JSON job specification, include this object only when your job has a transport stream output and the container settings contain the object M2tsSettings. H264SpatialAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'Only use this setting when you change the default value, Auto (AUTO), for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264AdaptiveQuantization and all other adaptive quantization from your JSON job specification, MediaConvert automatically applies the best types of quantization for your video content. When you set H264AdaptiveQuantization to a value other than AUTO, the default value for H264SpatialAdaptiveQuantization is Enabled (ENABLED). Keep this default value to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to set H264SpatialAdaptiveQuantization to Disabled (DISABLED). Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (H264AdaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher. To manually enable or disable H264SpatialAdaptiveQuantization, you must set Adaptive quantization (H264AdaptiveQuantization) to a value other than AUTO.' H265SceneChangeDetect: type: string enum: - DISABLED - ENABLED - TRANSITION_DETECTION description: Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. If this output uses QVBR, choose Transition detection (TRANSITION_DETECTION) for further video quality improvement. For more information about QVBR, see https://docs.aws.amazon.com/console/mediaconvert/cbr-vbr-qvbr. TimecodeBurnin: type: object properties: FontSize: allOf: - $ref: '#/components/schemas/__integerMin10Max48' - xml: name: fontSize description: Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48. Position: allOf: - $ref: '#/components/schemas/TimecodeBurninPosition' - xml: name: position description: Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Prefix: allOf: - $ref: '#/components/schemas/__stringPattern' - xml: name: prefix description: 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. description: Settings for burning the output timecode and specified prefix into the output. Hdr10Plus: type: object properties: MasteringMonitorNits: allOf: - $ref: '#/components/schemas/__integerMin0Max4000' - xml: name: masteringMonitorNits description: Specify the HDR10+ mastering display normalized peak luminance, in nits. This is the normalized actual peak luminance of the mastering display, as defined by ST 2094-40. TargetMonitorNits: allOf: - $ref: '#/components/schemas/__integerMin0Max4000' - xml: name: targetMonitorNits description: Specify the HDR10+ target display nominal peak luminance, in nits. This is the nominal maximum luminance of the target display as defined by ST 2094-40. description: Setting for HDR10+ metadata insertion H265RateControlMode: type: string enum: - VBR - CBR - QVBR description: Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). __stringMin1Max256: type: string minLength: 1 maxLength: 256 __stringMin3Max3Pattern1809aFAF09aEAE: type: string pattern: ^[1-8][0-9a-fA-F][0-9a-eA-E]$ minLength: 3 maxLength: 3 M2tsAudioDuration: type: string enum: - DEFAULT_CODEC_DURATION - MATCH_VIDEO_DURATION description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. __integerMin1000Max30000: type: integer minimum: 1000 maximum: 30000 AudioChannelTag: type: string enum: - L - R - C - LFE - LS - RS - LC - RC - CS - LSD - RSD - TCS - VHL - VHC - VHR description: You can add a tag for this mono-channel audio track to mimic its placement in a multi-channel layout. For example, if this track is the left surround channel, choose Left surround (LS). ProresSlowPal: type: string enum: - DISABLED - ENABLED description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' H264CodecProfile: type: string enum: - BASELINE - HIGH - HIGH_10BIT - HIGH_422 - HIGH_422_10BIT - MAIN description: H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. H265SlowPal: type: string enum: - DISABLED - ENABLED description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Eac3Settings: type: object properties: AttenuationControl: allOf: - $ref: '#/components/schemas/Eac3AttenuationControl' - xml: name: attenuationControl description: If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Bitrate: allOf: - $ref: '#/components/schemas/__integerMin32000Max3024000' - xml: name: bitrate description: 'Specify the average bitrate in bits per second. The bitrate that you specify must be a multiple of 8000 within the allowed minimum and maximum values. Leave blank to use the default bitrate for the coding mode you select according ETSI TS 102 366. Valid bitrates for coding mode 1/0: Default: 96000. Minimum: 32000. Maximum: 3024000. Valid bitrates for coding mode 2/0: Default: 192000. Minimum: 96000. Maximum: 3024000. Valid bitrates for coding mode 3/2: Default: 384000. Minimum: 192000. Maximum: 3024000.' BitstreamMode: allOf: - $ref: '#/components/schemas/Eac3BitstreamMode' - xml: name: bitstreamMode description: Specify the bitstream mode for the E-AC-3 stream that the encoder emits. For more information about the EAC3 bitstream mode, see ATSC A/52-2012 (Annex E). CodingMode: allOf: - $ref: '#/components/schemas/Eac3CodingMode' - xml: name: codingMode description: Dolby Digital Plus coding mode. Determines number of channels. DcFilter: allOf: - $ref: '#/components/schemas/Eac3DcFilter' - xml: name: dcFilter description: Activates a DC highpass filter for all input channels. Dialnorm: allOf: - $ref: '#/components/schemas/__integerMin1Max31' - xml: name: dialnorm description: Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through. DynamicRangeCompressionLine: allOf: - $ref: '#/components/schemas/Eac3DynamicRangeCompressionLine' - xml: name: dynamicRangeCompressionLine description: 'Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the line operating mode. Related setting: When you use this setting, MediaConvert ignores any value you provide for Dynamic range compression profile (DynamicRangeCompressionProfile). For information about the Dolby Digital DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' DynamicRangeCompressionRf: allOf: - $ref: '#/components/schemas/Eac3DynamicRangeCompressionRf' - xml: name: dynamicRangeCompressionRf description: 'Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the RF operating mode. Related setting: When you use this setting, MediaConvert ignores any value you provide for Dynamic range compression profile (DynamicRangeCompressionProfile). For information about the Dolby Digital DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' LfeControl: allOf: - $ref: '#/components/schemas/Eac3LfeControl' - xml: name: lfeControl description: When encoding 3/2 audio, controls whether the LFE channel is enabled LfeFilter: allOf: - $ref: '#/components/schemas/Eac3LfeFilter' - xml: name: lfeFilter description: Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. LoRoCenterMixLevel: allOf: - $ref: '#/components/schemas/__doubleMinNegative60Max3' - xml: name: loRoCenterMixLevel description: 'Specify a value for the following Dolby Digital Plus setting: Left only/Right only center mix (Lo/Ro center). MediaConvert uses this value for downmixing. How the service uses this value depends on the value that you choose for Stereo downmix (Eac3StereoDownmix). Valid values: 3.0, 1.5, 0.0, -1.5, -3.0, -4.5, -6.0, and -60. The value -60 mutes the channel. This setting applies only if you keep the default value of 3/2 - L, R, C, Ls, Rs (CODING_MODE_3_2) for the setting Coding mode (Eac3CodingMode). If you choose a different value for Coding mode, the service ignores Left only/Right only center (loRoCenterMixLevel).' LoRoSurroundMixLevel: allOf: - $ref: '#/components/schemas/__doubleMinNegative60MaxNegative1' - xml: name: loRoSurroundMixLevel description: 'Specify a value for the following Dolby Digital Plus setting: Left only/Right only (Lo/Ro surround). MediaConvert uses this value for downmixing. How the service uses this value depends on the value that you choose for Stereo downmix (Eac3StereoDownmix). Valid values: -1.5, -3.0, -4.5, -6.0, and -60. The value -60 mutes the channel. This setting applies only if you keep the default value of 3/2 - L, R, C, Ls, Rs (CODING_MODE_3_2) for the setting Coding mode (Eac3CodingMode). If you choose a different value for Coding mode, the service ignores Left only/Right only surround (loRoSurroundMixLevel).' LtRtCenterMixLevel: allOf: - $ref: '#/components/schemas/__doubleMinNegative60Max3' - xml: name: ltRtCenterMixLevel description: 'Specify a value for the following Dolby Digital Plus setting: Left total/Right total center mix (Lt/Rt center). MediaConvert uses this value for downmixing. How the service uses this value depends on the value that you choose for Stereo downmix (Eac3StereoDownmix). Valid values: 3.0, 1.5, 0.0, -1.5, -3.0, -4.5, -6.0, and -60. The value -60 mutes the channel. This setting applies only if you keep the default value of 3/2 - L, R, C, Ls, Rs (CODING_MODE_3_2) for the setting Coding mode (Eac3CodingMode). If you choose a different value for Coding mode, the service ignores Left total/Right total center (ltRtCenterMixLevel).' LtRtSurroundMixLevel: allOf: - $ref: '#/components/schemas/__doubleMinNegative60MaxNegative1' - xml: name: ltRtSurroundMixLevel description: 'Specify a value for the following Dolby Digital Plus setting: Left total/Right total surround mix (Lt/Rt surround). MediaConvert uses this value for downmixing. How the service uses this value depends on the value that you choose for Stereo downmix (Eac3StereoDownmix). Valid values: -1.5, -3.0, -4.5, -6.0, and -60. The value -60 mutes the channel. This setting applies only if you keep the default value of 3/2 - L, R, C, Ls, Rs (CODING_MODE_3_2) for the setting Coding mode (Eac3CodingMode). If you choose a different value for Coding mode, the service ignores Left total/Right total surround (ltRtSurroundMixLevel).' MetadataControl: allOf: - $ref: '#/components/schemas/Eac3MetadataControl' - xml: name: metadataControl description: 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: allOf: - $ref: '#/components/schemas/Eac3PassthroughControl' - xml: name: passthroughControl description: 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: allOf: - $ref: '#/components/schemas/Eac3PhaseControl' - xml: name: phaseControl description: Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. SampleRate: allOf: - $ref: '#/components/schemas/__integerMin48000Max48000' - xml: name: sampleRate description: This value is always 48000. It represents the sample rate in Hz. StereoDownmix: allOf: - $ref: '#/components/schemas/Eac3StereoDownmix' - xml: name: stereoDownmix description: Choose how the service does stereo downmixing. This setting only applies if you keep the default value of 3/2 - L, R, C, Ls, Rs (CODING_MODE_3_2) for the setting Coding mode (Eac3CodingMode). If you choose a different value for Coding mode, the service ignores Stereo downmix (Eac3StereoDownmix). SurroundExMode: allOf: - $ref: '#/components/schemas/Eac3SurroundExMode' - xml: name: surroundExMode description: When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. SurroundMode: allOf: - $ref: '#/components/schemas/Eac3SurroundMode' - xml: name: surroundMode description: When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3. DvbSubtitleFontColor: type: string enum: - WHITE - BLACK - YELLOW - RED - GREEN - BLUE - HEX - AUTO description: Specify the color of the captions text. Leave Font color (FontColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font color data from your input captions, if present. Within your job settings, all of your DVB-Sub settings must be identical. Eac3AtmosSurroundExMode: type: string enum: - NOT_INDICATED - ENABLED - DISABLED description: Specify whether your input audio has an additional center rear surround channel matrix encoded into your left and right surround channels. __stringMin6Max8Pattern09aFAF609aFAF2: type: string pattern: ^[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$ minLength: 6 maxLength: 8 DvbSubtitleTeletextSpacing: type: string enum: - FIXED_GRID - PROPORTIONAL - AUTO description: Specify whether the Text spacing (TeletextSpacing) in your captions is set by the captions grid, or varies depending on letter width. Choose fixed grid (FIXED_GRID) to conform to the spacing specified in the captions file more accurately. Choose proportional (PROPORTIONAL) to make the text easier to read for closed captions. Within your job settings, all of your DVB-Sub settings must be identical. BurninSubtitleFontColor: type: string enum: - WHITE - BLACK - YELLOW - RED - GREEN - BLUE - HEX - AUTO description: Specify the color of the burned-in captions text. Leave Font color (FontColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font color data from your input captions, if present. H264CodecLevel: type: string enum: - 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 description: Specify an H.264 level that is consistent with your output video settings. If you aren't sure what level to specify, choose Auto (AUTO). DvbSubtitleOutlineColor: type: string enum: - BLACK - WHITE - YELLOW - RED - GREEN - BLUE - AUTO description: Specify font outline color. Leave Outline color (OutlineColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font outline color data from your input captions, if present. Within your job settings, all of your DVB-Sub settings must be identical. Mpeg2Settings: type: object properties: AdaptiveQuantization: allOf: - $ref: '#/components/schemas/Mpeg2AdaptiveQuantization' - xml: name: adaptiveQuantization description: 'Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to the following settings: Spatial adaptive quantization (spatialAdaptiveQuantization), and Temporal adaptive quantization (temporalAdaptiveQuantization).' Bitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max288000000' - xml: name: bitrate description: Specify the average bitrate in bits per second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000. CodecLevel: allOf: - $ref: '#/components/schemas/Mpeg2CodecLevel' - xml: name: codecLevel description: Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. CodecProfile: allOf: - $ref: '#/components/schemas/Mpeg2CodecProfile' - xml: name: codecProfile description: Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. DynamicSubGop: allOf: - $ref: '#/components/schemas/Mpeg2DynamicSubGop' - xml: name: dynamicSubGop description: Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). FramerateControl: allOf: - $ref: '#/components/schemas/Mpeg2FramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/Mpeg2FramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max1001' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin24Max60000' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. GopClosedCadence: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: gopClosedCadence description: Specify the relative frequency of open to closed GOPs in this output. For example, if you want to allow four open GOPs and then require a closed GOP, set this value to 5. When you create a streaming output, we recommend that you keep the default value, 1, so that players starting mid-stream receive an IDR frame as quickly as possible. Don't set this value to 0; that would break output segmenting. GopSize: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: gopSize description: 'Specify the interval between keyframes, in seconds or frames, for this output. Default: 12 Related settings: When you specify the GOP size in seconds, set GOP mode control (GopSizeUnits) to Specified, seconds (SECONDS). The default value for GOP mode control (GopSizeUnits) is Frames (FRAMES).' GopSizeUnits: allOf: - $ref: '#/components/schemas/Mpeg2GopSizeUnits' - xml: name: gopSizeUnits description: Specify the units for GOP size (GopSize). If you don't specify a value here, by default the encoder measures GOP size in frames. HrdBufferFinalFillPercentage: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: hrdBufferFinalFillPercentage description: 'If your downstream systems have strict buffer requirements: Specify the minimum percentage of the HRD buffer that''s available at the end of each encoded video segment. For the best video quality: Set to 0 or leave blank to automatically determine the final buffer fill percentage.' HrdBufferInitialFillPercentage: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: hrdBufferInitialFillPercentage description: Percentage of the buffer that should initially be filled (HRD buffer model). HrdBufferSize: allOf: - $ref: '#/components/schemas/__integerMin0Max47185920' - xml: name: hrdBufferSize description: Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000. InterlaceMode: allOf: - $ref: '#/components/schemas/Mpeg2InterlaceMode' - xml: name: interlaceMode description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. IntraDcPrecision: allOf: - $ref: '#/components/schemas/Mpeg2IntraDcPrecision' - xml: name: intraDcPrecision description: 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: allOf: - $ref: '#/components/schemas/__integerMin1000Max300000000' - xml: name: maxBitrate description: Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. MinIInterval: allOf: - $ref: '#/components/schemas/__integerMin0Max30' - xml: name: minIInterval description: Use this setting only when you also enable Scene change detection (SceneChangeDetect). This setting determines how the encoder manages the spacing between I-frames that it inserts as part of the I-frame cadence and the I-frames that it inserts for Scene change detection. When you specify a value for this setting, the encoder determines whether to skip a cadence-driven I-frame by the value you set. For example, if you set Min I interval (minIInterval) to 5 and a cadence-driven I-frame would fall within 5 frames of a scene-change I-frame, then the encoder skips the cadence-driven I-frame. In this way, one GOP is shrunk slightly and one GOP is stretched slightly. When the cadence-driven I-frames are farther from the scene-change I-frame than the value you set, then the encoder leaves all I-frames in place and the GOPs surrounding the scene change are smaller than the usual cadence GOPs. NumberBFramesBetweenReferenceFrames: allOf: - $ref: '#/components/schemas/__integerMin0Max7' - xml: name: numberBFramesBetweenReferenceFrames description: Specify the number of B-frames that MediaConvert puts between reference frames in this output. Valid values are whole numbers from 0 through 7. When you don't specify a value, MediaConvert defaults to 2. ParControl: allOf: - $ref: '#/components/schemas/Mpeg2ParControl' - xml: name: parControl description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. ParDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parDenominator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33. ParNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parNumerator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40. QualityTuningLevel: allOf: - $ref: '#/components/schemas/Mpeg2QualityTuningLevel' - xml: name: qualityTuningLevel description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. RateControlMode: allOf: - $ref: '#/components/schemas/Mpeg2RateControlMode' - xml: name: rateControlMode description: Use Rate control mode (Mpeg2RateControlMode) to specify whether the bitrate is variable (vbr) or constant (cbr). ScanTypeConversionMode: allOf: - $ref: '#/components/schemas/Mpeg2ScanTypeConversionMode' - xml: name: scanTypeConversionMode description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' SceneChangeDetect: allOf: - $ref: '#/components/schemas/Mpeg2SceneChangeDetect' - xml: name: sceneChangeDetect description: Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. SlowPal: allOf: - $ref: '#/components/schemas/Mpeg2SlowPal' - xml: name: slowPal description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Softness: allOf: - $ref: '#/components/schemas/__integerMin0Max128' - xml: name: softness description: Ignore this setting unless you need to comply with a specification that requires a specific value. If you don't have a specification requirement, we recommend that you adjust the softness of your output by using a lower value for the setting Sharpness (sharpness) or by enabling a noise reducer filter (noiseReducerFilter). The Softness (softness) setting specifies the quantization matrices that the encoder uses. Keep the default value, 0, to use the AWS Elemental default matrices. Choose a value from 17 to 128 to use planar interpolation. Increasing values from 17 to 128 result in increasing reduction of high-frequency data. The value 128 results in the softest video. SpatialAdaptiveQuantization: allOf: - $ref: '#/components/schemas/Mpeg2SpatialAdaptiveQuantization' - xml: name: spatialAdaptiveQuantization description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (adaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.' Syntax: allOf: - $ref: '#/components/schemas/Mpeg2Syntax' - xml: name: syntax description: 'Specify whether this output''s video uses the D10 syntax. Keep the default value to not use the syntax. Related settings: When you choose D10 (D_10) for your MXF profile (profile), you must also set this value to D10 (D_10).' Telecine: allOf: - $ref: '#/components/schemas/Mpeg2Telecine' - xml: name: telecine description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or soft telecine to create a smoother picture. Hard telecine (HARD) produces a 29.97i output. Soft telecine (SOFT) produces an output with a 23.976 output that signals to the video player device to do the conversion during play back. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. TemporalAdaptiveQuantization: allOf: - $ref: '#/components/schemas/Mpeg2TemporalAdaptiveQuantization' - xml: name: temporalAdaptiveQuantization description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren''t moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn''t have moving objects with sharp edges, such as sports athletes'' faces, you might choose to disable this feature. Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization (adaptiveQuantization).' description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2. ImageInserter: type: object properties: InsertableImages: allOf: - $ref: '#/components/schemas/__listOfInsertableImage' - xml: name: insertableImages description: Specify the images that you want to overlay on your video. The images must be PNG or TGA files. SdrReferenceWhiteLevel: allOf: - $ref: '#/components/schemas/__integerMin100Max1000' - xml: name: sdrReferenceWhiteLevel description: Specify the reference white level, in nits, for all of your image inserter images. Use to correct brightness levels within HDR10 outputs. For 1,000 nit peak brightness displays, we recommend that you set SDR reference white level to 203 (according to ITU-R BT.2408). Leave blank to use the default value of 100, or specify an integer from 100 to 1000. description: Use the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input or output individually. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/graphic-overlay.html. This setting is disabled by default. FrameCaptureSettings: type: object properties: FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateDenominator description: 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: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateNumerator description: 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: allOf: - $ref: '#/components/schemas/__integerMin1Max10000000' - xml: name: maxCaptures description: Maximum number of captures (encoded jpg output files). Quality: allOf: - $ref: '#/components/schemas/__integerMin1Max100' - xml: name: quality description: JPEG Quality - a higher value equals higher quality. description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE. __listOfInsertableImage: type: array items: $ref: '#/components/schemas/InsertableImage' H265GopBReference: type: string enum: - DISABLED - ENABLED description: If enable, use reference B frames for GOP structures that have B frames > 1. __integerMin0Max15: type: integer minimum: 0 maximum: 15 M2tsForceTsVideoEbpOrder: type: string enum: - FORCE - DEFAULT description: Keep the default value (DEFAULT) unless you know that your audio EBP markers are incorrectly appearing before your video EBP markers. To correct this problem, set this value to Force (FORCE). __integerMin1Max64: type: integer minimum: 1 maximum: 64 Mpeg2CodecLevel: type: string enum: - AUTO - LOW - MAIN - HIGH1440 - HIGH description: Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. H264FlickerAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: Only use this setting when you change the default value, AUTO, for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264AdaptiveQuantization and all other adaptive quantization from your JSON job specification, MediaConvert automatically applies the best types of quantization for your video content. When you set H264AdaptiveQuantization to a value other than AUTO, the default value for H264FlickerAdaptiveQuantization is Disabled (DISABLED). Change this value to Enabled (ENABLED) to reduce I-frame pop. I-frame pop appears as a visual flicker that can arise when the encoder saves bits by copying some macroblocks many times from frame to frame, and then refreshes them at the I-frame. When you enable this setting, the encoder updates these macroblocks slightly more often to smooth out the flicker. To manually enable or disable H264FlickerAdaptiveQuantization, you must set Adaptive quantization (H264AdaptiveQuantization) to a value other than AUTO. Eac3PhaseControl: type: string enum: - SHIFT_90_DEGREES - NO_SHIFT description: Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. __integerMin1000Max480000000: type: integer minimum: 1000 maximum: 480000000 Type: type: string enum: - SYSTEM - CUSTOM __integerMin0Max1152000000: type: integer minimum: 0 maximum: 1152000000 __doubleMinNegative6Max3: type: number format: double Mpeg2Telecine: type: string enum: - NONE - SOFT - HARD description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or soft telecine to create a smoother picture. Hard telecine (HARD) produces a 29.97i output. Soft telecine (SOFT) produces an output with a 23.976 output that signals to the video player device to do the conversion during play back. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. CmfcAudioTrackType: type: string enum: - ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT - ALTERNATE_AUDIO_AUTO_SELECT - ALTERNATE_AUDIO_NOT_AUTO_SELECT description: Use this setting to control the values that MediaConvert puts in your HLS parent playlist to control how the client player selects which audio track to play. The other options for this setting determine the values that MediaConvert writes for the DEFAULT and AUTOSELECT attributes of the EXT-X-MEDIA entry for the audio variant. For more information about these attributes, see the Apple documentation article https://developer.apple.com/documentation/http_live_streaming/example_playlists_for_http_live_streaming/adding_alternate_media_to_a_playlist. Choose Alternate audio, auto select, default (ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT) to set DEFAULT=YES and AUTOSELECT=YES. Choose this value for only one variant in your output group. Choose Alternate audio, auto select, not default (ALTERNATE_AUDIO_AUTO_SELECT) to set DEFAULT=NO and AUTOSELECT=YES. Choose Alternate Audio, Not Auto Select to set DEFAULT=NO and AUTOSELECT=NO. When you don't specify a value for this setting, MediaConvert defaults to Alternate audio, auto select, default. When there is more than one variant in your output group, you must explicitly choose a value for this setting. RespondToAfd: type: string enum: - NONE - RESPOND - PASSTHROUGH description: 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. WebvttStylePassthrough: type: string enum: - ENABLED - DISABLED - STRICT description: 'To use the available style, color, and position information from your input captions: Set Style passthrough (stylePassthrough) to Enabled (ENABLED). MediaConvert uses default settings when style and position information is missing from your input captions. To recreate the input captions exactly: Set Style passthrough to Strict (STRICT). MediaConvert automatically applies timing adjustments, including adjustments for frame rate conversion, ad avails, and input clipping. Your input captions format must be WebVTT. To ignore the style and position information from your input captions and use simplified output captions: Set Style passthrough to Disabled (DISABLED), or leave blank.' __integerMin0Max10000: type: integer minimum: 0 maximum: 10000 H265GopSizeUnits: type: string enum: - FRAMES - SECONDS - AUTO description: Specify how the transcoder determines GOP size for this output. We recommend that you have the transcoder automatically choose this value for you based on characteristics of your input video. To enable this automatic behavior, choose Auto (AUTO) and and leave GOP size (GopSize) blank. By default, if you don't specify GOP mode control (GopSizeUnits), MediaConvert will use automatic behavior. If your output group specifies HLS, DASH, or CMAF, set GOP mode control to Auto and leave GOP size blank in each output in your output group. To explicitly specify the GOP length, choose Specified, frames (FRAMES) or Specified, seconds (SECONDS) and then provide the GOP length in the related setting GOP size (GopSize). __stringPatternAZaZ23AZaZ: type: string pattern: ^[A-Za-z]{2,3}(-[A-Za-z-]+)?$ OutputSdt: type: string enum: - SDT_FOLLOW - SDT_FOLLOW_IF_PRESENT - SDT_MANUAL - SDT_NONE description: 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. M2tsScte35Source: type: string enum: - PASSTHROUGH - NONE description: For SCTE-35 markers from your input-- Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None (NONE) if you don't want SCTE-35 markers in this output. For SCTE-35 markers from an ESAM XML document-- Choose None (NONE). Also provide the ESAM XML as a string in the setting Signal processing notification XML (sccXml). Also enable ESAM SCTE-35 (include the property scte35Esam). MpdAccessibilityCaptionHints: type: string enum: - INCLUDE - EXCLUDE description: 'Optional. Choose Include (INCLUDE) to have MediaConvert mark up your DASH manifest with elements for embedded 608 captions. This markup isn''t generally required, but some video players require it to discover and play embedded 608 captions. Keep the default value, Exclude (EXCLUDE), to leave these elements out. When you enable this setting, this is the markup that MediaConvert includes in your manifest: ' __integerMin0Max1000: type: integer minimum: 0 maximum: 1000 Av1FramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Ac3LfeFilter: type: string enum: - ENABLED - DISABLED description: Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. AvcIntraFramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. CmfcManifestMetadataSignaling: type: string enum: - ENABLED - DISABLED description: To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messages, the InbandEventStream element schemeIdUri will be same value that you specify for ID3 metadata scheme ID URI. For SCTE35 event messages, the InbandEventStream element schemeIdUri will be "urn:scte:scte35:2013:bin". To leave these elements out of your output MPD manifest, set Manifest metadata signaling to Disabled. To enable Manifest metadata signaling, you must also set SCTE-35 source to Passthrough, ESAM SCTE-35 to insert, or ID3 metadata (TimedMetadata) to Passthrough. Vp8FramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. H265AlternateTransferFunctionSei: type: string enum: - DISABLED - ENABLED description: Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). XavcGopBReference: type: string enum: - DISABLED - ENABLED description: Specify whether the encoder uses B-frames as reference frames for other pictures in the same GOP. Choose Allow (ENABLED) to allow the encoder to use B-frames as reference frames. Choose Don't allow (DISABLED) to prevent the encoder from using B-frames as reference frames. H264ParControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. CmfcIFrameOnlyManifest: type: string enum: - INCLUDE - EXCLUDE description: Choose Include (INCLUDE) to have MediaConvert generate an HLS child manifest that lists only the I-frames for this rendition, in addition to your regular manifest for this rendition. You might use this manifest as part of a workflow that creates preview functions for your video. MediaConvert adds both the I-frame only child manifest and the regular child manifest to the parent manifest. When you don't need the I-frame only child manifest, keep the default value Exclude (EXCLUDE). ProresCodecProfile: type: string enum: - APPLE_PRORES_422 - APPLE_PRORES_422_HQ - APPLE_PRORES_422_LT - APPLE_PRORES_422_PROXY - APPLE_PRORES_4444 - APPLE_PRORES_4444_XQ description: Use Profile (ProResCodecProfile) to specify the type of Apple ProRes codec to use for this output. ProresParControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. __integerMin32000Max192000: type: integer minimum: 32000 maximum: 192000 Av1AdaptiveQuantization: type: string enum: - false - LOW - MEDIUM - HIGH - HIGHER - MAX description: Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdaptiveQuantization). XavcEntropyEncoding: type: string enum: - AUTO - CABAC - CAVLC description: Optional. Choose a specific entropy encoding mode only when you want to override XAVC recommendations. If you choose the value auto, MediaConvert uses the mode that the XAVC file format specifies given this output's operating point. __integerMin32Max8182: type: integer minimum: 32 maximum: 8182 UpdatePresetResponse: type: object properties: Preset: allOf: - $ref: '#/components/schemas/Preset' - xml: name: preset description: A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process. DvbSubtitleStylePassthrough: type: string enum: - ENABLED - DISABLED description: 'Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses default settings for any missing style and position information in your input captions. Set Style passthrough to DISABLED, or leave blank, to ignore the style and position information from your input captions and use default settings: white text with black outlining, bottom-center positioning, and automatic sizing. Whether you set Style passthrough to enabled or not, you can also choose to manually override any of the individual style and position settings.' BurninDestinationSettings: type: object properties: Alignment: allOf: - $ref: '#/components/schemas/BurninSubtitleAlignment' - xml: name: alignment description: Specify the alignment of your captions. If no explicit x_position is provided, setting alignment to centered will placethe captions at the bottom center of the output. Similarly, setting a left alignment willalign 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. ApplyFontColor: allOf: - $ref: '#/components/schemas/BurninSubtitleApplyFontColor' - xml: name: applyFontColor description: Ignore this setting unless Style passthrough (StylePassthrough) is set to Enabled and Font color (FontColor) set to Black, Yellow, Red, Green, Blue, or Hex. Use Apply font color (ApplyFontColor) for additional font color controls. When you choose White text only (WHITE_TEXT_ONLY), or leave blank, your font color setting only applies to white text in your input captions. For example, if your font color setting is Yellow, and your input captions have red and white text, your output captions will have red and yellow text. When you choose ALL_TEXT, your font color setting applies to all of your output captions text. BackgroundColor: allOf: - $ref: '#/components/schemas/BurninSubtitleBackgroundColor' - xml: name: backgroundColor description: Specify the color of the rectangle behind the captions. Leave background color (BackgroundColor) blank and set Style passthrough (StylePassthrough) to enabled to use the background color data from your input captions, if present. BackgroundOpacity: allOf: - $ref: '#/components/schemas/__integerMin0Max255' - xml: name: backgroundOpacity description: Specify the opacity of the background rectangle. Enter a value from 0 to 255, where 0 is transparent and 255 is opaque. If Style passthrough (StylePassthrough) is set to enabled, leave blank to pass through the background style information in your input captions to your output captions. If Style passthrough is set to disabled, leave blank to use a value of 0 and remove all backgrounds from your output captions. FallbackFont: allOf: - $ref: '#/components/schemas/BurninSubtitleFallbackFont' - xml: name: fallbackFont description: Specify the font that you want the service to use for your burn in captions when your input captions specify a font that MediaConvert doesn't support. When you set Fallback font (FallbackFont) to best match (BEST_MATCH), or leave blank, MediaConvert uses a supported font that most closely matches the font that your input captions specify. When there are multiple unsupported fonts in your input captions, MediaConvert matches each font with the supported font that matches best. When you explicitly choose a replacement font, MediaConvert uses that font to replace all unsupported fonts from your input. FontColor: allOf: - $ref: '#/components/schemas/BurninSubtitleFontColor' - xml: name: fontColor description: Specify the color of the burned-in captions text. Leave Font color (FontColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font color data from your input captions, if present. FontOpacity: allOf: - $ref: '#/components/schemas/__integerMin0Max255' - xml: name: fontOpacity description: Specify the opacity of the burned-in captions. 255 is opaque; 0 is transparent. FontResolution: allOf: - $ref: '#/components/schemas/__integerMin96Max600' - xml: name: fontResolution description: Specify the Font resolution (FontResolution) in DPI (dots per inch). FontScript: allOf: - $ref: '#/components/schemas/FontScript' - xml: name: fontScript description: Set Font script (FontScript) to Automatically determined (AUTOMATIC), or leave blank, to automatically determine the font script in your input captions. Otherwise, set to Simplified Chinese (HANS) or Traditional Chinese (HANT) if your input font script uses Simplified or Traditional Chinese. FontSize: allOf: - $ref: '#/components/schemas/__integerMin0Max96' - xml: name: fontSize description: Specify the Font size (FontSize) in pixels. Must be a positive integer. Set to 0, or leave blank, for automatic font size. HexFontColor: allOf: - $ref: '#/components/schemas/__stringMin6Max8Pattern09aFAF609aFAF2' - xml: name: hexFontColor description: Ignore this setting unless your Font color is set to Hex. Enter either six or eight hexidecimal digits, representing red, green, and blue, with two optional extra digits for alpha. For example a value of 1122AABB is a red value of 0x11, a green value of 0x22, a blue value of 0xAA, and an alpha value of 0xBB. OutlineColor: allOf: - $ref: '#/components/schemas/BurninSubtitleOutlineColor' - xml: name: outlineColor description: Specify font outline color. Leave Outline color (OutlineColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font outline color data from your input captions, if present. OutlineSize: allOf: - $ref: '#/components/schemas/__integerMin0Max10' - xml: name: outlineSize description: Specify the Outline size (OutlineSize) of the caption text, in pixels. Leave Outline size blank and set Style passthrough (StylePassthrough) to enabled to use the outline size data from your input captions, if present. ShadowColor: allOf: - $ref: '#/components/schemas/BurninSubtitleShadowColor' - xml: name: shadowColor description: Specify the color of the shadow cast by the captions. Leave Shadow color (ShadowColor) blank and set Style passthrough (StylePassthrough) to enabled to use the shadow color data from your input captions, if present. ShadowOpacity: allOf: - $ref: '#/components/schemas/__integerMin0Max255' - xml: name: shadowOpacity description: Specify the opacity of the shadow. Enter a value from 0 to 255, where 0 is transparent and 255 is opaque. If Style passthrough (StylePassthrough) is set to Enabled, leave Shadow opacity (ShadowOpacity) blank to pass through the shadow style information in your input captions to your output captions. If Style passthrough is set to disabled, leave blank to use a value of 0 and remove all shadows from your output captions. ShadowXOffset: allOf: - $ref: '#/components/schemas/__integerMinNegative2147483648Max2147483647' - xml: name: shadowXOffset description: Specify 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. ShadowYOffset: allOf: - $ref: '#/components/schemas/__integerMinNegative2147483648Max2147483647' - xml: name: shadowYOffset description: Specify 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. Leave Shadow y-offset (ShadowYOffset) blank and set Style passthrough (StylePassthrough) to enabled to use the shadow y-offset data from your input captions, if present. StylePassthrough: allOf: - $ref: '#/components/schemas/BurnInSubtitleStylePassthrough' - xml: name: stylePassthrough description: 'Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses default settings for any missing style and position information in your input captions. Set Style passthrough to DISABLED, or leave blank, to ignore the style and position information from your input captions and use default settings: white text with black outlining, bottom-center positioning, and automatic sizing. Whether you set Style passthrough to enabled or not, you can also choose to manually override any of the individual style and position settings.' TeletextSpacing: allOf: - $ref: '#/components/schemas/BurninSubtitleTeletextSpacing' - xml: name: teletextSpacing description: Specify whether the text spacing (TeletextSpacing) in your captions is set by the captions grid, or varies depending on letter width. Choose fixed grid (FIXED_GRID) to conform to the spacing specified in the captions file more accurately. Choose proportional (PROPORTIONAL) to make the text easier to read for closed captions. XPosition: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: xPosition description: Specify the horizontal position (XPosition) of the captions, 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. YPosition: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: yPosition description: Specify the vertical position (YPosition) of the captions, 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. description: Burn-in is a captions delivery method, rather than a captions format. Burn-in writes the captions directly on your video frames, replacing pixels of video content with the captions. Set up burn-in captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/burn-in-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to BURN_IN. __integerMin0Max4000: type: integer minimum: 0 maximum: 4000 M2tsEbpAudioInterval: type: string enum: - VIDEO_AND_FIXED_INTERVALS - VIDEO_INTERVAL description: 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). BadRequestException: {} AacVbrQuality: type: string enum: - LOW - MEDIUM_LOW - MEDIUM_HIGH - HIGH description: VBR Quality Level - Only used if rate_control_mode is VBR. Mpeg2SlowPal: type: string enum: - DISABLED - ENABLED description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' H264InterlaceMode: type: string enum: - PROGRESSIVE - TOP_FIELD - BOTTOM_FIELD - FOLLOW_TOP_FIELD - FOLLOW_BOTTOM_FIELD description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. ConflictException: {} Preset: type: object required: - Settings - Name properties: Arn: allOf: - $ref: '#/components/schemas/__string' - xml: name: arn description: An identifier for this resource that is unique within all of AWS. Category: allOf: - $ref: '#/components/schemas/__string' - xml: name: category description: An optional category you create to organize your presets. CreatedAt: allOf: - $ref: '#/components/schemas/__timestampUnix' - xml: name: createdAt description: The timestamp in epoch seconds for preset creation. Description: allOf: - $ref: '#/components/schemas/__string' - xml: name: description description: An optional description you create for each preset. LastUpdated: allOf: - $ref: '#/components/schemas/__timestampUnix' - xml: name: lastUpdated description: The timestamp in epoch seconds when the preset was last updated. Name: allOf: - $ref: '#/components/schemas/__string' - xml: name: name description: A name you create for each preset. Each name must be unique within your account. Settings: allOf: - $ref: '#/components/schemas/PresetSettings' - xml: name: settings description: Settings for preset Type: allOf: - $ref: '#/components/schemas/Type' - xml: name: type description: 'A preset can be of two types: system or custom. System or built-in preset can''t be modified or deleted by the user.' description: A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process. MovMpeg2FourCCControl: type: string enum: - XDCAM - MPEG description: 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. AacCodingMode: type: string enum: - AD_RECEIVER_MIX - CODING_MODE_1_0 - CODING_MODE_1_1 - CODING_MODE_2_0 - CODING_MODE_5_1 description: 'The Coding mode that you specify determines the number of audio channels and the audio channel layout metadata in your AAC output. Valid coding modes depend on the Rate control mode and Profile that you select. The following list shows the number of audio channels and channel layout for each coding mode. * 1.0 Audio Description (Receiver Mix): One channel, C. Includes audio description data from your stereo input. For more information see ETSI TS 101 154 Annex E. * 1.0 Mono: One channel, C. * 2.0 Stereo: Two channels, L, R. * 5.1 Surround: Five channels, C, L, R, Ls, Rs, LFE.' ClipLimits: type: object properties: MaximumRGBTolerance: allOf: - $ref: '#/components/schemas/__integerMin90Max105' - xml: name: maximumRGBTolerance description: Specify the Maximum RGB color sample range tolerance for your output. MediaConvert corrects any YUV values that, when converted to RGB, would be outside the upper tolerance that you specify. Enter an integer from 90 to 105 as an offset percentage to the maximum possible value. Leave blank to use the default value 100. When you specify a value for Maximum RGB tolerance, you must set Sample range conversion to Limited range clip. MaximumYUV: allOf: - $ref: '#/components/schemas/__integerMin920Max1023' - xml: name: maximumYUV description: Specify the Maximum YUV color sample limit. MediaConvert conforms any pixels in your input above the value that you specify to typical limited range bounds. Enter an integer from 920 to 1023. Leave blank to use the default value 940. The value that you enter applies to 10-bit ranges. For 8-bit ranges, MediaConvert automatically scales this value down. When you specify a value for Maximum YUV, you must set Sample range conversion to Limited range clip. MinimumRGBTolerance: allOf: - $ref: '#/components/schemas/__integerMinNegative5Max10' - xml: name: minimumRGBTolerance description: Specify the Minimum RGB color sample range tolerance for your output. MediaConvert corrects any YUV values that, when converted to RGB, would be outside the lower tolerance that you specify. Enter an integer from -5 to 10 as an offset percentage to the minimum possible value. Leave blank to use the default value 0. When you specify a value for Minimum RGB tolerance, you must set Sample range conversion to Limited range clip. MinimumYUV: allOf: - $ref: '#/components/schemas/__integerMin0Max128' - xml: name: minimumYUV description: Specify the Minimum YUV color sample limit. MediaConvert conforms any pixels in your input below the value that you specify to typical limited range bounds. Enter an integer from 0 to 128. Leave blank to use the default value 64. The value that you enter applies to 10-bit ranges. For 8-bit ranges, MediaConvert automatically scales this value down. When you specify a value for Minumum YUV, you must set Sample range conversion to Limited range clip. description: Specify YUV limits and RGB tolerances when you set Sample range conversion to Limited range clip. __integerMin32000Max3024000: type: integer minimum: 32000 maximum: 3024000 M2tsEbpPlacement: type: string enum: - VIDEO_AND_AUDIO_PIDS - VIDEO_PID description: 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). AfdSignaling: type: string enum: - NONE - AUTO - FIXED description: This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes 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. Eac3AtmosDynamicRangeControl: type: string enum: - SPECIFIED - INITIALIZE_FROM_SOURCE description: 'Specify whether MediaConvert should use any dynamic range control metadata from your input file. Keep the default value, Custom (SPECIFIED), to provide dynamic range control values in your job settings. Choose Follow source (INITIALIZE_FROM_SOURCE) to use the metadata from your input. Related settings--Use these settings to specify your dynamic range control values: Dynamic range compression line (DynamicRangeCompressionLine) and Dynamic range compression RF (DynamicRangeCompressionRf). When you keep the value Custom (SPECIFIED) for Dynamic range control (DynamicRangeControl) and you don''t specify values for the related settings, MediaConvert uses default values for those settings.' H264SlowPal: type: string enum: - DISABLED - ENABLED description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' H264Syntax: type: string enum: - DEFAULT - RP2027 description: Produces a bitstream compliant with SMPTE RP-2027. __integerMin32000Max384000: type: integer minimum: 32000 maximum: 384000 XavcFlickerAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (XavcAdaptiveQuantization). When you do so, MediaConvert automatically applies the best types of quantization for your video content. Include this setting in your JSON job specification only when you choose to change the default value for Adaptive quantization. Enable this setting to have the encoder reduce I-frame pop. I-frame pop appears as a visual flicker that can arise when the encoder saves bits by copying some macroblocks many times from frame to frame, and then refreshes them at the I-frame. When you enable this setting, the encoder updates these macroblocks slightly more often to smooth out the flicker. This setting is disabled by default. Related setting: In addition to enabling this setting, you must also set Adaptive quantization (adaptiveQuantization) to a value other than Off (OFF) or Auto (AUTO). Use Adaptive quantization to adjust the degree of smoothing that Flicker adaptive quantization provides.' __integerMin4Max12: type: integer minimum: 4 maximum: 12 Hdr10Metadata: type: object properties: BluePrimaryX: allOf: - $ref: '#/components/schemas/__integerMin0Max50000' - xml: name: bluePrimaryX description: HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction. BluePrimaryY: allOf: - $ref: '#/components/schemas/__integerMin0Max50000' - xml: name: bluePrimaryY description: HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction. GreenPrimaryX: allOf: - $ref: '#/components/schemas/__integerMin0Max50000' - xml: name: greenPrimaryX description: HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction. GreenPrimaryY: allOf: - $ref: '#/components/schemas/__integerMin0Max50000' - xml: name: greenPrimaryY description: HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction. MaxContentLightLevel: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: maxContentLightLevel description: Maximum light level among all samples in the coded video sequence, in units of candelas per square meter. This setting doesn't have a default value; you must specify a value that is suitable for the content. MaxFrameAverageLightLevel: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: maxFrameAverageLightLevel description: Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter. This setting doesn't have a default value; you must specify a value that is suitable for the content. MaxLuminance: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: maxLuminance description: Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter. MinLuminance: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: minLuminance description: Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meter RedPrimaryX: allOf: - $ref: '#/components/schemas/__integerMin0Max50000' - xml: name: redPrimaryX description: HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction. RedPrimaryY: allOf: - $ref: '#/components/schemas/__integerMin0Max50000' - xml: name: redPrimaryY description: HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction. WhitePointX: allOf: - $ref: '#/components/schemas/__integerMin0Max50000' - xml: name: whitePointX description: HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction. WhitePointY: allOf: - $ref: '#/components/schemas/__integerMin0Max50000' - xml: name: whitePointY description: HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction. description: Use these settings to specify static color calibration metadata, as defined by SMPTE ST 2086. These values don't affect the pixel values that are encoded in the video stream. They are intended to help the downstream video player display content in a way that reflects the intentions of the the content creator. VideoPreprocessor: type: object properties: ColorCorrector: allOf: - $ref: '#/components/schemas/ColorCorrector' - xml: name: colorCorrector description: Use these settings to convert the color space or to modify properties such as hue and contrast for this output. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/converting-the-color-space.html. Deinterlacer: allOf: - $ref: '#/components/schemas/Deinterlacer' - xml: name: deinterlacer description: Use the deinterlacer to produce smoother motion and a clearer picture. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-scan-type.html. DolbyVision: allOf: - $ref: '#/components/schemas/DolbyVision' - xml: name: dolbyVision description: Enable Dolby Vision feature to produce Dolby Vision compatible video output. Hdr10Plus: allOf: - $ref: '#/components/schemas/Hdr10Plus' - xml: name: hdr10Plus description: Enable HDR10+ analyis and metadata injection. Compatible with HEVC only. ImageInserter: allOf: - $ref: '#/components/schemas/ImageInserter' - xml: name: imageInserter description: 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. NoiseReducer: allOf: - $ref: '#/components/schemas/NoiseReducer' - xml: name: noiseReducer description: Enable the Noise reducer 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. When you enable Noise reducer, you must also select a value for Noise reducer filter. For AVC outputs, when you include Noise reducer, you cannot include the Bandwidth reduction filter. PartnerWatermarking: allOf: - $ref: '#/components/schemas/PartnerWatermarking' - xml: name: partnerWatermarking description: If you work with a third party video watermarking partner, use the group of settings that correspond with your watermarking partner to include watermarks in your output. TimecodeBurnin: allOf: - $ref: '#/components/schemas/TimecodeBurnin' - xml: name: timecodeBurnin description: Settings for burning the output timecode and specified prefix into the output. description: Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default. H265TemporalIds: type: string enum: - DISABLED - ENABLED description: '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.' XavcHdProfileBitrateClass: type: string enum: - BITRATE_CLASS_25 - BITRATE_CLASS_35 - BITRATE_CLASS_50 description: Specify the XAVC HD (Long GOP) Bitrate Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. Eac3AtmosDownmixControl: type: string enum: - SPECIFIED - INITIALIZE_FROM_SOURCE description: 'Specify whether MediaConvert should use any downmix metadata from your input file. Keep the default value, Custom (SPECIFIED) to provide downmix values in your job settings. Choose Follow source (INITIALIZE_FROM_SOURCE) to use the metadata from your input. Related settings--Use these settings to specify your downmix values: Left only/Right only surround (LoRoSurroundMixLevel), Left total/Right total surround (LtRtSurroundMixLevel), Left total/Right total center (LtRtCenterMixLevel), Left only/Right only center (LoRoCenterMixLevel), and Stereo downmix (StereoDownmix). When you keep Custom (SPECIFIED) for Downmix control (DownmixControl) and you don''t specify values for the related settings, MediaConvert uses default values for those settings.' H265FlickerAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'Enable this setting to have the encoder reduce I-frame pop. I-frame pop appears as a visual flicker that can arise when the encoder saves bits by copying some macroblocks many times from frame to frame, and then refreshes them at the I-frame. When you enable this setting, the encoder updates these macroblocks slightly more often to smooth out the flicker. This setting is disabled by default. Related setting: In addition to enabling this setting, you must also set adaptiveQuantization to a value other than Off (OFF).' __integerMin0Max2147483647: type: integer minimum: 0 maximum: 2147483647 M2tsDataPtsControl: type: string enum: - AUTO - ALIGN_TO_VIDEO description: If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values). Keep the default value (AUTO) to allow all PTS values. DolbyVisionMapping: type: string enum: - HDR10_NOMAP - HDR10_1000 description: Required when you set Dolby Vision Profile to Profile 8.1. When you set Content mapping to None, content mapping is not applied to the HDR10-compatible signal. Depending on the source peak nit level, clipping might occur on HDR devices without Dolby Vision. When you set Content mapping to HDR10 1000, the transcoder creates a 1,000 nits peak HDR10-compatible signal by applying static content mapping to the source. This mode is speed-optimized for PQ10 sources with metadata that is created from analysis. For graded Dolby Vision content, be aware that creative intent might not be guaranteed with extreme 1,000 nits trims. Mpeg2CodecProfile: type: string enum: - MAIN - PROFILE_422 description: Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. AiffSettings: type: object properties: BitDepth: allOf: - $ref: '#/components/schemas/__integerMin16Max24' - xml: name: bitDepth description: Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track. Channels: allOf: - $ref: '#/components/schemas/__integerMin1Max64' - xml: name: channels description: Specify the number of channels in this output audio track. Valid values are 1 and even numbers up to 64. For example, 1, 2, 4, 6, and so on, up to 64. SampleRate: allOf: - $ref: '#/components/schemas/__integerMin8000Max192000' - xml: name: sampleRate description: Sample rate in hz. description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF. MovReference: type: string enum: - SELF_CONTAINED - EXTERNAL description: Always keep the default value (SELF_CONTAINED) for this setting. H264SceneChangeDetect: type: string enum: - DISABLED - ENABLED - TRANSITION_DETECTION description: Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. If this output uses QVBR, choose Transition detection (TRANSITION_DETECTION) for further video quality improvement. For more information about QVBR, see https://docs.aws.amazon.com/console/mediaconvert/cbr-vbr-qvbr. H264RepeatPps: type: string enum: - DISABLED - ENABLED description: Places a PPS header on each encoded picture, even if repeated. BandwidthReductionFilterSharpening: type: string enum: - LOW - MEDIUM - HIGH - false description: Optionally specify the level of sharpening to apply when you use the Bandwidth reduction filter. Sharpening adds contrast to the edges of your video content and can reduce softness. Keep the default value Off to apply no sharpening. Set Sharpening strength to Low to apply a minimal amount of sharpening, or High to apply a maximum amount of sharpening. H264AdaptiveQuantization: type: string enum: - false - AUTO - LOW - MEDIUM - HIGH - HIGHER - MAX description: 'Keep the default value, Auto (AUTO), for this setting to have MediaConvert automatically apply the best types of quantization for your video content. When you want to apply your quantization settings manually, you must set H264AdaptiveQuantization to a value other than Auto (AUTO). Use this setting to specify the strength of any adaptive quantization filters that you enable. If you don''t want MediaConvert to do any adaptive quantization in this transcode, set Adaptive quantization (H264AdaptiveQuantization) to Off (OFF). Related settings: The value that you choose here applies to the following settings: H264FlickerAdaptiveQuantization, H264SpatialAdaptiveQuantization, and H264TemporalAdaptiveQuantization.' XavcHdProfileQualityTuningLevel: type: string enum: - SINGLE_PASS - SINGLE_PASS_HQ - MULTI_PASS_HQ description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. Vp8RateControlMode: type: string enum: - VBR description: With the VP8 codec, you can use only the variable bitrate (VBR) rate control mode. DvbSubtitleApplyFontColor: type: string enum: - WHITE_TEXT_ONLY - ALL_TEXT description: Ignore this setting unless Style Passthrough (StylePassthrough) is set to Enabled and Font color (FontColor) set to Black, Yellow, Red, Green, Blue, or Hex. Use Apply font color (ApplyFontColor) for additional font color controls. When you choose White text only (WHITE_TEXT_ONLY), or leave blank, your font color setting only applies to white text in your input captions. For example, if your font color setting is Yellow, and your input captions have red and white text, your output captions will have red and yellow text. When you choose ALL_TEXT, your font color setting applies to all of your output captions text. Ac3BitstreamMode: type: string enum: - COMPLETE_MAIN - COMMENTARY - DIALOGUE - EMERGENCY - HEARING_IMPAIRED - MUSIC_AND_EFFECTS - VISUALLY_IMPAIRED - VOICE_OVER description: Specify the bitstream mode for the AC-3 stream that the encoder emits. For more information about the AC3 bitstream mode, see ATSC A/52-2012 (Annex E). DropFrameTimecode: type: string enum: - DISABLED - ENABLED description: 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. __integerMin1Max2147483647: type: integer minimum: 1 maximum: 2147483647 Mpeg2SpatialAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (adaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.' __stringMin14PatternS3BmpBMPPngPNGTgaTGAHttpsBmpBMPPngPNGTgaTGA: type: string pattern: ^((s3://(.*?)\.(bmp|BMP|png|PNG|tga|TGA))|(https?://(.*?)\.(bmp|BMP|png|PNG|tga|TGA)(\?([^&=]+=[^&]+&)*[^&=]+=[^&]+)?))$ minLength: 14 __integerMin22050Max48000: type: integer minimum: 22050 maximum: 48000 H265Telecine: type: string enum: - NONE - SOFT - HARD description: '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.' ProresFramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. AudioCodec: type: string enum: - AAC - MP2 - MP3 - WAV - AIFF - AC3 - EAC3 - EAC3_ATMOS - VORBIS - OPUS - PASSTHROUGH description: 'Choose the audio codec for this output. Note that the option Dolby Digital passthrough (PASSTHROUGH) applies only to Dolby Digital and Dolby Digital Plus audio inputs. Make sure that you choose a codec that''s supported with your output container: https://docs.aws.amazon.com/mediaconvert/latest/ug/reference-codecs-containers.html#reference-codecs-containers-output-audio For audio-only outputs, make sure that both your input audio codec and your output audio codec are supported for audio-only workflows. For more information, see: https://docs.aws.amazon.com/mediaconvert/latest/ug/reference-codecs-containers-input.html#reference-codecs-containers-input-audio-only and https://docs.aws.amazon.com/mediaconvert/latest/ug/reference-codecs-containers.html#audio-only-output' AacRateControlMode: type: string enum: - CBR - VBR description: Rate Control Mode. TeletextDestinationSettings: type: object properties: PageNumber: allOf: - $ref: '#/components/schemas/__stringMin3Max3Pattern1809aFAF09aEAE' - xml: name: pageNumber description: 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. PageTypes: allOf: - $ref: '#/components/schemas/__listOfTeletextPageType' - xml: name: pageTypes description: Specify the page types for this Teletext page. If you don't specify a value here, the service sets the page type to the default value Subtitle (PAGE_TYPE_SUBTITLE). If you pass through the entire set of Teletext data, don't use this field. When you pass through a set of Teletext pages, your output has the same page types as your input. description: Settings related to teletext captions. Set up teletext captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/teletext-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to TELETEXT. Mp4FreeSpaceBox: type: string enum: - INCLUDE - EXCLUDE description: Inserts a free-space box immediately after the moov box. __integerMin8000Max192000: type: integer minimum: 8000 maximum: 192000 PresetSettings: type: object properties: AudioDescriptions: allOf: - $ref: '#/components/schemas/__listOfAudioDescription' - xml: name: audioDescriptions description: (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. CaptionDescriptions: allOf: - $ref: '#/components/schemas/__listOfCaptionDescriptionPreset' - xml: name: captionDescriptions description: This object holds groups of settings related to captions for one output. For each output that has captions, include one instance of CaptionDescriptions. ContainerSettings: allOf: - $ref: '#/components/schemas/ContainerSettings' - xml: name: containerSettings description: Container specific settings. VideoDescription: allOf: - $ref: '#/components/schemas/VideoDescription' - xml: name: videoDescription description: VideoDescription contains a group of video encoding settings. The specific video settings depend on the video codec that you choose for the property codec. Include one instance of VideoDescription per output. description: Settings for preset XavcTemporalAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (adaptiveQuantization). When you do so, MediaConvert automatically applies the best types of quantization for your video content. Include this setting in your JSON job specification only when you choose to change the default value for Adaptive quantization. For this setting, keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren''t moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn''t have moving objects with sharp edges, such as sports athletes'' faces, you might choose to disable this feature. Related setting: When you enable temporal adaptive quantization, adjust the strength of the filter with the setting Adaptive quantization (adaptiveQuantization).' NoiseReducerTemporalFilterSettings: type: object properties: AggressiveMode: allOf: - $ref: '#/components/schemas/__integerMin0Max4' - xml: name: aggressiveMode description: Use Aggressive mode for content that has complex motion. Higher values produce stronger temporal filtering. This filters highly complex scenes more aggressively and creates better VQ for low bitrate outputs. PostTemporalSharpening: allOf: - $ref: '#/components/schemas/NoiseFilterPostTemporalSharpening' - xml: name: postTemporalSharpening description: When you set Noise reducer (noiseReducer) to Temporal (TEMPORAL), the bandwidth and sharpness of your output is reduced. You can optionally use Post temporal sharpening (postTemporalSharpening) to apply sharpening to the edges of your output. Note that Post temporal sharpening will also make the bandwidth reduction from the Noise reducer smaller. The default behavior, Auto (AUTO), allows the transcoder to determine whether to apply sharpening, depending on your input type and quality. When you set Post temporal sharpening to Enabled (ENABLED), specify how much sharpening is applied using Post temporal sharpening strength (postTemporalSharpeningStrength). Set Post temporal sharpening to Disabled (DISABLED) to not apply sharpening. PostTemporalSharpeningStrength: allOf: - $ref: '#/components/schemas/NoiseFilterPostTemporalSharpeningStrength' - xml: name: postTemporalSharpeningStrength description: Use Post temporal sharpening strength (postTemporalSharpeningStrength) to define the amount of sharpening the transcoder applies to your output. Set Post temporal sharpening strength to Low (LOW), Medium (MEDIUM), or High (HIGH) to indicate the amount of sharpening. Speed: allOf: - $ref: '#/components/schemas/__integerMinNegative1Max3' - xml: name: speed description: The speed of the filter (higher number is faster). Low setting reduces bit rate at the cost of transcode time, high setting improves transcode time at the cost of bit rate. Strength: allOf: - $ref: '#/components/schemas/__integerMin0Max16' - xml: name: strength description: 'Specify the strength of the noise reducing filter on this output. Higher values produce stronger filtering. We recommend the following value ranges, depending on the result that you want: * 0-2 for complexity reduction with minimal sharpness loss * 2-8 for complexity reduction with image preservation * 8-16 for a high level of complexity reduction' description: Noise reducer filter settings for temporal filter. AvcIntraClass: type: string enum: - CLASS_50 - CLASS_100 - CLASS_200 - CLASS_4K_2K description: Specify the AVC-Intra class of your output. The AVC-Intra class selection determines the output video bit rate depending on the frame rate of the output. Outputs with higher class values have higher bitrates and improved image quality. Note that for Class 4K/2K, MediaConvert supports only 4:2:2 chroma subsampling. H264FramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Xavc4kProfileSettings: type: object properties: BitrateClass: allOf: - $ref: '#/components/schemas/Xavc4kProfileBitrateClass' - xml: name: bitrateClass description: Specify the XAVC 4k (Long GOP) Bitrate Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. CodecProfile: allOf: - $ref: '#/components/schemas/Xavc4kProfileCodecProfile' - xml: name: codecProfile description: Specify the codec profile for this output. Choose High, 8-bit, 4:2:0 (HIGH) or High, 10-bit, 4:2:2 (HIGH_422). These profiles are specified in ITU-T H.264. FlickerAdaptiveQuantization: allOf: - $ref: '#/components/schemas/XavcFlickerAdaptiveQuantization' - xml: name: flickerAdaptiveQuantization description: 'The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (XavcAdaptiveQuantization). When you do so, MediaConvert automatically applies the best types of quantization for your video content. Include this setting in your JSON job specification only when you choose to change the default value for Adaptive quantization. Enable this setting to have the encoder reduce I-frame pop. I-frame pop appears as a visual flicker that can arise when the encoder saves bits by copying some macroblocks many times from frame to frame, and then refreshes them at the I-frame. When you enable this setting, the encoder updates these macroblocks slightly more often to smooth out the flicker. This setting is disabled by default. Related setting: In addition to enabling this setting, you must also set Adaptive quantization (adaptiveQuantization) to a value other than Off (OFF) or Auto (AUTO). Use Adaptive quantization to adjust the degree of smoothing that Flicker adaptive quantization provides.' GopBReference: allOf: - $ref: '#/components/schemas/XavcGopBReference' - xml: name: gopBReference description: Specify whether the encoder uses B-frames as reference frames for other pictures in the same GOP. Choose Allow (ENABLED) to allow the encoder to use B-frames as reference frames. Choose Don't allow (DISABLED) to prevent the encoder from using B-frames as reference frames. GopClosedCadence: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: gopClosedCadence description: 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. HrdBufferSize: allOf: - $ref: '#/components/schemas/__integerMin0Max1152000000' - xml: name: hrdBufferSize description: Specify the size of the buffer that MediaConvert uses in the HRD buffer model for this output. Specify this value in bits; for example, enter five megabits as 5000000. When you don't set this value, or you set it to zero, MediaConvert calculates the default by doubling the bitrate of this output point. QualityTuningLevel: allOf: - $ref: '#/components/schemas/Xavc4kProfileQualityTuningLevel' - xml: name: qualityTuningLevel description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. Slices: allOf: - $ref: '#/components/schemas/__integerMin8Max12' - xml: name: slices description: 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. description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_4K. __integerMin0Max7: type: integer minimum: 0 maximum: 7 XavcSpatialAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (adaptiveQuantization). When you do so, MediaConvert automatically applies the best types of quantization for your video content. Include this setting in your JSON job specification only when you choose to change the default value for Adaptive quantization. For this setting, keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (adaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.' H265SampleAdaptiveOffsetFilterMode: type: string enum: - DEFAULT - ADAPTIVE - false description: Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content MovSettings: type: object properties: ClapAtom: allOf: - $ref: '#/components/schemas/MovClapAtom' - xml: name: clapAtom description: When enabled, include 'clap' atom if appropriate for the video output settings. CslgAtom: allOf: - $ref: '#/components/schemas/MovCslgAtom' - xml: name: cslgAtom description: 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: allOf: - $ref: '#/components/schemas/MovMpeg2FourCCControl' - xml: name: mpeg2FourCCControl description: 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: allOf: - $ref: '#/components/schemas/MovPaddingControl' - xml: name: paddingControl description: 'Unless you need Omneon compatibility: Keep the default value, None. To make this output compatible with Omneon: Choose Omneon. When you do, MediaConvert increases the length of the ''elst'' edit list atom. Note that this might cause file rejections when a recipient of the output file doesn''t expect this extra padding.' Reference: allOf: - $ref: '#/components/schemas/MovReference' - xml: name: reference description: Always keep the default value (SELF_CONTAINED) for this setting. description: These settings relate to your QuickTime MOV output container. __integerMin0Max1466400000: type: integer minimum: 0 maximum: 1466400000 Rectangle: type: object properties: Height: allOf: - $ref: '#/components/schemas/__integerMin2Max2147483647' - xml: name: height description: Height of rectangle in pixels. Specify only even numbers. Width: allOf: - $ref: '#/components/schemas/__integerMin2Max2147483647' - xml: name: width description: Width of rectangle in pixels. Specify only even numbers. X: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: x description: The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers. Y: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: y description: The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers. description: Use Rectangle to identify a specific area of the video frame. __integerMin6000Max1024000: type: integer minimum: 6000 maximum: 1024000 __integerMin1Max10000000: type: integer minimum: 1 maximum: 10000000 ColorSpaceConversion: type: string enum: - NONE - FORCE_601 - FORCE_709 - FORCE_HDR10 - FORCE_HLG_2020 - FORCE_P3DCI - FORCE_P3D65_SDR - FORCE_P3D65_HDR description: "Specify the color space you want for this output. The service supports conversion between HDR formats, between SDR formats, from SDR to HDR, and from HDR to SDR. SDR to HDR conversion doesn't upgrade the dynamic range. The converted video has an HDR format, but visually appears the same as an unconverted output. HDR to SDR conversion uses tone mapping to approximate the outcome of manually regrading from HDR to SDR. When you specify an output color space, MediaConvert uses the following color space metadata, which includes color primaries, transfer characteristics, and matrix coefficients:\n * HDR 10: BT.2020, PQ, BT.2020 non-constant\n * HLG 2020: BT.2020, HLG, BT.2020 non-constant\n * P3DCI (Theater): DCIP3, SMPTE 428M, BT.709\n * P3D65 (SDR): Display P3, sRGB, BT.709\n * P3D65 (HDR): Display P3, PQ, BT.709" CmfcAudioDuration: type: string enum: - DEFAULT_CODEC_DURATION - MATCH_VIDEO_DURATION description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. __integerMin1Max32: type: integer minimum: 1 maximum: 32 Eac3PassthroughControl: type: string enum: - WHEN_POSSIBLE - NO_PASSTHROUGH description: 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. Mp3RateControlMode: type: string enum: - CBR - VBR description: Specify whether the service encodes this MP3 audio output with a constant bitrate (CBR) or a variable bitrate (VBR). CmfcDescriptiveVideoServiceFlag: type: string enum: - DONT_FLAG - FLAG description: Specify whether to flag this audio track as descriptive video service (DVS) in your HLS parent manifest. When you choose Flag (FLAG), MediaConvert includes the parameter CHARACTERISTICS="public.accessibility.describes-video" in the EXT-X-MEDIA entry for this track. When you keep the default choice, Don't flag (DONT_FLAG), MediaConvert leaves this parameter out. The DVS flag can help with accessibility on Apple devices. For more information, see the Apple documentation. NoiseFilterPostTemporalSharpeningStrength: type: string enum: - LOW - MEDIUM - HIGH description: Use Post temporal sharpening strength (postTemporalSharpeningStrength) to define the amount of sharpening the transcoder applies to your output. Set Post temporal sharpening strength to Low (LOW), Medium (MEDIUM), or High (HIGH) to indicate the amount of sharpening. Eac3AtmosDynamicRangeCompressionRf: type: string enum: - NONE - FILM_STANDARD - FILM_LIGHT - MUSIC_STANDARD - MUSIC_LIGHT - SPEECH description: 'Choose the Dolby dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby stream for the RF operating mode. Default value: Film light (ATMOS_STORAGE_DDP_COMPR_FILM_LIGHT) Related setting: To have MediaConvert use the value you specify here, keep the default value, Custom (SPECIFIED) for the setting Dynamic range control (DynamicRangeControl). Otherwise, MediaConvert ignores Dynamic range compression RF (DynamicRangeCompressionRf). For information about the Dolby DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' H264GopSizeUnits: type: string enum: - FRAMES - SECONDS - AUTO description: Specify how the transcoder determines GOP size for this output. We recommend that you have the transcoder automatically choose this value for you based on characteristics of your input video. To enable this automatic behavior, choose Auto (AUTO) and and leave GOP size (GopSize) blank. By default, if you don't specify GOP mode control (GopSizeUnits), MediaConvert will use automatic behavior. If your output group specifies HLS, DASH, or CMAF, set GOP mode control to Auto and leave GOP size blank in each output in your output group. To explicitly specify the GOP length, choose Specified, frames (FRAMES) or Specified, seconds (SECONDS) and then provide the GOP length in the related setting GOP size (GopSize). XavcSlowPal: type: string enum: - DISABLED - ENABLED description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output by relabeling the video frames and resampling your audio. Note that enabling this setting will slightly reduce the duration of your video. Related settings: You must also set Frame rate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Mpeg2Syntax: type: string enum: - DEFAULT - D_10 description: 'Specify whether this output''s video uses the D10 syntax. Keep the default value to not use the syntax. Related settings: When you choose D10 (D_10) for your MXF profile (profile), you must also set this value to D10 (D_10).' H265AdaptiveQuantization: type: string enum: - false - LOW - MEDIUM - HIGH - HIGHER - MAX - AUTO description: When you set Adaptive Quantization (H265AdaptiveQuantization) to Auto (AUTO), or leave blank, MediaConvert automatically applies quantization to improve the video quality of your output. Set Adaptive Quantization to Low (LOW), Medium (MEDIUM), High (HIGH), Higher (HIGHER), or Max (MAX) to manually control the strength of the quantization filter. When you do, you can specify a value for Spatial Adaptive Quantization (H265SpatialAdaptiveQuantization), Temporal Adaptive Quantization (H265TemporalAdaptiveQuantization), and Flicker Adaptive Quantization (H265FlickerAdaptiveQuantization), to further control the quantization filter. Set Adaptive Quantization to Off (OFF) to apply no quantization to your output. Mp2Settings: type: object properties: Bitrate: allOf: - $ref: '#/components/schemas/__integerMin32000Max384000' - xml: name: bitrate description: Specify the average bitrate in bits per second. Channels: allOf: - $ref: '#/components/schemas/__integerMin1Max2' - xml: name: channels description: 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: allOf: - $ref: '#/components/schemas/__integerMin32000Max48000' - xml: name: sampleRate description: Sample rate in hz. description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2. MpdManifestMetadataSignaling: type: string enum: - ENABLED - DISABLED description: To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messages, the InbandEventStream element schemeIdUri will be same value that you specify for ID3 metadata scheme ID URI. For SCTE35 event messages, the InbandEventStream element schemeIdUri will be "urn:scte:scte35:2013:bin". To leave these elements out of your output MPD manifest, set Manifest metadata signaling to Disabled. To enable Manifest metadata signaling, you must also set SCTE-35 source to Passthrough, ESAM SCTE-35 to insert, or ID3 metadata (TimedMetadata) to Passthrough. __integerMin1Max100: type: integer minimum: 1 maximum: 100 H264FramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. Eac3MetadataControl: type: string enum: - FOLLOW_INPUT - USE_CONFIGURED description: 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. __integerMin1Max1001: type: integer minimum: 1 maximum: 1001 H265QualityTuningLevel: type: string enum: - SINGLE_PASS - SINGLE_PASS_HQ - MULTI_PASS_HQ description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. __listOfOutputChannelMapping: type: array items: $ref: '#/components/schemas/OutputChannelMapping' M2tsScte35Esam: type: object properties: Scte35EsamPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: scte35EsamPid description: Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM. description: Settings for SCTE-35 signals from ESAM. Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml). M2tsRateMode: type: string enum: - VBR - CBR description: 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. ColorMetadata: type: string enum: - IGNORE - INSERT description: Choose Insert (INSERT) for this setting to include color metadata in this output. Choose Ignore (IGNORE) to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default. Av1Settings: type: object properties: AdaptiveQuantization: allOf: - $ref: '#/components/schemas/Av1AdaptiveQuantization' - xml: name: adaptiveQuantization description: Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdaptiveQuantization). BitDepth: allOf: - $ref: '#/components/schemas/Av1BitDepth' - xml: name: bitDepth description: Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT_8) or 10-bit (BIT_10). FramerateControl: allOf: - $ref: '#/components/schemas/Av1FramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/Av1FramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. GopSize: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: gopSize description: Specify the GOP length (keyframe interval) in frames. With AV1, MediaConvert doesn't support GOP length in seconds. This value must be greater than zero and preferably equal to 1 + ((numberBFrames + 1) * x), where x is an integer value. MaxBitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1152000000' - xml: name: maxBitrate description: Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR. NumberBFramesBetweenReferenceFrames: allOf: - $ref: '#/components/schemas/__integerMin0Max15' - xml: name: numberBFramesBetweenReferenceFrames description: Specify from the number of B-frames, in the range of 0-15. For AV1 encoding, we recommend using 7 or 15. Choose a larger number for a lower bitrate and smaller file size; choose a smaller number for better video quality. QvbrSettings: allOf: - $ref: '#/components/schemas/Av1QvbrSettings' - xml: name: qvbrSettings description: Settings for quality-defined variable bitrate encoding with the H.265 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode). RateControlMode: allOf: - $ref: '#/components/schemas/Av1RateControlMode' - xml: name: rateControlMode description: '''With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''''t use CBR or VBR.''' Slices: allOf: - $ref: '#/components/schemas/__integerMin1Max32' - xml: name: slices description: Specify the number of slices per picture. This value must be 1, 2, 4, 8, 16, or 32. For progressive pictures, this value must be less than or equal to the number of macroblock rows. For interlaced pictures, this value must be less than or equal to half the number of macroblock rows. SpatialAdaptiveQuantization: allOf: - $ref: '#/components/schemas/Av1SpatialAdaptiveQuantization' - xml: name: spatialAdaptiveQuantization description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (adaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.' description: Required when you set Codec, under VideoDescription>CodecSettings to the value AV1. __integerMin0Max65535: type: integer minimum: 0 maximum: 65535 __integerMin0Max3: type: integer minimum: 0 maximum: 3 Xavc4kIntraCbgProfileClass: type: string enum: - CLASS_100 - CLASS_300 - CLASS_480 description: Specify the XAVC Intra 4k (CBG) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. Vp9QualityTuningLevel: type: string enum: - MULTI_PASS - MULTI_PASS_HQ description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, multi-pass encoding. H264FieldEncoding: type: string enum: - PAFF - FORCE_FIELD - MBAFF description: The video encoding method for your MPEG-4 AVC output. Keep the default value, PAFF, to have MediaConvert use PAFF encoding for interlaced outputs. Choose Force field (FORCE_FIELD) to disable PAFF encoding and create separate interlaced fields. Choose MBAFF to disable PAFF and have MediaConvert use MBAFF encoding for interlaced outputs. ListPresetsResponse: type: object properties: NextToken: allOf: - $ref: '#/components/schemas/__string' - xml: name: nextToken description: Use this string to request the next batch of presets. Presets: allOf: - $ref: '#/components/schemas/__listOfPreset' - xml: name: presets description: List of presets MovClapAtom: type: string enum: - INCLUDE - EXCLUDE description: When enabled, include 'clap' atom if appropriate for the video output settings. NoiseReducerFilterSettings: type: object properties: Strength: allOf: - $ref: '#/components/schemas/__integerMin0Max3' - xml: name: strength description: Relative strength of noise reducing filter. Higher values produce stronger filtering. description: Settings for a noise reducer filter ImscStylePassthrough: type: string enum: - ENABLED - DISABLED description: Keep this setting enabled to have MediaConvert use the font style and position information from the captions source in the output. This option is available only when your input captions are IMSC, SMPTE-TT, or TTML. Disable this setting for simplified output captions. H264DynamicSubGop: type: string enum: - ADAPTIVE - STATIC description: Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). __integerMin1Max6: type: integer minimum: 1 maximum: 6 Vp8QualityTuningLevel: type: string enum: - MULTI_PASS - MULTI_PASS_HQ description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, multi-pass encoding. AudioChannelTaggingSettings: type: object properties: ChannelTag: allOf: - $ref: '#/components/schemas/AudioChannelTag' - xml: name: channelTag description: You can add a tag for this mono-channel audio track to mimic its placement in a multi-channel layout. For example, if this track is the left surround channel, choose Left surround (LS). description: When you mimic a multi-channel audio layout with multiple mono-channel tracks, you can tag each channel layout manually. For example, you would tag the tracks that contain your left, right, and center audio with Left (L), Right (R), and Center (C), respectively. When you don't specify a value, MediaConvert labels your track as Center (C) by default. To use audio layout tagging, your output must be in a QuickTime (.mov) container; your audio codec must be AAC, WAV, or AIFF; and you must set up your audio track to have only one channel. __integerMin0Max1: type: integer minimum: 0 maximum: 1 Xavc4kProfileCodecProfile: type: string enum: - HIGH - HIGH_422 description: Specify the codec profile for this output. Choose High, 8-bit, 4:2:0 (HIGH) or High, 10-bit, 4:2:2 (HIGH_422). These profiles are specified in ITU-T H.264. ProresFramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. ColorCorrector: type: object properties: Brightness: allOf: - $ref: '#/components/schemas/__integerMin1Max100' - xml: name: brightness description: Brightness level. ClipLimits: allOf: - $ref: '#/components/schemas/ClipLimits' - xml: name: clipLimits description: Specify YUV limits and RGB tolerances when you set Sample range conversion to Limited range clip. ColorSpaceConversion: allOf: - $ref: '#/components/schemas/ColorSpaceConversion' - xml: name: colorSpaceConversion description: "Specify the color space you want for this output. The service supports conversion between HDR formats, between SDR formats, from SDR to HDR, and from HDR to SDR. SDR to HDR conversion doesn't upgrade the dynamic range. The converted video has an HDR format, but visually appears the same as an unconverted output. HDR to SDR conversion uses tone mapping to approximate the outcome of manually regrading from HDR to SDR. When you specify an output color space, MediaConvert uses the following color space metadata, which includes color primaries, transfer characteristics, and matrix coefficients:\n * HDR 10: BT.2020, PQ, BT.2020 non-constant\n * HLG 2020: BT.2020, HLG, BT.2020 non-constant\n * P3DCI (Theater): DCIP3, SMPTE 428M, BT.709\n * P3D65 (SDR): Display P3, sRGB, BT.709\n * P3D65 (HDR): Display P3, PQ, BT.709" Contrast: allOf: - $ref: '#/components/schemas/__integerMin1Max100' - xml: name: contrast description: Contrast level. Hdr10Metadata: allOf: - $ref: '#/components/schemas/Hdr10Metadata' - xml: name: hdr10Metadata description: Use these settings when you convert to the HDR 10 color space. Specify the SMPTE ST 2086 Mastering Display Color Volume static metadata that you want signaled in the output. These values don't affect the pixel values that are encoded in the video stream. They are intended to help the downstream video player display content in a way that reflects the intentions of the the content creator. When you set Color space conversion (ColorSpaceConversion) to HDR 10 (FORCE_HDR10), these settings are required. You must set values for Max frame average light level (maxFrameAverageLightLevel) and Max content light level (maxContentLightLevel); these settings don't have a default value. The default values for the other HDR 10 metadata settings are defined by the P3D65 color space. For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr. HdrToSdrToneMapper: allOf: - $ref: '#/components/schemas/HDRToSDRToneMapper' - xml: name: hdrToSdrToneMapper description: 'Specify how MediaConvert maps brightness and colors from your HDR input to your SDR output. The mode that you select represents a creative choice, with different tradeoffs in the details and tones of your output. To maintain details in bright or saturated areas of your output: Choose Preserve details. For some sources, your SDR output may look less bright and less saturated when compared to your HDR source. MediaConvert automatically applies this mode for HLG sources, regardless of your choice. For a bright and saturated output: Choose Vibrant. We recommend that you choose this mode when any of your source content is HDR10, and for the best results when it is mastered for 1000 nits. You may notice loss of details in bright or saturated areas of your output. HDR to SDR tone mapping has no effect when your input is SDR.' Hue: allOf: - $ref: '#/components/schemas/__integerMinNegative180Max180' - xml: name: hue description: Hue in degrees. SampleRangeConversion: allOf: - $ref: '#/components/schemas/SampleRangeConversion' - xml: name: sampleRangeConversion description: 'Specify how MediaConvert limits the color sample range for this output. To create a limited range output from a full range input: Choose Limited range squeeze. For full range inputs, MediaConvert performs a linear offset to color samples equally across all pixels and frames. Color samples in 10-bit outputs are limited to 64 through 940, and 8-bit outputs are limited to 16 through 235. Note: For limited range inputs, values for color samples are passed through to your output unchanged. MediaConvert does not limit the sample range. To correct pixels in your input that are out of range or out of gamut: Choose Limited range clip. Use for broadcast applications. MediaConvert conforms any pixels outside of the values that you specify under Minimum YUV and Maximum YUV to limited range bounds. MediaConvert also corrects any YUV values that, when converted to RGB, would be outside the bounds you specify under Minimum RGB tolerance and Maximum RGB tolerance. With either limited range conversion, MediaConvert writes the sample range metadata in the output.' Saturation: allOf: - $ref: '#/components/schemas/__integerMin1Max100' - xml: name: saturation description: Saturation level. SdrReferenceWhiteLevel: allOf: - $ref: '#/components/schemas/__integerMin100Max1000' - xml: name: sdrReferenceWhiteLevel description: 'Specify the reference white level, in nits, for all of your SDR inputs. Use to correct brightness levels within HDR10 outputs. The following color metadata must be present in your SDR input: color primaries, transfer characteristics, and matrix coefficients. If your SDR input has missing color metadata, or if you want to correct input color metadata, manually specify a color space in the input video selector. For 1,000 nit peak brightness displays, we recommend that you set SDR reference white level to 203 (according to ITU-R BT.2408). Leave blank to use the default value of 100, or specify an integer from 100 to 1000.' description: Settings for color correction. ProresSettings: type: object properties: ChromaSampling: allOf: - $ref: '#/components/schemas/ProresChromaSampling' - xml: name: chromaSampling description: 'This setting applies only to ProRes 4444 and ProRes 4444 XQ outputs that you create from inputs that use 4:4:4 chroma sampling. Set Preserve 4:4:4 sampling (PRESERVE_444_SAMPLING) to allow outputs to also use 4:4:4 chroma sampling. You must specify a value for this setting when your output codec profile supports 4:4:4 chroma sampling. Related Settings: When you set Chroma sampling to Preserve 4:4:4 sampling (PRESERVE_444_SAMPLING), you must choose an output codec profile that supports 4:4:4 chroma sampling. These values for Profile (CodecProfile) support 4:4:4 chroma sampling: Apple ProRes 4444 (APPLE_PRORES_4444) or Apple ProRes 4444 XQ (APPLE_PRORES_4444_XQ). When you set Chroma sampling to Preserve 4:4:4 sampling, you must disable all video preprocessors except for Nexguard file marker (PartnerWatermarking). When you set Chroma sampling to Preserve 4:4:4 sampling and use framerate conversion, you must set Frame rate conversion algorithm (FramerateConversionAlgorithm) to Drop duplicate (DUPLICATE_DROP).' CodecProfile: allOf: - $ref: '#/components/schemas/ProresCodecProfile' - xml: name: codecProfile description: Use Profile (ProResCodecProfile) to specify the type of Apple ProRes codec to use for this output. FramerateControl: allOf: - $ref: '#/components/schemas/ProresFramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/ProresFramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. InterlaceMode: allOf: - $ref: '#/components/schemas/ProresInterlaceMode' - xml: name: interlaceMode description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. ParControl: allOf: - $ref: '#/components/schemas/ProresParControl' - xml: name: parControl description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. ParDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parDenominator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33. ParNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parNumerator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40. ScanTypeConversionMode: allOf: - $ref: '#/components/schemas/ProresScanTypeConversionMode' - xml: name: scanTypeConversionMode description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' SlowPal: allOf: - $ref: '#/components/schemas/ProresSlowPal' - xml: name: slowPal description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Telecine: allOf: - $ref: '#/components/schemas/ProresTelecine' - xml: name: telecine description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard telecine (HARD) to create a smoother picture. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES. CmfcScte35Esam: type: string enum: - INSERT - NONE description: Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml). WavFormat: type: string enum: - RIFF - RF64 description: The service defaults to using RIFF for WAV outputs. If your output audio is likely to exceed 4 GB in file size, or if you otherwise need the extended support of the RF64 format, set your output WAV file format to RF64. DvbSubDestinationSettings: type: object properties: Alignment: allOf: - $ref: '#/components/schemas/DvbSubtitleAlignment' - xml: name: alignment description: Specify the alignment of your captions. If no explicit x_position is provided, setting alignment to centered will placethe captions at the bottom center of the output. Similarly, setting a left alignment willalign 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. Within your job settings, all of your DVB-Sub settings must be identical. ApplyFontColor: allOf: - $ref: '#/components/schemas/DvbSubtitleApplyFontColor' - xml: name: applyFontColor description: Ignore this setting unless Style Passthrough (StylePassthrough) is set to Enabled and Font color (FontColor) set to Black, Yellow, Red, Green, Blue, or Hex. Use Apply font color (ApplyFontColor) for additional font color controls. When you choose White text only (WHITE_TEXT_ONLY), or leave blank, your font color setting only applies to white text in your input captions. For example, if your font color setting is Yellow, and your input captions have red and white text, your output captions will have red and yellow text. When you choose ALL_TEXT, your font color setting applies to all of your output captions text. BackgroundColor: allOf: - $ref: '#/components/schemas/DvbSubtitleBackgroundColor' - xml: name: backgroundColor description: Specify the color of the rectangle behind the captions. Leave background color (BackgroundColor) blank and set Style passthrough (StylePassthrough) to enabled to use the background color data from your input captions, if present. BackgroundOpacity: allOf: - $ref: '#/components/schemas/__integerMin0Max255' - xml: name: backgroundOpacity description: Specify the opacity of the background rectangle. Enter a value from 0 to 255, where 0 is transparent and 255 is opaque. If Style passthrough (StylePassthrough) is set to enabled, leave blank to pass through the background style information in your input captions to your output captions. If Style passthrough is set to disabled, leave blank to use a value of 0 and remove all backgrounds from your output captions. Within your job settings, all of your DVB-Sub settings must be identical. DdsHandling: allOf: - $ref: '#/components/schemas/DvbddsHandling' - xml: name: ddsHandling description: 'Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS: Choose Specified. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate. To include the DDS, but not include display window data: Choose No display window. When you do, you can write position metadata to the page composition segment (PCS) with DDS x-coordinate and DDS y-coordinate. For video resolutions with a height of 576 pixels or less, MediaConvert doesn''t include the DDS, regardless of the value you choose for DDS handling. All burn-in and DVB-Sub font settings must match.' DdsXCoordinate: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: ddsXCoordinate description: 'Use this setting, along with DDS y-coordinate (ddsYCoordinate), to specify the upper left corner of the display definition segment (DDS) display window. With this setting, specify the distance, in pixels, between the left side of the frame and the left side of the DDS display window. Keep the default value, 0, to have MediaConvert automatically choose this offset. Related setting: When you use this setting, you must set DDS handling (ddsHandling) to a value other than None (NONE). MediaConvert uses these values to determine whether to write page position data to the DDS or to the page composition segment (PCS). All burn-in and DVB-Sub font settings must match.' DdsYCoordinate: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: ddsYCoordinate description: 'Use this setting, along with DDS x-coordinate (ddsXCoordinate), to specify the upper left corner of the display definition segment (DDS) display window. With this setting, specify the distance, in pixels, between the top of the frame and the top of the DDS display window. Keep the default value, 0, to have MediaConvert automatically choose this offset. Related setting: When you use this setting, you must set DDS handling (ddsHandling) to a value other than None (NONE). MediaConvert uses these values to determine whether to write page position data to the DDS or to the page composition segment (PCS). All burn-in and DVB-Sub font settings must match.' FallbackFont: allOf: - $ref: '#/components/schemas/DvbSubSubtitleFallbackFont' - xml: name: fallbackFont description: Specify the font that you want the service to use for your burn in captions when your input captions specify a font that MediaConvert doesn't support. When you set Fallback font (FallbackFont) to best match (BEST_MATCH), or leave blank, MediaConvert uses a supported font that most closely matches the font that your input captions specify. When there are multiple unsupported fonts in your input captions, MediaConvert matches each font with the supported font that matches best. When you explicitly choose a replacement font, MediaConvert uses that font to replace all unsupported fonts from your input. FontColor: allOf: - $ref: '#/components/schemas/DvbSubtitleFontColor' - xml: name: fontColor description: Specify the color of the captions text. Leave Font color (FontColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font color data from your input captions, if present. Within your job settings, all of your DVB-Sub settings must be identical. FontOpacity: allOf: - $ref: '#/components/schemas/__integerMin0Max255' - xml: name: fontOpacity description: 'Specify the opacity of the burned-in captions. 255 is opaque; 0 is transparent. Within your job settings, all of your DVB-Sub settings must be identical.' FontResolution: allOf: - $ref: '#/components/schemas/__integerMin96Max600' - xml: name: fontResolution description: 'Specify the Font resolution (FontResolution) in DPI (dots per inch). Within your job settings, all of your DVB-Sub settings must be identical.' FontScript: allOf: - $ref: '#/components/schemas/FontScript' - xml: name: fontScript description: Set Font script (FontScript) to Automatically determined (AUTOMATIC), or leave blank, to automatically determine the font script in your input captions. Otherwise, set to Simplified Chinese (HANS) or Traditional Chinese (HANT) if your input font script uses Simplified or Traditional Chinese. Within your job settings, all of your DVB-Sub settings must be identical. FontSize: allOf: - $ref: '#/components/schemas/__integerMin0Max96' - xml: name: fontSize description: Specify the Font size (FontSize) in pixels. Must be a positive integer. Set to 0, or leave blank, for automatic font size. Within your job settings, all of your DVB-Sub settings must be identical. Height: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: height description: 'Specify the height, in pixels, of this set of DVB-Sub captions. The default value is 576 pixels. Related setting: When you use this setting, you must set DDS handling (ddsHandling) to a value other than None (NONE). All burn-in and DVB-Sub font settings must match.' HexFontColor: allOf: - $ref: '#/components/schemas/__stringMin6Max8Pattern09aFAF609aFAF2' - xml: name: hexFontColor description: Ignore this setting unless your Font color is set to Hex. Enter either six or eight hexidecimal digits, representing red, green, and blue, with two optional extra digits for alpha. For example a value of 1122AABB is a red value of 0x11, a green value of 0x22, a blue value of 0xAA, and an alpha value of 0xBB. OutlineColor: allOf: - $ref: '#/components/schemas/DvbSubtitleOutlineColor' - xml: name: outlineColor description: Specify font outline color. Leave Outline color (OutlineColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font outline color data from your input captions, if present. Within your job settings, all of your DVB-Sub settings must be identical. OutlineSize: allOf: - $ref: '#/components/schemas/__integerMin0Max10' - xml: name: outlineSize description: Specify the Outline size (OutlineSize) of the caption text, in pixels. Leave Outline size blank and set Style passthrough (StylePassthrough) to enabled to use the outline size data from your input captions, if present. Within your job settings, all of your DVB-Sub settings must be identical. ShadowColor: allOf: - $ref: '#/components/schemas/DvbSubtitleShadowColor' - xml: name: shadowColor description: Specify the color of the shadow cast by the captions. Leave Shadow color (ShadowColor) blank and set Style passthrough (StylePassthrough) to enabled to use the shadow color data from your input captions, if present. Within your job settings, all of your DVB-Sub settings must be identical. ShadowOpacity: allOf: - $ref: '#/components/schemas/__integerMin0Max255' - xml: name: shadowOpacity description: Specify the opacity of the shadow. Enter a value from 0 to 255, where 0 is transparent and 255 is opaque. If Style passthrough (StylePassthrough) is set to Enabled, leave Shadow opacity (ShadowOpacity) blank to pass through the shadow style information in your input captions to your output captions. If Style passthrough is set to disabled, leave blank to use a value of 0 and remove all shadows from your output captions. Within your job settings, all of your DVB-Sub settings must be identical. ShadowXOffset: allOf: - $ref: '#/components/schemas/__integerMinNegative2147483648Max2147483647' - xml: name: shadowXOffset description: Specify 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. Within your job settings, all of your DVB-Sub settings must be identical. ShadowYOffset: allOf: - $ref: '#/components/schemas/__integerMinNegative2147483648Max2147483647' - xml: name: shadowYOffset description: Specify 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. Leave Shadow y-offset (ShadowYOffset) blank and set Style passthrough (StylePassthrough) to enabled to use the shadow y-offset data from your input captions, if present. Within your job settings, all of your DVB-Sub settings must be identical. StylePassthrough: allOf: - $ref: '#/components/schemas/DvbSubtitleStylePassthrough' - xml: name: stylePassthrough description: 'Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses default settings for any missing style and position information in your input captions. Set Style passthrough to DISABLED, or leave blank, to ignore the style and position information from your input captions and use default settings: white text with black outlining, bottom-center positioning, and automatic sizing. Whether you set Style passthrough to enabled or not, you can also choose to manually override any of the individual style and position settings.' SubtitlingType: allOf: - $ref: '#/components/schemas/DvbSubtitlingType' - xml: name: subtitlingType description: Specify whether your DVB subtitles are standard or for hearing impaired. Choose hearing impaired if your subtitles include audio descriptions and dialogue. Choose standard if your subtitles include only dialogue. TeletextSpacing: allOf: - $ref: '#/components/schemas/DvbSubtitleTeletextSpacing' - xml: name: teletextSpacing description: Specify whether the Text spacing (TeletextSpacing) in your captions is set by the captions grid, or varies depending on letter width. Choose fixed grid (FIXED_GRID) to conform to the spacing specified in the captions file more accurately. Choose proportional (PROPORTIONAL) to make the text easier to read for closed captions. Within your job settings, all of your DVB-Sub settings must be identical. Width: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: width description: 'Specify the width, in pixels, of this set of DVB-Sub captions. The default value is 720 pixels. Related setting: When you use this setting, you must set DDS handling (ddsHandling) to a value other than None (NONE). All burn-in and DVB-Sub font settings must match.' XPosition: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: xPosition description: Specify the horizontal position (XPosition) of the captions, relative to the left side of the outputin pixels. A value of 10 would result in the captions starting 10 pixels from the left ofthe output. If no explicit x_position is provided, the horizontal caption position will bedetermined by the alignment parameter. Within your job settings, all of your DVB-Sub settings must be identical. YPosition: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: yPosition description: Specify the vertical position (YPosition) of the captions, 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. Within your job settings, all of your DVB-Sub settings must be identical. description: Settings related to DVB-Sub captions. Set up DVB-Sub captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/dvb-sub-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to DVB_SUB. __integerMin0Max500: type: integer minimum: 0 maximum: 500 ProresInterlaceMode: type: string enum: - PROGRESSIVE - TOP_FIELD - BOTTOM_FIELD - FOLLOW_TOP_FIELD - FOLLOW_BOTTOM_FIELD description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. XavcFramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Frame rate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list. The framerates shown in the dropdown list are decimal approximations of fractions. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate that you specify in the settings FramerateNumerator and FramerateDenominator. Eac3AtmosStereoDownmix: type: string enum: - NOT_INDICATED - STEREO - SURROUND - DPL2 description: 'Choose how the service does stereo downmixing. Default value: Not indicated (ATMOS_STORAGE_DDP_DMIXMOD_NOT_INDICATED) Related setting: To have MediaConvert use this value, keep the default value, Custom (SPECIFIED) for the setting Downmix control (DownmixControl). Otherwise, MediaConvert ignores Stereo downmix (StereoDownmix).' __integerMin25Max2000: type: integer minimum: 25 maximum: 2000 Mpeg2DynamicSubGop: type: string enum: - ADAPTIVE - STATIC description: Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). TtmlDestinationSettings: type: object properties: StylePassthrough: allOf: - $ref: '#/components/schemas/TtmlStylePassthrough' - xml: name: stylePassthrough description: Pass through style and position information from a TTML-like input source (TTML, IMSC, SMPTE-TT) to the TTML output. description: Settings related to TTML captions. TTML is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/ttml-and-webvtt-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to TTML. H264ScanTypeConversionMode: type: string enum: - INTERLACED - INTERLACED_OPTIMIZE description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' H265Tiles: type: string enum: - DISABLED - ENABLED description: Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. DolbyVisionLevel6Metadata: type: object properties: MaxCll: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: maxCll description: Maximum Content Light Level. Static HDR metadata that corresponds to the brightest pixel in the entire stream. Measured in nits. MaxFall: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: maxFall description: Maximum Frame-Average Light Level. Static HDR metadata that corresponds to the highest frame-average brightness in the entire stream. Measured in nits. description: Use these settings when you set DolbyVisionLevel6Mode to SPECIFY to override the MaxCLL and MaxFALL values in your input with new values. __integerMin920Max1023: type: integer minimum: 920 maximum: 1023 __listOf__doubleMinNegative60Max6: type: array items: $ref: '#/components/schemas/__doubleMinNegative60Max6' MxfAfdSignaling: type: string enum: - NO_COPY - COPY_FROM_VIDEO description: 'Optional. When you have AFD signaling set up in your output video stream, use this setting to choose whether to also include it in the MXF wrapper. Choose Don''t copy (NO_COPY) to exclude AFD signaling from the MXF wrapper. Choose Copy from video stream (COPY_FROM_VIDEO) to copy the AFD values from the video stream for this output to the MXF wrapper. Regardless of which option you choose, the AFD values remain in the video stream. Related settings: To set up your output to include or exclude AFD values, see AfdSignaling, under VideoDescription. On the console, find AFD signaling under the output''s video encoding settings.' Eac3DynamicRangeCompressionRf: type: string enum: - NONE - FILM_STANDARD - FILM_LIGHT - MUSIC_STANDARD - MUSIC_LIGHT - SPEECH description: 'Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the RF operating mode. Related setting: When you use this setting, MediaConvert ignores any value you provide for Dynamic range compression profile (DynamicRangeCompressionProfile). For information about the Dolby Digital DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' DeinterlaceAlgorithm: type: string enum: - INTERPOLATE - INTERPOLATE_TICKER - BLEND - BLEND_TICKER description: 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. __integerMin16000Max48000: type: integer minimum: 16000 maximum: 48000 Av1SpatialAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (adaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.' __integerMin100Max1000: type: integer minimum: 100 maximum: 1000 SampleRangeConversion: type: string enum: - LIMITED_RANGE_SQUEEZE - NONE - LIMITED_RANGE_CLIP description: 'Specify how MediaConvert limits the color sample range for this output. To create a limited range output from a full range input: Choose Limited range squeeze. For full range inputs, MediaConvert performs a linear offset to color samples equally across all pixels and frames. Color samples in 10-bit outputs are limited to 64 through 940, and 8-bit outputs are limited to 16 through 235. Note: For limited range inputs, values for color samples are passed through to your output unchanged. MediaConvert does not limit the sample range. To correct pixels in your input that are out of range or out of gamut: Choose Limited range clip. Use for broadcast applications. MediaConvert conforms any pixels outside of the values that you specify under Minimum YUV and Maximum YUV to limited range bounds. MediaConvert also corrects any YUV values that, when converted to RGB, would be outside the bounds you specify under Minimum RGB tolerance and Maximum RGB tolerance. With either limited range conversion, MediaConvert writes the sample range metadata in the output.' __doubleMinNegative59Max0: type: number format: double __integerMin32Max8192: type: integer minimum: 32 maximum: 8192 M2tsNielsenId3: type: string enum: - INSERT - NONE description: 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. AudioNormalizationAlgorithmControl: type: string enum: - CORRECT_AUDIO - MEASURE_ONLY description: When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. OpusSettings: type: object properties: Bitrate: allOf: - $ref: '#/components/schemas/__integerMin32000Max192000' - xml: name: bitrate description: Optional. Specify the average bitrate in bits per second. Valid values are multiples of 8000, from 32000 through 192000. The default value is 96000, which we recommend for quality and bandwidth. Channels: allOf: - $ref: '#/components/schemas/__integerMin1Max2' - xml: name: channels description: Specify the number of channels in this output audio track. Choosing Mono on the console gives you 1 output channel; choosing Stereo gives you 2. In the API, valid values are 1 and 2. SampleRate: allOf: - $ref: '#/components/schemas/__integerMin16000Max48000' - xml: name: sampleRate description: Optional. Sample rate in hz. Valid values are 16000, 24000, and 48000. The default value is 48000. description: Required when you set Codec, under AudioDescriptions>CodecSettings, to the value OPUS. Eac3AtmosCodingMode: type: string enum: - CODING_MODE_AUTO - CODING_MODE_5_1_4 - CODING_MODE_7_1_4 - CODING_MODE_9_1_6 description: The coding mode for Dolby Digital Plus JOC (Atmos). Xavc4kIntraCbgProfileSettings: type: object properties: XavcClass: allOf: - $ref: '#/components/schemas/Xavc4kIntraCbgProfileClass' - xml: name: xavcClass description: Specify the XAVC Intra 4k (CBG) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_4K_INTRA_CBG. H265FramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. VideoTimecodeInsertion: type: string enum: - DISABLED - PIC_TIMING_SEI description: Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. CmfcKlvMetadata: type: string enum: - PASSTHROUGH - NONE description: 'To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and writes each instance to a separate event message box in the output, according to MISB ST1910.1. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.' __integerMinNegative5Max10: type: integer minimum: -5 maximum: 10 MpdAudioDuration: type: string enum: - DEFAULT_CODEC_DURATION - MATCH_VIDEO_DURATION description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. __doubleMinNegative60Max6: type: number format: double H264Telecine: type: string enum: - NONE - SOFT - HARD description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or soft telecine to create a smoother picture. Hard telecine (HARD) produces a 29.97i output. Soft telecine (SOFT) produces an output with a 23.976 output that signals to the video player device to do the conversion during play back. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. VideoCodec: type: string enum: - AV1 - AVC_INTRA - FRAME_CAPTURE - H_264 - H_265 - MPEG2 - PRORES - VC3 - VP8 - VP9 - XAVC description: Type of video codec __doubleMin0Max1: type: number format: double H265TemporalAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren''t moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn''t have moving objects with sharp edges, such as sports athletes'' faces, you might choose to disable this feature. Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization (adaptiveQuantization).' NoiseReducerFilter: type: string enum: - BILATERAL - MEAN - GAUSSIAN - LANCZOS - SHARPEN - CONSERVE - SPATIAL - TEMPORAL description: 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 preserves edges while reducing noise. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) do convolution filtering. * Conserve does min/max noise reduction. * Spatial does frequency-domain filtering based on JND principles. * Temporal optimizes video quality for complex motion. WavSettings: type: object properties: BitDepth: allOf: - $ref: '#/components/schemas/__integerMin16Max24' - xml: name: bitDepth description: Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track. Channels: allOf: - $ref: '#/components/schemas/__integerMin1Max64' - xml: name: channels description: Specify the number of channels in this output audio track. Valid values are 1 and even numbers up to 64. For example, 1, 2, 4, 6, and so on, up to 64. Format: allOf: - $ref: '#/components/schemas/WavFormat' - xml: name: format description: The service defaults to using RIFF for WAV outputs. If your output audio is likely to exceed 4 GB in file size, or if you otherwise need the extended support of the RF64 format, set your output WAV file format to RF64. SampleRate: allOf: - $ref: '#/components/schemas/__integerMin8000Max192000' - xml: name: sampleRate description: Sample rate in Hz. description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV. AacRawFormat: type: string enum: - LATM_LOAS - NONE description: 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. AacCodecProfile: type: string enum: - LC - HEV1 - HEV2 description: AAC Profile. Vc3Settings: type: object properties: FramerateControl: allOf: - $ref: '#/components/schemas/Vc3FramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/Vc3FramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max1001' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin24Max60000' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. InterlaceMode: allOf: - $ref: '#/components/schemas/Vc3InterlaceMode' - xml: name: interlaceMode description: Optional. Choose the scan line type for this output. If you don't specify a value, MediaConvert will create a progressive output. ScanTypeConversionMode: allOf: - $ref: '#/components/schemas/Vc3ScanTypeConversionMode' - xml: name: scanTypeConversionMode description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' SlowPal: allOf: - $ref: '#/components/schemas/Vc3SlowPal' - xml: name: slowPal description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output by relabeling the video frames and resampling your audio. Note that enabling this setting will slightly reduce the duration of your video. Related settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Telecine: allOf: - $ref: '#/components/schemas/Vc3Telecine' - xml: name: telecine description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard telecine (HARD) to create a smoother picture. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. Vc3Class: allOf: - $ref: '#/components/schemas/Vc3Class' - xml: name: vc3Class description: Specify the VC3 class to choose the quality characteristics for this output. VC3 class, together with the settings Framerate (framerateNumerator and framerateDenominator) and Resolution (height and width), determine your output bitrate. For example, say that your video resolution is 1920x1080 and your framerate is 29.97. Then Class 145 (CLASS_145) gives you an output with a bitrate of approximately 145 Mbps and Class 220 (CLASS_220) gives you and output with a bitrate of approximately 220 Mbps. VC3 class also specifies the color bit depth of your output. description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value VC3 GetPresetResponse: type: object properties: Preset: allOf: - $ref: '#/components/schemas/Preset' - xml: name: preset description: A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process. XavcInterlaceMode: type: string enum: - PROGRESSIVE - TOP_FIELD - BOTTOM_FIELD - FOLLOW_TOP_FIELD - FOLLOW_BOTTOM_FIELD description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. Mpeg2ParControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. __integerMin1Max31: type: integer minimum: 1 maximum: 31 __integerMin0Max99: type: integer minimum: 0 maximum: 99 SrtDestinationSettings: type: object properties: StylePassthrough: allOf: - $ref: '#/components/schemas/SrtStylePassthrough' - xml: name: stylePassthrough description: Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses default settings for any missing style and position information in your input captions. Set Style passthrough to DISABLED, or leave blank, to ignore the style and position information from your input captions and use simplified output captions. description: Settings related to SRT captions. SRT is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to SRT. __integerMin0Max10: type: integer minimum: 0 maximum: 10 DeinterlacerControl: type: string enum: - FORCE_ALL_FRAMES - NORMAL description: '- 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.' M2tsSegmentationMarkers: type: string enum: - NONE - RAI_SEGSTART - RAI_ADAPT - PSI_SEGSTART - EBP - EBP_LEGACY description: 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. Xavc4kIntraVbrProfileSettings: type: object properties: XavcClass: allOf: - $ref: '#/components/schemas/Xavc4kIntraVbrProfileClass' - xml: name: xavcClass description: Specify the XAVC Intra 4k (VBR) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_4K_INTRA_VBR. H264QualityTuningLevel: type: string enum: - SINGLE_PASS - SINGLE_PASS_HQ - MULTI_PASS_HQ description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. Mpeg2IntraDcPrecision: type: string enum: - AUTO - INTRA_DC_PRECISION_8 - INTRA_DC_PRECISION_9 - INTRA_DC_PRECISION_10 - INTRA_DC_PRECISION_11 description: 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. __integerMin1000Max300000000: type: integer minimum: 1000 maximum: 300000000 TimecodeBurninPosition: type: string enum: - TOP_CENTER - TOP_LEFT - TOP_RIGHT - MIDDLE_LEFT - MIDDLE_CENTER - MIDDLE_RIGHT - BOTTOM_LEFT - BOTTOM_CENTER - BOTTOM_RIGHT description: Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. __integerMinNegative2Max3: type: integer minimum: -2 maximum: 3 M3u8Scte35Source: type: string enum: - PASSTHROUGH - NONE description: For SCTE-35 markers from your input-- Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None (NONE) if you don't want SCTE-35 markers in this output. For SCTE-35 markers from an ESAM XML document-- Choose None (NONE) if you don't want manifest conditioning. Choose Passthrough (PASSTHROUGH) and choose Ad markers (adMarkers) if you do want manifest conditioning. In both cases, also provide the ESAM XML as a string in the setting Signal processing notification XML (sccXml). H265DynamicSubGop: type: string enum: - ADAPTIVE - STATIC description: Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Eac3LfeControl: type: string enum: - LFE - NO_LFE description: When encoding 3/2 audio, controls whether the LFE channel is enabled HDRToSDRToneMapper: type: string enum: - PRESERVE_DETAILS - VIBRANT description: 'Specify how MediaConvert maps brightness and colors from your HDR input to your SDR output. The mode that you select represents a creative choice, with different tradeoffs in the details and tones of your output. To maintain details in bright or saturated areas of your output: Choose Preserve details. For some sources, your SDR output may look less bright and less saturated when compared to your HDR source. MediaConvert automatically applies this mode for HLG sources, regardless of your choice. For a bright and saturated output: Choose Vibrant. We recommend that you choose this mode when any of your source content is HDR10, and for the best results when it is mastered for 1000 nits. You may notice loss of details in bright or saturated areas of your output. HDR to SDR tone mapping has no effect when your input is SDR.' AvcIntraFramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. RemixSettings: type: object properties: ChannelMapping: allOf: - $ref: '#/components/schemas/ChannelMapping' - xml: name: channelMapping description: Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel, in dB. Specify remix values to indicate how much of the content from your input audio channel you want in your output audio channels. Each instance of the InputChannels or InputChannelsFineTune array specifies these values for one output channel. Use one instance of this array for each output channel. In the console, each array corresponds to a column in the graphical depiction of the mapping matrix. The rows of the graphical matrix correspond to input channels. Valid 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). Use InputChannels or InputChannelsFineTune to specify your remix values. Don't use both. ChannelsIn: allOf: - $ref: '#/components/schemas/__integerMin1Max64' - xml: name: channelsIn description: 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. If you are doing both input channel mapping and output channel mapping, the number of output channels in your input mapping must be the same as the number of input channels in your output mapping. ChannelsOut: allOf: - $ref: '#/components/schemas/__integerMin1Max64' - xml: name: channelsOut description: 'Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8... 64. (1 and even numbers to 64.) If you are doing both input channel mapping and output channel mapping, the number of output channels in your input mapping must be the same as the number of input channels in your output mapping.' description: Use Manual audio remixing (RemixSettings) to adjust audio levels for each audio channel in each output of your job. With audio remixing, you can output more or fewer audio channels than your input audio source provides. Eac3SurroundMode: type: string enum: - NOT_INDICATED - ENABLED - DISABLED description: When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. XavcHdProfileTelecine: type: string enum: - NONE - HARD description: Ignore this setting unless you set Frame rate (framerateNumerator divided by framerateDenominator) to 29.970. If your input framerate is 23.976, choose Hard (HARD). Otherwise, keep the default value None (NONE). For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-telecine-and-inverse-telecine.html. NoiseFilterPostTemporalSharpening: type: string enum: - DISABLED - ENABLED - AUTO description: When you set Noise reducer (noiseReducer) to Temporal (TEMPORAL), the bandwidth and sharpness of your output is reduced. You can optionally use Post temporal sharpening (postTemporalSharpening) to apply sharpening to the edges of your output. Note that Post temporal sharpening will also make the bandwidth reduction from the Noise reducer smaller. The default behavior, Auto (AUTO), allows the transcoder to determine whether to apply sharpening, depending on your input type and quality. When you set Post temporal sharpening to Enabled (ENABLED), specify how much sharpening is applied using Post temporal sharpening strength (postTemporalSharpeningStrength). Set Post temporal sharpening to Disabled (DISABLED) to not apply sharpening. M3u8NielsenId3: type: string enum: - INSERT - NONE description: 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. Eac3AtmosSettings: type: object properties: Bitrate: allOf: - $ref: '#/components/schemas/__integerMin384000Max1024000' - xml: name: bitrate description: 'Specify the average bitrate for this output in bits per second. Valid values: 384k, 448k, 576k, 640k, 768k, 1024k Default value: 448k Note that MediaConvert supports 384k only with channel-based immersive (CBI) 7.1.4 and 5.1.4 inputs. For CBI 9.1.6 and other input types, MediaConvert automatically increases your output bitrate to 448k.' BitstreamMode: allOf: - $ref: '#/components/schemas/Eac3AtmosBitstreamMode' - xml: name: bitstreamMode description: Specify the bitstream mode for the E-AC-3 stream that the encoder emits. For more information about the EAC3 bitstream mode, see ATSC A/52-2012 (Annex E). CodingMode: allOf: - $ref: '#/components/schemas/Eac3AtmosCodingMode' - xml: name: codingMode description: The coding mode for Dolby Digital Plus JOC (Atmos). DialogueIntelligence: allOf: - $ref: '#/components/schemas/Eac3AtmosDialogueIntelligence' - xml: name: dialogueIntelligence description: Enable Dolby Dialogue Intelligence to adjust loudness based on dialogue analysis. DownmixControl: allOf: - $ref: '#/components/schemas/Eac3AtmosDownmixControl' - xml: name: downmixControl description: 'Specify whether MediaConvert should use any downmix metadata from your input file. Keep the default value, Custom (SPECIFIED) to provide downmix values in your job settings. Choose Follow source (INITIALIZE_FROM_SOURCE) to use the metadata from your input. Related settings--Use these settings to specify your downmix values: Left only/Right only surround (LoRoSurroundMixLevel), Left total/Right total surround (LtRtSurroundMixLevel), Left total/Right total center (LtRtCenterMixLevel), Left only/Right only center (LoRoCenterMixLevel), and Stereo downmix (StereoDownmix). When you keep Custom (SPECIFIED) for Downmix control (DownmixControl) and you don''t specify values for the related settings, MediaConvert uses default values for those settings.' DynamicRangeCompressionLine: allOf: - $ref: '#/components/schemas/Eac3AtmosDynamicRangeCompressionLine' - xml: name: dynamicRangeCompressionLine description: 'Choose the Dolby dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby stream for the line operating mode. Default value: Film light (ATMOS_STORAGE_DDP_COMPR_FILM_LIGHT) Related setting: To have MediaConvert use the value you specify here, keep the default value, Custom (SPECIFIED) for the setting Dynamic range control (DynamicRangeControl). Otherwise, MediaConvert ignores Dynamic range compression line (DynamicRangeCompressionLine). For information about the Dolby DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' DynamicRangeCompressionRf: allOf: - $ref: '#/components/schemas/Eac3AtmosDynamicRangeCompressionRf' - xml: name: dynamicRangeCompressionRf description: 'Choose the Dolby dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby stream for the RF operating mode. Default value: Film light (ATMOS_STORAGE_DDP_COMPR_FILM_LIGHT) Related setting: To have MediaConvert use the value you specify here, keep the default value, Custom (SPECIFIED) for the setting Dynamic range control (DynamicRangeControl). Otherwise, MediaConvert ignores Dynamic range compression RF (DynamicRangeCompressionRf). For information about the Dolby DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' DynamicRangeControl: allOf: - $ref: '#/components/schemas/Eac3AtmosDynamicRangeControl' - xml: name: dynamicRangeControl description: 'Specify whether MediaConvert should use any dynamic range control metadata from your input file. Keep the default value, Custom (SPECIFIED), to provide dynamic range control values in your job settings. Choose Follow source (INITIALIZE_FROM_SOURCE) to use the metadata from your input. Related settings--Use these settings to specify your dynamic range control values: Dynamic range compression line (DynamicRangeCompressionLine) and Dynamic range compression RF (DynamicRangeCompressionRf). When you keep the value Custom (SPECIFIED) for Dynamic range control (DynamicRangeControl) and you don''t specify values for the related settings, MediaConvert uses default values for those settings.' LoRoCenterMixLevel: allOf: - $ref: '#/components/schemas/__doubleMinNegative6Max3' - xml: name: loRoCenterMixLevel description: 'Specify a value for the following Dolby Atmos setting: Left only/Right only center mix (Lo/Ro center). MediaConvert uses this value for downmixing. Default value: -3 dB (ATMOS_STORAGE_DDP_MIXLEV_MINUS_3_DB). Valid values: 3.0, 1.5, 0.0, -1.5, -3.0, -4.5, and -6.0. Related setting: How the service uses this value depends on the value that you choose for Stereo downmix (Eac3AtmosStereoDownmix). Related setting: To have MediaConvert use this value, keep the default value, Custom (SPECIFIED) for the setting Downmix control (DownmixControl). Otherwise, MediaConvert ignores Left only/Right only center (LoRoCenterMixLevel).' LoRoSurroundMixLevel: allOf: - $ref: '#/components/schemas/__doubleMinNegative60MaxNegative1' - xml: name: loRoSurroundMixLevel description: 'Specify a value for the following Dolby Atmos setting: Left only/Right only (Lo/Ro surround). MediaConvert uses this value for downmixing. Default value: -3 dB (ATMOS_STORAGE_DDP_MIXLEV_MINUS_3_DB). Valid values: -1.5, -3.0, -4.5, -6.0, and -60. The value -60 mutes the channel. Related setting: How the service uses this value depends on the value that you choose for Stereo downmix (Eac3AtmosStereoDownmix). Related setting: To have MediaConvert use this value, keep the default value, Custom (SPECIFIED) for the setting Downmix control (DownmixControl). Otherwise, MediaConvert ignores Left only/Right only surround (LoRoSurroundMixLevel).' LtRtCenterMixLevel: allOf: - $ref: '#/components/schemas/__doubleMinNegative6Max3' - xml: name: ltRtCenterMixLevel description: 'Specify a value for the following Dolby Atmos setting: Left total/Right total center mix (Lt/Rt center). MediaConvert uses this value for downmixing. Default value: -3 dB (ATMOS_STORAGE_DDP_MIXLEV_MINUS_3_DB) Valid values: 3.0, 1.5, 0.0, -1.5, -3.0, -4.5, and -6.0. Related setting: How the service uses this value depends on the value that you choose for Stereo downmix (Eac3AtmosStereoDownmix). Related setting: To have MediaConvert use this value, keep the default value, Custom (SPECIFIED) for the setting Downmix control (DownmixControl). Otherwise, MediaConvert ignores Left total/Right total center (LtRtCenterMixLevel).' LtRtSurroundMixLevel: allOf: - $ref: '#/components/schemas/__doubleMinNegative60MaxNegative1' - xml: name: ltRtSurroundMixLevel description: 'Specify a value for the following Dolby Atmos setting: Left total/Right total surround mix (Lt/Rt surround). MediaConvert uses this value for downmixing. Default value: -3 dB (ATMOS_STORAGE_DDP_MIXLEV_MINUS_3_DB) Valid values: -1.5, -3.0, -4.5, -6.0, and -60. The value -60 mutes the channel. Related setting: How the service uses this value depends on the value that you choose for Stereo downmix (Eac3AtmosStereoDownmix). Related setting: To have MediaConvert use this value, keep the default value, Custom (SPECIFIED) for the setting Downmix control (DownmixControl). Otherwise, the service ignores Left total/Right total surround (LtRtSurroundMixLevel).' MeteringMode: allOf: - $ref: '#/components/schemas/Eac3AtmosMeteringMode' - xml: name: meteringMode description: Choose how the service meters the loudness of your audio. SampleRate: allOf: - $ref: '#/components/schemas/__integerMin48000Max48000' - xml: name: sampleRate description: This value is always 48000. It represents the sample rate in Hz. SpeechThreshold: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: speechThreshold description: 'Specify the percentage of audio content, from 0% to 100%, that must be speech in order for the encoder to use the measured speech loudness as the overall program loudness. Default value: 15%' StereoDownmix: allOf: - $ref: '#/components/schemas/Eac3AtmosStereoDownmix' - xml: name: stereoDownmix description: 'Choose how the service does stereo downmixing. Default value: Not indicated (ATMOS_STORAGE_DDP_DMIXMOD_NOT_INDICATED) Related setting: To have MediaConvert use this value, keep the default value, Custom (SPECIFIED) for the setting Downmix control (DownmixControl). Otherwise, MediaConvert ignores Stereo downmix (StereoDownmix).' SurroundExMode: allOf: - $ref: '#/components/schemas/Eac3AtmosSurroundExMode' - xml: name: surroundExMode description: Specify whether your input audio has an additional center rear surround channel matrix encoded into your left and right surround channels. description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3_ATMOS. VorbisSettings: type: object properties: Channels: allOf: - $ref: '#/components/schemas/__integerMin1Max2' - xml: name: channels description: Optional. Specify the number of channels in this output audio track. Choosing Mono on the console gives you 1 output channel; choosing Stereo gives you 2. In the API, valid values are 1 and 2. The default value is 2. SampleRate: allOf: - $ref: '#/components/schemas/__integerMin22050Max48000' - xml: name: sampleRate description: Optional. Specify the audio sample rate in Hz. Valid values are 22050, 32000, 44100, and 48000. The default value is 48000. VbrQuality: allOf: - $ref: '#/components/schemas/__integerMinNegative1Max10' - xml: name: vbrQuality description: Optional. Specify the variable audio quality of this Vorbis output from -1 (lowest quality, ~45 kbit/s) to 10 (highest quality, ~500 kbit/s). The default value is 4 (~128 kbit/s). Values 5 and 6 are approximately 160 and 192 kbit/s, respectively. description: Required when you set Codec, under AudioDescriptions>CodecSettings, to the value Vorbis. __integerMin0Max9: type: integer minimum: 0 maximum: 9 H264EntropyEncoding: type: string enum: - CABAC - CAVLC description: Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Ac3DynamicRangeCompressionProfile: type: string enum: - FILM_STANDARD - NONE description: When you want to add Dolby dynamic range compression (DRC) signaling to your output stream, we recommend that you use the mode-specific settings instead of Dynamic range compression profile (DynamicRangeCompressionProfile). The mode-specific settings are Dynamic range compression profile, line mode (dynamicRangeCompressionLine) and Dynamic range compression profile, RF mode (dynamicRangeCompressionRf). Note that when you specify values for all three settings, MediaConvert ignores the value of this setting in favor of the mode-specific settings. If you do use this setting instead of the mode-specific settings, choose None (NONE) to leave out DRC signaling. Keep the default Film standard (FILM_STANDARD) to set the profile to Dolby's film standard profile for all operating modes. F4vSettings: type: object properties: MoovPlacement: allOf: - $ref: '#/components/schemas/F4vMoovPlacement' - xml: name: moovPlacement description: 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. description: Settings for F4v container CreatePresetResponse: type: object properties: Preset: allOf: - $ref: '#/components/schemas/Preset' - xml: name: preset description: A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process. BurninSubtitleTeletextSpacing: type: string enum: - FIXED_GRID - PROPORTIONAL - AUTO description: Specify whether the text spacing (TeletextSpacing) in your captions is set by the captions grid, or varies depending on letter width. Choose fixed grid (FIXED_GRID) to conform to the spacing specified in the captions file more accurately. Choose proportional (PROPORTIONAL) to make the text easier to read for closed captions. AvcIntraTelecine: type: string enum: - NONE - HARD description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard telecine (HARD) to create a smoother picture. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. AudioNormalizationSettings: type: object properties: Algorithm: allOf: - $ref: '#/components/schemas/AudioNormalizationAlgorithm' - xml: name: algorithm description: 'Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.' AlgorithmControl: allOf: - $ref: '#/components/schemas/AudioNormalizationAlgorithmControl' - xml: name: algorithmControl description: When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. CorrectionGateLevel: allOf: - $ref: '#/components/schemas/__integerMinNegative70Max0' - xml: name: correctionGateLevel description: Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. LoudnessLogging: allOf: - $ref: '#/components/schemas/AudioNormalizationLoudnessLogging' - xml: name: loudnessLogging description: If set to LOG, log each output's audio track loudness to a CSV file. PeakCalculation: allOf: - $ref: '#/components/schemas/AudioNormalizationPeakCalculation' - xml: name: peakCalculation description: If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. TargetLkfs: allOf: - $ref: '#/components/schemas/__doubleMinNegative59Max0' - xml: name: targetLkfs description: When you use Audio normalization (AudioNormalizationSettings), optionally use this setting to specify a target loudness. If you don't specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm (algorithm). If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS. TruePeakLimiterThreshold: allOf: - $ref: '#/components/schemas/__doubleMinNegative20Max0' - xml: name: truePeakLimiterThreshold description: Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -20. Leave blank to use the default value 0. description: Advanced audio normalization settings. Ignore these settings unless you need to comply with a loudness standard. ContainerSettings: type: object properties: CmfcSettings: allOf: - $ref: '#/components/schemas/CmfcSettings' - xml: name: cmfcSettings description: These settings relate to the fragmented MP4 container for the segments in your CMAF outputs. Container: allOf: - $ref: '#/components/schemas/ContainerType' - xml: name: container description: Container for this output. Some containers require a container settings object. If not specified, the default object will be created. F4vSettings: allOf: - $ref: '#/components/schemas/F4vSettings' - xml: name: f4vSettings description: Settings for F4v container M2tsSettings: allOf: - $ref: '#/components/schemas/M2tsSettings' - xml: name: m2tsSettings description: MPEG-2 TS container settings. These apply to outputs in a File output group when the output's container (ContainerType) is MPEG-2 Transport Stream (M2TS). In these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset. M3u8Settings: allOf: - $ref: '#/components/schemas/M3u8Settings' - xml: name: m3u8Settings description: These settings relate to the MPEG-2 transport stream (MPEG2-TS) container for the MPEG2-TS segments in your HLS outputs. MovSettings: allOf: - $ref: '#/components/schemas/MovSettings' - xml: name: movSettings description: These settings relate to your QuickTime MOV output container. Mp4Settings: allOf: - $ref: '#/components/schemas/Mp4Settings' - xml: name: mp4Settings description: These settings relate to your MP4 output container. You can create audio only outputs with this container. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/supported-codecs-containers-audio-only.html#output-codecs-and-containers-supported-for-audio-only. MpdSettings: allOf: - $ref: '#/components/schemas/MpdSettings' - xml: name: mpdSettings description: These settings relate to the fragmented MP4 container for the segments in your DASH outputs. MxfSettings: allOf: - $ref: '#/components/schemas/MxfSettings' - xml: name: mxfSettings description: These settings relate to your MXF output container. description: Container specific settings. __integerMin2Max2147483647: type: integer minimum: 2 maximum: 2147483647 Vp9Settings: type: object properties: Bitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max480000000' - xml: name: bitrate description: Target bitrate in bits/second. For example, enter five megabits per second as 5000000. FramerateControl: allOf: - $ref: '#/components/schemas/Vp9FramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/Vp9FramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. GopSize: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: gopSize description: GOP Length (keyframe interval) in frames. Must be greater than zero. HrdBufferSize: allOf: - $ref: '#/components/schemas/__integerMin0Max47185920' - xml: name: hrdBufferSize description: Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000. MaxBitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max480000000' - xml: name: maxBitrate description: Ignore this setting unless you set qualityTuningLevel to MULTI_PASS. Optional. Specify the maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. The default behavior uses twice the target bitrate as the maximum bitrate. ParControl: allOf: - $ref: '#/components/schemas/Vp9ParControl' - xml: name: parControl description: Optional. Specify how the service determines the pixel aspect ratio for this output. The default behavior is to use the same pixel aspect ratio as your input video. ParDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parDenominator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33. ParNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parNumerator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40. QualityTuningLevel: allOf: - $ref: '#/components/schemas/Vp9QualityTuningLevel' - xml: name: qualityTuningLevel description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, multi-pass encoding. RateControlMode: allOf: - $ref: '#/components/schemas/Vp9RateControlMode' - xml: name: rateControlMode description: With the VP9 codec, you can use only the variable bitrate (VBR) rate control mode. description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value VP9. __integerMin16Max24: type: integer minimum: 16 maximum: 24 __integerMin0Max30: type: integer minimum: 0 maximum: 30 AntiAlias: type: string enum: - DISABLED - ENABLED description: The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting. MpdTimedMetadataBoxVersion: type: string enum: - VERSION_0 - VERSION_1 description: 'Specify the event message box (eMSG) version for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax. Leave blank to use the default value Version 0. When you specify Version 1, you must also set ID3 metadata (timedMetadata) to Passthrough.' __integerMinNegative2147483648Max2147483647: type: integer minimum: -2147483648 maximum: 2147483647 ImscAccessibilitySubs: type: string enum: - DISABLED - ENABLED description: 'Set Accessibility subtitles to Enabled if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. When you enable this feature, MediaConvert adds the following attributes under EXT-X-MEDIA in the HLS or CMAF manifest for this track: CHARACTERISTICS="public.accessibility.describes-spoken-dialog,public.accessibility.describes-music-and-sound" and AUTOSELECT="YES". Keep the default value, Disabled, if the captions track is not intended to provide such accessibility. MediaConvert will not add the above attributes.' __integerMin0Max100: type: integer minimum: 0 maximum: 100 AudioLanguageCodeControl: type: string enum: - FOLLOW_INPUT - USE_CONFIGURED description: Specify which source for language code takes precedence for this audio track. When you choose Follow input (FOLLOW_INPUT), the service uses the language code from the input track if it's present. If there's no languge code on the input track, the service uses the code that you specify in the setting Language code (languageCode or customLanguageCode). When you choose Use configured (USE_CONFIGURED), the service uses the language code that you specify. MpdScte35Esam: type: string enum: - INSERT - NONE description: Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml). MpdTimedMetadata: type: string enum: - PASSTHROUGH - NONE description: 'To include ID3 metadata in this output: Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH). Specify this ID3 metadata in Custom ID3 metadata inserter (timedMetadataInsertion). MediaConvert writes each instance of ID3 metadata in a separate Event Message (eMSG) box. To exclude this ID3 metadata: Set ID3 metadata to None (NONE) or leave blank.' __stringPattern01D20305D205D: type: string pattern: ^((([0-1]\d)|(2[0-3]))(:[0-5]\d){2}([:;][0-5]\d))$ TeletextPageType: type: string enum: - PAGE_TYPE_INITIAL - PAGE_TYPE_SUBTITLE - PAGE_TYPE_ADDL_INFO - PAGE_TYPE_PROGRAM_SCHEDULE - PAGE_TYPE_HEARING_IMPAIRED_SUBTITLE description: A page type as defined in the standard ETSI EN 300 468, Table 94 H265UnregisteredSeiTimecode: type: string enum: - DISABLED - ENABLED description: Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Vc3Class: type: string enum: - CLASS_145_8BIT - CLASS_220_8BIT - CLASS_220_10BIT description: Specify the VC3 class to choose the quality characteristics for this output. VC3 class, together with the settings Framerate (framerateNumerator and framerateDenominator) and Resolution (height and width), determine your output bitrate. For example, say that your video resolution is 1920x1080 and your framerate is 29.97. Then Class 145 (CLASS_145) gives you an output with a bitrate of approximately 145 Mbps and Class 220 (CLASS_220) gives you and output with a bitrate of approximately 220 Mbps. VC3 class also specifies the color bit depth of your output. Mpeg2ScanTypeConversionMode: type: string enum: - INTERLACED - INTERLACED_OPTIMIZE description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' Xavc4kProfileQualityTuningLevel: type: string enum: - SINGLE_PASS - SINGLE_PASS_HQ - MULTI_PASS_HQ description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. __integerMin0Max255: type: integer minimum: 0 maximum: 255 __integerMinNegative60Max6: type: integer minimum: -60 maximum: 6 __integerMin96Max600: type: integer minimum: 96 maximum: 600 Av1FramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. __integerMin0Max4194303: type: integer minimum: 0 maximum: 4194303 Vp8ParControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. AvcIntraInterlaceMode: type: string enum: - PROGRESSIVE - TOP_FIELD - BOTTOM_FIELD - FOLLOW_TOP_FIELD - FOLLOW_BOTTOM_FIELD description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. M2tsEsRateInPes: type: string enum: - INCLUDE - EXCLUDE description: Controls whether to include the ES Rate field in the PES header. NoiseReducer: type: object properties: Filter: allOf: - $ref: '#/components/schemas/NoiseReducerFilter' - xml: name: filter description: 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 preserves edges while reducing noise. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) do convolution filtering. * Conserve does min/max noise reduction. * Spatial does frequency-domain filtering based on JND principles. * Temporal optimizes video quality for complex motion. FilterSettings: allOf: - $ref: '#/components/schemas/NoiseReducerFilterSettings' - xml: name: filterSettings description: Settings for a noise reducer filter SpatialFilterSettings: allOf: - $ref: '#/components/schemas/NoiseReducerSpatialFilterSettings' - xml: name: spatialFilterSettings description: Noise reducer filter settings for spatial filter. TemporalFilterSettings: allOf: - $ref: '#/components/schemas/NoiseReducerTemporalFilterSettings' - xml: name: temporalFilterSettings description: Noise reducer filter settings for temporal filter. description: Enable the Noise reducer 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. When you enable Noise reducer, you must also select a value for Noise reducer filter. For AVC outputs, when you include Noise reducer, you cannot include the Bandwidth reduction filter. __integerMinNegative70Max0: type: integer minimum: -70 maximum: 0 __integerMin0Max47185920: type: integer minimum: 0 maximum: 47185920 Mpeg2QualityTuningLevel: type: string enum: - SINGLE_PASS - MULTI_PASS description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. NoiseReducerSpatialFilterSettings: type: object properties: PostFilterSharpenStrength: allOf: - $ref: '#/components/schemas/__integerMin0Max3' - xml: name: postFilterSharpenStrength description: Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength. Speed: allOf: - $ref: '#/components/schemas/__integerMinNegative2Max3' - xml: name: speed description: The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value. Strength: allOf: - $ref: '#/components/schemas/__integerMin0Max16' - xml: name: strength description: Relative strength of noise reducing filter. Higher values produce stronger filtering. description: Noise reducer filter settings for spatial filter. Eac3AtmosMeteringMode: type: string enum: - LEQ_A - ITU_BS_1770_1 - ITU_BS_1770_2 - ITU_BS_1770_3 - ITU_BS_1770_4 description: Choose how the service meters the loudness of your audio. MovCslgAtom: type: string enum: - INCLUDE - EXCLUDE description: 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. WebvttAccessibilitySubs: type: string enum: - DISABLED - ENABLED description: 'Set Accessibility subtitles to Enabled if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. When you enable this feature, MediaConvert adds the following attributes under EXT-X-MEDIA in the HLS or CMAF manifest for this track: CHARACTERISTICS="public.accessibility.describes-spoken-dialog,public.accessibility.describes-music-and-sound" and AUTOSELECT="YES". Keep the default value, Disabled, if the captions track is not intended to provide such accessibility. MediaConvert will not add the above attributes.' MpdCaptionContainerType: type: string enum: - RAW - FRAGMENTED_MP4 description: Use this setting only in DASH output groups that include sidecar TTML or IMSC captions. You specify sidecar captions in a separate output from your audio and video. Choose Raw (RAW) for captions in a single XML file in a raw container. Choose Fragmented MPEG-4 (FRAGMENTED_MP4) for captions in XML format contained within fragmented MP4 files. This set of fragmented MP4 files is separate from your video and audio fragmented MP4 files. H264GopBReference: type: string enum: - DISABLED - ENABLED description: If enable, use reference B frames for GOP structures that have B frames > 1. H264RateControlMode: type: string enum: - VBR - CBR - QVBR description: Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). XavcFramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. M2tsKlvMetadata: type: string enum: - PASSTHROUGH - NONE description: 'To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and passes it through to the output transport stream. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.' Mpeg2FramerateControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. H264Settings: type: object properties: AdaptiveQuantization: allOf: - $ref: '#/components/schemas/H264AdaptiveQuantization' - xml: name: adaptiveQuantization description: 'Keep the default value, Auto (AUTO), for this setting to have MediaConvert automatically apply the best types of quantization for your video content. When you want to apply your quantization settings manually, you must set H264AdaptiveQuantization to a value other than Auto (AUTO). Use this setting to specify the strength of any adaptive quantization filters that you enable. If you don''t want MediaConvert to do any adaptive quantization in this transcode, set Adaptive quantization (H264AdaptiveQuantization) to Off (OFF). Related settings: The value that you choose here applies to the following settings: H264FlickerAdaptiveQuantization, H264SpatialAdaptiveQuantization, and H264TemporalAdaptiveQuantization.' BandwidthReductionFilter: allOf: - $ref: '#/components/schemas/BandwidthReductionFilter' - xml: name: bandwidthReductionFilter description: The Bandwidth reduction filter increases the video quality of your output relative to its bitrate. Use to lower the bitrate of your constant quality QVBR output, with little or no perceptual decrease in quality. Or, use to increase the video quality of outputs with other rate control modes relative to the bitrate that you specify. Bandwidth reduction increases further when your input is low quality or noisy. Outputs that use this feature incur pro-tier pricing. When you include Bandwidth reduction filter, you cannot include the Noise reducer preprocessor. Bitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1152000000' - xml: name: bitrate description: Specify the average bitrate in bits per second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000. CodecLevel: allOf: - $ref: '#/components/schemas/H264CodecLevel' - xml: name: codecLevel description: Specify an H.264 level that is consistent with your output video settings. If you aren't sure what level to specify, choose Auto (AUTO). CodecProfile: allOf: - $ref: '#/components/schemas/H264CodecProfile' - xml: name: codecProfile description: H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. DynamicSubGop: allOf: - $ref: '#/components/schemas/H264DynamicSubGop' - xml: name: dynamicSubGop description: Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). EntropyEncoding: allOf: - $ref: '#/components/schemas/H264EntropyEncoding' - xml: name: entropyEncoding description: Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. FieldEncoding: allOf: - $ref: '#/components/schemas/H264FieldEncoding' - xml: name: fieldEncoding description: The video encoding method for your MPEG-4 AVC output. Keep the default value, PAFF, to have MediaConvert use PAFF encoding for interlaced outputs. Choose Force field (FORCE_FIELD) to disable PAFF encoding and create separate interlaced fields. Choose MBAFF to disable PAFF and have MediaConvert use MBAFF encoding for interlaced outputs. FlickerAdaptiveQuantization: allOf: - $ref: '#/components/schemas/H264FlickerAdaptiveQuantization' - xml: name: flickerAdaptiveQuantization description: Only use this setting when you change the default value, AUTO, for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264AdaptiveQuantization and all other adaptive quantization from your JSON job specification, MediaConvert automatically applies the best types of quantization for your video content. When you set H264AdaptiveQuantization to a value other than AUTO, the default value for H264FlickerAdaptiveQuantization is Disabled (DISABLED). Change this value to Enabled (ENABLED) to reduce I-frame pop. I-frame pop appears as a visual flicker that can arise when the encoder saves bits by copying some macroblocks many times from frame to frame, and then refreshes them at the I-frame. When you enable this setting, the encoder updates these macroblocks slightly more often to smooth out the flicker. To manually enable or disable H264FlickerAdaptiveQuantization, you must set Adaptive quantization (H264AdaptiveQuantization) to a value other than AUTO. FramerateControl: allOf: - $ref: '#/components/schemas/H264FramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/H264FramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. GopBReference: allOf: - $ref: '#/components/schemas/H264GopBReference' - xml: name: gopBReference description: If enable, use reference B frames for GOP structures that have B frames > 1. GopClosedCadence: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: gopClosedCadence description: Specify the relative frequency of open to closed GOPs in this output. For example, if you want to allow four open GOPs and then require a closed GOP, set this value to 5. We recommend that you have the transcoder automatically choose this value for you based on characteristics of your input video. To enable this automatic behavior, keep the default value by leaving this setting out of your JSON job specification. In the console, do this by keeping the default empty value. If you do explicitly specify a value, for segmented outputs, don't set this value to 0. GopSize: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: gopSize description: Use this setting only when you set GOP mode control (GopSizeUnits) to Specified, frames (FRAMES) or Specified, seconds (SECONDS). Specify the GOP length using a whole number of frames or a decimal value of seconds. MediaConvert will interpret this value as frames or seconds depending on the value you choose for GOP mode control (GopSizeUnits). If you want to allow MediaConvert to automatically determine GOP size, leave GOP size blank and set GOP mode control to Auto (AUTO). If your output group specifies HLS, DASH, or CMAF, leave GOP size blank and set GOP mode control to Auto in each output in your output group. GopSizeUnits: allOf: - $ref: '#/components/schemas/H264GopSizeUnits' - xml: name: gopSizeUnits description: Specify how the transcoder determines GOP size for this output. We recommend that you have the transcoder automatically choose this value for you based on characteristics of your input video. To enable this automatic behavior, choose Auto (AUTO) and and leave GOP size (GopSize) blank. By default, if you don't specify GOP mode control (GopSizeUnits), MediaConvert will use automatic behavior. If your output group specifies HLS, DASH, or CMAF, set GOP mode control to Auto and leave GOP size blank in each output in your output group. To explicitly specify the GOP length, choose Specified, frames (FRAMES) or Specified, seconds (SECONDS) and then provide the GOP length in the related setting GOP size (GopSize). HrdBufferFinalFillPercentage: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: hrdBufferFinalFillPercentage description: 'If your downstream systems have strict buffer requirements: Specify the minimum percentage of the HRD buffer that''s available at the end of each encoded video segment. For the best video quality: Set to 0 or leave blank to automatically determine the final buffer fill percentage.' HrdBufferInitialFillPercentage: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: hrdBufferInitialFillPercentage description: Percentage of the buffer that should initially be filled (HRD buffer model). HrdBufferSize: allOf: - $ref: '#/components/schemas/__integerMin0Max1152000000' - xml: name: hrdBufferSize description: Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000. InterlaceMode: allOf: - $ref: '#/components/schemas/H264InterlaceMode' - xml: name: interlaceMode description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. MaxBitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1152000000' - xml: name: maxBitrate description: Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR. MinIInterval: allOf: - $ref: '#/components/schemas/__integerMin0Max30' - xml: name: minIInterval description: Use this setting only when you also enable Scene change detection (SceneChangeDetect). This setting determines how the encoder manages the spacing between I-frames that it inserts as part of the I-frame cadence and the I-frames that it inserts for Scene change detection. We recommend that you have the transcoder automatically choose this value for you based on characteristics of your input video. To enable this automatic behavior, keep the default value by leaving this setting out of your JSON job specification. In the console, do this by keeping the default empty value. When you explicitly specify a value for this setting, the encoder determines whether to skip a cadence-driven I-frame by the value you set. For example, if you set Min I interval (minIInterval) to 5 and a cadence-driven I-frame would fall within 5 frames of a scene-change I-frame, then the encoder skips the cadence-driven I-frame. In this way, one GOP is shrunk slightly and one GOP is stretched slightly. When the cadence-driven I-frames are farther from the scene-change I-frame than the value you set, then the encoder leaves all I-frames in place and the GOPs surrounding the scene change are smaller than the usual cadence GOPs. NumberBFramesBetweenReferenceFrames: allOf: - $ref: '#/components/schemas/__integerMin0Max7' - xml: name: numberBFramesBetweenReferenceFrames description: This setting to determines the number of B-frames that MediaConvert puts between reference frames in this output. We recommend that you use automatic behavior to allow the transcoder to choose the best value based on characteristics of your input video. In the console, choose AUTO to select this automatic behavior. When you manually edit your JSON job specification, leave this setting out to choose automatic behavior. When you want to specify this number explicitly, choose a whole number from 0 through 7. NumberReferenceFrames: allOf: - $ref: '#/components/schemas/__integerMin1Max6' - xml: name: numberReferenceFrames description: Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding. ParControl: allOf: - $ref: '#/components/schemas/H264ParControl' - xml: name: parControl description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. ParDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parDenominator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33. ParNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parNumerator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40. QualityTuningLevel: allOf: - $ref: '#/components/schemas/H264QualityTuningLevel' - xml: name: qualityTuningLevel description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. QvbrSettings: allOf: - $ref: '#/components/schemas/H264QvbrSettings' - xml: name: qvbrSettings description: Settings for quality-defined variable bitrate encoding with the H.265 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode). RateControlMode: allOf: - $ref: '#/components/schemas/H264RateControlMode' - xml: name: rateControlMode description: Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). RepeatPps: allOf: - $ref: '#/components/schemas/H264RepeatPps' - xml: name: repeatPps description: Places a PPS header on each encoded picture, even if repeated. ScanTypeConversionMode: allOf: - $ref: '#/components/schemas/H264ScanTypeConversionMode' - xml: name: scanTypeConversionMode description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' SceneChangeDetect: allOf: - $ref: '#/components/schemas/H264SceneChangeDetect' - xml: name: sceneChangeDetect description: Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. If this output uses QVBR, choose Transition detection (TRANSITION_DETECTION) for further video quality improvement. For more information about QVBR, see https://docs.aws.amazon.com/console/mediaconvert/cbr-vbr-qvbr. Slices: allOf: - $ref: '#/components/schemas/__integerMin1Max32' - xml: name: slices description: 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: allOf: - $ref: '#/components/schemas/H264SlowPal' - xml: name: slowPal description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Softness: allOf: - $ref: '#/components/schemas/__integerMin0Max128' - xml: name: softness description: Ignore this setting unless you need to comply with a specification that requires a specific value. If you don't have a specification requirement, we recommend that you adjust the softness of your output by using a lower value for the setting Sharpness (sharpness) or by enabling a noise reducer filter (noiseReducerFilter). The Softness (softness) setting specifies the quantization matrices that the encoder uses. Keep the default value, 0, for flat quantization. Choose the value 1 or 16 to use the default JVT softening quantization matricies from the H.264 specification. Choose a value from 17 to 128 to use planar interpolation. Increasing values from 17 to 128 result in increasing reduction of high-frequency data. The value 128 results in the softest video. SpatialAdaptiveQuantization: allOf: - $ref: '#/components/schemas/H264SpatialAdaptiveQuantization' - xml: name: spatialAdaptiveQuantization description: 'Only use this setting when you change the default value, Auto (AUTO), for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264AdaptiveQuantization and all other adaptive quantization from your JSON job specification, MediaConvert automatically applies the best types of quantization for your video content. When you set H264AdaptiveQuantization to a value other than AUTO, the default value for H264SpatialAdaptiveQuantization is Enabled (ENABLED). Keep this default value to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to set H264SpatialAdaptiveQuantization to Disabled (DISABLED). Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (H264AdaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher. To manually enable or disable H264SpatialAdaptiveQuantization, you must set Adaptive quantization (H264AdaptiveQuantization) to a value other than AUTO.' Syntax: allOf: - $ref: '#/components/schemas/H264Syntax' - xml: name: syntax description: Produces a bitstream compliant with SMPTE RP-2027. Telecine: allOf: - $ref: '#/components/schemas/H264Telecine' - xml: name: telecine description: When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or soft telecine to create a smoother picture. Hard telecine (HARD) produces a 29.97i output. Soft telecine (SOFT) produces an output with a 23.976 output that signals to the video player device to do the conversion during play back. When you keep the default value, None (NONE), MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture. TemporalAdaptiveQuantization: allOf: - $ref: '#/components/schemas/H264TemporalAdaptiveQuantization' - xml: name: temporalAdaptiveQuantization description: 'Only use this setting when you change the default value, AUTO, for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264AdaptiveQuantization and all other adaptive quantization from your JSON job specification, MediaConvert automatically applies the best types of quantization for your video content. When you set H264AdaptiveQuantization to a value other than AUTO, the default value for H264TemporalAdaptiveQuantization is Enabled (ENABLED). Keep this default value to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren''t moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn''t have moving objects with sharp edges, such as sports athletes'' faces, you might choose to set H264TemporalAdaptiveQuantization to Disabled (DISABLED). Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization (adaptiveQuantization). To manually enable or disable H264TemporalAdaptiveQuantization, you must set Adaptive quantization (H264AdaptiveQuantization) to a value other than AUTO.' UnregisteredSeiTimecode: allOf: - $ref: '#/components/schemas/H264UnregisteredSeiTimecode' - xml: name: unregisteredSeiTimecode description: Inserts timecode for each frame as 4 bytes of an unregistered SEI message. description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264. __integerMin24Max60000: type: integer minimum: 24 maximum: 60000 H265CodecProfile: type: string enum: - MAIN_MAIN - MAIN_HIGH - MAIN10_MAIN - MAIN10_HIGH - MAIN_422_8BIT_MAIN - MAIN_422_8BIT_HIGH - MAIN_422_10BIT_MAIN - MAIN_422_10BIT_HIGH description: 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. __integerMin90Max105: type: integer minimum: 90 maximum: 105 __integerMin1000Max1466400000: type: integer minimum: 1000 maximum: 1466400000 Vp8Settings: type: object properties: Bitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1152000000' - xml: name: bitrate description: Target bitrate in bits/second. For example, enter five megabits per second as 5000000. FramerateControl: allOf: - $ref: '#/components/schemas/Vp8FramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/Vp8FramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. GopSize: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: gopSize description: GOP Length (keyframe interval) in frames. Must be greater than zero. HrdBufferSize: allOf: - $ref: '#/components/schemas/__integerMin0Max47185920' - xml: name: hrdBufferSize description: Optional. Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000. MaxBitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1152000000' - xml: name: maxBitrate description: Ignore this setting unless you set qualityTuningLevel to MULTI_PASS. Optional. Specify the maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. The default behavior uses twice the target bitrate as the maximum bitrate. ParControl: allOf: - $ref: '#/components/schemas/Vp8ParControl' - xml: name: parControl description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. ParDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parDenominator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33. ParNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parNumerator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40. QualityTuningLevel: allOf: - $ref: '#/components/schemas/Vp8QualityTuningLevel' - xml: name: qualityTuningLevel description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, multi-pass encoding. RateControlMode: allOf: - $ref: '#/components/schemas/Vp8RateControlMode' - xml: name: rateControlMode description: With the VP8 codec, you can use only the variable bitrate (VBR) rate control mode. description: Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value VP8. Eac3AtmosDynamicRangeCompressionLine: type: string enum: - NONE - FILM_STANDARD - FILM_LIGHT - MUSIC_STANDARD - MUSIC_LIGHT - SPEECH description: 'Choose the Dolby dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby stream for the line operating mode. Default value: Film light (ATMOS_STORAGE_DDP_COMPR_FILM_LIGHT) Related setting: To have MediaConvert use the value you specify here, keep the default value, Custom (SPECIFIED) for the setting Dynamic range control (DynamicRangeControl). Otherwise, MediaConvert ignores Dynamic range compression line (DynamicRangeCompressionLine). For information about the Dolby DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' BandwidthReductionFilterStrength: type: string enum: - LOW - MEDIUM - HIGH - AUTO - false description: Specify the strength of the Bandwidth reduction filter. For most workflows, we recommend that you choose Auto to reduce the bandwidth of your output with little to no perceptual decrease in video quality. For high quality and high bitrate outputs, choose Low. For the most bandwidth reduction, choose High. We recommend that you choose High for low bitrate outputs. Note that High may incur a slight increase in the softness of your output. H265FramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. __integerMin64000Max640000: type: integer minimum: 64000 maximum: 640000 DvbSubtitleBackgroundColor: type: string enum: - NONE - BLACK - WHITE - AUTO description: Specify the color of the rectangle behind the captions. Leave background color (BackgroundColor) blank and set Style passthrough (StylePassthrough) to enabled to use the background color data from your input captions, if present. __integerMin0Max128: type: integer minimum: 0 maximum: 128 BurninSubtitleAlignment: type: string enum: - CENTERED - LEFT - AUTO description: Specify the alignment of your captions. If no explicit x_position is provided, setting alignment to centered will placethe captions at the bottom center of the output. Similarly, setting a left alignment willalign 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. MpdScte35Source: type: string enum: - PASSTHROUGH - NONE description: Ignore this setting unless you have SCTE-35 markers in your input video file. Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None (NONE) if you don't want those SCTE-35 markers in this output. __stringPatternWS: type: string pattern: ^[\w\s]*$ H264TemporalAdaptiveQuantization: type: string enum: - DISABLED - ENABLED description: 'Only use this setting when you change the default value, AUTO, for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264AdaptiveQuantization and all other adaptive quantization from your JSON job specification, MediaConvert automatically applies the best types of quantization for your video content. When you set H264AdaptiveQuantization to a value other than AUTO, the default value for H264TemporalAdaptiveQuantization is Enabled (ENABLED). Keep this default value to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren''t moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn''t have moving objects with sharp edges, such as sports athletes'' faces, you might choose to set H264TemporalAdaptiveQuantization to Disabled (DISABLED). Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization (adaptiveQuantization). To manually enable or disable H264TemporalAdaptiveQuantization, you must set Adaptive quantization (H264AdaptiveQuantization) to a value other than AUTO.' __integerMin25Max10000: type: integer minimum: 25 maximum: 10000 __integerMin0Max4: type: integer minimum: 0 maximum: 4 __stringPattern: type: string pattern: ^[ -~]+$ __integerMin32000Max48000: type: integer minimum: 32000 maximum: 48000 BandwidthReductionFilter: type: object properties: Sharpening: allOf: - $ref: '#/components/schemas/BandwidthReductionFilterSharpening' - xml: name: sharpening description: Optionally specify the level of sharpening to apply when you use the Bandwidth reduction filter. Sharpening adds contrast to the edges of your video content and can reduce softness. Keep the default value Off to apply no sharpening. Set Sharpening strength to Low to apply a minimal amount of sharpening, or High to apply a maximum amount of sharpening. Strength: allOf: - $ref: '#/components/schemas/BandwidthReductionFilterStrength' - xml: name: strength description: Specify the strength of the Bandwidth reduction filter. For most workflows, we recommend that you choose Auto to reduce the bandwidth of your output with little to no perceptual decrease in video quality. For high quality and high bitrate outputs, choose Low. For the most bandwidth reduction, choose High. We recommend that you choose High for low bitrate outputs. Note that High may incur a slight increase in the softness of your output. description: The Bandwidth reduction filter increases the video quality of your output relative to its bitrate. Use to lower the bitrate of your constant quality QVBR output, with little or no perceptual decrease in quality. Or, use to increase the video quality of outputs with other rate control modes relative to the bitrate that you specify. Bandwidth reduction increases further when your input is low quality or noisy. Outputs that use this feature incur pro-tier pricing. When you include Bandwidth reduction filter, you cannot include the Noise reducer preprocessor. BurnInSubtitleStylePassthrough: type: string enum: - ENABLED - DISABLED description: 'Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses default settings for any missing style and position information in your input captions. Set Style passthrough to DISABLED, or leave blank, to ignore the style and position information from your input captions and use default settings: white text with black outlining, bottom-center positioning, and automatic sizing. Whether you set Style passthrough to enabled or not, you can also choose to manually override any of the individual style and position settings.' Mp4CslgAtom: type: string enum: - INCLUDE - EXCLUDE description: 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. DvbNitSettings: type: object properties: NetworkId: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: networkId description: The numeric value placed in the Network Information Table (NIT). NetworkName: allOf: - $ref: '#/components/schemas/__stringMin1Max256' - xml: name: networkName description: The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters. NitInterval: allOf: - $ref: '#/components/schemas/__integerMin25Max10000' - xml: name: nitInterval description: The number of milliseconds between instances of this table in the output transport stream. description: Use these settings to insert a DVB Network Information Table (NIT) in the transport stream of this output. When you work directly in your JSON job specification, include this object only when your job has a transport stream output and the container settings contain the object M2tsSettings. Ac3Settings: type: object properties: Bitrate: allOf: - $ref: '#/components/schemas/__integerMin64000Max640000' - xml: name: bitrate description: 'Specify the average bitrate in bits per second. The bitrate that you specify must be a multiple of 8000 within the allowed minimum and maximum values. Leave blank to use the default bitrate for the coding mode you select according ETSI TS 102 366. Valid bitrates for coding mode 1/0: Default: 96000. Minimum: 64000. Maximum: 128000. Valid bitrates for coding mode 1/1: Default: 192000. Minimum: 128000. Maximum: 384000. Valid bitrates for coding mode 2/0: Default: 192000. Minimum: 128000. Maximum: 384000. Valid bitrates for coding mode 3/2 with FLE: Default: 384000. Minimum: 384000. Maximum: 640000.' BitstreamMode: allOf: - $ref: '#/components/schemas/Ac3BitstreamMode' - xml: name: bitstreamMode description: Specify the bitstream mode for the AC-3 stream that the encoder emits. For more information about the AC3 bitstream mode, see ATSC A/52-2012 (Annex E). CodingMode: allOf: - $ref: '#/components/schemas/Ac3CodingMode' - xml: name: codingMode description: Dolby Digital coding mode. Determines number of channels. Dialnorm: allOf: - $ref: '#/components/schemas/__integerMin1Max31' - xml: name: dialnorm description: Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through. DynamicRangeCompressionLine: allOf: - $ref: '#/components/schemas/Ac3DynamicRangeCompressionLine' - xml: name: dynamicRangeCompressionLine description: 'Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the line operating mode. Related setting: When you use this setting, MediaConvert ignores any value you provide for Dynamic range compression profile (DynamicRangeCompressionProfile). For information about the Dolby Digital DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' DynamicRangeCompressionProfile: allOf: - $ref: '#/components/schemas/Ac3DynamicRangeCompressionProfile' - xml: name: dynamicRangeCompressionProfile description: When you want to add Dolby dynamic range compression (DRC) signaling to your output stream, we recommend that you use the mode-specific settings instead of Dynamic range compression profile (DynamicRangeCompressionProfile). The mode-specific settings are Dynamic range compression profile, line mode (dynamicRangeCompressionLine) and Dynamic range compression profile, RF mode (dynamicRangeCompressionRf). Note that when you specify values for all three settings, MediaConvert ignores the value of this setting in favor of the mode-specific settings. If you do use this setting instead of the mode-specific settings, choose None (NONE) to leave out DRC signaling. Keep the default Film standard (FILM_STANDARD) to set the profile to Dolby's film standard profile for all operating modes. DynamicRangeCompressionRf: allOf: - $ref: '#/components/schemas/Ac3DynamicRangeCompressionRf' - xml: name: dynamicRangeCompressionRf description: 'Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the RF operating mode. Related setting: When you use this setting, MediaConvert ignores any value you provide for Dynamic range compression profile (DynamicRangeCompressionProfile). For information about the Dolby Digital DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' LfeFilter: allOf: - $ref: '#/components/schemas/Ac3LfeFilter' - xml: name: lfeFilter description: Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. MetadataControl: allOf: - $ref: '#/components/schemas/Ac3MetadataControl' - xml: name: metadataControl description: 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: allOf: - $ref: '#/components/schemas/__integerMin48000Max48000' - xml: name: sampleRate description: This value is always 48000. It represents the sample rate in Hz. description: Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3. Ac3DynamicRangeCompressionRf: type: string enum: - FILM_STANDARD - FILM_LIGHT - MUSIC_STANDARD - MUSIC_LIGHT - SPEECH - NONE description: 'Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the RF operating mode. Related setting: When you use this setting, MediaConvert ignores any value you provide for Dynamic range compression profile (DynamicRangeCompressionProfile). For information about the Dolby Digital DRC operating modes and profiles, see the Dynamic Range Control chapter of the Dolby Metadata Guide at https://developer.dolby.com/globalassets/professional/documents/dolby-metadata-guide.pdf.' Vp9ParControl: type: string enum: - INITIALIZE_FROM_SOURCE - SPECIFIED description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. Av1RateControlMode: type: string enum: - QVBR description: '''With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''''t use CBR or VBR.''' M2tsSegmentationStyle: type: string enum: - MAINTAIN_CADENCE - RESET_CADENCE description: 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. H265WriteMp4PackagingType: type: string enum: - HVC1 - HEV1 description: 'If the location of parameter set NAL units doesn''t matter in your workflow, ignore this setting. Use this setting only with CMAF or DASH outputs, or with standalone file outputs in an MPEG-4 container (MP4 outputs). Choose HVC1 to mark your output as HVC1. This makes your output compliant with the following specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. For MP4 outputs, when you choose HVC1, your output video might not work properly with some downstream systems and video players. The service defaults to marking your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples.' H265Settings: type: object properties: AdaptiveQuantization: allOf: - $ref: '#/components/schemas/H265AdaptiveQuantization' - xml: name: adaptiveQuantization description: When you set Adaptive Quantization (H265AdaptiveQuantization) to Auto (AUTO), or leave blank, MediaConvert automatically applies quantization to improve the video quality of your output. Set Adaptive Quantization to Low (LOW), Medium (MEDIUM), High (HIGH), Higher (HIGHER), or Max (MAX) to manually control the strength of the quantization filter. When you do, you can specify a value for Spatial Adaptive Quantization (H265SpatialAdaptiveQuantization), Temporal Adaptive Quantization (H265TemporalAdaptiveQuantization), and Flicker Adaptive Quantization (H265FlickerAdaptiveQuantization), to further control the quantization filter. Set Adaptive Quantization to Off (OFF) to apply no quantization to your output. AlternateTransferFunctionSei: allOf: - $ref: '#/components/schemas/H265AlternateTransferFunctionSei' - xml: name: alternateTransferFunctionSei description: Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Bitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1466400000' - xml: name: bitrate description: Specify the average bitrate in bits per second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000. CodecLevel: allOf: - $ref: '#/components/schemas/H265CodecLevel' - xml: name: codecLevel description: H.265 Level. CodecProfile: allOf: - $ref: '#/components/schemas/H265CodecProfile' - xml: name: codecProfile description: 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. DynamicSubGop: allOf: - $ref: '#/components/schemas/H265DynamicSubGop' - xml: name: dynamicSubGop description: Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). FlickerAdaptiveQuantization: allOf: - $ref: '#/components/schemas/H265FlickerAdaptiveQuantization' - xml: name: flickerAdaptiveQuantization description: 'Enable this setting to have the encoder reduce I-frame pop. I-frame pop appears as a visual flicker that can arise when the encoder saves bits by copying some macroblocks many times from frame to frame, and then refreshes them at the I-frame. When you enable this setting, the encoder updates these macroblocks slightly more often to smooth out the flicker. This setting is disabled by default. Related setting: In addition to enabling this setting, you must also set adaptiveQuantization to a value other than Off (OFF).' FramerateControl: allOf: - $ref: '#/components/schemas/H265FramerateControl' - xml: name: framerateControl description: If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. FramerateConversionAlgorithm: allOf: - $ref: '#/components/schemas/H265FramerateConversionAlgorithm' - xml: name: framerateConversionAlgorithm description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. FramerateDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateDenominator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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 frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. FramerateNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: framerateNumerator description: When you use the API for transcode jobs that use frame rate conversion, specify the frame rate 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. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976. GopBReference: allOf: - $ref: '#/components/schemas/H265GopBReference' - xml: name: gopBReference description: If enable, use reference B frames for GOP structures that have B frames > 1. GopClosedCadence: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: gopClosedCadence description: Specify the relative frequency of open to closed GOPs in this output. For example, if you want to allow four open GOPs and then require a closed GOP, set this value to 5. We recommend that you have the transcoder automatically choose this value for you based on characteristics of your input video. To enable this automatic behavior, keep the default value by leaving this setting out of your JSON job specification. In the console, do this by keeping the default empty value. If you do explicitly specify a value, for segmented outputs, don't set this value to 0. GopSize: allOf: - $ref: '#/components/schemas/__doubleMin0' - xml: name: gopSize description: Use this setting only when you set GOP mode control (GopSizeUnits) to Specified, frames (FRAMES) or Specified, seconds (SECONDS). Specify the GOP length using a whole number of frames or a decimal value of seconds. MediaConvert will interpret this value as frames or seconds depending on the value you choose for GOP mode control (GopSizeUnits). If you want to allow MediaConvert to automatically determine GOP size, leave GOP size blank and set GOP mode control to Auto (AUTO). If your output group specifies HLS, DASH, or CMAF, leave GOP size blank and set GOP mode control to Auto in each output in your output group. GopSizeUnits: allOf: - $ref: '#/components/schemas/H265GopSizeUnits' - xml: name: gopSizeUnits description: Specify how the transcoder determines GOP size for this output. We recommend that you have the transcoder automatically choose this value for you based on characteristics of your input video. To enable this automatic behavior, choose Auto (AUTO) and and leave GOP size (GopSize) blank. By default, if you don't specify GOP mode control (GopSizeUnits), MediaConvert will use automatic behavior. If your output group specifies HLS, DASH, or CMAF, set GOP mode control to Auto and leave GOP size blank in each output in your output group. To explicitly specify the GOP length, choose Specified, frames (FRAMES) or Specified, seconds (SECONDS) and then provide the GOP length in the related setting GOP size (GopSize). HrdBufferFinalFillPercentage: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: hrdBufferFinalFillPercentage description: 'If your downstream systems have strict buffer requirements: Specify the minimum percentage of the HRD buffer that''s available at the end of each encoded video segment. For the best video quality: Set to 0 or leave blank to automatically determine the final buffer fill percentage.' HrdBufferInitialFillPercentage: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: hrdBufferInitialFillPercentage description: Percentage of the buffer that should initially be filled (HRD buffer model). HrdBufferSize: allOf: - $ref: '#/components/schemas/__integerMin0Max1466400000' - xml: name: hrdBufferSize description: Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000. InterlaceMode: allOf: - $ref: '#/components/schemas/H265InterlaceMode' - xml: name: interlaceMode description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. MaxBitrate: allOf: - $ref: '#/components/schemas/__integerMin1000Max1466400000' - xml: name: maxBitrate description: Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR. MinIInterval: allOf: - $ref: '#/components/schemas/__integerMin0Max30' - xml: name: minIInterval description: Use this setting only when you also enable Scene change detection (SceneChangeDetect). This setting determines how the encoder manages the spacing between I-frames that it inserts as part of the I-frame cadence and the I-frames that it inserts for Scene change detection. We recommend that you have the transcoder automatically choose this value for you based on characteristics of your input video. To enable this automatic behavior, keep the default value by leaving this setting out of your JSON job specification. In the console, do this by keeping the default empty value. When you explicitly specify a value for this setting, the encoder determines whether to skip a cadence-driven I-frame by the value you set. For example, if you set Min I interval (minIInterval) to 5 and a cadence-driven I-frame would fall within 5 frames of a scene-change I-frame, then the encoder skips the cadence-driven I-frame. In this way, one GOP is shrunk slightly and one GOP is stretched slightly. When the cadence-driven I-frames are farther from the scene-change I-frame than the value you set, then the encoder leaves all I-frames in place and the GOPs surrounding the scene change are smaller than the usual cadence GOPs. NumberBFramesBetweenReferenceFrames: allOf: - $ref: '#/components/schemas/__integerMin0Max7' - xml: name: numberBFramesBetweenReferenceFrames description: Specify the number of B-frames that MediaConvert puts between reference frames in this output. Valid values are whole numbers from 0 through 7. When you don't specify a value, MediaConvert defaults to 2. NumberReferenceFrames: allOf: - $ref: '#/components/schemas/__integerMin1Max6' - xml: name: numberReferenceFrames description: Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding. ParControl: allOf: - $ref: '#/components/schemas/H265ParControl' - xml: name: parControl description: Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings. ParDenominator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parDenominator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33. ParNumerator: allOf: - $ref: '#/components/schemas/__integerMin1Max2147483647' - xml: name: parNumerator description: Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40. QualityTuningLevel: allOf: - $ref: '#/components/schemas/H265QualityTuningLevel' - xml: name: qualityTuningLevel description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. QvbrSettings: allOf: - $ref: '#/components/schemas/H265QvbrSettings' - xml: name: qvbrSettings description: Settings for quality-defined variable bitrate encoding with the H.265 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode). RateControlMode: allOf: - $ref: '#/components/schemas/H265RateControlMode' - xml: name: rateControlMode description: Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). SampleAdaptiveOffsetFilterMode: allOf: - $ref: '#/components/schemas/H265SampleAdaptiveOffsetFilterMode' - xml: name: sampleAdaptiveOffsetFilterMode description: Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content ScanTypeConversionMode: allOf: - $ref: '#/components/schemas/H265ScanTypeConversionMode' - xml: name: scanTypeConversionMode description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' SceneChangeDetect: allOf: - $ref: '#/components/schemas/H265SceneChangeDetect' - xml: name: sceneChangeDetect description: Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. If this output uses QVBR, choose Transition detection (TRANSITION_DETECTION) for further video quality improvement. For more information about QVBR, see https://docs.aws.amazon.com/console/mediaconvert/cbr-vbr-qvbr. Slices: allOf: - $ref: '#/components/schemas/__integerMin1Max32' - xml: name: slices description: 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: allOf: - $ref: '#/components/schemas/H265SlowPal' - xml: name: slowPal description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' SpatialAdaptiveQuantization: allOf: - $ref: '#/components/schemas/H265SpatialAdaptiveQuantization' - xml: name: spatialAdaptiveQuantization description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization (adaptiveQuantization) depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.' Telecine: allOf: - $ref: '#/components/schemas/H265Telecine' - xml: name: telecine description: '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: allOf: - $ref: '#/components/schemas/H265TemporalAdaptiveQuantization' - xml: name: temporalAdaptiveQuantization description: 'Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren''t moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn''t take into account where the viewer''s attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn''t have moving objects with sharp edges, such as sports athletes'' faces, you might choose to disable this feature. Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization (adaptiveQuantization).' TemporalIds: allOf: - $ref: '#/components/schemas/H265TemporalIds' - xml: name: temporalIds description: '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: allOf: - $ref: '#/components/schemas/H265Tiles' - xml: name: tiles description: Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. UnregisteredSeiTimecode: allOf: - $ref: '#/components/schemas/H265UnregisteredSeiTimecode' - xml: name: unregisteredSeiTimecode description: Inserts timecode for each frame as 4 bytes of an unregistered SEI message. WriteMp4PackagingType: allOf: - $ref: '#/components/schemas/H265WriteMp4PackagingType' - xml: name: writeMp4PackagingType description: 'If the location of parameter set NAL units doesn''t matter in your workflow, ignore this setting. Use this setting only with CMAF or DASH outputs, or with standalone file outputs in an MPEG-4 container (MP4 outputs). Choose HVC1 to mark your output as HVC1. This makes your output compliant with the following specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. For MP4 outputs, when you choose HVC1, your output video might not work properly with some downstream systems and video players. The service defaults to marking your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples.' description: Settings for H265 codec AvcIntraUhdQualityTuningLevel: type: string enum: - SINGLE_PASS - MULTI_PASS description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how many transcoding passes MediaConvert does with your video. When you choose Multi-pass (MULTI_PASS), your video quality is better and your output bitrate is more accurate. That is, the actual bitrate of your output is closer to the target bitrate defined in the specification. When you choose Single-pass (SINGLE_PASS), your encoding time is faster. The default behavior is Single-pass (SINGLE_PASS). VideoDescription: type: object properties: AfdSignaling: allOf: - $ref: '#/components/schemas/AfdSignaling' - xml: name: afdSignaling description: This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes 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: allOf: - $ref: '#/components/schemas/AntiAlias' - xml: name: antiAlias description: The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting. CodecSettings: allOf: - $ref: '#/components/schemas/VideoCodecSettings' - xml: name: codecSettings description: 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 that you choose for Video codec (Codec). For each codec enum that you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AV1, Av1Settings * AVC_INTRA, AvcIntraSettings * FRAME_CAPTURE, FrameCaptureSettings * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * VC3, Vc3Settings * VP8, Vp8Settings * VP9, Vp9Settings * XAVC, XavcSettings ColorMetadata: allOf: - $ref: '#/components/schemas/ColorMetadata' - xml: name: colorMetadata description: Choose Insert (INSERT) for this setting to include color metadata in this output. Choose Ignore (IGNORE) to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default. Crop: allOf: - $ref: '#/components/schemas/Rectangle' - xml: name: crop description: Use Cropping selection (crop) to specify the video area that the service will include in the output video frame. DropFrameTimecode: allOf: - $ref: '#/components/schemas/DropFrameTimecode' - xml: name: dropFrameTimecode description: 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: allOf: - $ref: '#/components/schemas/__integerMin0Max15' - xml: name: fixedAfd description: 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: allOf: - $ref: '#/components/schemas/__integerMin32Max8192' - xml: name: height description: 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: allOf: - $ref: '#/components/schemas/Rectangle' - xml: name: position description: Use Selection placement (position) to define the video area in your output frame. The area outside of the rectangle that you specify here is black. RespondToAfd: allOf: - $ref: '#/components/schemas/RespondToAfd' - xml: name: respondToAfd description: 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: allOf: - $ref: '#/components/schemas/ScalingBehavior' - xml: name: scalingBehavior description: Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio. Choose Stretch to output (STRETCH_TO_OUTPUT) to have the service stretch your video image to fit. Keep the setting Default (DEFAULT) to have the service letterbox your video instead. This setting overrides any value that you specify for the setting Selection placement (position) in this output. Sharpness: allOf: - $ref: '#/components/schemas/__integerMin0Max100' - xml: name: sharpness description: 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. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content. TimecodeInsertion: allOf: - $ref: '#/components/schemas/VideoTimecodeInsertion' - xml: name: timecodeInsertion description: Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. VideoPreprocessors: allOf: - $ref: '#/components/schemas/VideoPreprocessor' - xml: name: videoPreprocessors description: Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default. Width: allOf: - $ref: '#/components/schemas/__integerMin32Max8192' - xml: name: width description: 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. description: Settings related to video encoding of your output. The specific video settings depend on the video codec that you choose. When you work directly in your JSON job specification, include one instance of Video description (VideoDescription) per output. DolbyVision: type: object properties: L6Metadata: allOf: - $ref: '#/components/schemas/DolbyVisionLevel6Metadata' - xml: name: l6Metadata description: Use these settings when you set DolbyVisionLevel6Mode to SPECIFY to override the MaxCLL and MaxFALL values in your input with new values. L6Mode: allOf: - $ref: '#/components/schemas/DolbyVisionLevel6Mode' - xml: name: l6Mode description: Use Dolby Vision Mode to choose how the service will handle Dolby Vision MaxCLL and MaxFALL properies. Mapping: allOf: - $ref: '#/components/schemas/DolbyVisionMapping' - xml: name: mapping description: Required when you set Dolby Vision Profile to Profile 8.1. When you set Content mapping to None, content mapping is not applied to the HDR10-compatible signal. Depending on the source peak nit level, clipping might occur on HDR devices without Dolby Vision. When you set Content mapping to HDR10 1000, the transcoder creates a 1,000 nits peak HDR10-compatible signal by applying static content mapping to the source. This mode is speed-optimized for PQ10 sources with metadata that is created from analysis. For graded Dolby Vision content, be aware that creative intent might not be guaranteed with extreme 1,000 nits trims. Profile: allOf: - $ref: '#/components/schemas/DolbyVisionProfile' - xml: name: profile description: Required when you enable Dolby Vision. Use Profile 5 to include frame-interleaved Dolby Vision metadata in your output. Your input must include Dolby Vision metadata or an HDR10 YUV color space. Use Profile 8.1 to include frame-interleaved Dolby Vision metadata and HDR10 metadata in your output. Your input must include Dolby Vision metadata. description: Create Dolby Vision Profile 5 or Profile 8.1 compatible video output. ContainerType: type: string enum: - F4V - ISMV - M2TS - M3U8 - CMFC - MOV - MP4 - MPD - MXF - WEBM - RAW description: Container for this output. Some containers require a container settings object. If not specified, the default object will be created. __integerMin1Max2: type: integer minimum: 1 maximum: 2 __timestampUnix: type: string format: date-time Eac3AtmosBitstreamMode: type: string enum: - COMPLETE_MAIN description: Specify the bitstream mode for the E-AC-3 stream that the encoder emits. For more information about the EAC3 bitstream mode, see ATSC A/52-2012 (Annex E). DvbTdtSettings: type: object properties: TdtInterval: allOf: - $ref: '#/components/schemas/__integerMin1000Max30000' - xml: name: tdtInterval description: The number of milliseconds between instances of this table in the output transport stream. description: Use these settings to insert a DVB Time and Date Table (TDT) in the transport stream of this output. When you work directly in your JSON job specification, include this object only when your job has a transport stream output and the container settings contain the object M2tsSettings. Mpeg2FramerateConversionAlgorithm: type: string enum: - DUPLICATE_DROP - INTERPOLATE - FRAMEFORMER description: Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. __doubleMinNegative60Max3: type: number format: double Eac3StereoDownmix: type: string enum: - NOT_INDICATED - LO_RO - LT_RT - DPL2 description: Choose how the service does stereo downmixing. This setting only applies if you keep the default value of 3/2 - L, R, C, Ls, Rs (CODING_MODE_3_2) for the setting Coding mode (Eac3CodingMode). If you choose a different value for Coding mode, the service ignores Stereo downmix (Eac3StereoDownmix). AvcIntraScanTypeConversionMode: type: string enum: - INTERLACED - INTERLACED_OPTIMIZE description: 'Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing (INTERLACED), for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn''t suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine (telecine) to None (NONE) or Soft (SOFT). You can''t use optimized interlacing for hard telecine outputs. You must also set Interlace mode (interlaceMode) to a value other than Progressive (PROGRESSIVE).' AvcIntraSlowPal: type: string enum: - DISABLED - ENABLED description: 'Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25. In your JSON job specification, set (framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and (framerateDenominator) to 1.' Av1QvbrSettings: type: object properties: QvbrQualityLevel: allOf: - $ref: '#/components/schemas/__integerMin1Max10' - xml: name: qvbrQualityLevel description: Use this setting only when you set Rate control mode (RateControlMode) to QVBR. Specify the target quality level for this output. MediaConvert determines the right number of bits to use for each part of the video to maintain the video quality that you specify. When you keep the default value, AUTO, MediaConvert picks a quality level for you, based on characteristics of your input video. If you prefer to specify a quality level, specify a number from 1 through 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9. Optionally, to specify a value between whole numbers, also provide a value for the setting qvbrQualityLevelFineTune. For example, if you want your QVBR quality level to be 7.33, set qvbrQualityLevel to 7 and set qvbrQualityLevelFineTune to .33. QvbrQualityLevelFineTune: allOf: - $ref: '#/components/schemas/__doubleMin0Max1' - xml: name: qvbrQualityLevelFineTune description: Optional. Specify a value here to set the QVBR quality to a level that is between whole numbers. For example, if you want your QVBR quality level to be 7.33, set qvbrQualityLevel to 7 and set qvbrQualityLevelFineTune to .33. MediaConvert rounds your QVBR quality level to the nearest third of a whole number. For example, if you set qvbrQualityLevel to 7 and you set qvbrQualityLevelFineTune to .25, your actual QVBR quality level is 7.33. description: Settings for quality-defined variable bitrate encoding with the AV1 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode). M3u8AudioDuration: type: string enum: - DEFAULT_CODEC_DURATION - MATCH_VIDEO_DURATION description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. OutputChannelMapping: type: object properties: InputChannels: allOf: - $ref: '#/components/schemas/__listOf__integerMinNegative60Max6' - xml: name: inputChannels description: Use this setting to specify your remix values when they are integers, such as -10, 0, or 4. InputChannelsFineTune: allOf: - $ref: '#/components/schemas/__listOf__doubleMinNegative60Max6' - xml: name: inputChannelsFineTune description: Use this setting to specify your remix values when they have a decimal component, such as -10.312, 0.08, or 4.9. MediaConvert rounds your remixing values to the nearest thousandth. description: OutputChannel mapping settings. Xavc4kIntraVbrProfileClass: type: string enum: - CLASS_100 - CLASS_300 - CLASS_480 description: Specify the XAVC Intra 4k (VBR) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. M3u8Settings: type: object properties: AudioDuration: allOf: - $ref: '#/components/schemas/M3u8AudioDuration' - xml: name: audioDuration description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. AudioFramesPerPes: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: audioFramesPerPes description: The number of audio frames to insert for each PES packet. AudioPids: allOf: - $ref: '#/components/schemas/__listOf__integerMin32Max8182' - xml: name: audioPids description: 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. DataPTSControl: allOf: - $ref: '#/components/schemas/M3u8DataPtsControl' - xml: name: dataPTSControl description: If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values). Keep the default value (AUTO) to allow all PTS values. MaxPcrInterval: allOf: - $ref: '#/components/schemas/__integerMin0Max500' - xml: name: maxPcrInterval description: Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream. NielsenId3: allOf: - $ref: '#/components/schemas/M3u8NielsenId3' - xml: name: nielsenId3 description: 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: allOf: - $ref: '#/components/schemas/__integerMin0Max1000' - xml: name: patInterval description: The number of milliseconds between instances of this table in the output transport stream. PcrControl: allOf: - $ref: '#/components/schemas/M3u8PcrControl' - xml: name: pcrControl description: 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: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: pcrPid description: 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: allOf: - $ref: '#/components/schemas/__integerMin0Max1000' - xml: name: pmtInterval description: The number of milliseconds between instances of this table in the output transport stream. PmtPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: pmtPid description: Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream. PrivateMetadataPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: privateMetadataPid description: Packet Identifier (PID) of the private metadata stream in the transport stream. ProgramNumber: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: programNumber description: The value of the program number field in the Program Map Table. Scte35Pid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: scte35Pid description: Packet Identifier (PID) of the SCTE-35 stream in the transport stream. Scte35Source: allOf: - $ref: '#/components/schemas/M3u8Scte35Source' - xml: name: scte35Source description: For SCTE-35 markers from your input-- Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None (NONE) if you don't want SCTE-35 markers in this output. For SCTE-35 markers from an ESAM XML document-- Choose None (NONE) if you don't want manifest conditioning. Choose Passthrough (PASSTHROUGH) and choose Ad markers (adMarkers) if you do want manifest conditioning. In both cases, also provide the ESAM XML as a string in the setting Signal processing notification XML (sccXml). TimedMetadata: allOf: - $ref: '#/components/schemas/TimedMetadata' - xml: name: timedMetadata description: 'Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH) to include ID3 metadata in this output. This includes ID3 metadata from the following features: ID3 timestamp period (timedMetadataId3Period), and Custom ID3 metadata inserter (timedMetadataInsertion). To exclude this ID3 metadata in this output: set ID3 metadata to None (NONE) or leave blank.' TimedMetadataPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: timedMetadataPid description: Packet Identifier (PID) of the ID3 metadata stream in the transport stream. TransportStreamId: allOf: - $ref: '#/components/schemas/__integerMin0Max65535' - xml: name: transportStreamId description: The value of the transport stream ID field in the Program Map Table. VideoPid: allOf: - $ref: '#/components/schemas/__integerMin32Max8182' - xml: name: videoPid description: Packet Identifier (PID) of the elementary video stream in the transport stream. description: These settings relate to the MPEG-2 transport stream (MPEG2-TS) container for the MPEG2-TS segments in your HLS outputs. __integerMinNegative180Max180: type: integer minimum: -180 maximum: 180 XavcHdIntraCbgProfileSettings: type: object properties: XavcClass: allOf: - $ref: '#/components/schemas/XavcHdIntraCbgProfileClass' - xml: name: xavcClass description: Specify the XAVC Intra HD (CBG) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_HD_INTRA_CBG. __stringMin1Max100000: type: string minLength: 1 maxLength: 100000 __integerMin1000Max1152000000: type: integer minimum: 1000 maximum: 1152000000 ForbiddenException: {} XavcHdProfileSettings: type: object properties: BitrateClass: allOf: - $ref: '#/components/schemas/XavcHdProfileBitrateClass' - xml: name: bitrateClass description: Specify the XAVC HD (Long GOP) Bitrate Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that are valid for that class. FlickerAdaptiveQuantization: allOf: - $ref: '#/components/schemas/XavcFlickerAdaptiveQuantization' - xml: name: flickerAdaptiveQuantization description: 'The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (XavcAdaptiveQuantization). When you do so, MediaConvert automatically applies the best types of quantization for your video content. Include this setting in your JSON job specification only when you choose to change the default value for Adaptive quantization. Enable this setting to have the encoder reduce I-frame pop. I-frame pop appears as a visual flicker that can arise when the encoder saves bits by copying some macroblocks many times from frame to frame, and then refreshes them at the I-frame. When you enable this setting, the encoder updates these macroblocks slightly more often to smooth out the flicker. This setting is disabled by default. Related setting: In addition to enabling this setting, you must also set Adaptive quantization (adaptiveQuantization) to a value other than Off (OFF) or Auto (AUTO). Use Adaptive quantization to adjust the degree of smoothing that Flicker adaptive quantization provides.' GopBReference: allOf: - $ref: '#/components/schemas/XavcGopBReference' - xml: name: gopBReference description: Specify whether the encoder uses B-frames as reference frames for other pictures in the same GOP. Choose Allow (ENABLED) to allow the encoder to use B-frames as reference frames. Choose Don't allow (DISABLED) to prevent the encoder from using B-frames as reference frames. GopClosedCadence: allOf: - $ref: '#/components/schemas/__integerMin0Max2147483647' - xml: name: gopClosedCadence description: 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. HrdBufferSize: allOf: - $ref: '#/components/schemas/__integerMin0Max1152000000' - xml: name: hrdBufferSize description: Specify the size of the buffer that MediaConvert uses in the HRD buffer model for this output. Specify this value in bits; for example, enter five megabits as 5000000. When you don't set this value, or you set it to zero, MediaConvert calculates the default by doubling the bitrate of this output point. InterlaceMode: allOf: - $ref: '#/components/schemas/XavcInterlaceMode' - xml: name: interlaceMode description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. QualityTuningLevel: allOf: - $ref: '#/components/schemas/XavcHdProfileQualityTuningLevel' - xml: name: qualityTuningLevel description: Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding. Slices: allOf: - $ref: '#/components/schemas/__integerMin4Max12' - xml: name: slices description: 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. Telecine: allOf: - $ref: '#/components/schemas/XavcHdProfileTelecine' - xml: name: telecine description: Ignore this setting unless you set Frame rate (framerateNumerator divided by framerateDenominator) to 29.970. If your input framerate is 23.976, choose Hard (HARD). Otherwise, keep the default value None (NONE). For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-telecine-and-inverse-telecine.html. description: Required when you set (Profile) under (VideoDescription)>(CodecSettings)>(XavcSettings) to the value XAVC_HD. WatermarkingStrength: type: string enum: - LIGHTEST - LIGHTER - DEFAULT - STRONGER - STRONGEST description: Optional. Ignore this setting unless Nagra support directs you to specify a value. When you don't specify a value here, the Nagra NexGuard library uses its default value. BurninSubtitleBackgroundColor: type: string enum: - NONE - BLACK - WHITE - AUTO description: Specify the color of the rectangle behind the captions. Leave background color (BackgroundColor) blank and set Style passthrough (StylePassthrough) to enabled to use the background color data from your input captions, if present. Mp4Settings: type: object properties: AudioDuration: allOf: - $ref: '#/components/schemas/CmfcAudioDuration' - xml: name: audioDuration description: Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration (MATCH_VIDEO_DURATION). In all other cases, keep the default value, Default codec duration (DEFAULT_CODEC_DURATION). When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec. CslgAtom: allOf: - $ref: '#/components/schemas/Mp4CslgAtom' - xml: name: cslgAtom description: 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. CttsVersion: allOf: - $ref: '#/components/schemas/__integerMin0Max1' - xml: name: cttsVersion description: Ignore this setting unless compliance to the CTTS box version specification matters in your workflow. Specify a value of 1 to set your CTTS box version to 1 and make your output compliant with the specification. When you specify a value of 1, you must also set CSLG atom (cslgAtom) to the value INCLUDE. Keep the default value 0 to set your CTTS box version to 0. This can provide backward compatibility for some players and packagers. FreeSpaceBox: allOf: - $ref: '#/components/schemas/Mp4FreeSpaceBox' - xml: name: freeSpaceBox description: Inserts a free-space box immediately after the moov box. MoovPlacement: allOf: - $ref: '#/components/schemas/Mp4MoovPlacement' - xml: name: moovPlacement description: 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: allOf: - $ref: '#/components/schemas/__string' - xml: name: mp4MajorBrand description: Overrides the "Major Brand" field in the output file. Usually not necessary to specify. description: These settings relate to your MP4 output container. You can create audio only outputs with this container. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/supported-codecs-containers-audio-only.html#output-codecs-and-containers-supported-for-audio-only. __integerMin1000Max288000000: type: integer minimum: 1000 maximum: 288000000 BurninSubtitleFallbackFont: type: string enum: - BEST_MATCH - MONOSPACED_SANSSERIF - MONOSPACED_SERIF - PROPORTIONAL_SANSSERIF - PROPORTIONAL_SERIF description: Specify the font that you want the service to use for your burn in captions when your input captions specify a font that MediaConvert doesn't support. When you set Fallback font (FallbackFont) to best match (BEST_MATCH), or leave blank, MediaConvert uses a supported font that most closely matches the font that your input captions specify. When there are multiple unsupported fonts in your input captions, MediaConvert matches each font with the supported font that matches best. When you explicitly choose a replacement font, MediaConvert uses that font to replace all unsupported fonts from your input. __integerMin0Max16: type: integer minimum: 0 maximum: 16 SrtStylePassthrough: type: string enum: - ENABLED - DISABLED description: Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses default settings for any missing style and position information in your input captions. Set Style passthrough to DISABLED, or leave blank, to ignore the style and position information from your input captions and use simplified output captions. Eac3LfeFilter: type: string enum: - ENABLED - DISABLED description: Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. CaptionDescriptionPreset: type: object properties: CustomLanguageCode: allOf: - $ref: '#/components/schemas/__stringPatternAZaZ23AZaZ' - xml: name: customLanguageCode description: 'Specify the language for this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information when automatically selecting the font script for rendering the captions text. For all outputs, you can use an ISO 639-2 or ISO 639-3 code. For streaming outputs, you can also use any other code in the full RFC-5646 specification. Streaming outputs are those that are in one of the following output groups: CMAF, DASH ISO, Apple HLS, or Microsoft Smooth Streaming.' DestinationSettings: allOf: - $ref: '#/components/schemas/CaptionDestinationSettings' - xml: name: destinationSettings description: Settings related to one captions tab on the MediaConvert console. In your job JSON, an instance of captions DestinationSettings is equivalent to one captions tab in the console. Usually, one captions tab corresponds to one output captions track. Depending on your output captions format, one tab might correspond to a set of output captions tracks. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/including-captions.html. LanguageCode: allOf: - $ref: '#/components/schemas/LanguageCode' - xml: name: languageCode description: Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. LanguageDescription: allOf: - $ref: '#/components/schemas/__string' - xml: name: languageDescription description: Specify a label for this set of output captions. For example, "English", "Director commentary", or "track_2". For streaming outputs, MediaConvert passes this information into destination manifests for display on the end-viewer's player device. For outputs in other output groups, the service ignores this setting. description: Caption Description for preset Deinterlacer: type: object properties: Algorithm: allOf: - $ref: '#/components/schemas/DeinterlaceAlgorithm' - xml: name: algorithm description: 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: allOf: - $ref: '#/components/schemas/DeinterlacerControl' - xml: name: control description: '- 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: allOf: - $ref: '#/components/schemas/DeinterlacerMode' - xml: name: mode description: 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. description: Settings for deinterlacer __integerMinNegative1Max10: type: integer minimum: -1 maximum: 10 H265InterlaceMode: type: string enum: - PROGRESSIVE - TOP_FIELD - BOTTOM_FIELD - FOLLOW_TOP_FIELD - FOLLOW_BOTTOM_FIELD description: Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your input. Use Top field first (TOP_FIELD) or Bottom field first (BOTTOM_FIELD) to create an output that's interlaced with the same field polarity throughout. Use Follow, default top (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose. WebvttDestinationSettings: type: object properties: Accessibility: allOf: - $ref: '#/components/schemas/WebvttAccessibilitySubs' - xml: name: accessibility description: 'Set Accessibility subtitles to Enabled if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. When you enable this feature, MediaConvert adds the following attributes under EXT-X-MEDIA in the HLS or CMAF manifest for this track: CHARACTERISTICS="public.accessibility.describes-spoken-dialog,public.accessibility.describes-music-and-sound" and AUTOSELECT="YES". Keep the default value, Disabled, if the captions track is not intended to provide such accessibility. MediaConvert will not add the above attributes.' StylePassthrough: allOf: - $ref: '#/components/schemas/WebvttStylePassthrough' - xml: name: stylePassthrough description: 'To use the available style, color, and position information from your input captions: Set Style passthrough (stylePassthrough) to Enabled (ENABLED). MediaConvert uses default settings when style and position information is missing from your input captions. To recreate the input captions exactly: Set Style passthrough to Strict (STRICT). MediaConvert automatically applies timing adjustments, including adjustments for frame rate conversion, ad avails, and input clipping. Your input captions format must be WebVTT. To ignore the style and position information from your input captions and use simplified output captions: Set Style passthrough to Disabled (DISABLED), or leave blank.' description: Settings related to WebVTT captions. WebVTT is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in the same output group, but different output from your video. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/ttml-and-webvtt-output-captions.html. When you work directly in your JSON job specification, include this object and any required children when you set destinationType to WebVTT. CaptionDestinationType: type: string enum: - BURN_IN - DVB_SUB - EMBEDDED - EMBEDDED_PLUS_SCTE20 - IMSC - SCTE20_PLUS_EMBEDDED - SCC - SRT - SMI - TELETEXT - TTML - WEBVTT description: Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Note that your choice of video output container constrains your choice of output captions format. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/captions-support-tables.html. If you are using SCTE-20 and you want to create an output that complies with the SCTE-43 spec, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED). To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). XavcAdaptiveQuantization: type: string enum: - false - AUTO - LOW - MEDIUM - HIGH - HIGHER - MAX description: 'Keep the default value, Auto (AUTO), for this setting to have MediaConvert automatically apply the best types of quantization for your video content. When you want to apply your quantization settings manually, you must set Adaptive quantization (adaptiveQuantization) to a value other than Auto (AUTO). Use this setting to specify the strength of any adaptive quantization filters that you enable. If you don''t want MediaConvert to do any adaptive quantization in this transcode, set Adaptive quantization to Off (OFF). Related settings: The value that you choose here applies to the following settings: Flicker adaptive quantization (flickerAdaptiveQuantization), Spatial adaptive quantization (spatialAdaptiveQuantization), and Temporal adaptive quantization (temporalAdaptiveQuantization).' __listOfCaptionDescriptionPreset: type: array items: $ref: '#/components/schemas/CaptionDescriptionPreset' BurninSubtitleShadowColor: type: string enum: - NONE - BLACK - WHITE - AUTO description: Specify the color of the shadow cast by the captions. Leave Shadow color (ShadowColor) blank and set Style passthrough (StylePassthrough) to enabled to use the shadow color data from your input captions, if present. __doubleMinNegative20Max0: type: number format: double parameters: X-Amz-SignedHeaders: name: X-Amz-SignedHeaders in: header schema: type: string required: false X-Amz-Security-Token: name: X-Amz-Security-Token in: header schema: type: string required: false X-Amz-Algorithm: name: X-Amz-Algorithm in: header schema: type: string required: false X-Amz-Date: name: X-Amz-Date in: header schema: type: string required: false X-Amz-Credential: name: X-Amz-Credential in: header schema: type: string required: false X-Amz-Content-Sha256: name: X-Amz-Content-Sha256 in: header schema: type: string required: false X-Amz-Signature: name: X-Amz-Signature in: header schema: type: string required: false securitySchemes: hmac: type: apiKey name: Authorization in: header description: Amazon Signature authorization v4 x-amazon-apigateway-authtype: awsSigv4 externalDocs: description: Amazon Web Services documentation url: https://docs.aws.amazon.com/mediaconvert/