blib/lib/Paws/MediaConvert/Mpeg2Settings.pm untested

filter: Statementstmt 0.0% 0 / 67 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 0.0% 0 / 1 Podpod n/a totaltotal 0.0% 0 / 68 CC 1 SCAR 6.9
CC
1
Cov
0%
BEGIN
2.0
CRAP 2.0
1 # Generated by default/object.tt
2 package Paws::MediaConvert::Mpeg2Settings;
3 use Moose;
4 has AdaptiveQuantization => (is => 'ro', isa => 'Str', request_name => 'adaptiveQuantization', traits => ['NameInRequest']);
5 has Bitrate => (is => 'ro', isa => 'Int', request_name => 'bitrate', traits => ['NameInRequest']);
6 has CodecLevel => (is => 'ro', isa => 'Str', request_name => 'codecLevel', traits => ['NameInRequest']);
7 has CodecProfile => (is => 'ro', isa => 'Str', request_name => 'codecProfile', traits => ['NameInRequest']);
8 has DynamicSubGop => (is => 'ro', isa => 'Str', request_name => 'dynamicSubGop', traits => ['NameInRequest']);
9 has FramerateControl => (is => 'ro', isa => 'Str', request_name => 'framerateControl', traits => ['NameInRequest']);
10 has FramerateConversionAlgorithm => (is => 'ro', isa => 'Str', request_name => 'framerateConversionAlgorithm', traits => ['NameInRequest']);
11 has FramerateDenominator => (is => 'ro', isa => 'Int', request_name => 'framerateDenominator', traits => ['NameInRequest']);
12 has FramerateNumerator => (is => 'ro', isa => 'Int', request_name => 'framerateNumerator', traits => ['NameInRequest']);
13 has GopClosedCadence => (is => 'ro', isa => 'Int', request_name => 'gopClosedCadence', traits => ['NameInRequest']);
14 has GopSize => (is => 'ro', isa => 'Num', request_name => 'gopSize', traits => ['NameInRequest']);
15 has GopSizeUnits => (is => 'ro', isa => 'Str', request_name => 'gopSizeUnits', traits => ['NameInRequest']);
16 has HrdBufferInitialFillPercentage => (is => 'ro', isa => 'Int', request_name => 'hrdBufferInitialFillPercentage', traits => ['NameInRequest']);
17 has HrdBufferSize => (is => 'ro', isa => 'Int', request_name => 'hrdBufferSize', traits => ['NameInRequest']);
18 has InterlaceMode => (is => 'ro', isa => 'Str', request_name => 'interlaceMode', traits => ['NameInRequest']);
19 has IntraDcPrecision => (is => 'ro', isa => 'Str', request_name => 'intraDcPrecision', traits => ['NameInRequest']);
20 has MaxBitrate => (is => 'ro', isa => 'Int', request_name => 'maxBitrate', traits => ['NameInRequest']);
21 has MinIInterval => (is => 'ro', isa => 'Int', request_name => 'minIInterval', traits => ['NameInRequest']);
22 has NumberBFramesBetweenReferenceFrames => (is => 'ro', isa => 'Int', request_name => 'numberBFramesBetweenReferenceFrames', traits => ['NameInRequest']);
23 has ParControl => (is => 'ro', isa => 'Str', request_name => 'parControl', traits => ['NameInRequest']);
24 has ParDenominator => (is => 'ro', isa => 'Int', request_name => 'parDenominator', traits => ['NameInRequest']);
25 has ParNumerator => (is => 'ro', isa => 'Int', request_name => 'parNumerator', traits => ['NameInRequest']);
26 has QualityTuningLevel => (is => 'ro', isa => 'Str', request_name => 'qualityTuningLevel', traits => ['NameInRequest']);
27 has RateControlMode => (is => 'ro', isa => 'Str', request_name => 'rateControlMode', traits => ['NameInRequest']);
28 has ScanTypeConversionMode => (is => 'ro', isa => 'Str', request_name => 'scanTypeConversionMode', traits => ['NameInRequest']);
29 has SceneChangeDetect => (is => 'ro', isa => 'Str', request_name => 'sceneChangeDetect', traits => ['NameInRequest']);
30 has SlowPal => (is => 'ro', isa => 'Str', request_name => 'slowPal', traits => ['NameInRequest']);
31 has Softness => (is => 'ro', isa => 'Int', request_name => 'softness', traits => ['NameInRequest']);
32 has SpatialAdaptiveQuantization => (is => 'ro', isa => 'Str', request_name => 'spatialAdaptiveQuantization', traits => ['NameInRequest']);
33 has Syntax => (is => 'ro', isa => 'Str', request_name => 'syntax', traits => ['NameInRequest']);
34 has Telecine => (is => 'ro', isa => 'Str', request_name => 'telecine', traits => ['NameInRequest']);
35 has TemporalAdaptiveQuantization => (is => 'ro', isa => 'Str', request_name => 'temporalAdaptiveQuantization', traits => ['NameInRequest']);
36  
37 1;
38  
39 ### main pod documentation begin ###
40  
41 =head1 NAME
42  
43 Paws::MediaConvert::Mpeg2Settings
44  
45 =head1 USAGE
46  
47 This class represents one of two things:
48  
49 =head3 Arguments in a call to a service
50  
51 Use the attributes of this class as arguments to methods. You shouldn't make instances of this class.
52 Each attribute should be used as a named argument in the calls that expect this type of object.
53  
54 As an example, if Att1 is expected to be a Paws::MediaConvert::Mpeg2Settings object:
55  
56 $service_obj->Method(Att1 => { AdaptiveQuantization => $value, ..., TemporalAdaptiveQuantization => $value });
57  
58 =head3 Results returned from an API call
59  
60 Use accessors for each attribute. If Att1 is expected to be an Paws::MediaConvert::Mpeg2Settings object:
61  
62 $result = $service_obj->Method(...);
63 $result->Att1->AdaptiveQuantization
64  
65 =head1 DESCRIPTION
66  
67 Required when you set (Codec) under
68 (VideoDescription)E<gt>(CodecSettings) to the value MPEG2.
69  
70 =head1 ATTRIBUTES
71  
72  
73 =head2 AdaptiveQuantization => Str
74  
75 Specify the strength of any adaptive quantization filters that you
76 enable. The value that you choose here applies to the following
77 settings: Spatial adaptive quantization (spatialAdaptiveQuantization),
78 and Temporal adaptive quantization (temporalAdaptiveQuantization).
79  
80  
81 =head2 Bitrate => Int
82  
83 Specify the average bitrate in bits per second. Required for VBR and
84 CBR. For MS Smooth outputs, bitrates must be unique when rounded down
85 to the nearest multiple of 1000.
86  
87  
88 =head2 CodecLevel => Str
89  
90 Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video
91 output.
92  
93  
94 =head2 CodecProfile => Str
95  
96 Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video
97 output.
98  
99  
100 =head2 DynamicSubGop => Str
101  
102 Choose Adaptive to improve subjective video quality for high-motion
103 content. This will cause the service to use fewer B-frames (which infer
104 information based on other frames) for high-motion portions of the
105 video and more B-frames for low-motion portions. The maximum number of
106 B-frames is limited by the value you provide for the setting B frames
107 between reference frames (numberBFramesBetweenReferenceFrames).
108  
109  
110 =head2 FramerateControl => Str
111  
112 If you are using the console, use the Framerate setting to specify the
113 frame rate for this output. If you want to keep the same frame rate as
114 the input video, choose Follow source. If you want to do frame rate
115 conversion, choose a frame rate from the dropdown list or choose
116 Custom. The framerates shown in the dropdown list are decimal
117 approximations of fractions. If you choose Custom, specify your frame
118 rate as a fraction. If you are creating your transcoding job
119 specification as a JSON file without the console, use FramerateControl
120 to specify which value the service uses for the frame rate for this
121 output. Choose INITIALIZE_FROM_SOURCE if you want the service to use
122 the frame rate from the input. Choose SPECIFIED if you want the service
123 to use the frame rate you specify in the settings FramerateNumerator
124 and FramerateDenominator.
125  
126  
127 =head2 FramerateConversionAlgorithm => Str
128  
129 Choose the method that you want MediaConvert to use when increasing or
130 decreasing the frame rate. We recommend using drop duplicate
131 (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to
132 30 fps. For numerically complex conversions, you can use interpolate
133 (INTERPOLATE) to avoid stutter. This results in a smooth picture, but
134 might introduce undesirable video artifacts. For complex frame rate
135 conversions, especially if your source video has already been converted
136 from its original cadence, use FrameFormer (FRAMEFORMER) to do
137 motion-compensated interpolation. FrameFormer chooses the best
138 conversion method frame by frame. Note that using FrameFormer increases
139 the transcoding time and incurs a significant add-on cost.
140  
141  
142 =head2 FramerateDenominator => Int
143  
144 When you use the API for transcode jobs that use frame rate conversion,
145 specify the frame rate as a fraction. For example, 24000 / 1001 =
146 23.976 fps. Use FramerateDenominator to specify the denominator of this
147 fraction. In this example, use 1001 for the value of
148 FramerateDenominator. When you use the console for transcode jobs that
149 use frame rate conversion, provide the value as a decimal number for
150 Framerate. In this example, specify 23.976.
151  
152  
153 =head2 FramerateNumerator => Int
154  
155 When you use the API for transcode jobs that use frame rate conversion,
156 specify the frame rate as a fraction. For example, 24000 / 1001 =
157 23.976 fps. Use FramerateNumerator to specify the numerator of this
158 fraction. In this example, use 24000 for the value of
159 FramerateNumerator. When you use the console for transcode jobs that
160 use frame rate conversion, provide the value as a decimal number for
161 Framerate. In this example, specify 23.976.
162  
163  
164 =head2 GopClosedCadence => Int
165  
166 Frequency of closed GOPs. In streaming applications, it is recommended
167 that this be set to 1 so a decoder joining mid-stream will receive an
168 IDR frame as quickly as possible. Setting this value to 0 will break
169 output segmenting.
170  
171  
172 =head2 GopSize => Num
173  
174 GOP Length (keyframe interval) in frames or seconds. Must be greater
175 than zero.
176  
177  
178 =head2 GopSizeUnits => Str
179  
180 Indicates if the GOP Size in MPEG2 is specified in frames or seconds.
181 If seconds the system will convert the GOP Size into a frame count at
182 run time.
183  
184  
185 =head2 HrdBufferInitialFillPercentage => Int
186  
187 Percentage of the buffer that should initially be filled (HRD buffer
188 model).
189  
190  
191 =head2 HrdBufferSize => Int
192  
193 Size of buffer (HRD buffer model) in bits. For example, enter five
194 megabits as 5000000.
195  
196  
197 =head2 InterlaceMode => Str
198  
199 Choose the scan line type for the output. Keep the default value,
200 Progressive (PROGRESSIVE) to create a progressive output, regardless of
201 the scan type of your input. Use Top field first (TOP_FIELD) or Bottom
202 field first (BOTTOM_FIELD) to create an output that's interlaced with
203 the same field polarity throughout. Use Follow, default top
204 (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to
205 produce outputs with the same field polarity as the source. For jobs
206 that have multiple inputs, the output field polarity might change over
207 the course of the output. Follow behavior depends on the input scan
208 type. If the source is interlaced, the output will be interlaced with
209 the same polarity as the source. If the source is progressive, the
210 output will be interlaced with top field bottom field first, depending
211 on which of the Follow options you choose.
212  
213  
214 =head2 IntraDcPrecision => Str
215  
216 Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization
217 precision for intra-block DC coefficients. If you choose the value
218 auto, the service will automatically select the precision based on the
219 per-frame compression ratio.
220  
221  
222 =head2 MaxBitrate => Int
223  
224 Maximum bitrate in bits/second. For example, enter five megabits per
225 second as 5000000.
226  
227  
228 =head2 MinIInterval => Int
229  
230 Enforces separation between repeated (cadence) I-frames and I-frames
231 inserted by Scene Change Detection. If a scene change I-frame is within
232 I-interval frames of a cadence I-frame, the GOP is shrunk and/or
233 stretched to the scene change I-frame. GOP stretch requires enabling
234 lookahead as well as setting I-interval. The normal cadence resumes for
235 the next GOP. This setting is only used when Scene Change Detect is
236 enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1
237  
238  
239 =head2 NumberBFramesBetweenReferenceFrames => Int
240  
241 Number of B-frames between reference frames.
242  
243  
244 =head2 ParControl => Str
245  
246 Optional. Specify how the service determines the pixel aspect ratio
247 (PAR) for this output. The default behavior, Follow source
248 (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your
249 output. To specify a different PAR in the console, choose any value
250 other than Follow source. To specify a different PAR by editing the
251 JSON job specification, choose SPECIFIED. When you choose SPECIFIED for
252 this setting, you must also specify values for the parNumerator and
253 parDenominator settings.
254  
255  
256 =head2 ParDenominator => Int
257  
258 Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On
259 the console, this corresponds to any value other than Follow source.
260 When you specify an output pixel aspect ratio (PAR) that is different
261 from your input video PAR, provide your output PAR as a ratio. For
262 example, for D1/DV NTSC widescreen, you would specify the ratio 40:33.
263 In this example, the value for parDenominator is 33.
264  
265  
266 =head2 ParNumerator => Int
267  
268 Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On
269 the console, this corresponds to any value other than Follow source.
270 When you specify an output pixel aspect ratio (PAR) that is different
271 from your input video PAR, provide your output PAR as a ratio. For
272 example, for D1/DV NTSC widescreen, you would specify the ratio 40:33.
273 In this example, the value for parNumerator is 40.
274  
275  
276 =head2 QualityTuningLevel => Str
277  
278 Optional. Use Quality tuning level (qualityTuningLevel) to choose how
279 you want to trade off encoding speed for output video quality. The
280 default behavior is faster, lower quality, single-pass encoding.
281  
282  
283 =head2 RateControlMode => Str
284  
285 Use Rate control mode (Mpeg2RateControlMode) to specify whether the
286 bitrate is variable (vbr) or constant (cbr).
287  
288  
289 =head2 ScanTypeConversionMode => Str
290  
291 Use this setting for interlaced outputs, when your output frame rate is
292 half of your input frame rate. In this situation, choose Optimized
293 interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced
294 output. In this case, each progressive frame from the input corresponds
295 to an interlaced field in the output. Keep the default value, Basic
296 interlacing (INTERLACED), for all other output frame rates. With basic
297 interlacing, MediaConvert performs any frame rate conversion first and
298 then interlaces the frames. When you choose Optimized interlacing and
299 you set your output frame rate to a value that isn't suitable for
300 optimized interlacing, MediaConvert automatically falls back to basic
301 interlacing. Required settings: To use optimized interlacing, you must
302 set Telecine (telecine) to None (NONE) or Soft (SOFT). You can't use
303 optimized interlacing for hard telecine outputs. You must also set
304 Interlace mode (interlaceMode) to a value other than Progressive
305 (PROGRESSIVE).
306  
307  
308 =head2 SceneChangeDetect => Str
309  
310 Enable this setting to insert I-frames at scene changes that the
311 service automatically detects. This improves video quality and is
312 enabled by default.
313  
314  
315 =head2 SlowPal => Str
316  
317 Ignore this setting unless your input frame rate is 23.976 or 24 frames
318 per second (fps). Enable slow PAL to create a 25 fps output. When you
319 enable slow PAL, MediaConvert relabels the video frames to 25 fps and
320 resamples your audio to keep it synchronized with the video. Note that
321 enabling this setting will slightly reduce the duration of your video.
322 Required settings: You must also set Framerate to 25. In your JSON job
323 specification, set (framerateControl) to (SPECIFIED),
324 (framerateNumerator) to 25 and (framerateDenominator) to 1.
325  
326  
327 =head2 Softness => Int
328  
329 Ignore this setting unless you need to comply with a specification that
330 requires a specific value. If you don't have a specification
331 requirement, we recommend that you adjust the softness of your output
332 by using a lower value for the setting Sharpness (sharpness) or by
333 enabling a noise reducer filter (noiseReducerFilter). The Softness
334 (softness) setting specifies the quantization matrices that the encoder
335 uses. Keep the default value, 0, to use the AWS Elemental default
336 matrices. Choose a value from 17 to 128 to use planar interpolation.
337 Increasing values from 17 to 128 result in increasing reduction of
338 high-frequency data. The value 128 results in the softest video.
339  
340  
341 =head2 SpatialAdaptiveQuantization => Str
342  
343 Keep the default value, Enabled (ENABLED), to adjust quantization
344 within each frame based on spatial variation of content complexity.
345 When you enable this feature, the encoder uses fewer bits on areas that
346 can sustain more distortion with no noticeable visual degradation and
347 uses more bits on areas where any small distortion will be noticeable.
348 For example, complex textured blocks are encoded with fewer bits and
349 smooth textured blocks are encoded with more bits. Enabling this
350 feature will almost always improve your video quality. Note, though,
351 that this feature doesn't take into account where the viewer's
352 attention is likely to be. If viewers are likely to be focusing their
353 attention on a part of the screen with a lot of complex texture, you
354 might choose to disable this feature. Related setting: When you enable
355 spatial adaptive quantization, set the value for Adaptive quantization
356 (adaptiveQuantization) depending on your content. For homogeneous
357 content, such as cartoons and video games, set it to Low. For content
358 with a wider variety of textures, set it to High or Higher.
359  
360  
361 =head2 Syntax => Str
362  
363 Specify whether this output's video uses the D10 syntax. Keep the
364 default value to not use the syntax. Related settings: When you choose
365 D10 (D_10) for your MXF profile (profile), you must also set this value
366 to to D10 (D_10).
367  
368  
369 =head2 Telecine => Str
370  
371 When you do frame rate conversion from 23.976 frames per second (fps)
372 to 29.97 fps, and your output scan type is interlaced, you can
373 optionally enable hard or soft telecine to create a smoother picture.
374 Hard telecine (HARD) produces a 29.97i output. Soft telecine (SOFT)
375 produces an output with a 23.976 output that signals to the video
376 player device to do the conversion during play back. When you keep the
377 default value, None (NONE), MediaConvert does a standard frame rate
378 conversion to 29.97 without doing anything with the field polarity to
379 create a smoother picture.
380  
381  
382 =head2 TemporalAdaptiveQuantization => Str
383  
384 Keep the default value, Enabled (ENABLED), to adjust quantization
385 within each frame based on temporal variation of content complexity.
386 When you enable this feature, the encoder uses fewer bits on areas of
387 the frame that aren't moving and uses more bits on complex objects with
388 sharp edges that move a lot. For example, this feature improves the
389 readability of text tickers on newscasts and scoreboards on sports
390 matches. Enabling this feature will almost always improve your video
391 quality. Note, though, that this feature doesn't take into account
392 where the viewer's attention is likely to be. If viewers are likely to
393 be focusing their attention on a part of the screen that doesn't have
394 moving objects with sharp edges, such as sports athletes' faces, you
395 might choose to disable this feature. Related setting: When you enable
396 temporal quantization, adjust the strength of the filter with the
397 setting Adaptive quantization (adaptiveQuantization).
398  
399  
400  
401 =head1 SEE ALSO
402  
403 This class forms part of L<Paws>, describing an object used in L<Paws::MediaConvert>
404  
405 =head1 BUGS and CONTRIBUTIONS
406  
407 The source code is located here: L<https://github.com/pplu/aws-sdk-perl>
408  
409 Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues>
410  
411 =cut
412