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

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

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb

Overview

Note:

When making an API call, you may pass VideoSelector data as a hash:

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

Instance Attribute Summary collapse

Instance Attribute Details

#color_spaceString

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.

Returns:

  • (String)


17805
17806
17807
17808
17809
17810
17811
17812
17813
# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 17805

class VideoSelector < Struct.new(
  :color_space,
  :color_space_usage,
  :hdr_10_metadata,
  :pid,
  :program_number,
  :rotate)
  include Aws::Structure
end

#color_space_usageString

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.

Returns:

  • (String)


17805
17806
17807
17808
17809
17810
17811
17812
17813
# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 17805

class VideoSelector < Struct.new(
  :color_space,
  :color_space_usage,
  :hdr_10_metadata,
  :pid,
  :program_number,
  :rotate)
  include Aws::Structure
end

#hdr_10_metadataTypes::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.



17805
17806
17807
17808
17809
17810
17811
17812
17813
# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 17805

class VideoSelector < Struct.new(
  :color_space,
  :color_space_usage,
  :hdr_10_metadata,
  :pid,
  :program_number,
  :rotate)
  include Aws::Structure
end

#pidInteger

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)


17805
17806
17807
17808
17809
17810
17811
17812
17813
# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 17805

class VideoSelector < Struct.new(
  :color_space,
  :color_space_usage,
  :hdr_10_metadata,
  :pid,
  :program_number,
  :rotate)
  include Aws::Structure
end

#program_numberInteger

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

Returns:

  • (Integer)


17805
17806
17807
17808
17809
17810
17811
17812
17813
# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 17805

class VideoSelector < Struct.new(
  :color_space,
  :color_space_usage,
  :hdr_10_metadata,
  :pid,
  :program_number,
  :rotate)
  include Aws::Structure
end

#rotateString

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.

Returns:

  • (String)


17805
17806
17807
17808
17809
17810
17811
17812
17813
# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 17805

class VideoSelector < Struct.new(
  :color_space,
  :color_space_usage,
  :hdr_10_metadata,
  :pid,
  :program_number,
  :rotate)
  include Aws::Structure
end