/AWS1/CL_MDCXAVCSETTINGS¶
Required when you set Codec to the value XAVC.
CONSTRUCTOR
¶
IMPORTING¶
Optional arguments:¶
IV_ADAPTIVEQUANTIZATION
TYPE /AWS1/MDCXAVCADAPTIVEQUANTIZ00
/AWS1/MDCXAVCADAPTIVEQUANTIZ00
¶
Keep the default value, 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 to a value other than 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. Related settings: The value that you choose here applies to the following settings: Flicker adaptive quantization (flickerAdaptiveQuantization), Spatial adaptive quantization, and Temporal adaptive quantization.
IV_ENTROPYENCODING
TYPE /AWS1/MDCXAVCENTROPYENCODING
/AWS1/MDCXAVCENTROPYENCODING
¶
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.
IV_FRAMERATECONTROL
TYPE /AWS1/MDCXAVCFRAMERATECONTROL
/AWS1/MDCXAVCFRAMERATECONTROL
¶
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.
IV_FRAMERATECONVERSIONALG
TYPE /AWS1/MDCXAVCFRAMERATECONVRS00
/AWS1/MDCXAVCFRAMERATECONVRS00
¶
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 Frame rate. 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_PROFILE
TYPE /AWS1/MDCXAVCPROFILE
/AWS1/MDCXAVCPROFILE
¶
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.
IV_SLOWPAL
TYPE /AWS1/MDCXAVCSLOWPAL
/AWS1/MDCXAVCSLOWPAL
¶
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.
IV_SOFTNESS
TYPE /AWS1/MDC__INTEGERMIN0MAX128
/AWS1/MDC__INTEGERMIN0MAX128
¶
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 or by enabling a noise reducer filter. The 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.
IV_SPATIALADAPTIVEQUANTIZA00
TYPE /AWS1/MDCXAVCSPATIALADAPTIVE00
/AWS1/MDCXAVCSPATIALADAPTIVE00
¶
The best way to set up adaptive quantization is to keep the default value, Auto, for the setting Adaptive quantization. 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, 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_TEMPORALADAPTIVEQUANTIZ00
TYPE /AWS1/MDCXAVCTEMPORALADAPTIV00
/AWS1/MDCXAVCTEMPORALADAPTIV00
¶
The best way to set up adaptive quantization is to keep the default value, Auto, for the setting Adaptive quantization. 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, 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.
IO_XAVC4KINTRACBGPROFILESTGS
TYPE REF TO /AWS1/CL_MDCXAVC4KINTRACBGPF00
/AWS1/CL_MDCXAVC4KINTRACBGPF00
¶
Required when you set Profile to the value XAVC_4K_INTRA_CBG.
IO_XAVC4KINTRAVBRPROFILESTGS
TYPE REF TO /AWS1/CL_MDCXAVC4KINTRAVBRPF00
/AWS1/CL_MDCXAVC4KINTRAVBRPF00
¶
Required when you set Profile to the value XAVC_4K_INTRA_VBR.
IO_XAVC4KPROFILESETTINGS
TYPE REF TO /AWS1/CL_MDCXAVC4KPROFILESTGS
/AWS1/CL_MDCXAVC4KPROFILESTGS
¶
Required when you set Profile to the value XAVC_4K.
IO_XAVCHDINTRACBGPROFILESTGS
TYPE REF TO /AWS1/CL_MDCXAVCHDINTRACBGPF00
/AWS1/CL_MDCXAVCHDINTRACBGPF00
¶
Required when you set Profile to the value XAVC_HD_INTRA_CBG.
IO_XAVCHDPROFILESETTINGS
TYPE REF TO /AWS1/CL_MDCXAVCHDPROFILESTGS
/AWS1/CL_MDCXAVCHDPROFILESTGS
¶
Required when you set Profile to the value XAVC_HD.
Queryable Attributes¶
AdaptiveQuantization¶
Keep the default value, 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 to a value other than 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. Related settings: The value that you choose here applies to the following settings: Flicker adaptive quantization (flickerAdaptiveQuantization), 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 |
EntropyEncoding¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_ENTROPYENCODING() |
Getter for ENTROPYENCODING, with configurable default |
ASK_ENTROPYENCODING() |
Getter for ENTROPYENCODING w/ exceptions if field has no val |
HAS_ENTROPYENCODING() |
Determine if ENTROPYENCODING has a value |
FramerateControl¶
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.
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 Frame rate. 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 |
Profile¶
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.
Accessible with the following methods¶
Method | Description |
---|---|
GET_PROFILE() |
Getter for PROFILE, with configurable default |
ASK_PROFILE() |
Getter for PROFILE w/ exceptions if field has no value |
HAS_PROFILE() |
Determine if PROFILE 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 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.
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 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 or by enabling a noise reducer filter. The 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.
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¶
The best way to set up adaptive quantization is to keep the default value, Auto, for the setting Adaptive quantization. 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, 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 |
TemporalAdaptiveQuantization¶
The best way to set up adaptive quantization is to keep the default value, Auto, for the setting Adaptive quantization. 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, 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.
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 |
Xavc4kIntraCbgProfileSettings¶
Required when you set Profile to the value XAVC_4K_INTRA_CBG.
Accessible with the following methods¶
Method | Description |
---|---|
GET_XAVC4KINTRACBGPFLSTGS() |
Getter for XAVC4KINTRACBGPROFILESTGS |
Xavc4kIntraVbrProfileSettings¶
Required when you set Profile to the value XAVC_4K_INTRA_VBR.
Accessible with the following methods¶
Method | Description |
---|---|
GET_XAVC4KINTRAVBRPFLSTGS() |
Getter for XAVC4KINTRAVBRPROFILESTGS |
Xavc4kProfileSettings¶
Required when you set Profile to the value XAVC_4K.
Accessible with the following methods¶
Method | Description |
---|---|
GET_XAVC4KPROFILESETTINGS() |
Getter for XAVC4KPROFILESETTINGS |
XavcHdIntraCbgProfileSettings¶
Required when you set Profile to the value XAVC_HD_INTRA_CBG.
Accessible with the following methods¶
Method | Description |
---|---|
GET_XAVCHDINTRACBGPFLSTGS() |
Getter for XAVCHDINTRACBGPROFILESTGS |
XavcHdProfileSettings¶
Required when you set Profile to the value XAVC_HD.
Accessible with the following methods¶
Method | Description |
---|---|
GET_XAVCHDPROFILESETTINGS() |
Getter for XAVCHDPROFILESETTINGS |