software.amazon.awssdk.services.mediaconvert.model

Interface VideoDescription.Builder

All Superinterfaces:

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

Enclosing class:

VideoDescription

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

Method Summary

Modifier and Type	Method and Description
VideoDescription.Builder	afdSignaling(AfdSignaling afdSignaling) This setting only applies to H.264, H.265, and MPEG2 outputs.
VideoDescription.Builder	afdSignaling(String afdSignaling) This setting only applies to H.264, H.265, and MPEG2 outputs.
VideoDescription.Builder	antiAlias(AntiAlias antiAlias) The anti-alias filter is automatically applied to all outputs.
VideoDescription.Builder	antiAlias(String antiAlias) The anti-alias filter is automatically applied to all outputs.
default VideoDescription.Builder	codecSettings(Consumer<VideoCodecSettings.Builder> codecSettings) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding.
VideoDescription.Builder	codecSettings(VideoCodecSettings codecSettings) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding.
VideoDescription.Builder	colorMetadata(ColorMetadata colorMetadata) Choose Insert (INSERT) for this setting to include color metadata in this output.
VideoDescription.Builder	colorMetadata(String colorMetadata) Choose Insert (INSERT) for this setting to include color metadata in this output.
default VideoDescription.Builder	crop(Consumer<Rectangle.Builder> crop) Use Cropping selection (crop) to specify the video area that the service will include in the output video frame.
VideoDescription.Builder	crop(Rectangle crop) Use Cropping selection (crop) to specify the video area that the service will include in the output video frame.
VideoDescription.Builder	dropFrameTimecode(DropFrameTimecode dropFrameTimecode) Applies only to 29.97 fps outputs.
VideoDescription.Builder	dropFrameTimecode(String dropFrameTimecode) Applies only to 29.97 fps outputs.
VideoDescription.Builder	fixedAfd(Integer fixedAfd) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED).
VideoDescription.Builder	height(Integer height) Use the Height (Height) setting to define the video resolution height for this output.
default VideoDescription.Builder	position(Consumer<Rectangle.Builder> position) Use Selection placement (position) to define the video area in your output frame.
VideoDescription.Builder	position(Rectangle position) Use Selection placement (position) to define the video area in your output frame.
VideoDescription.Builder	respondToAfd(RespondToAfd respondToAfd) Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input.
VideoDescription.Builder	respondToAfd(String respondToAfd) Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input.
VideoDescription.Builder	scalingBehavior(ScalingBehavior scalingBehavior) Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio.
VideoDescription.Builder	scalingBehavior(String scalingBehavior) Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio.
VideoDescription.Builder	sharpness(Integer sharpness) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing.
VideoDescription.Builder	timecodeInsertion(String timecodeInsertion) Applies only to H.264, H.265, MPEG2, and ProRes outputs.
VideoDescription.Builder	timecodeInsertion(VideoTimecodeInsertion timecodeInsertion) Applies only to H.264, H.265, MPEG2, and ProRes outputs.
default VideoDescription.Builder	videoPreprocessors(Consumer<VideoPreprocessor.Builder> videoPreprocessors) Find additional transcoding features under Preprocessors (VideoPreprocessors).
VideoDescription.Builder	videoPreprocessors(VideoPreprocessor videoPreprocessors) Find additional transcoding features under Preprocessors (VideoPreprocessors).
VideoDescription.Builder	width(Integer width) Use Width (Width) to define the video resolution width, in pixels, for this output.

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

afdSignaling

VideoDescription.Builder afdSignaling(String afdSignaling)

This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.

Parameters:

afdSignaling - This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.

Returns:

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

See Also:

AfdSignaling, AfdSignaling

afdSignaling

VideoDescription.Builder afdSignaling(AfdSignaling afdSignaling)

This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.

Parameters:

afdSignaling - This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.

Returns:

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

See Also:

AfdSignaling, AfdSignaling

antiAlias

VideoDescription.Builder antiAlias(String antiAlias)

The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting.

Parameters:

antiAlias - The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting.

Returns:

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

See Also:

AntiAlias, AntiAlias

antiAlias

VideoDescription.Builder antiAlias(AntiAlias antiAlias)

The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting.

Parameters:

antiAlias - The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting.

Returns:

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

See Also:

AntiAlias, AntiAlias

codecSettings

VideoDescription.Builder codecSettings(VideoCodecSettings codecSettings)

Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value that you choose for Video codec (Codec). For each codec enum that you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettings

Parameters:

codecSettings - Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value that you choose for Video codec (Codec). For each codec enum that you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettings

Returns:

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

codecSettings

default VideoDescription.Builder codecSettings(Consumer<VideoCodecSettings.Builder> codecSettings)

Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value that you choose for Video codec (Codec). For each codec enum that you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettings This is a convenience that creates an instance of the VideoCodecSettings.Builder avoiding the need to create one manually via VideoCodecSettings.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to codecSettings(VideoCodecSettings).

Parameters:

codecSettings - a consumer that will call methods on VideoCodecSettings.Builder

Returns:

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

See Also:

codecSettings(VideoCodecSettings)

colorMetadata

VideoDescription.Builder colorMetadata(String colorMetadata)

Choose Insert (INSERT) for this setting to include color metadata in this output. Choose Ignore (IGNORE) to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default.

Parameters:

colorMetadata - Choose Insert (INSERT) for this setting to include color metadata in this output. Choose Ignore (IGNORE) to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default.

Returns:

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

See Also:

ColorMetadata, ColorMetadata

colorMetadata

VideoDescription.Builder colorMetadata(ColorMetadata colorMetadata)

Choose Insert (INSERT) for this setting to include color metadata in this output. Choose Ignore (IGNORE) to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default.

Parameters:

colorMetadata - Choose Insert (INSERT) for this setting to include color metadata in this output. Choose Ignore (IGNORE) to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default.

Returns:

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

See Also:

ColorMetadata, ColorMetadata

crop

VideoDescription.Builder crop(Rectangle crop)

Use Cropping selection (crop) to specify the video area that the service will include in the output video frame.

Parameters:

crop - Use Cropping selection (crop) to specify the video area that the service will include in the output video frame.

Returns:

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

crop

default VideoDescription.Builder crop(Consumer<Rectangle.Builder> crop)

Use Cropping selection (crop) to specify the video area that the service will include in the output video frame. This is a convenience that creates an instance of the Rectangle.Builder avoiding the need to create one manually via Rectangle.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to crop(Rectangle).

Parameters:

crop - a consumer that will call methods on Rectangle.Builder

Returns:

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

See Also:

crop(Rectangle)

dropFrameTimecode

VideoDescription.Builder dropFrameTimecode(String dropFrameTimecode)

Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled.

Parameters:

dropFrameTimecode - Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled.

Returns:

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

See Also:

DropFrameTimecode, DropFrameTimecode

dropFrameTimecode

VideoDescription.Builder dropFrameTimecode(DropFrameTimecode dropFrameTimecode)

Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled.

Parameters:

dropFrameTimecode - Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled.

Returns:

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

See Also:

DropFrameTimecode, DropFrameTimecode

fixedAfd

VideoDescription.Builder fixedAfd(Integer fixedAfd)

Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.

Parameters:

fixedAfd - Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.

Returns:

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

height

VideoDescription.Builder height(Integer height)

Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.

Parameters:

height - Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.

Returns:

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

position

VideoDescription.Builder position(Rectangle position)

Use Selection placement (position) to define the video area in your output frame. The area outside of the rectangle that you specify here is black.

Parameters:

position - Use Selection placement (position) to define the video area in your output frame. The area outside of the rectangle that you specify here is black.

Returns:

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

position

default VideoDescription.Builder position(Consumer<Rectangle.Builder> position)

Use Selection placement (position) to define the video area in your output frame. The area outside of the rectangle that you specify here is black. This is a convenience that creates an instance of the Rectangle.Builder avoiding the need to create one manually via Rectangle.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to position(Rectangle).

Parameters:

position - a consumer that will call methods on Rectangle.Builder

Returns:

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

See Also:

position(Rectangle)

respondToAfd

VideoDescription.Builder respondToAfd(String respondToAfd)

Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input. * Choose Respond to clip the input video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output.

Parameters:

respondToAfd - Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input. * Choose Respond to clip the input video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output.

Returns:

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

See Also:

RespondToAfd, RespondToAfd

respondToAfd

VideoDescription.Builder respondToAfd(RespondToAfd respondToAfd)

Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input. * Choose Respond to clip the input video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output.

Parameters:

respondToAfd - Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input. * Choose Respond to clip the input video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output.

Returns:

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

See Also:

RespondToAfd, RespondToAfd

scalingBehavior

VideoDescription.Builder scalingBehavior(String scalingBehavior)

Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio. Choose Stretch to output (STRETCH_TO_OUTPUT) to have the service stretch your video image to fit. Keep the setting Default (DEFAULT) to have the service letterbox your video instead. This setting overrides any value that you specify for the setting Selection placement (position) in this output.

Parameters:

scalingBehavior - Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio. Choose Stretch to output (STRETCH_TO_OUTPUT) to have the service stretch your video image to fit. Keep the setting Default (DEFAULT) to have the service letterbox your video instead. This setting overrides any value that you specify for the setting Selection placement (position) in this output.

Returns:

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

See Also:

ScalingBehavior, ScalingBehavior

scalingBehavior

VideoDescription.Builder scalingBehavior(ScalingBehavior scalingBehavior)

Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio. Choose Stretch to output (STRETCH_TO_OUTPUT) to have the service stretch your video image to fit. Keep the setting Default (DEFAULT) to have the service letterbox your video instead. This setting overrides any value that you specify for the setting Selection placement (position) in this output.

Parameters:

scalingBehavior - Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio. Choose Stretch to output (STRETCH_TO_OUTPUT) to have the service stretch your video image to fit. Keep the setting Default (DEFAULT) to have the service letterbox your video instead. This setting overrides any value that you specify for the setting Selection placement (position) in this output.

Returns:

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

See Also:

ScalingBehavior, ScalingBehavior

sharpness

VideoDescription.Builder sharpness(Integer sharpness)

Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.

Parameters:

sharpness - Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.

Returns:

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

timecodeInsertion

VideoDescription.Builder timecodeInsertion(String timecodeInsertion)

Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does.

Parameters:

timecodeInsertion - Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does.

Returns:

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

See Also:

VideoTimecodeInsertion, VideoTimecodeInsertion

timecodeInsertion

VideoDescription.Builder timecodeInsertion(VideoTimecodeInsertion timecodeInsertion)

Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does.

Parameters:

timecodeInsertion - Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does.

Returns:

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

See Also:

VideoTimecodeInsertion, VideoTimecodeInsertion

videoPreprocessors

VideoDescription.Builder videoPreprocessors(VideoPreprocessor videoPreprocessors)

Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.

Parameters:

videoPreprocessors - Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.

Returns:

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

videoPreprocessors

default VideoDescription.Builder videoPreprocessors(Consumer<VideoPreprocessor.Builder> videoPreprocessors)

Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default. This is a convenience that creates an instance of the VideoPreprocessor.Builder avoiding the need to create one manually via VideoPreprocessor.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to videoPreprocessors(VideoPreprocessor).

Parameters:

videoPreprocessors - a consumer that will call methods on VideoPreprocessor.Builder

Returns:

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

See Also:

videoPreprocessors(VideoPreprocessor)

width

VideoDescription.Builder width(Integer width)

Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.

Parameters:

width - Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.

Returns:

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