Copyright | (c) 2013-2021 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Synopsis
- data Av1Settings = Av1Settings' {
- gopSize :: Maybe Double
- numberBFramesBetweenReferenceFrames :: Maybe Natural
- slices :: Maybe Natural
- rateControlMode :: Maybe Av1RateControlMode
- qvbrSettings :: Maybe Av1QvbrSettings
- framerateDenominator :: Maybe Natural
- framerateConversionAlgorithm :: Maybe Av1FramerateConversionAlgorithm
- framerateControl :: Maybe Av1FramerateControl
- adaptiveQuantization :: Maybe Av1AdaptiveQuantization
- framerateNumerator :: Maybe Natural
- maxBitrate :: Maybe Natural
- spatialAdaptiveQuantization :: Maybe Av1SpatialAdaptiveQuantization
- newAv1Settings :: Av1Settings
- av1Settings_gopSize :: Lens' Av1Settings (Maybe Double)
- av1Settings_numberBFramesBetweenReferenceFrames :: Lens' Av1Settings (Maybe Natural)
- av1Settings_slices :: Lens' Av1Settings (Maybe Natural)
- av1Settings_rateControlMode :: Lens' Av1Settings (Maybe Av1RateControlMode)
- av1Settings_qvbrSettings :: Lens' Av1Settings (Maybe Av1QvbrSettings)
- av1Settings_framerateDenominator :: Lens' Av1Settings (Maybe Natural)
- av1Settings_framerateConversionAlgorithm :: Lens' Av1Settings (Maybe Av1FramerateConversionAlgorithm)
- av1Settings_framerateControl :: Lens' Av1Settings (Maybe Av1FramerateControl)
- av1Settings_adaptiveQuantization :: Lens' Av1Settings (Maybe Av1AdaptiveQuantization)
- av1Settings_framerateNumerator :: Lens' Av1Settings (Maybe Natural)
- av1Settings_maxBitrate :: Lens' Av1Settings (Maybe Natural)
- av1Settings_spatialAdaptiveQuantization :: Lens' Av1Settings (Maybe Av1SpatialAdaptiveQuantization)
Documentation
data Av1Settings Source #
Required when you set Codec, under VideoDescription>CodecSettings to the value AV1.
See: newAv1Settings
smart constructor.
Av1Settings' | |
|
Instances
newAv1Settings :: Av1Settings Source #
Create a value of Av1Settings
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:gopSize:Av1Settings'
, av1Settings_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.
$sel:numberBFramesBetweenReferenceFrames:Av1Settings'
, av1Settings_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.
$sel:slices:Av1Settings'
, av1Settings_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.
$sel:rateControlMode:Av1Settings'
, av1Settings_rateControlMode
- 'With AV1 outputs, for rate control mode, MediaConvert supports only
quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'
$sel:qvbrSettings:Av1Settings'
, av1Settings_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
(RateControlMode).
$sel:framerateDenominator:Av1Settings'
, av1Settings_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.
$sel:framerateConversionAlgorithm:Av1Settings'
, av1Settings_framerateConversionAlgorithm
- 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.
$sel:framerateControl:Av1Settings'
, av1Settings_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.
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.
$sel:adaptiveQuantization:Av1Settings'
, av1Settings_adaptiveQuantization
- Specify the strength of any adaptive quantization filters that you
enable. The value that you choose here applies to Spatial adaptive
quantization (spatialAdaptiveQuantization).
$sel:framerateNumerator:Av1Settings'
, av1Settings_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.
$sel:maxBitrate:Av1Settings'
, av1Settings_maxBitrate
- Maximum bitrate in bits/second. For example, enter five megabits per
second as 5000000. Required when Rate control mode is QVBR.
$sel:spatialAdaptiveQuantization:Av1Settings'
, av1Settings_spatialAdaptiveQuantization
- 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.
av1Settings_gopSize :: Lens' Av1Settings (Maybe Double) Source #
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.
av1Settings_numberBFramesBetweenReferenceFrames :: Lens' Av1Settings (Maybe Natural) Source #
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.
av1Settings_slices :: Lens' Av1Settings (Maybe Natural) Source #
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.
av1Settings_rateControlMode :: Lens' Av1Settings (Maybe Av1RateControlMode) Source #
'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'
av1Settings_qvbrSettings :: Lens' Av1Settings (Maybe Av1QvbrSettings) Source #
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).
av1Settings_framerateDenominator :: Lens' Av1Settings (Maybe Natural) Source #
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.
av1Settings_framerateConversionAlgorithm :: Lens' Av1Settings (Maybe Av1FramerateConversionAlgorithm) Source #
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.
av1Settings_framerateControl :: Lens' Av1Settings (Maybe Av1FramerateControl) Source #
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.
av1Settings_adaptiveQuantization :: Lens' Av1Settings (Maybe Av1AdaptiveQuantization) Source #
Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdaptiveQuantization).
av1Settings_framerateNumerator :: Lens' Av1Settings (Maybe Natural) Source #
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.
av1Settings_maxBitrate :: Lens' Av1Settings (Maybe Natural) Source #
Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.
av1Settings_spatialAdaptiveQuantization :: Lens' Av1Settings (Maybe Av1SpatialAdaptiveQuantization) Source #
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.