You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::MediaConvert::Types::VideoSelector

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing VideoSelector as input to an Aws::Client method, you can use a vanilla Hash:

{
  alpha_behavior: "DISCARD", # accepts DISCARD, REMAP_TO_LUMA
  color_space: "FOLLOW", # accepts FOLLOW, REC_601, REC_709, HDR10, HLG_2020
  color_space_usage: "FORCE", # accepts FORCE, FALLBACK
  hdr_10_metadata: {
    blue_primary_x: 1,
    blue_primary_y: 1,
    green_primary_x: 1,
    green_primary_y: 1,
    max_content_light_level: 1,
    max_frame_average_light_level: 1,
    max_luminance: 1,
    min_luminance: 1,
    red_primary_x: 1,
    red_primary_y: 1,
    white_point_x: 1,
    white_point_y: 1,
  },
  pid: 1,
  program_number: 1,
  rotate: "DEGREE_0", # accepts DEGREE_0, DEGREES_90, DEGREES_180, DEGREES_270, AUTO
}

Selector for video.

Returned by:

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#alpha_behavior ⇒ String

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.

Possible values:

  • DISCARD
  • REMAP_TO_LUMA

Returns:

  • (String) —

    Ignore this setting unless this input is a QuickTime animation with an alpha channel.

#color_space ⇒ String

If your input video has accurate color space metadata, or if you don\'t know about color space, leave this set to the default value Follow (FOLLOW). The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, 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 (FORCE_HDR10) here and specify correct values in the input HDR 10 metadata (Hdr10Metadata) settings. For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr.

Possible values:

  • FOLLOW
  • REC_601
  • REC_709
  • HDR10
  • HLG_2020

Returns:

  • (String) —

    If your input video has accurate color space metadata, or if you don\'t know about color space, leave this set to the default value Follow (FOLLOW).

#color_space_usage ⇒ String

There are two sources for color metadata, the input file and the job input settings Color space (ColorSpace) and HDR master display information settings(Hdr10Metadata). The Color space usage setting determines which takes precedence. Choose Force (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 (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.

Possible values:

  • FORCE
  • FALLBACK

Returns:

  • (String) —

    There are two sources for color metadata, the input file and the job input settings Color space (ColorSpace) and HDR master display information settings(Hdr10Metadata).

#hdr_10_metadata ⇒ Types::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 (ColorSpace) to HDR 10 (HDR10). 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 (ColorSpaceUsage). To specify whether color metadata is included in an output, set Color metadata (ColorMetadata). For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr.

Returns:

  • (Types::Hdr10Metadata) —

    Use these settings to provide HDR 10 metadata that is missing or inaccurate in your input video.

#pid ⇒ Integer

Use PID (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:

  • (Integer) —

    Use PID (Pid) to select specific video data from an input file.

#program_number ⇒ Integer

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

Returns:

  • (Integer) —

    Selects a specific program from within a multi-program transport stream.

#rotate ⇒ String

Use Rotate (InputRotate) 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.

Possible values:

  • DEGREE_0
  • DEGREES_90
  • DEGREES_180
  • DEGREES_270
  • AUTO

Returns:

  • (String) —

    Use Rotate (InputRotate) to specify how the service rotates your video.