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

Class: Aws::MediaConvert::Types::Vp8Settings

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

Overview

Note:

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

{
  bitrate: 1,
  framerate_control: "INITIALIZE_FROM_SOURCE", # accepts INITIALIZE_FROM_SOURCE, SPECIFIED
  framerate_conversion_algorithm: "DUPLICATE_DROP", # accepts DUPLICATE_DROP, INTERPOLATE, FRAMEFORMER
  framerate_denominator: 1,
  framerate_numerator: 1,
  gop_size: 1.0,
  hrd_buffer_size: 1,
  max_bitrate: 1,
  par_control: "INITIALIZE_FROM_SOURCE", # accepts INITIALIZE_FROM_SOURCE, SPECIFIED
  par_denominator: 1,
  par_numerator: 1,
  quality_tuning_level: "MULTI_PASS", # accepts MULTI_PASS, MULTI_PASS_HQ
  rate_control_mode: "VBR", # accepts VBR
}

Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value VP8.

Returned by:

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#bitrate ⇒ Integer

Target bitrate in bits/second. For example, enter five megabits per second as 5000000.

Returns:

  • (Integer) —

    Target bitrate in bits/second.

#framerate_control ⇒ String

If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator.

Possible values:

  • INITIALIZE_FROM_SOURCE
  • SPECIFIED

Returns:

  • (String) —

    If you are using the console, use the Framerate setting to specify the frame rate for this output.

#framerate_conversion_algorithm ⇒ String

Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost.

Possible values:

  • DUPLICATE_DROP
  • INTERPOLATE
  • FRAMEFORMER

Returns:

  • (String) —

    Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate.

#framerate_denominator ⇒ Integer

When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

Returns:

  • (Integer) —

    When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction.

#framerate_numerator ⇒ Integer

When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

Returns:

  • (Integer) —

    When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction.

#gop_size ⇒ Float

GOP Length (keyframe interval) in frames. Must be greater than zero.

Returns:

  • (Float) —

    GOP Length (keyframe interval) in frames.

#hrd_buffer_size ⇒ Integer

Optional. Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.

Returns:

  • (Integer) —

    Optional.

#max_bitrate ⇒ Integer

Ignore this setting unless you set qualityTuningLevel to MULTI_PASS. Optional. Specify the maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. The default behavior uses twice the target bitrate as the maximum bitrate.

Returns:

  • (Integer) —

    Ignore this setting unless you set qualityTuningLevel to MULTI_PASS.

#par_control ⇒ String

Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.

Possible values:

  • INITIALIZE_FROM_SOURCE
  • SPECIFIED

Returns:

  • (String) —

    Optional.

#par_denominator ⇒ Integer

Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33.

Returns:

  • (Integer) —

    Required when you set Pixel aspect ratio (parControl) to SPECIFIED.

#par_numerator ⇒ Integer

Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40.

Returns:

  • (Integer) —

    Required when you set Pixel aspect ratio (parControl) to SPECIFIED.

#quality_tuning_level ⇒ String

Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, multi-pass encoding.

Possible values:

  • MULTI_PASS
  • MULTI_PASS_HQ

Returns:

  • (String) —

    Optional.

#rate_control_mode ⇒ String

With the VP8 codec, you can use only the variable bitrate (VBR) rate control mode.

Possible values:

  • VBR

Returns:

  • (String) —

    With the VP8 codec, you can use only the variable bitrate (VBR) rate control mode.