/AWS1/CL_MDCAV1SETTINGS¶
Required when you set Codec, under VideoDescription>CodecSettings to the value AV1.
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
IV_ADAPTIVEQUANTIZATION TYPE /AWS1/MDCAV1ADAPTIVEQUANTIZA00 /AWS1/MDCAV1ADAPTIVEQUANTIZA00¶
Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization.
IV_BITDEPTH TYPE /AWS1/MDCAV1BITDEPTH /AWS1/MDCAV1BITDEPTH¶
Specify the Bit depth. You can choose 8-bit or 10-bit.
IV_FILMGRAINSYNTHESIS TYPE /AWS1/MDCAV1FILMGRAINSYNTHESIS /AWS1/MDCAV1FILMGRAINSYNTHESIS¶
Film grain synthesis replaces film grain present in your content with similar quality synthesized AV1 film grain. We recommend that you choose Enabled to reduce the bandwidth of your QVBR quality level 5, 6, 7, or 8 outputs. For QVBR quality level 9 or 10 outputs we recommend that you keep the default value, Disabled. When you include Film grain synthesis, you cannot include the Noise reducer preprocessor.
IV_FRAMERATECONTROL TYPE /AWS1/MDCAV1FRAMERATECONTROL /AWS1/MDCAV1FRAMERATECONTROL¶
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/MDCAV1FRAMERATECONVRSALG /AWS1/MDCAV1FRAMERATECONVRSALG¶
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__INTEGERMIN1MAX21400 /AWS1/MDC__INTEGERMIN1MAX21400¶
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__INTEGERMIN1MAX21400 /AWS1/MDC__INTEGERMIN1MAX21400¶
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_GOPSIZE TYPE /AWS1/RT_DOUBLE_AS_STRING /AWS1/RT_DOUBLE_AS_STRING¶
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.
IV_MAXBITRATE TYPE /AWS1/MDC__INTEGERMIN1000MAX01 /AWS1/MDC__INTEGERMIN1000MAX01¶
Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.
IV_NOBFRAMESBETWEENREFEREN00 TYPE /AWS1/MDC__INTEGERMIN0MAX15 /AWS1/MDC__INTEGERMIN0MAX15¶
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.
IO_QVBRSETTINGS TYPE REF TO /AWS1/CL_MDCAV1QVBRSETTINGS /AWS1/CL_MDCAV1QVBRSETTINGS¶
Settings for quality-defined variable bitrate encoding with the H.265 codec. Use these settings only when you set QVBR for Rate control mode.
IV_RATECONTROLMODE TYPE /AWS1/MDCAV1RATECONTROLMODE /AWS1/MDCAV1RATECONTROLMODE¶
'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'
IV_SLICES TYPE /AWS1/MDC__INTEGERMIN1MAX32 /AWS1/MDC__INTEGERMIN1MAX32¶
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.
IV_SPATIALADAPTIVEQUANTIZA00 TYPE /AWS1/MDCAV1SPATIALADAPTIVEQ00 /AWS1/MDCAV1SPATIALADAPTIVEQ00¶
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.
Queryable Attributes¶
AdaptiveQuantization¶
Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial 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 |
BitDepth¶
Specify the Bit depth. You can choose 8-bit or 10-bit.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_BITDEPTH() |
Getter for BITDEPTH, with configurable default |
ASK_BITDEPTH() |
Getter for BITDEPTH w/ exceptions if field has no value |
HAS_BITDEPTH() |
Determine if BITDEPTH has a value |
FilmGrainSynthesis¶
Film grain synthesis replaces film grain present in your content with similar quality synthesized AV1 film grain. We recommend that you choose Enabled to reduce the bandwidth of your QVBR quality level 5, 6, 7, or 8 outputs. For QVBR quality level 9 or 10 outputs we recommend that you keep the default value, Disabled. When you include Film grain synthesis, you cannot include the Noise reducer preprocessor.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FILMGRAINSYNTHESIS() |
Getter for FILMGRAINSYNTHESIS, with configurable default |
ASK_FILMGRAINSYNTHESIS() |
Getter for FILMGRAINSYNTHESIS w/ exceptions if field has no |
HAS_FILMGRAINSYNTHESIS() |
Determine if FILMGRAINSYNTHESIS has a value |
FramerateControl¶
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 |
GopSize¶
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.
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 |
MaxBitrate¶
Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.
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 |
NumberBFramesBetweenReferenceFrames¶
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.
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 |
QvbrSettings¶
Settings for quality-defined variable bitrate encoding with the H.265 codec. Use these settings only when you set QVBR for Rate control mode.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_QVBRSETTINGS() |
Getter for QVBRSETTINGS |
RateControlMode¶
'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'
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 |
Slices¶
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SLICES() |
Getter for SLICES, with configurable default |
ASK_SLICES() |
Getter for SLICES w/ exceptions if field has no value |
HAS_SLICES() |
Determine if SLICES 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 |