class Aws::MediaConvert::Types::Mpeg2Settings

@see docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/Mpeg2Settings AWS API Documentation
@return [String]
Adaptive quantization (adaptiveQuantization).
quantization, adjust the strength of the filter with the setting
this feature. Related setting: When you enable temporal
edges, such as sports athletes’ faces, you might choose to disable
part of the screen that doesn’t have moving objects with sharp
to be. If viewers are likely to be focusing their attention on a
doesn’t take into account where the viewer’s attention is likely
always improve your video quality. Note, though, that this feature
scoreboards on sports matches. Enabling this feature will almost
improves the readability of text tickers on newscasts and
objects with sharp edges that move a lot. For example, this feature
of the frame that aren’t moving and uses more bits on complex
When you enable this feature, the encoder uses fewer bits on areas
within each frame based on temporal variation of content complexity.
Keep the default value, Enabled (ENABLED), to adjust quantization
@!attribute [rw] temporal_adaptive_quantization
@return [String]
the field polarity to create a smoother picture.
standard frame rate conversion to 29.97 without doing anything with
When you keep the default value, None (NONE), MediaConvert does a
to the video player device to do the conversion during play back.
telecine (SOFT) produces an output with a 23.976 output that signals
picture. Hard telecine (HARD) produces a 29.97i output. Soft
optionally enable hard or soft telecine to create a smoother
(fps) to 29.97 fps, and your output scan type is interlaced, you can
When you do frame rate conversion from 23.976 frames per second
@!attribute [rw] telecine
@return [String]
this value to to D10 (D_10).
choose D10 (D_10) for your MXF profile (profile), you must also set
default value to not use the syntax. Related settings: When you
Specify whether this output’s video uses the D10 syntax. Keep the
@!attribute [rw] syntax
@return [String]
set it to High or Higher.
games, set it to Low. For content with a wider variety of textures,
your content. For homogeneous content, such as cartoons and video
value for Adaptive quantization (adaptiveQuantization) depending on
setting: When you enable spatial adaptive quantization, set the
complex texture, you might choose to disable this feature. Related
to be focusing their attention on a part of the screen with a lot of
where the viewer’s attention is likely to be. If viewers are likely
quality. Note, though, that this feature doesn’t take into account
bits. Enabling this feature will almost always improve your video
with fewer bits and smooth textured blocks are encoded with more
will be noticeable. For example, complex textured blocks are encoded
degradation and uses more bits on areas where any small distortion
that can sustain more distortion with no noticeable visual
When you enable this feature, the encoder uses fewer bits on areas
within each frame based on spatial variation of content complexity.
Keep the default value, Enabled (ENABLED), to adjust quantization
@!attribute [rw] spatial_adaptive_quantization
@return [Integer]
in the softest video.
increasing reduction of high-frequency data. The value 128 results
planar interpolation. Increasing values from 17 to 128 result in
Elemental default matrices. Choose a value from 17 to 128 to use
the encoder uses. Keep the default value, 0, to use the AWS
Softness (softness) setting specifies the quantization matrices that
or by enabling a noise reducer filter (noiseReducerFilter). The
output by using a lower value for the setting Sharpness (sharpness)
requirement, we recommend that you adjust the softness of your
that requires a specific value. If you don’t have a specification
Ignore this setting unless you need to comply with a specification
@!attribute [rw] softness
@return [String]
(framerateDenominator) to 1.
(framerateControl) to (SPECIFIED), (framerateNumerator) to 25 and
Framerate to 25. In your JSON job specification, set
duration of your video. Required settings: You must also set
video. Note that enabling this setting will slightly reduce the
25 fps and resamples your audio to keep it synchronized with the
When you enable slow PAL, MediaConvert relabels the video frames to
frames per second (fps). Enable slow PAL to create a 25 fps output.
Ignore this setting unless your input frame rate is 23.976 or 24
@!attribute [rw] slow_pal
@return [String]
enabled by default.
service automatically detects. This improves video quality and is
Enable this setting to insert I-frames at scene changes that the
@!attribute [rw] scene_change_detect
@return [String]
to a value other than Progressive (PROGRESSIVE).
telecine outputs. You must also set Interlace mode (interlaceMode)
(NONE) or Soft (SOFT). You can’t use optimized interlacing for hard
use optimized interlacing, you must set Telecine (telecine) to None
automatically falls back to basic interlacing. Required settings: To
value that isn’t suitable for optimized interlacing, MediaConvert
choose Optimized interlacing and you set your output frame rate to a
rate conversion first and then interlaces the frames. When you
frame rates. With basic interlacing, MediaConvert performs any frame
default value, Basic interlacing (INTERLACED), for all other output
the input corresponds to an interlaced field in the output. Keep the
quality interlaced output. In this case, each progressive frame from
Optimized interlacing (INTERLACED_OPTIMIZE) to create a better
is half of your input frame rate. In this situation, choose
Use this setting for interlaced outputs, when your output frame rate
@!attribute [rw] scan_type_conversion_mode
@return [String]
bitrate is variable (vbr) or constant (cbr).
Use Rate control mode (Mpeg2RateControlMode) to specify whether the
@!attribute [rw] rate_control_mode
@return [String]
The default behavior is faster, lower quality, single-pass encoding.
how you want to trade off encoding speed for output video quality.
Optional. Use Quality tuning level (qualityTuningLevel) to choose
@!attribute [rw] quality_tuning_level
@return [Integer]
ratio 40:33. In this example, the value for parNumerator is 40.
ratio. For example, for D1/DV NTSC widescreen, you would specify the
different from your input video PAR, provide your output PAR as a
source. When you specify an output pixel aspect ratio (PAR) that is
On the console, this corresponds to any value other than Follow
Required when you set Pixel aspect ratio (parControl) to SPECIFIED.
@!attribute [rw] par_numerator
@return [Integer]
ratio 40:33. In this example, the value for parDenominator is 33.
ratio. For example, for D1/DV NTSC widescreen, you would specify the
different from your input video PAR, provide your output PAR as a
source. When you specify an output pixel aspect ratio (PAR) that is
On the console, this corresponds to any value other than Follow
Required when you set Pixel aspect ratio (parControl) to SPECIFIED.
@!attribute [rw] par_denominator
@return [String]
the parNumerator and parDenominator settings.
choose SPECIFIED for this setting, you must also specify values for
editing the JSON job specification, choose SPECIFIED. When you
value other than Follow source. To specify a different PAR by
your output. To specify a different PAR in the console, choose any
(INITIALIZE_FROM_SOURCE), uses the PAR from your input video for
(PAR) for this output. The default behavior, Follow source
Optional. Specify how the service determines the pixel aspect ratio
@!attribute [rw] par_control
@return [Integer]
Number of B-frames between reference frames.
@!attribute [rw] number_b_frames_between_reference_frames
@return [Integer]
Min-I-interval - 1
Change Detect is enabled. Note: Maximum GOP stretch = GOP size +
resumes for the next GOP. This setting is only used when Scene
enabling lookahead as well as setting I-interval. The normal cadence
and/or stretched to the scene change I-frame. GOP stretch requires
within I-interval frames of a cadence I-frame, the GOP is shrunk
inserted by Scene Change Detection. If a scene change I-frame is
Enforces separation between repeated (cadence) I-frames and I-frames
@!attribute [rw] min_i_interval
@return [Integer]
second as 5000000.
Maximum bitrate in bits/second. For example, enter five megabits per
@!attribute [rw] max_bitrate
@return [String]
the per-frame compression ratio.
auto, the service will automatically select the precision based on
precision for intra-block DC coefficients. If you choose the value
Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization
@!attribute [rw] intra_dc_precision
@return [String]
the Follow options you choose.
interlaced with top field bottom field first, depending on which of
the source. If the source is progressive, the output will be
interlaced, the output will be interlaced with the same polarity as
Follow behavior depends on the input scan type. If the source is
output field polarity might change over the course of the output.
polarity as the source. For jobs that have multiple inputs, the
(FOLLOW_BOTTOM_FIELD) to produce outputs with the same field
default top (FOLLOW_TOP_FIELD) or Follow, default bottom
interlaced with the same field polarity throughout. Use Follow,
Bottom field first (BOTTOM_FIELD) to create an output that’s
of the scan type of your input. Use Top field first (TOP_FIELD) or
Progressive (PROGRESSIVE) to create a progressive output, regardless
Choose the scan line type for the output. Keep the default value,
@!attribute [rw] interlace_mode
@return [Integer]
megabits as 5000000.
Size of buffer (HRD buffer model) in bits. For example, enter five
@!attribute [rw] hrd_buffer_size
@return [Integer]
model).
Percentage of the buffer that should initially be filled (HRD buffer
@!attribute [rw] hrd_buffer_initial_fill_percentage
@return [String]
frame count at run time.
seconds. If seconds the system will convert the GOP Size into a
Indicates if the GOP Size in MPEG2 is specified in frames or
@!attribute [rw] gop_size_units
@return [Float]
than zero.
GOP Length (keyframe interval) in frames or seconds. Must be greater
@!attribute [rw] gop_size
@return [Integer]
to 0 will break output segmenting.
will receive an IDR frame as quickly as possible. Setting this value
recommended that this be set to 1 so a decoder joining mid-stream
Frequency of closed GOPs. In streaming applications, it is
@!attribute [rw] gop_closed_cadence
@return [Integer]
Framerate. In this example, specify 23.976.
use frame rate conversion, provide the value as a decimal number for
FramerateNumerator. When you use the console for transcode jobs that
of this fraction. In this example, use 24000 for the value of
/ 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator
conversion, specify the frame rate as a fraction. For example, 24000
When you use the API for transcode jobs that use frame rate
@!attribute [rw] framerate_numerator
@return [Integer]
a decimal number for Framerate. In this example, specify 23.976.
transcode jobs that use frame rate conversion, provide the value as
value of FramerateDenominator. When you use the console for
denominator of this fraction. In this example, use 1001 for the
/ 1001 = 23.976 fps. Use FramerateDenominator to specify the
conversion, specify the frame rate as a fraction. For example, 24000
When you use the API for transcode jobs that use frame rate
@!attribute [rw] framerate_denominator
@return [String]
add-on cost.
FrameFormer increases the transcoding time and incurs a significant
chooses the best conversion method frame by frame. Note that using
(FRAMEFORMER) to do motion-compensated interpolation. FrameFormer
already been converted from its original cadence, use FrameFormer
complex frame rate conversions, especially if your source video has
picture, but might introduce undesirable video artifacts. For
interpolate (INTERPOLATE) to avoid stutter. This results in a smooth
to 30 fps. For numerically complex conversions, you can use
(DUPLICATE_DROP) for numerically simple conversions, such as 60 fps
or decreasing the frame rate. We recommend using drop duplicate
Choose the method that you want MediaConvert to use when increasing
@!attribute [rw] framerate_conversion_algorithm
@return [String]
in the settings FramerateNumerator and FramerateDenominator.
SPECIFIED if you want the service to use the frame rate you specify
want the service to use the frame rate from the input. Choose
frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you
FramerateControl to specify which value the service uses for the
specification as a JSON file without the console, use
frame rate as a fraction. If you are creating your transcoding job
approximations of fractions. If you choose Custom, specify your
choose Custom. The framerates shown in the dropdown list are decimal
frame rate conversion, choose a frame rate from the dropdown list or
rate as the input video, choose Follow source. If you want to do
the frame rate for this output. If you want to keep the same frame
If you are using the console, use the Framerate setting to specify
@!attribute [rw] framerate_control
@return [String]
(numberBFramesBetweenReferenceFrames).
setting B frames between reference frames
number of B-frames is limited by the value you provide for the
the video and more B-frames for low-motion portions. The maximum
infer information based on other frames) for high-motion portions of
content. This will cause the service to use fewer B-frames (which
Choose Adaptive to improve subjective video quality for high-motion
@!attribute [rw] dynamic_sub_gop
@return [String]
video output.
Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the
@!attribute [rw] codec_profile
@return [String]
output.
Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video
@!attribute [rw] codec_level
@return [Integer]
down to the nearest multiple of 1000.
CBR. For MS Smooth outputs, bitrates must be unique when rounded
Specify the average bitrate in bits per second. Required for VBR and
@!attribute [rw] bitrate
@return [String]
(temporalAdaptiveQuantization).
(spatialAdaptiveQuantization), and Temporal adaptive quantization
settings: Spatial adaptive quantization
enable. The value that you choose here applies to the following
Specify the strength of any adaptive quantization filters that you
@!attribute [rw] adaptive_quantization
}
temporal_adaptive_quantization: “DISABLED”, # accepts DISABLED, ENABLED
telecine: “NONE”, # accepts NONE, SOFT, HARD
syntax: “DEFAULT”, # accepts DEFAULT, D_10
spatial_adaptive_quantization: “DISABLED”, # accepts DISABLED, ENABLED
softness: 1,
slow_pal: “DISABLED”, # accepts DISABLED, ENABLED
scene_change_detect: “DISABLED”, # accepts DISABLED, ENABLED
scan_type_conversion_mode: “INTERLACED”, # accepts INTERLACED, INTERLACED_OPTIMIZE
rate_control_mode: “VBR”, # accepts VBR, CBR
quality_tuning_level: “SINGLE_PASS”, # accepts SINGLE_PASS, MULTI_PASS
par_numerator: 1,
par_denominator: 1,
par_control: “INITIALIZE_FROM_SOURCE”, # accepts INITIALIZE_FROM_SOURCE, SPECIFIED
number_b_frames_between_reference_frames: 1,
min_i_interval: 1,
max_bitrate: 1,
intra_dc_precision: “AUTO”, # accepts AUTO, INTRA_DC_PRECISION_8, INTRA_DC_PRECISION_9, INTRA_DC_PRECISION_10, INTRA_DC_PRECISION_11
interlace_mode: “PROGRESSIVE”, # accepts PROGRESSIVE, TOP_FIELD, BOTTOM_FIELD, FOLLOW_TOP_FIELD, FOLLOW_BOTTOM_FIELD
hrd_buffer_size: 1,
hrd_buffer_initial_fill_percentage: 1,
gop_size_units: “FRAMES”, # accepts FRAMES, SECONDS
gop_size: 1.0,
gop_closed_cadence: 1,
framerate_numerator: 1,
framerate_denominator: 1,
framerate_conversion_algorithm: “DUPLICATE_DROP”, # accepts DUPLICATE_DROP, INTERPOLATE, FRAMEFORMER
framerate_control: “INITIALIZE_FROM_SOURCE”, # accepts INITIALIZE_FROM_SOURCE, SPECIFIED
dynamic_sub_gop: “ADAPTIVE”, # accepts ADAPTIVE, STATIC
codec_profile: “MAIN”, # accepts MAIN, PROFILE_422
codec_level: “AUTO”, # accepts AUTO, LOW, MAIN, HIGH1440, HIGH
bitrate: 1,
adaptive_quantization: “OFF”, # accepts OFF, LOW, MEDIUM, HIGH
{
data as a hash:
@note When making an API call, you may pass Mpeg2Settings
to the value MPEG2.
Required when you set (Codec) under (VideoDescription)>(CodecSettings)