software.amazon.awssdk.services.mediaconvert.model

Class VideoSelector

java.lang.Object

software.amazon.awssdk.services.mediaconvert.model.VideoSelector

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<VideoSelector.Builder,VideoSelector>

@Generated(value="software.amazon.awssdk:codegen")
public final class VideoSelector
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<VideoSelector.Builder,VideoSelector>

Input video selectors contain the video settings for the input. Each of your inputs can have up to one video selector.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	VideoSelector.Builder

Method Summary

Modifier and Type	Method and Description
AlphaBehavior	alphaBehavior() Ignore this setting unless this input is a QuickTime animation with an alpha channel.
String	alphaBehaviorAsString() Ignore this setting unless this input is a QuickTime animation with an alpha channel.
static VideoSelector.Builder	builder()
ColorSpace	colorSpace() If your input video has accurate color space metadata, or if you don't know about color space: Keep the default value, Follow.
String	colorSpaceAsString() If your input video has accurate color space metadata, or if you don't know about color space: Keep the default value, Follow.
ColorSpaceUsage	colorSpaceUsage() There are two sources for color metadata, the input file and the job input settings Color space and HDR master display information settings.
String	colorSpaceUsageAsString() There are two sources for color metadata, the input file and the job input settings Color space and HDR master display information settings.
EmbeddedTimecodeOverride	embeddedTimecodeOverride() Set Embedded timecode override to Use MDPM when your AVCHD input contains timecode tag data in the Modified Digital Video Pack Metadata.
String	embeddedTimecodeOverrideAsString() Set Embedded timecode override to Use MDPM when your AVCHD input contains timecode tag data in the Modified Digital Video Pack Metadata.
boolean	equals(Object obj)
boolean	equalsBySdkFields(Object obj)
<T> Optional<T>	getValueForField(String fieldName, Class<T> clazz)
int	hashCode()
Hdr10Metadata	hdr10Metadata() Use these settings to provide HDR 10 metadata that is missing or inaccurate in your input video.
PadVideo	padVideo() Use this setting if your input has video and audio durations that don't align, and your output or player has strict alignment requirements.
String	padVideoAsString() Use this setting if your input has video and audio durations that don't align, and your output or player has strict alignment requirements.
Integer	pid() Use PID to select specific video data from an input file.
Integer	programNumber() Selects a specific program from within a multi-program transport stream.
InputRotate	rotate() Use Rotate to specify how the service rotates your video.
String	rotateAsString() Use Rotate to specify how the service rotates your video.
InputSampleRange	sampleRange() If the sample range metadata in your input video is accurate, or if you don't know about sample range, keep the default value, Follow, for this setting.
String	sampleRangeAsString() If the sample range metadata in your input video is accurate, or if you don't know about sample range, keep the default value, Follow, for this setting.
List<SdkField<?>>	sdkFields()
static Class<? extends VideoSelector.Builder>	serializableBuilderClass()
VideoSelector.Builder	toBuilder()
String	toString() Returns a string representation of this object.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

copy

Method Detail

alphaBehavior

public final AlphaBehavior alphaBehavior()

Ignore this setting unless this input is a QuickTime animation with an alpha channel. Use this setting to create separate Key and Fill outputs. In each output, specify which part of the input MediaConvert uses. Leave this setting at the default value DISCARD to delete the alpha channel and preserve the video. Set it to REMAP_TO_LUMA to delete the video and map the alpha channel to the luma channel of your outputs.

If the service returns an enum value that is not available in the current SDK version, alphaBehavior will return AlphaBehavior.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from alphaBehaviorAsString().

Returns:

Ignore this setting unless this input is a QuickTime animation with an alpha channel. Use this setting to create separate Key and Fill outputs. In each output, specify which part of the input MediaConvert uses. Leave this setting at the default value DISCARD to delete the alpha channel and preserve the video. Set it to REMAP_TO_LUMA to delete the video and map the alpha channel to the luma channel of your outputs.

See Also:

AlphaBehavior

alphaBehaviorAsString

public final String alphaBehaviorAsString()

Ignore this setting unless this input is a QuickTime animation with an alpha channel. Use this setting to create separate Key and Fill outputs. In each output, specify which part of the input MediaConvert uses. Leave this setting at the default value DISCARD to delete the alpha channel and preserve the video. Set it to REMAP_TO_LUMA to delete the video and map the alpha channel to the luma channel of your outputs.

If the service returns an enum value that is not available in the current SDK version, alphaBehavior will return AlphaBehavior.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from alphaBehaviorAsString().

Returns:

Ignore this setting unless this input is a QuickTime animation with an alpha channel. Use this setting to create separate Key and Fill outputs. In each output, specify which part of the input MediaConvert uses. Leave this setting at the default value DISCARD to delete the alpha channel and preserve the video. Set it to REMAP_TO_LUMA to delete the video and map the alpha channel to the luma channel of your outputs.

See Also:

AlphaBehavior

colorSpace

public final ColorSpace colorSpace()

If your input video has accurate color space metadata, or if you don't know about color space: Keep the default value, Follow. MediaConvert will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or has missing metadata: Specify the accurate color space here. If your input video is HDR 10 and the SMPTE ST 2086 Mastering Display Color Volume static metadata isn't present in your video stream, or if that metadata is present but not accurate: Choose Force HDR 10. Specify correct values in the input HDR 10 metadata settings. For more information about HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr. When you specify an input color space, MediaConvert uses the following color space metadata, which includes color primaries, transfer characteristics, and matrix coefficients: * HDR 10: BT.2020, PQ, BT.2020 non-constant * HLG 2020: BT.2020, HLG, BT.2020 non-constant * P3DCI (Theater): DCIP3, SMPTE 428M, BT.709 * P3D65 (SDR): Display P3, sRGB, BT.709 * P3D65 (HDR): Display P3, PQ, BT.709

If the service returns an enum value that is not available in the current SDK version, colorSpace will return ColorSpace.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from colorSpaceAsString().

Returns:

If your input video has accurate color space metadata, or if you don't know about color space: Keep the default value, Follow. MediaConvert will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or has missing metadata: Specify the accurate color space here. If your input video is HDR 10 and the SMPTE ST 2086 Mastering Display Color Volume static metadata isn't present in your video stream, or if that metadata is present but not accurate: Choose Force HDR 10. Specify correct values in the input HDR 10 metadata settings. For more information about HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr. When you specify an input color space, MediaConvert uses the following color space metadata, which includes color primaries, transfer characteristics, and matrix coefficients: * HDR 10: BT.2020, PQ, BT.2020 non-constant * HLG 2020: BT.2020, HLG, BT.2020 non-constant * P3DCI (Theater): DCIP3, SMPTE 428M, BT.709 * P3D65 (SDR): Display P3, sRGB, BT.709 * P3D65 (HDR): Display P3, PQ, BT.709

See Also:

ColorSpace

colorSpaceAsString

public final String colorSpaceAsString()

If your input video has accurate color space metadata, or if you don't know about color space: Keep the default value, Follow. MediaConvert will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or has missing metadata: Specify the accurate color space here. If your input video is HDR 10 and the SMPTE ST 2086 Mastering Display Color Volume static metadata isn't present in your video stream, or if that metadata is present but not accurate: Choose Force HDR 10. Specify correct values in the input HDR 10 metadata settings. For more information about HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr. When you specify an input color space, MediaConvert uses the following color space metadata, which includes color primaries, transfer characteristics, and matrix coefficients: * HDR 10: BT.2020, PQ, BT.2020 non-constant * HLG 2020: BT.2020, HLG, BT.2020 non-constant * P3DCI (Theater): DCIP3, SMPTE 428M, BT.709 * P3D65 (SDR): Display P3, sRGB, BT.709 * P3D65 (HDR): Display P3, PQ, BT.709

If the service returns an enum value that is not available in the current SDK version, colorSpace will return ColorSpace.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from colorSpaceAsString().

Returns:

If your input video has accurate color space metadata, or if you don't know about color space: Keep the default value, Follow. MediaConvert will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or has missing metadata: Specify the accurate color space here. If your input video is HDR 10 and the SMPTE ST 2086 Mastering Display Color Volume static metadata isn't present in your video stream, or if that metadata is present but not accurate: Choose Force HDR 10. Specify correct values in the input HDR 10 metadata settings. For more information about HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr. When you specify an input color space, MediaConvert uses the following color space metadata, which includes color primaries, transfer characteristics, and matrix coefficients: * HDR 10: BT.2020, PQ, BT.2020 non-constant * HLG 2020: BT.2020, HLG, BT.2020 non-constant * P3DCI (Theater): DCIP3, SMPTE 428M, BT.709 * P3D65 (SDR): Display P3, sRGB, BT.709 * P3D65 (HDR): Display P3, PQ, BT.709

See Also:

ColorSpace

colorSpaceUsage

public final ColorSpaceUsage colorSpaceUsage()

There are two sources for color metadata, the input file and the job input settings Color space and HDR master display information settings. The Color space usage setting determines which takes precedence. Choose Force to use color metadata from the input job settings. If you don't specify values for those settings, the service defaults to using metadata from your input. FALLBACK - Choose Fallback to use color metadata from the source when it is present. If there's no color metadata in your input file, the service defaults to using values you specify in the input settings.

If the service returns an enum value that is not available in the current SDK version, colorSpaceUsage will return ColorSpaceUsage.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from colorSpaceUsageAsString().

Returns:

There are two sources for color metadata, the input file and the job input settings Color space and HDR master display information settings. The Color space usage setting determines which takes precedence. Choose Force to use color metadata from the input job settings. If you don't specify values for those settings, the service defaults to using metadata from your input. FALLBACK - Choose Fallback to use color metadata from the source when it is present. If there's no color metadata in your input file, the service defaults to using values you specify in the input settings.

See Also:

ColorSpaceUsage

colorSpaceUsageAsString

public final String colorSpaceUsageAsString()

There are two sources for color metadata, the input file and the job input settings Color space and HDR master display information settings. The Color space usage setting determines which takes precedence. Choose Force to use color metadata from the input job settings. If you don't specify values for those settings, the service defaults to using metadata from your input. FALLBACK - Choose Fallback to use color metadata from the source when it is present. If there's no color metadata in your input file, the service defaults to using values you specify in the input settings.

If the service returns an enum value that is not available in the current SDK version, colorSpaceUsage will return ColorSpaceUsage.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from colorSpaceUsageAsString().

Returns:

There are two sources for color metadata, the input file and the job input settings Color space and HDR master display information settings. The Color space usage setting determines which takes precedence. Choose Force to use color metadata from the input job settings. If you don't specify values for those settings, the service defaults to using metadata from your input. FALLBACK - Choose Fallback to use color metadata from the source when it is present. If there's no color metadata in your input file, the service defaults to using values you specify in the input settings.

See Also:

ColorSpaceUsage

embeddedTimecodeOverride

public final EmbeddedTimecodeOverride embeddedTimecodeOverride()

Set Embedded timecode override to Use MDPM when your AVCHD input contains timecode tag data in the Modified Digital Video Pack Metadata. When you do, we recommend you also set Timecode source to Embedded. Leave Embedded timecode override blank, or set to None, when your input does not contain MDPM timecode.

If the service returns an enum value that is not available in the current SDK version, embeddedTimecodeOverride will return EmbeddedTimecodeOverride.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from embeddedTimecodeOverrideAsString().

Returns:

Set Embedded timecode override to Use MDPM when your AVCHD input contains timecode tag data in the Modified Digital Video Pack Metadata. When you do, we recommend you also set Timecode source to Embedded. Leave Embedded timecode override blank, or set to None, when your input does not contain MDPM timecode.

See Also:

EmbeddedTimecodeOverride

embeddedTimecodeOverrideAsString

public final String embeddedTimecodeOverrideAsString()

Set Embedded timecode override to Use MDPM when your AVCHD input contains timecode tag data in the Modified Digital Video Pack Metadata. When you do, we recommend you also set Timecode source to Embedded. Leave Embedded timecode override blank, or set to None, when your input does not contain MDPM timecode.

If the service returns an enum value that is not available in the current SDK version, embeddedTimecodeOverride will return EmbeddedTimecodeOverride.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from embeddedTimecodeOverrideAsString().

Returns:

Set Embedded timecode override to Use MDPM when your AVCHD input contains timecode tag data in the Modified Digital Video Pack Metadata. When you do, we recommend you also set Timecode source to Embedded. Leave Embedded timecode override blank, or set to None, when your input does not contain MDPM timecode.

See Also:

EmbeddedTimecodeOverride

hdr10Metadata

public final Hdr10Metadata hdr10Metadata()

Use these settings to provide HDR 10 metadata that is missing or inaccurate in your input video. Appropriate values vary depending on the input video and must be provided by a color grader. The color grader generates these values during the HDR 10 mastering process. The valid range for each of these settings is 0 to 50,000. Each increment represents 0.00002 in CIE1931 color coordinate. Related settings - When you specify these values, you must also set Color space to HDR 10. To specify whether the the values you specify here take precedence over the values in the metadata of your input file, set Color space usage. To specify whether color metadata is included in an output, set Color metadata. For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr.

Returns:

Use these settings to provide HDR 10 metadata that is missing or inaccurate in your input video. Appropriate values vary depending on the input video and must be provided by a color grader. The color grader generates these values during the HDR 10 mastering process. The valid range for each of these settings is 0 to 50,000. Each increment represents 0.00002 in CIE1931 color coordinate. Related settings - When you specify these values, you must also set Color space to HDR 10. To specify whether the the values you specify here take precedence over the values in the metadata of your input file, set Color space usage. To specify whether color metadata is included in an output, set Color metadata. For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr.

padVideo

public final PadVideo padVideo()

Use this setting if your input has video and audio durations that don't align, and your output or player has strict alignment requirements. Examples: Input audio track has a delayed start. Input video track ends before audio ends. When you set Pad video to Black, MediaConvert generates black video frames so that output video and audio durations match. Black video frames are added at the beginning or end, depending on your input. To keep the default behavior and not generate black video, set Pad video to Disabled or leave blank.

If the service returns an enum value that is not available in the current SDK version, padVideo will return PadVideo.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from padVideoAsString().

Returns:

Use this setting if your input has video and audio durations that don't align, and your output or player has strict alignment requirements. Examples: Input audio track has a delayed start. Input video track ends before audio ends. When you set Pad video to Black, MediaConvert generates black video frames so that output video and audio durations match. Black video frames are added at the beginning or end, depending on your input. To keep the default behavior and not generate black video, set Pad video to Disabled or leave blank.

See Also:

PadVideo

padVideoAsString

public final String padVideoAsString()

Use this setting if your input has video and audio durations that don't align, and your output or player has strict alignment requirements. Examples: Input audio track has a delayed start. Input video track ends before audio ends. When you set Pad video to Black, MediaConvert generates black video frames so that output video and audio durations match. Black video frames are added at the beginning or end, depending on your input. To keep the default behavior and not generate black video, set Pad video to Disabled or leave blank.

If the service returns an enum value that is not available in the current SDK version, padVideo will return PadVideo.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from padVideoAsString().

Returns:

Use this setting if your input has video and audio durations that don't align, and your output or player has strict alignment requirements. Examples: Input audio track has a delayed start. Input video track ends before audio ends. When you set Pad video to Black, MediaConvert generates black video frames so that output video and audio durations match. Black video frames are added at the beginning or end, depending on your input. To keep the default behavior and not generate black video, set Pad video to Disabled or leave blank.

See Also:

PadVideo

pid

public final Integer pid()

Use PID to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.

Returns:

Use PID to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.

programNumber

public final Integer programNumber()

Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.

Returns:

Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.

rotate

public final InputRotate rotate()

Use Rotate to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata.

If the service returns an enum value that is not available in the current SDK version, rotate will return InputRotate.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from rotateAsString().

Returns:

Use Rotate to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata.

See Also:

InputRotate

rotateAsString

public final String rotateAsString()

Use Rotate to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata.

If the service returns an enum value that is not available in the current SDK version, rotate will return InputRotate.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from rotateAsString().

Returns:

Use Rotate to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata.

See Also:

InputRotate

sampleRange

public final InputSampleRange sampleRange()

If the sample range metadata in your input video is accurate, or if you don't know about sample range, keep the default value, Follow, for this setting. When you do, the service automatically detects your input sample range. If your input video has metadata indicating the wrong sample range, specify the accurate sample range here. When you do, MediaConvert ignores any sample range information in the input metadata. Regardless of whether MediaConvert uses the input sample range or the sample range that you specify, MediaConvert uses the sample range for transcoding and also writes it to the output metadata.

If the service returns an enum value that is not available in the current SDK version, sampleRange will return InputSampleRange.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from sampleRangeAsString().

Returns:

If the sample range metadata in your input video is accurate, or if you don't know about sample range, keep the default value, Follow, for this setting. When you do, the service automatically detects your input sample range. If your input video has metadata indicating the wrong sample range, specify the accurate sample range here. When you do, MediaConvert ignores any sample range information in the input metadata. Regardless of whether MediaConvert uses the input sample range or the sample range that you specify, MediaConvert uses the sample range for transcoding and also writes it to the output metadata.

See Also:

InputSampleRange

sampleRangeAsString

public final String sampleRangeAsString()

If the sample range metadata in your input video is accurate, or if you don't know about sample range, keep the default value, Follow, for this setting. When you do, the service automatically detects your input sample range. If your input video has metadata indicating the wrong sample range, specify the accurate sample range here. When you do, MediaConvert ignores any sample range information in the input metadata. Regardless of whether MediaConvert uses the input sample range or the sample range that you specify, MediaConvert uses the sample range for transcoding and also writes it to the output metadata.

If the service returns an enum value that is not available in the current SDK version, sampleRange will return InputSampleRange.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from sampleRangeAsString().

Returns:

If the sample range metadata in your input video is accurate, or if you don't know about sample range, keep the default value, Follow, for this setting. When you do, the service automatically detects your input sample range. If your input video has metadata indicating the wrong sample range, specify the accurate sample range here. When you do, MediaConvert ignores any sample range information in the input metadata. Regardless of whether MediaConvert uses the input sample range or the sample range that you specify, MediaConvert uses the sample range for transcoding and also writes it to the output metadata.

See Also:

InputSampleRange

toBuilder

public VideoSelector.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<VideoSelector.Builder,VideoSelector>

builder

public static VideoSelector.Builder builder()

serializableBuilderClass

public static Class<? extends VideoSelector.Builder> serializableBuilderClass()

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object

equalsBySdkFields

public final boolean equalsBySdkFields(Object obj)

Specified by:

equalsBySdkFields in interface SdkPojo

toString

public final String toString()

Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

getValueForField

public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)

sdkFields

public final List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo