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

Class: Aws::MediaLive::Types::H265Settings

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

Overview

Note:

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

{
  adaptive_quantization: "HIGH", # accepts HIGH, HIGHER, LOW, MAX, MEDIUM, OFF
  afd_signaling: "AUTO", # accepts AUTO, FIXED, NONE
  alternative_transfer_function: "INSERT", # accepts INSERT, OMIT
  bitrate: 1,
  buf_size: 1,
  color_metadata: "IGNORE", # accepts IGNORE, INSERT
  color_space_settings: {
    color_space_passthrough_settings: {
    },
    hdr_10_settings: {
      max_cll: 1,
      max_fall: 1,
    },
    rec_601_settings: {
    },
    rec_709_settings: {
    },
  },
  filter_settings: {
    temporal_filter_settings: {
      post_filter_sharpening: "AUTO", # accepts AUTO, DISABLED, ENABLED
      strength: "AUTO", # accepts AUTO, STRENGTH_1, STRENGTH_2, STRENGTH_3, STRENGTH_4, STRENGTH_5, STRENGTH_6, STRENGTH_7, STRENGTH_8, STRENGTH_9, STRENGTH_10, STRENGTH_11, STRENGTH_12, STRENGTH_13, STRENGTH_14, STRENGTH_15, STRENGTH_16
    },
  },
  fixed_afd: "AFD_0000", # accepts AFD_0000, AFD_0010, AFD_0011, AFD_0100, AFD_1000, AFD_1001, AFD_1010, AFD_1011, AFD_1101, AFD_1110, AFD_1111
  flicker_aq: "DISABLED", # accepts DISABLED, ENABLED
  framerate_denominator: 1, # required
  framerate_numerator: 1, # required
  gop_closed_cadence: 1,
  gop_size: 1.0,
  gop_size_units: "FRAMES", # accepts FRAMES, SECONDS
  level: "H265_LEVEL_1", # accepts H265_LEVEL_1, H265_LEVEL_2, H265_LEVEL_2_1, H265_LEVEL_3, H265_LEVEL_3_1, H265_LEVEL_4, H265_LEVEL_4_1, H265_LEVEL_5, H265_LEVEL_5_1, H265_LEVEL_5_2, H265_LEVEL_6, H265_LEVEL_6_1, H265_LEVEL_6_2, H265_LEVEL_AUTO
  look_ahead_rate_control: "HIGH", # accepts HIGH, LOW, MEDIUM
  max_bitrate: 1,
  min_i_interval: 1,
  par_denominator: 1,
  par_numerator: 1,
  profile: "MAIN", # accepts MAIN, MAIN_10BIT
  qvbr_quality_level: 1,
  rate_control_mode: "CBR", # accepts CBR, MULTIPLEX, QVBR
  scan_type: "INTERLACED", # accepts INTERLACED, PROGRESSIVE
  scene_change_detect: "DISABLED", # accepts DISABLED, ENABLED
  slices: 1,
  tier: "HIGH", # accepts HIGH, MAIN
  timecode_insertion: "DISABLED", # accepts DISABLED, PIC_TIMING_SEI
}

H265 Settings

Returned by:

Instance Attribute Summary collapse

Instance Attribute Details

#adaptive_quantizationString

Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.

Possible values:

  • HIGH
  • HIGHER
  • LOW
  • MAX
  • MEDIUM
  • OFF

Returns:

  • (String)

    Adaptive quantization.

#afd_signalingString

Indicates that AFD values will be written into the output stream. If afdSignaling is \"auto\", the system will try to preserve the input AFD value (in cases where multiple AFD values are valid). If set to \"fixed\", the AFD value will be the value configured in the fixedAfd parameter.

Possible values:

  • AUTO
  • FIXED
  • NONE

Returns:

  • (String)

    Indicates that AFD values will be written into the output stream.

#alternative_transfer_functionString

Whether or not EML should insert an Alternative Transfer Function SEI message to support backwards compatibility with non-HDR decoders and displays.

Possible values:

  • INSERT
  • OMIT

Returns:

  • (String)

    Whether or not EML should insert an Alternative Transfer Function SEI message to support backwards compatibility with non-HDR decoders and displays.

#bitrateInteger

Average bitrate in bits/second. Required when the rate control mode is VBR or CBR. Not used for QVBR. In an MS Smooth output group, each output must have a unique value when its bitrate is rounded down to the nearest multiple of 1000.

Returns:

  • (Integer)

    Average bitrate in bits/second.

#buf_sizeInteger

Size of buffer (HRD buffer model) in bits.

Returns:

  • (Integer)

    Size of buffer (HRD buffer model) in bits.

#color_metadataString

Includes colorspace metadata in the output.

Possible values:

  • IGNORE
  • INSERT

Returns:

  • (String)

    Includes colorspace metadata in the output.

#color_space_settingsTypes::H265ColorSpaceSettings

Color Space settings

Returns:

#filter_settingsTypes::H265FilterSettings

Optional filters that you can apply to an encode.

Returns:

#fixed_afdString

Four bit AFD value to write on all frames of video in the output stream. Only valid when afdSignaling is set to \'Fixed\'.

Possible values:

  • AFD_0000
  • AFD_0010
  • AFD_0011
  • AFD_0100
  • AFD_1000
  • AFD_1001
  • AFD_1010
  • AFD_1011
  • AFD_1101
  • AFD_1110
  • AFD_1111

Returns:

  • (String)

    Four bit AFD value to write on all frames of video in the output stream.

#flicker_aqString

If set to enabled, adjust quantization within each frame to reduce flicker or \'pop\' on I-frames.

Possible values:

  • DISABLED
  • ENABLED

Returns:

  • (String)

    If set to enabled, adjust quantization within each frame to reduce flicker or \'pop\' on I-frames.

#framerate_denominatorInteger

Framerate denominator.

Returns:

  • (Integer)

    Framerate denominator.

#framerate_numeratorInteger

Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps.

Returns:

  • (Integer)

    Framerate numerator - framerate is a fraction, e.g.

#gop_closed_cadenceInteger

Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.

Returns:

  • (Integer)

    Frequency of closed GOPs.

#gop_sizeFloat

GOP size (keyframe interval) in units of either frames or seconds per gopSizeUnits. If gopSizeUnits is frames, gopSize must be an integer and must be greater than or equal to 1. If gopSizeUnits is seconds, gopSize must be greater than 0, but need not be an integer.

Returns:

  • (Float)

    GOP size (keyframe interval) in units of either frames or seconds per gopSizeUnits.

#gop_size_unitsString

Indicates if the gopSize is specified in frames or seconds. If seconds the system will convert the gopSize into a frame count at run time.

Possible values:

  • FRAMES
  • SECONDS

Returns:

  • (String)

    Indicates if the gopSize is specified in frames or seconds.

#levelString

H.265 Level.

Possible values:

  • H265_LEVEL_1
  • H265_LEVEL_2
  • H265_LEVEL_2_1
  • H265_LEVEL_3
  • H265_LEVEL_3_1
  • H265_LEVEL_4
  • H265_LEVEL_4_1
  • H265_LEVEL_5
  • H265_LEVEL_5_1
  • H265_LEVEL_5_2
  • H265_LEVEL_6
  • H265_LEVEL_6_1
  • H265_LEVEL_6_2
  • H265_LEVEL_AUTO

Returns:

  • (String)

    H.265 Level.

#look_ahead_rate_controlString

Amount of lookahead. A value of low can decrease latency and memory usage, while high can produce better quality for certain content.

Possible values:

  • HIGH
  • LOW
  • MEDIUM

Returns:

  • (String)

    Amount of lookahead.

#max_bitrateInteger

For QVBR: See the tooltip for Quality level

Returns:

  • (Integer)

    For QVBR: See the tooltip for Quality level.

#min_i_intervalInteger

Only meaningful if sceneChangeDetect is set to enabled. Defaults to 5 if multiplex rate control is used. Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1

Returns:

  • (Integer)

    Only meaningful if sceneChangeDetect is set to enabled.

#par_denominatorInteger

Pixel Aspect Ratio denominator.

Returns:

  • (Integer)

    Pixel Aspect Ratio denominator.

#par_numeratorInteger

Pixel Aspect Ratio numerator.

Returns:

  • (Integer)

    Pixel Aspect Ratio numerator.

#profileString

H.265 Profile.

Possible values:

  • MAIN
  • MAIN_10BIT

Returns:

  • (String)

    H.265 Profile.

#qvbr_quality_levelInteger

Controls the target quality for the video encode. Applies only when the rate control mode is QVBR. Set values for the QVBR quality level field and Max bitrate field that suit your most important viewing devices. Recommended values are: - Primary screen: Quality level: 8 to 10. Max bitrate: 4M - PC or tablet: Quality level: 7. Max bitrate: 1.5M to 3M - Smartphone: Quality level: 6. Max bitrate: 1M to 1.5M

Returns:

  • (Integer)

    Controls the target quality for the video encode.

#rate_control_modeString

Rate control mode. QVBR: Quality will match the specified quality level except when it is constrained by the maximum bitrate. Recommended if you or your viewers pay for bandwidth. CBR: Quality varies, depending on the video complexity. Recommended only if you distribute your assets to devices that cannot handle variable bitrates. Multiplex: This rate control mode is only supported (and is required) when the video is being delivered to a MediaLive Multiplex in which case the rate control configuration is controlled by the properties within the Multiplex Program.

Possible values:

  • CBR
  • MULTIPLEX
  • QVBR

Returns:

  • (String)

    Rate control mode.

#scan_typeString

Sets the scan type of the output to progressive or top-field-first interlaced.

Possible values:

  • INTERLACED
  • PROGRESSIVE

Returns:

  • (String)

    Sets the scan type of the output to progressive or top-field-first interlaced.

#scene_change_detectString

Scene change detection.

Possible values:

  • DISABLED
  • ENABLED

Returns:

  • (String)

    Scene change detection.

#slicesInteger

Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures. This field is optional; when no value is specified the encoder will choose the number of slices based on encode resolution.

Returns:

  • (Integer)

    Number of slices per picture.

#tierString

H.265 Tier.

Possible values:

  • HIGH
  • MAIN

Returns:

  • (String)

    H.265 Tier.

#timecode_insertionString

Determines how timecodes should be inserted into the video elementary stream. - \'disabled\': Do not include timecodes - \'picTimingSei\': Pass through picture timing SEI messages from the source specified in Timecode Config

Possible values:

  • DISABLED
  • PIC_TIMING_SEI

Returns:

  • (String)

    Determines how timecodes should be inserted into the video elementary stream.