/AWS1/CL_MDCMPEG2SETTINGS¶
Required when you set Codec to the value MPEG2.
CONSTRUCTOR
¶
IMPORTING¶
Optional arguments:¶
IV_ADAPTIVEQUANTIZATION
TYPE /AWS1/MDCMPEG2ADAPTIVEQUANTI00
/AWS1/MDCMPEG2ADAPTIVEQUANTI00
¶
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, and Temporal adaptive quantization.
IV_BITRATE
TYPE /AWS1/MDC__INTEGERMIN1000MAX03
/AWS1/MDC__INTEGERMIN1000MAX03
¶
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.
IV_CODECLEVEL
TYPE /AWS1/MDCMPEG2CODECLEVEL
/AWS1/MDCMPEG2CODECLEVEL
¶
Use Level to set the MPEG-2 level for the video output.
IV_CODECPROFILE
TYPE /AWS1/MDCMPEG2CODECPROFILE
/AWS1/MDCMPEG2CODECPROFILE
¶
Use Profile to set the MPEG-2 profile for the video output.
IV_DYNAMICSUBGOP
TYPE /AWS1/MDCMPEG2DYNAMICSUBGOP
/AWS1/MDCMPEG2DYNAMICSUBGOP
¶
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.
IV_FRAMERATECONTROL
TYPE /AWS1/MDCMPEG2FRAMERATECONTROL
/AWS1/MDCMPEG2FRAMERATECONTROL
¶
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.
IV_FRAMERATECONVERSIONALG
TYPE /AWS1/MDCMPEG2FRAMERATECONVR00
/AWS1/MDCMPEG2FRAMERATECONVR00
¶
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. For numerically simple conversions, such as 60 fps to 30 fps: We recommend that you keep the default value, Drop duplicate. For numerically complex conversions, to avoid stutter: Choose Interpolate. 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: Choose FrameFormer to do motion-compensated interpolation. FrameFormer uses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. When you choose FrameFormer, your input video resolution must be at least 128x96.
IV_FRAMERATEDENOMINATOR
TYPE /AWS1/MDC__INTEGERMIN1MAX1001
/AWS1/MDC__INTEGERMIN1MAX1001
¶
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.
IV_FRAMERATENUMERATOR
TYPE /AWS1/MDC__INTEGERMIN24MAX6000
/AWS1/MDC__INTEGERMIN24MAX6000
¶
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.
IV_GOPCLOSEDCADENCE
TYPE /AWS1/MDC__INTEGERMIN0MAX21400
/AWS1/MDC__INTEGERMIN0MAX21400
¶
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.
IV_GOPSIZE
TYPE /AWS1/RT_DOUBLE_AS_STRING
/AWS1/RT_DOUBLE_AS_STRING
¶
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 to Specified, seconds. The default value for GOP mode control is Frames.
IV_GOPSIZEUNITS
TYPE /AWS1/MDCMPEG2GOPSIZEUNITS
/AWS1/MDCMPEG2GOPSIZEUNITS
¶
Specify the units for GOP size. If you don't specify a value here, by default the encoder measures GOP size in frames.
IV_HRDBUFFERFINALFILLPERCE00
TYPE /AWS1/MDC__INTEGERMIN0MAX100
/AWS1/MDC__INTEGERMIN0MAX100
¶
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.
IV_HRDBUFFERINITIALFILLPER00
TYPE /AWS1/MDC__INTEGERMIN0MAX100
/AWS1/MDC__INTEGERMIN0MAX100
¶
Percentage of the buffer that should initially be filled (HRD buffer model).
IV_HRDBUFFERSIZE
TYPE /AWS1/MDC__INTEGERMIN0MAX47100
/AWS1/MDC__INTEGERMIN0MAX47100
¶
Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.
IV_INTERLACEMODE
TYPE /AWS1/MDCMPEG2INTERLACEMODE
/AWS1/MDCMPEG2INTERLACEMODE
¶
Choose the scan line type for the output. Keep the default value, Progressive to create a progressive output, regardless of the scan type of your input. Use Top field first or Bottom field first to create an output that's interlaced with the same field polarity throughout. Use Follow, default top or Follow, default bottom 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.
IV_INTRADCPRECISION
TYPE /AWS1/MDCMPEG2INTRADCPRECISION
/AWS1/MDCMPEG2INTRADCPRECISION
¶
Use Intra DC precision 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.
IV_MAXBITRATE
TYPE /AWS1/MDC__INTEGERMIN1000MAX04
/AWS1/MDC__INTEGERMIN1000MAX04
¶
Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.
IV_MINIINTERVAL
TYPE /AWS1/MDC__INTEGERMIN0MAX30
/AWS1/MDC__INTEGERMIN0MAX30
¶
Specify the minimum number of frames allowed between two IDR-frames in your output. This includes frames created at the start of a GOP or a scene change. Use Min I-Interval to improve video compression by varying GOP size when two IDR-frames would be created near each other. For example, if a regular cadence-driven IDR-frame would fall within 5 frames of a scene-change IDR-frame, and you set Min I-interval to 5, then the encoder would only write an IDR-frame for the scene-change. In this way, one GOP is shortened or extended. If a cadence-driven IDR-frame would be further than 5 frames from a scene-change IDR-frame, then the encoder leaves all IDR-frames in place. To manually specify an interval: Enter a value from 1 to 30. Use when your downstream systems have specific GOP size requirements. To disable GOP size variance: Enter 0. MediaConvert will only create IDR-frames at the start of your output's cadence-driven GOP. Use when your downstream systems require a regular GOP size.
IV_NOBFRAMESBETWEENREFEREN00
TYPE /AWS1/MDC__INTEGERMIN0MAX7
/AWS1/MDC__INTEGERMIN0MAX7
¶
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.
IV_PARCONTROL
TYPE /AWS1/MDCMPEG2PARCONTROL
/AWS1/MDCMPEG2PARCONTROL
¶
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow 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. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.
IV_PARDENOMINATOR
TYPE /AWS1/MDC__INTEGERMIN1MAX21400
/AWS1/MDC__INTEGERMIN1MAX21400
¶
Required when you set Pixel aspect ratio 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.
IV_PARNUMERATOR
TYPE /AWS1/MDC__INTEGERMIN1MAX21400
/AWS1/MDC__INTEGERMIN1MAX21400
¶
Required when you set Pixel aspect ratio 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.
IV_QUALITYTUNINGLEVEL
TYPE /AWS1/MDCMPEG2QUALITYTUNLEVEL
/AWS1/MDCMPEG2QUALITYTUNLEVEL
¶
Optional. Use Quality tuning level to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding.
IV_RATECONTROLMODE
TYPE /AWS1/MDCMPEG2RATECONTROLMODE
/AWS1/MDCMPEG2RATECONTROLMODE
¶
Use Rate control mode to specify whether the bitrate is variable (vbr) or constant (cbr).
IV_SCANTYPECONVERSIONMODE
TYPE /AWS1/MDCMPEG2SCANTYPECONVRS00
/AWS1/MDCMPEG2SCANTYPECONVRS00
¶
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing 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, 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 to None or Soft. You can't use optimized interlacing for hard telecine outputs. You must also set Interlace mode to a value other than Progressive.
IV_SCENECHANGEDETECT
TYPE /AWS1/MDCMPEG2SCENECHANGEDET00
/AWS1/MDCMPEG2SCENECHANGEDET00
¶
Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default.
IV_SLOWPAL
TYPE /AWS1/MDCMPEG2SLOWPAL
/AWS1/MDCMPEG2SLOWPAL
¶
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.
IV_SOFTNESS
TYPE /AWS1/MDC__INTEGERMIN0MAX128
/AWS1/MDC__INTEGERMIN0MAX128
¶
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 or by enabling a noise reducer filter. The 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.
IV_SPATIALADAPTIVEQUANTIZA00
TYPE /AWS1/MDCMPEG2SPATIALADAPTIV00
/AWS1/MDCMPEG2SPATIALADAPTIV00
¶
Keep the default value, 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 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.
IV_SYNTAX
TYPE /AWS1/MDCMPEG2SYNTAX
/AWS1/MDCMPEG2SYNTAX
¶
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 for your MXF profile, you must also set this value to D10.
IV_TELECINE
TYPE /AWS1/MDCMPEG2TELECINE
/AWS1/MDCMPEG2TELECINE
¶
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 produces a 29.97i output. Soft telecine 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, MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture.
IV_TEMPORALADAPTIVEQUANTIZ00
TYPE /AWS1/MDCMPEG2TEMPORALADAPTI00
/AWS1/MDCMPEG2TEMPORALADAPTI00
¶
Keep the default value, 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.
Queryable Attributes¶
AdaptiveQuantization¶
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, and Temporal adaptive quantization.
Accessible with the following methods¶
Method | Description |
---|---|
GET_ADAPTIVEQUANTIZATION() |
Getter for ADAPTIVEQUANTIZATION, with configurable default |
ASK_ADAPTIVEQUANTIZATION() |
Getter for ADAPTIVEQUANTIZATION w/ exceptions if field has n |
HAS_ADAPTIVEQUANTIZATION() |
Determine if ADAPTIVEQUANTIZATION has a value |
Bitrate¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_BITRATE() |
Getter for BITRATE, with configurable default |
ASK_BITRATE() |
Getter for BITRATE w/ exceptions if field has no value |
HAS_BITRATE() |
Determine if BITRATE has a value |
CodecLevel¶
Use Level to set the MPEG-2 level for the video output.
Accessible with the following methods¶
Method | Description |
---|---|
GET_CODECLEVEL() |
Getter for CODECLEVEL, with configurable default |
ASK_CODECLEVEL() |
Getter for CODECLEVEL w/ exceptions if field has no value |
HAS_CODECLEVEL() |
Determine if CODECLEVEL has a value |
CodecProfile¶
Use Profile to set the MPEG-2 profile for the video output.
Accessible with the following methods¶
Method | Description |
---|---|
GET_CODECPROFILE() |
Getter for CODECPROFILE, with configurable default |
ASK_CODECPROFILE() |
Getter for CODECPROFILE w/ exceptions if field has no value |
HAS_CODECPROFILE() |
Determine if CODECPROFILE has a value |
DynamicSubGop¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_DYNAMICSUBGOP() |
Getter for DYNAMICSUBGOP, with configurable default |
ASK_DYNAMICSUBGOP() |
Getter for DYNAMICSUBGOP w/ exceptions if field has no value |
HAS_DYNAMICSUBGOP() |
Determine if DYNAMICSUBGOP has a value |
FramerateControl¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_FRAMERATECONTROL() |
Getter for FRAMERATECONTROL, with configurable default |
ASK_FRAMERATECONTROL() |
Getter for FRAMERATECONTROL w/ exceptions if field has no va |
HAS_FRAMERATECONTROL() |
Determine if FRAMERATECONTROL has a value |
FramerateConversionAlgorithm¶
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. For numerically simple conversions, such as 60 fps to 30 fps: We recommend that you keep the default value, Drop duplicate. For numerically complex conversions, to avoid stutter: Choose Interpolate. 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: Choose FrameFormer to do motion-compensated interpolation. FrameFormer uses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. When you choose FrameFormer, your input video resolution must be at least 128x96.
Accessible with the following methods¶
Method | Description |
---|---|
GET_FRAMERATECONVERSIONALG() |
Getter for FRAMERATECONVERSIONALGORITHM, with configurable d |
ASK_FRAMERATECONVERSIONALG() |
Getter for FRAMERATECONVERSIONALGORITHM w/ exceptions if fie |
HAS_FRAMERATECONVERSIONALG() |
Determine if FRAMERATECONVERSIONALGORITHM has a value |
FramerateDenominator¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_FRAMERATEDENOMINATOR() |
Getter for FRAMERATEDENOMINATOR, with configurable default |
ASK_FRAMERATEDENOMINATOR() |
Getter for FRAMERATEDENOMINATOR w/ exceptions if field has n |
HAS_FRAMERATEDENOMINATOR() |
Determine if FRAMERATEDENOMINATOR has a value |
FramerateNumerator¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_FRAMERATENUMERATOR() |
Getter for FRAMERATENUMERATOR, with configurable default |
ASK_FRAMERATENUMERATOR() |
Getter for FRAMERATENUMERATOR w/ exceptions if field has no |
HAS_FRAMERATENUMERATOR() |
Determine if FRAMERATENUMERATOR has a value |
GopClosedCadence¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_GOPCLOSEDCADENCE() |
Getter for GOPCLOSEDCADENCE, with configurable default |
ASK_GOPCLOSEDCADENCE() |
Getter for GOPCLOSEDCADENCE w/ exceptions if field has no va |
HAS_GOPCLOSEDCADENCE() |
Determine if GOPCLOSEDCADENCE has a value |
GopSize¶
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 to Specified, seconds. The default value for GOP mode control is Frames.
Accessible with the following methods¶
Method | Description |
---|---|
GET_GOPSIZE() |
Getter for GOPSIZE, with configurable default |
ASK_GOPSIZE() |
Getter for GOPSIZE w/ exceptions if field has no value |
STR_GOPSIZE() |
String format for GOPSIZE, with configurable default |
HAS_GOPSIZE() |
Determine if GOPSIZE has a value |
GopSizeUnits¶
Specify the units for GOP size. If you don't specify a value here, by default the encoder measures GOP size in frames.
Accessible with the following methods¶
Method | Description |
---|---|
GET_GOPSIZEUNITS() |
Getter for GOPSIZEUNITS, with configurable default |
ASK_GOPSIZEUNITS() |
Getter for GOPSIZEUNITS w/ exceptions if field has no value |
HAS_GOPSIZEUNITS() |
Determine if GOPSIZEUNITS has a value |
HrdBufferFinalFillPercentage¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_HRDBUFFERFINALFILLPERC00() |
Getter for HRDBUFFERFINALFILLPERCENTAGE, with configurable d |
ASK_HRDBUFFERFINALFILLPERC00() |
Getter for HRDBUFFERFINALFILLPERCENTAGE w/ exceptions if fie |
HAS_HRDBUFFERFINALFILLPERC00() |
Determine if HRDBUFFERFINALFILLPERCENTAGE has a value |
HrdBufferInitialFillPercentage¶
Percentage of the buffer that should initially be filled (HRD buffer model).
Accessible with the following methods¶
Method | Description |
---|---|
GET_HRDBUFFERINITIALFILLPE00() |
Getter for HRDBUFFERINITIALFILLPERCEN00, with configurable d |
ASK_HRDBUFFERINITIALFILLPE00() |
Getter for HRDBUFFERINITIALFILLPERCEN00 w/ exceptions if fie |
HAS_HRDBUFFERINITIALFILLPE00() |
Determine if HRDBUFFERINITIALFILLPERCEN00 has a value |
HrdBufferSize¶
Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.
Accessible with the following methods¶
Method | Description |
---|---|
GET_HRDBUFFERSIZE() |
Getter for HRDBUFFERSIZE, with configurable default |
ASK_HRDBUFFERSIZE() |
Getter for HRDBUFFERSIZE w/ exceptions if field has no value |
HAS_HRDBUFFERSIZE() |
Determine if HRDBUFFERSIZE has a value |
InterlaceMode¶
Choose the scan line type for the output. Keep the default value, Progressive to create a progressive output, regardless of the scan type of your input. Use Top field first or Bottom field first to create an output that's interlaced with the same field polarity throughout. Use Follow, default top or Follow, default bottom 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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_INTERLACEMODE() |
Getter for INTERLACEMODE, with configurable default |
ASK_INTERLACEMODE() |
Getter for INTERLACEMODE w/ exceptions if field has no value |
HAS_INTERLACEMODE() |
Determine if INTERLACEMODE has a value |
IntraDcPrecision¶
Use Intra DC precision 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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_INTRADCPRECISION() |
Getter for INTRADCPRECISION, with configurable default |
ASK_INTRADCPRECISION() |
Getter for INTRADCPRECISION w/ exceptions if field has no va |
HAS_INTRADCPRECISION() |
Determine if INTRADCPRECISION has a value |
MaxBitrate¶
Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.
Accessible with the following methods¶
Method | Description |
---|---|
GET_MAXBITRATE() |
Getter for MAXBITRATE, with configurable default |
ASK_MAXBITRATE() |
Getter for MAXBITRATE w/ exceptions if field has no value |
HAS_MAXBITRATE() |
Determine if MAXBITRATE has a value |
MinIInterval¶
Specify the minimum number of frames allowed between two IDR-frames in your output. This includes frames created at the start of a GOP or a scene change. Use Min I-Interval to improve video compression by varying GOP size when two IDR-frames would be created near each other. For example, if a regular cadence-driven IDR-frame would fall within 5 frames of a scene-change IDR-frame, and you set Min I-interval to 5, then the encoder would only write an IDR-frame for the scene-change. In this way, one GOP is shortened or extended. If a cadence-driven IDR-frame would be further than 5 frames from a scene-change IDR-frame, then the encoder leaves all IDR-frames in place. To manually specify an interval: Enter a value from 1 to 30. Use when your downstream systems have specific GOP size requirements. To disable GOP size variance: Enter 0. MediaConvert will only create IDR-frames at the start of your output's cadence-driven GOP. Use when your downstream systems require a regular GOP size.
Accessible with the following methods¶
Method | Description |
---|---|
GET_MINIINTERVAL() |
Getter for MINIINTERVAL, with configurable default |
ASK_MINIINTERVAL() |
Getter for MINIINTERVAL w/ exceptions if field has no value |
HAS_MINIINTERVAL() |
Determine if MINIINTERVAL has a value |
NumberBFramesBetweenReferenceFrames¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_NOBFRAMESBETWEENREFERE00() |
Getter for NOBFRAMESBETWEENREFERENCEF00, with configurable d |
ASK_NOBFRAMESBETWEENREFERE00() |
Getter for NOBFRAMESBETWEENREFERENCEF00 w/ exceptions if fie |
HAS_NOBFRAMESBETWEENREFERE00() |
Determine if NOBFRAMESBETWEENREFERENCEF00 has a value |
ParControl¶
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow 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. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.
Accessible with the following methods¶
Method | Description |
---|---|
GET_PARCONTROL() |
Getter for PARCONTROL, with configurable default |
ASK_PARCONTROL() |
Getter for PARCONTROL w/ exceptions if field has no value |
HAS_PARCONTROL() |
Determine if PARCONTROL has a value |
ParDenominator¶
Required when you set Pixel aspect ratio 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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_PARDENOMINATOR() |
Getter for PARDENOMINATOR, with configurable default |
ASK_PARDENOMINATOR() |
Getter for PARDENOMINATOR w/ exceptions if field has no valu |
HAS_PARDENOMINATOR() |
Determine if PARDENOMINATOR has a value |
ParNumerator¶
Required when you set Pixel aspect ratio 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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_PARNUMERATOR() |
Getter for PARNUMERATOR, with configurable default |
ASK_PARNUMERATOR() |
Getter for PARNUMERATOR w/ exceptions if field has no value |
HAS_PARNUMERATOR() |
Determine if PARNUMERATOR has a value |
QualityTuningLevel¶
Optional. Use Quality tuning level to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding.
Accessible with the following methods¶
Method | Description |
---|---|
GET_QUALITYTUNINGLEVEL() |
Getter for QUALITYTUNINGLEVEL, with configurable default |
ASK_QUALITYTUNINGLEVEL() |
Getter for QUALITYTUNINGLEVEL w/ exceptions if field has no |
HAS_QUALITYTUNINGLEVEL() |
Determine if QUALITYTUNINGLEVEL has a value |
RateControlMode¶
Use Rate control mode to specify whether the bitrate is variable (vbr) or constant (cbr).
Accessible with the following methods¶
Method | Description |
---|---|
GET_RATECONTROLMODE() |
Getter for RATECONTROLMODE, with configurable default |
ASK_RATECONTROLMODE() |
Getter for RATECONTROLMODE w/ exceptions if field has no val |
HAS_RATECONTROLMODE() |
Determine if RATECONTROLMODE has a value |
ScanTypeConversionMode¶
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing 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, 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 to None or Soft. You can't use optimized interlacing for hard telecine outputs. You must also set Interlace mode to a value other than Progressive.
Accessible with the following methods¶
Method | Description |
---|---|
GET_SCANTYPECONVERSIONMODE() |
Getter for SCANTYPECONVERSIONMODE, with configurable default |
ASK_SCANTYPECONVERSIONMODE() |
Getter for SCANTYPECONVERSIONMODE w/ exceptions if field has |
HAS_SCANTYPECONVERSIONMODE() |
Determine if SCANTYPECONVERSIONMODE has a value |
SceneChangeDetect¶
Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default.
Accessible with the following methods¶
Method | Description |
---|---|
GET_SCENECHANGEDETECT() |
Getter for SCENECHANGEDETECT, with configurable default |
ASK_SCENECHANGEDETECT() |
Getter for SCENECHANGEDETECT w/ exceptions if field has no v |
HAS_SCENECHANGEDETECT() |
Determine if SCENECHANGEDETECT has a value |
SlowPal¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_SLOWPAL() |
Getter for SLOWPAL, with configurable default |
ASK_SLOWPAL() |
Getter for SLOWPAL w/ exceptions if field has no value |
HAS_SLOWPAL() |
Determine if SLOWPAL has a value |
Softness¶
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 or by enabling a noise reducer filter. The 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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_SOFTNESS() |
Getter for SOFTNESS, with configurable default |
ASK_SOFTNESS() |
Getter for SOFTNESS w/ exceptions if field has no value |
HAS_SOFTNESS() |
Determine if SOFTNESS has a value |
SpatialAdaptiveQuantization¶
Keep the default value, 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 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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_SPATIALADAPTIVEQUANTIZ00() |
Getter for SPATIALADAPTIVEQUANTIZATION, with configurable de |
ASK_SPATIALADAPTIVEQUANTIZ00() |
Getter for SPATIALADAPTIVEQUANTIZATION w/ exceptions if fiel |
HAS_SPATIALADAPTIVEQUANTIZ00() |
Determine if SPATIALADAPTIVEQUANTIZATION has a value |
Syntax¶
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 for your MXF profile, you must also set this value to D10.
Accessible with the following methods¶
Method | Description |
---|---|
GET_SYNTAX() |
Getter for SYNTAX, with configurable default |
ASK_SYNTAX() |
Getter for SYNTAX w/ exceptions if field has no value |
HAS_SYNTAX() |
Determine if SYNTAX has a value |
Telecine¶
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 produces a 29.97i output. Soft telecine 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, MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture.
Accessible with the following methods¶
Method | Description |
---|---|
GET_TELECINE() |
Getter for TELECINE, with configurable default |
ASK_TELECINE() |
Getter for TELECINE w/ exceptions if field has no value |
HAS_TELECINE() |
Determine if TELECINE has a value |
TemporalAdaptiveQuantization¶
Keep the default value, 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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_TEMPORALADAPTIVEQUANTI00() |
Getter for TEMPORALADAPTIVEQUANTIZATION, with configurable d |
ASK_TEMPORALADAPTIVEQUANTI00() |
Getter for TEMPORALADAPTIVEQUANTIZATION w/ exceptions if fie |
HAS_TEMPORALADAPTIVEQUANTI00() |
Determine if TEMPORALADAPTIVEQUANTIZATION has a value |