software.amazon.awssdk.services.mediaconvert.model

Interface Av1Settings.Builder

All Superinterfaces:

Buildable, CopyableBuilder<Av1Settings.Builder,Av1Settings>, SdkBuilder<Av1Settings.Builder,Av1Settings>, SdkPojo

Enclosing class:

Av1Settings

public static interface Av1Settings.Builder
extends SdkPojo, CopyableBuilder<Av1Settings.Builder,Av1Settings>

Method Summary

Modifier and Type	Method and Description
Av1Settings.Builder	adaptiveQuantization(Av1AdaptiveQuantization adaptiveQuantization) Specify the strength of any adaptive quantization filters that you enable.
Av1Settings.Builder	adaptiveQuantization(String adaptiveQuantization) Specify the strength of any adaptive quantization filters that you enable.
Av1Settings.Builder	bitDepth(Av1BitDepth bitDepth) Specify the Bit depth (Av1BitDepth).
Av1Settings.Builder	bitDepth(String bitDepth) Specify the Bit depth (Av1BitDepth).
Av1Settings.Builder	framerateControl(Av1FramerateControl framerateControl) If you are using the console, use the Framerate setting to specify the frame rate for this output.
Av1Settings.Builder	framerateControl(String framerateControl) If you are using the console, use the Framerate setting to specify the frame rate for this output.
Av1Settings.Builder	framerateConversionAlgorithm(Av1FramerateConversionAlgorithm framerateConversionAlgorithm) Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate.
Av1Settings.Builder	framerateConversionAlgorithm(String framerateConversionAlgorithm) Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate.
Av1Settings.Builder	framerateDenominator(Integer framerateDenominator) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction.
Av1Settings.Builder	framerateNumerator(Integer framerateNumerator) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction.
Av1Settings.Builder	gopSize(Double gopSize) Specify the GOP length (keyframe interval) in frames.
Av1Settings.Builder	maxBitrate(Integer maxBitrate) Maximum bitrate in bits/second.
Av1Settings.Builder	numberBFramesBetweenReferenceFrames(Integer numberBFramesBetweenReferenceFrames) Specify from the number of B-frames, in the range of 0-15.
Av1Settings.Builder	qvbrSettings(Av1QvbrSettings qvbrSettings) Settings for quality-defined variable bitrate encoding with the H.265 codec.
default Av1Settings.Builder	qvbrSettings(Consumer<Av1QvbrSettings.Builder> qvbrSettings) Settings for quality-defined variable bitrate encoding with the H.265 codec.
Av1Settings.Builder	rateControlMode(Av1RateControlMode rateControlMode) 'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR).
Av1Settings.Builder	rateControlMode(String rateControlMode) 'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR).
Av1Settings.Builder	slices(Integer slices) Specify the number of slices per picture.
Av1Settings.Builder	spatialAdaptiveQuantization(Av1SpatialAdaptiveQuantization spatialAdaptiveQuantization) Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity.
Av1Settings.Builder	spatialAdaptiveQuantization(String spatialAdaptiveQuantization) Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity.

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

equalsBySdkFields, sdkFields

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Method Detail

adaptiveQuantization

Av1Settings.Builder adaptiveQuantization(String adaptiveQuantization)

Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdaptiveQuantization).

Parameters:

adaptiveQuantization - Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdaptiveQuantization).

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1AdaptiveQuantization, Av1AdaptiveQuantization

adaptiveQuantization

Av1Settings.Builder adaptiveQuantization(Av1AdaptiveQuantization adaptiveQuantization)

Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdaptiveQuantization).

Parameters:

adaptiveQuantization - Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdaptiveQuantization).

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1AdaptiveQuantization, Av1AdaptiveQuantization

bitDepth

Av1Settings.Builder bitDepth(String bitDepth)

Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT_8) or 10-bit (BIT_10).

Parameters:

bitDepth - Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT_8) or 10-bit (BIT_10).

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1BitDepth, Av1BitDepth

bitDepth

Av1Settings.Builder bitDepth(Av1BitDepth bitDepth)

Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT_8) or 10-bit (BIT_10).

Parameters:

bitDepth - Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT_8) or 10-bit (BIT_10).

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1BitDepth, Av1BitDepth

framerateControl

Av1Settings.Builder framerateControl(String 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1FramerateControl, Av1FramerateControl

framerateControl

Av1Settings.Builder framerateControl(Av1FramerateControl 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1FramerateControl, Av1FramerateControl

framerateConversionAlgorithm

Av1Settings.Builder framerateConversionAlgorithm(String 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1FramerateConversionAlgorithm, Av1FramerateConversionAlgorithm

framerateConversionAlgorithm

Av1Settings.Builder framerateConversionAlgorithm(Av1FramerateConversionAlgorithm 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1FramerateConversionAlgorithm, Av1FramerateConversionAlgorithm

framerateDenominator

Av1Settings.Builder framerateDenominator(Integer 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

framerateNumerator

Av1Settings.Builder framerateNumerator(Integer 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

gopSize

Av1Settings.Builder gopSize(Double 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

maxBitrate

Av1Settings.Builder maxBitrate(Integer maxBitrate)

Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.

Parameters:

maxBitrate - Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.

Returns:

Returns a reference to this object so that method calls can be chained together.

numberBFramesBetweenReferenceFrames

Av1Settings.Builder numberBFramesBetweenReferenceFrames(Integer 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

qvbrSettings

Av1Settings.Builder qvbrSettings(Av1QvbrSettings 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).

Parameters:

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).

Returns:

Returns a reference to this object so that method calls can be chained together.

qvbrSettings

default Av1Settings.Builder qvbrSettings(Consumer<Av1QvbrSettings.Builder> 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). This is a convenience method that creates an instance of the Av1QvbrSettings.Builder avoiding the need to create one manually via Av1QvbrSettings.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to qvbrSettings(Av1QvbrSettings).

Parameters:

qvbrSettings - a consumer that will call methods on Av1QvbrSettings.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

qvbrSettings(Av1QvbrSettings)

rateControlMode

Av1Settings.Builder rateControlMode(String rateControlMode)

'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'

Parameters:

rateControlMode - 'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1RateControlMode, Av1RateControlMode

rateControlMode

Av1Settings.Builder rateControlMode(Av1RateControlMode rateControlMode)

'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'

Parameters:

rateControlMode - 'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1RateControlMode, Av1RateControlMode

slices

Av1Settings.Builder slices(Integer 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

spatialAdaptiveQuantization

Av1Settings.Builder spatialAdaptiveQuantization(String 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1SpatialAdaptiveQuantization, Av1SpatialAdaptiveQuantization

spatialAdaptiveQuantization

Av1Settings.Builder spatialAdaptiveQuantization(Av1SpatialAdaptiveQuantization 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

Av1SpatialAdaptiveQuantization, Av1SpatialAdaptiveQuantization