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

filter: Statementstmt 0.0% 0 / 83 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 0.0% 0 / 1 Podpod n/a totaltotal 0.0% 0 / 84 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::H265Settings;
3 use Moose;
4 has AdaptiveQuantization => (is => 'ro', isa => 'Str', request_name => 'adaptiveQuantization', traits => ['NameInRequest']);
5 has AlternateTransferFunctionSei => (is => 'ro', isa => 'Str', request_name => 'alternateTransferFunctionSei', traits => ['NameInRequest']);
6 has Bitrate => (is => 'ro', isa => 'Int', request_name => 'bitrate', traits => ['NameInRequest']);
7 has CodecLevel => (is => 'ro', isa => 'Str', request_name => 'codecLevel', traits => ['NameInRequest']);
8 has CodecProfile => (is => 'ro', isa => 'Str', request_name => 'codecProfile', traits => ['NameInRequest']);
9 has DynamicSubGop => (is => 'ro', isa => 'Str', request_name => 'dynamicSubGop', traits => ['NameInRequest']);
10 has FlickerAdaptiveQuantization => (is => 'ro', isa => 'Str', request_name => 'flickerAdaptiveQuantization', traits => ['NameInRequest']);
11 has FramerateControl => (is => 'ro', isa => 'Str', request_name => 'framerateControl', traits => ['NameInRequest']);
12 has FramerateConversionAlgorithm => (is => 'ro', isa => 'Str', request_name => 'framerateConversionAlgorithm', traits => ['NameInRequest']);
13 has FramerateDenominator => (is => 'ro', isa => 'Int', request_name => 'framerateDenominator', traits => ['NameInRequest']);
14 has FramerateNumerator => (is => 'ro', isa => 'Int', request_name => 'framerateNumerator', traits => ['NameInRequest']);
15 has GopBReference => (is => 'ro', isa => 'Str', request_name => 'gopBReference', traits => ['NameInRequest']);
16 has GopClosedCadence => (is => 'ro', isa => 'Int', request_name => 'gopClosedCadence', traits => ['NameInRequest']);
17 has GopSize => (is => 'ro', isa => 'Num', request_name => 'gopSize', traits => ['NameInRequest']);
18 has GopSizeUnits => (is => 'ro', isa => 'Str', request_name => 'gopSizeUnits', traits => ['NameInRequest']);
19 has HrdBufferInitialFillPercentage => (is => 'ro', isa => 'Int', request_name => 'hrdBufferInitialFillPercentage', traits => ['NameInRequest']);
20 has HrdBufferSize => (is => 'ro', isa => 'Int', request_name => 'hrdBufferSize', traits => ['NameInRequest']);
21 has InterlaceMode => (is => 'ro', isa => 'Str', request_name => 'interlaceMode', traits => ['NameInRequest']);
22 has MaxBitrate => (is => 'ro', isa => 'Int', request_name => 'maxBitrate', traits => ['NameInRequest']);
23 has MinIInterval => (is => 'ro', isa => 'Int', request_name => 'minIInterval', traits => ['NameInRequest']);
24 has NumberBFramesBetweenReferenceFrames => (is => 'ro', isa => 'Int', request_name => 'numberBFramesBetweenReferenceFrames', traits => ['NameInRequest']);
25 has NumberReferenceFrames => (is => 'ro', isa => 'Int', request_name => 'numberReferenceFrames', traits => ['NameInRequest']);
26 has ParControl => (is => 'ro', isa => 'Str', request_name => 'parControl', traits => ['NameInRequest']);
27 has ParDenominator => (is => 'ro', isa => 'Int', request_name => 'parDenominator', traits => ['NameInRequest']);
28 has ParNumerator => (is => 'ro', isa => 'Int', request_name => 'parNumerator', traits => ['NameInRequest']);
29 has QualityTuningLevel => (is => 'ro', isa => 'Str', request_name => 'qualityTuningLevel', traits => ['NameInRequest']);
30 has QvbrSettings => (is => 'ro', isa => 'Paws::MediaConvert::H265QvbrSettings', request_name => 'qvbrSettings', traits => ['NameInRequest']);
31 has RateControlMode => (is => 'ro', isa => 'Str', request_name => 'rateControlMode', traits => ['NameInRequest']);
32 has SampleAdaptiveOffsetFilterMode => (is => 'ro', isa => 'Str', request_name => 'sampleAdaptiveOffsetFilterMode', traits => ['NameInRequest']);
33 has ScanTypeConversionMode => (is => 'ro', isa => 'Str', request_name => 'scanTypeConversionMode', traits => ['NameInRequest']);
34 has SceneChangeDetect => (is => 'ro', isa => 'Str', request_name => 'sceneChangeDetect', traits => ['NameInRequest']);
35 has Slices => (is => 'ro', isa => 'Int', request_name => 'slices', traits => ['NameInRequest']);
36 has SlowPal => (is => 'ro', isa => 'Str', request_name => 'slowPal', traits => ['NameInRequest']);
37 has SpatialAdaptiveQuantization => (is => 'ro', isa => 'Str', request_name => 'spatialAdaptiveQuantization', traits => ['NameInRequest']);
38 has Telecine => (is => 'ro', isa => 'Str', request_name => 'telecine', traits => ['NameInRequest']);
39 has TemporalAdaptiveQuantization => (is => 'ro', isa => 'Str', request_name => 'temporalAdaptiveQuantization', traits => ['NameInRequest']);
40 has TemporalIds => (is => 'ro', isa => 'Str', request_name => 'temporalIds', traits => ['NameInRequest']);
41 has Tiles => (is => 'ro', isa => 'Str', request_name => 'tiles', traits => ['NameInRequest']);
42 has UnregisteredSeiTimecode => (is => 'ro', isa => 'Str', request_name => 'unregisteredSeiTimecode', traits => ['NameInRequest']);
43 has WriteMp4PackagingType => (is => 'ro', isa => 'Str', request_name => 'writeMp4PackagingType', traits => ['NameInRequest']);
44  
45 1;
46  
47 ### main pod documentation begin ###
48  
49 =head1 NAME
50  
51 Paws::MediaConvert::H265Settings
52  
53 =head1 USAGE
54  
55 This class represents one of two things:
56  
57 =head3 Arguments in a call to a service
58  
59 Use the attributes of this class as arguments to methods. You shouldn't make instances of this class.
60 Each attribute should be used as a named argument in the calls that expect this type of object.
61  
62 As an example, if Att1 is expected to be a Paws::MediaConvert::H265Settings object:
63  
64 $service_obj->Method(Att1 => { AdaptiveQuantization => $value, ..., WriteMp4PackagingType => $value });
65  
66 =head3 Results returned from an API call
67  
68 Use accessors for each attribute. If Att1 is expected to be an Paws::MediaConvert::H265Settings object:
69  
70 $result = $service_obj->Method(...);
71 $result->Att1->AdaptiveQuantization
72  
73 =head1 DESCRIPTION
74  
75 Settings for H265 codec
76  
77 =head1 ATTRIBUTES
78  
79  
80 =head2 AdaptiveQuantization => Str
81  
82 Specify the strength of any adaptive quantization filters that you
83 enable. The value that you choose here applies to the following
84 settings: Flicker adaptive quantization (flickerAdaptiveQuantization),
85 Spatial adaptive quantization (spatialAdaptiveQuantization), and
86 Temporal adaptive quantization (temporalAdaptiveQuantization).
87  
88  
89 =head2 AlternateTransferFunctionSei => Str
90  
91 Enables Alternate Transfer Function SEI message for outputs using
92 Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF).
93  
94  
95 =head2 Bitrate => Int
96  
97 Specify the average bitrate in bits per second. Required for VBR and
98 CBR. For MS Smooth outputs, bitrates must be unique when rounded down
99 to the nearest multiple of 1000.
100  
101  
102 =head2 CodecLevel => Str
103  
104 H.265 Level.
105  
106  
107 =head2 CodecProfile => Str
108  
109 Represents the Profile and Tier, per the HEVC (H.265) specification.
110 Selections are grouped as [Profile] / [Tier], so "Main/High" represents
111 Main Profile with High Tier. 4:2:2 profiles are only available with the
112 HEVC 4:2:2 License.
113  
114  
115 =head2 DynamicSubGop => Str
116  
117 Choose Adaptive to improve subjective video quality for high-motion
118 content. This will cause the service to use fewer B-frames (which infer
119 information based on other frames) for high-motion portions of the
120 video and more B-frames for low-motion portions. The maximum number of
121 B-frames is limited by the value you provide for the setting B frames
122 between reference frames (numberBFramesBetweenReferenceFrames).
123  
124  
125 =head2 FlickerAdaptiveQuantization => Str
126  
127 Enable this setting to have the encoder reduce I-frame pop. I-frame pop
128 appears as a visual flicker that can arise when the encoder saves bits
129 by copying some macroblocks many times from frame to frame, and then
130 refreshes them at the I-frame. When you enable this setting, the
131 encoder updates these macroblocks slightly more often to smooth out the
132 flicker. This setting is disabled by default. Related setting: In
133 addition to enabling this setting, you must also set
134 adaptiveQuantization to a value other than Off (OFF).
135  
136  
137 =head2 FramerateControl => Str
138  
139 If you are using the console, use the Framerate setting to specify the
140 frame rate for this output. If you want to keep the same frame rate as
141 the input video, choose Follow source. If you want to do frame rate
142 conversion, choose a frame rate from the dropdown list or choose
143 Custom. The framerates shown in the dropdown list are decimal
144 approximations of fractions. If you choose Custom, specify your frame
145 rate as a fraction. If you are creating your transcoding job
146 specification as a JSON file without the console, use FramerateControl
147 to specify which value the service uses for the frame rate for this
148 output. Choose INITIALIZE_FROM_SOURCE if you want the service to use
149 the frame rate from the input. Choose SPECIFIED if you want the service
150 to use the frame rate you specify in the settings FramerateNumerator
151 and FramerateDenominator.
152  
153  
154 =head2 FramerateConversionAlgorithm => Str
155  
156 Choose the method that you want MediaConvert to use when increasing or
157 decreasing the frame rate. We recommend using drop duplicate
158 (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to
159 30 fps. For numerically complex conversions, you can use interpolate
160 (INTERPOLATE) to avoid stutter. This results in a smooth picture, but
161 might introduce undesirable video artifacts. For complex frame rate
162 conversions, especially if your source video has already been converted
163 from its original cadence, use FrameFormer (FRAMEFORMER) to do
164 motion-compensated interpolation. FrameFormer chooses the best
165 conversion method frame by frame. Note that using FrameFormer increases
166 the transcoding time and incurs a significant add-on cost.
167  
168  
169 =head2 FramerateDenominator => Int
170  
171 When you use the API for transcode jobs that use frame rate conversion,
172 specify the frame rate as a fraction. For example, 24000 / 1001 =
173 23.976 fps. Use FramerateDenominator to specify the denominator of this
174 fraction. In this example, use 1001 for the value of
175 FramerateDenominator. When you use the console for transcode jobs that
176 use frame rate conversion, provide the value as a decimal number for
177 Framerate. In this example, specify 23.976.
178  
179  
180 =head2 FramerateNumerator => Int
181  
182 When you use the API for transcode jobs that use frame rate conversion,
183 specify the frame rate as a fraction. For example, 24000 / 1001 =
184 23.976 fps. Use FramerateNumerator to specify the numerator of this
185 fraction. In this example, use 24000 for the value of
186 FramerateNumerator. When you use the console for transcode jobs that
187 use frame rate conversion, provide the value as a decimal number for
188 Framerate. In this example, specify 23.976.
189  
190  
191 =head2 GopBReference => Str
192  
193 If enable, use reference B frames for GOP structures that have B frames
194 E<gt> 1.
195  
196  
197 =head2 GopClosedCadence => Int
198  
199 Frequency of closed GOPs. In streaming applications, it is recommended
200 that this be set to 1 so a decoder joining mid-stream will receive an
201 IDR frame as quickly as possible. Setting this value to 0 will break
202 output segmenting.
203  
204  
205 =head2 GopSize => Num
206  
207 GOP Length (keyframe interval) in frames or seconds. Must be greater
208 than zero.
209  
210  
211 =head2 GopSizeUnits => Str
212  
213 Indicates if the GOP Size in H265 is specified in frames or seconds. If
214 seconds the system will convert the GOP Size into a frame count at run
215 time.
216  
217  
218 =head2 HrdBufferInitialFillPercentage => Int
219  
220 Percentage of the buffer that should initially be filled (HRD buffer
221 model).
222  
223  
224 =head2 HrdBufferSize => Int
225  
226 Size of buffer (HRD buffer model) in bits. For example, enter five
227 megabits as 5000000.
228  
229  
230 =head2 InterlaceMode => Str
231  
232 Choose the scan line type for the output. Keep the default value,
233 Progressive (PROGRESSIVE) to create a progressive output, regardless of
234 the scan type of your input. Use Top field first (TOP_FIELD) or Bottom
235 field first (BOTTOM_FIELD) to create an output that's interlaced with
236 the same field polarity throughout. Use Follow, default top
237 (FOLLOW_TOP_FIELD) or Follow, default bottom (FOLLOW_BOTTOM_FIELD) to
238 produce outputs with the same field polarity as the source. For jobs
239 that have multiple inputs, the output field polarity might change over
240 the course of the output. Follow behavior depends on the input scan
241 type. If the source is interlaced, the output will be interlaced with
242 the same polarity as the source. If the source is progressive, the
243 output will be interlaced with top field bottom field first, depending
244 on which of the Follow options you choose.
245  
246  
247 =head2 MaxBitrate => Int
248  
249 Maximum bitrate in bits/second. For example, enter five megabits per
250 second as 5000000. Required when Rate control mode is QVBR.
251  
252  
253 =head2 MinIInterval => Int
254  
255 Enforces separation between repeated (cadence) I-frames and I-frames
256 inserted by Scene Change Detection. If a scene change I-frame is within
257 I-interval frames of a cadence I-frame, the GOP is shrunk and/or
258 stretched to the scene change I-frame. GOP stretch requires enabling
259 lookahead as well as setting I-interval. The normal cadence resumes for
260 the next GOP. This setting is only used when Scene Change Detect is
261 enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1
262  
263  
264 =head2 NumberBFramesBetweenReferenceFrames => Int
265  
266 Number of B-frames between reference frames.
267  
268  
269 =head2 NumberReferenceFrames => Int
270  
271 Number of reference frames to use. The encoder may use more than
272 requested if using B-frames and/or interlaced encoding.
273  
274  
275 =head2 ParControl => Str
276  
277 Optional. Specify how the service determines the pixel aspect ratio
278 (PAR) for this output. The default behavior, Follow source
279 (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your
280 output. To specify a different PAR in the console, choose any value
281 other than Follow source. To specify a different PAR by editing the
282 JSON job specification, choose SPECIFIED. When you choose SPECIFIED for
283 this setting, you must also specify values for the parNumerator and
284 parDenominator settings.
285  
286  
287 =head2 ParDenominator => Int
288  
289 Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On
290 the console, this corresponds to any value other than Follow source.
291 When you specify an output pixel aspect ratio (PAR) that is different
292 from your input video PAR, provide your output PAR as a ratio. For
293 example, for D1/DV NTSC widescreen, you would specify the ratio 40:33.
294 In this example, the value for parDenominator is 33.
295  
296  
297 =head2 ParNumerator => Int
298  
299 Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On
300 the console, this corresponds to any value other than Follow source.
301 When you specify an output pixel aspect ratio (PAR) that is different
302 from your input video PAR, provide your output PAR as a ratio. For
303 example, for D1/DV NTSC widescreen, you would specify the ratio 40:33.
304 In this example, the value for parNumerator is 40.
305  
306  
307 =head2 QualityTuningLevel => Str
308  
309 Optional. Use Quality tuning level (qualityTuningLevel) to choose how
310 you want to trade off encoding speed for output video quality. The
311 default behavior is faster, lower quality, single-pass encoding.
312  
313  
314 =head2 QvbrSettings => L<Paws::MediaConvert::H265QvbrSettings>
315  
316 Settings for quality-defined variable bitrate encoding with the H.265
317 codec. Required when you set Rate control mode to QVBR. Not valid when
318 you set Rate control mode to a value other than QVBR, or when you don't
319 define Rate control mode.
320  
321  
322 =head2 RateControlMode => Str
323  
324 Use this setting to specify whether this output has a variable bitrate
325 (VBR), constant bitrate (CBR) or quality-defined variable bitrate
326 (QVBR).
327  
328  
329 =head2 SampleAdaptiveOffsetFilterMode => Str
330  
331 Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode
332 dynamically selects best strength based on content
333  
334  
335 =head2 ScanTypeConversionMode => Str
336  
337 Use this setting for interlaced outputs, when your output frame rate is
338 half of your input frame rate. In this situation, choose Optimized
339 interlacing (INTERLACED_OPTIMIZE) to create a better quality interlaced
340 output. In this case, each progressive frame from the input corresponds
341 to an interlaced field in the output. Keep the default value, Basic
342 interlacing (INTERLACED), for all other output frame rates. With basic
343 interlacing, MediaConvert performs any frame rate conversion first and
344 then interlaces the frames. When you choose Optimized interlacing and
345 you set your output frame rate to a value that isn't suitable for
346 optimized interlacing, MediaConvert automatically falls back to basic
347 interlacing. Required settings: To use optimized interlacing, you must
348 set Telecine (telecine) to None (NONE) or Soft (SOFT). You can't use
349 optimized interlacing for hard telecine outputs. You must also set
350 Interlace mode (interlaceMode) to a value other than Progressive
351 (PROGRESSIVE).
352  
353  
354 =head2 SceneChangeDetect => Str
355  
356 Enable this setting to insert I-frames at scene changes that the
357 service automatically detects. This improves video quality and is
358 enabled by default. If this output uses QVBR, choose Transition
359 detection (TRANSITION_DETECTION) for further video quality improvement.
360 For more information about QVBR, see
361 https://docs.aws.amazon.com/console/mediaconvert/cbr-vbr-qvbr.
362  
363  
364 =head2 Slices => Int
365  
366 Number of slices per picture. Must be less than or equal to the number
367 of macroblock rows for progressive pictures, and less than or equal to
368 half the number of macroblock rows for interlaced pictures.
369  
370  
371 =head2 SlowPal => Str
372  
373 Ignore this setting unless your input frame rate is 23.976 or 24 frames
374 per second (fps). Enable slow PAL to create a 25 fps output. When you
375 enable slow PAL, MediaConvert relabels the video frames to 25 fps and
376 resamples your audio to keep it synchronized with the video. Note that
377 enabling this setting will slightly reduce the duration of your video.
378 Required settings: You must also set Framerate to 25. In your JSON job
379 specification, set (framerateControl) to (SPECIFIED),
380 (framerateNumerator) to 25 and (framerateDenominator) to 1.
381  
382  
383 =head2 SpatialAdaptiveQuantization => Str
384  
385 Keep the default value, Enabled (ENABLED), to adjust quantization
386 within each frame based on spatial variation of content complexity.
387 When you enable this feature, the encoder uses fewer bits on areas that
388 can sustain more distortion with no noticeable visual degradation and
389 uses more bits on areas where any small distortion will be noticeable.
390 For example, complex textured blocks are encoded with fewer bits and
391 smooth textured blocks are encoded with more bits. Enabling this
392 feature will almost always improve your video quality. Note, though,
393 that this feature doesn't take into account where the viewer's
394 attention is likely to be. If viewers are likely to be focusing their
395 attention on a part of the screen with a lot of complex texture, you
396 might choose to disable this feature. Related setting: When you enable
397 spatial adaptive quantization, set the value for Adaptive quantization
398 (adaptiveQuantization) depending on your content. For homogeneous
399 content, such as cartoons and video games, set it to Low. For content
400 with a wider variety of textures, set it to High or Higher.
401  
402  
403 =head2 Telecine => Str
404  
405 This field applies only if the Streams E<gt> Advanced E<gt> Framerate
406 (framerate) field is set to 29.970. This field works with the Streams
407 E<gt> Advanced E<gt> Preprocessors E<gt> Deinterlacer field
408 (deinterlace_mode) and the Streams E<gt> Advanced E<gt> Interlaced Mode
409 field (interlace_mode) to identify the scan type for the output:
410 Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard:
411 produces 29.97i output from 23.976 input. - Soft: produces 23.976; the
412 player converts this output to 29.97i.
413  
414  
415 =head2 TemporalAdaptiveQuantization => Str
416  
417 Keep the default value, Enabled (ENABLED), to adjust quantization
418 within each frame based on temporal variation of content complexity.
419 When you enable this feature, the encoder uses fewer bits on areas of
420 the frame that aren't moving and uses more bits on complex objects with
421 sharp edges that move a lot. For example, this feature improves the
422 readability of text tickers on newscasts and scoreboards on sports
423 matches. Enabling this feature will almost always improve your video
424 quality. Note, though, that this feature doesn't take into account
425 where the viewer's attention is likely to be. If viewers are likely to
426 be focusing their attention on a part of the screen that doesn't have
427 moving objects with sharp edges, such as sports athletes' faces, you
428 might choose to disable this feature. Related setting: When you enable
429 temporal quantization, adjust the strength of the filter with the
430 setting Adaptive quantization (adaptiveQuantization).
431  
432  
433 =head2 TemporalIds => Str
434  
435 Enables temporal layer identifiers in the encoded bitstream. Up to 3
436 layers are supported depending on GOP structure: I- and P-frames form
437 one layer, reference B-frames can form a second layer and non-reference
438 b-frames can form a third layer. Decoders can optionally decode only
439 the lower temporal layers to generate a lower frame rate output. For
440 example, given a bitstream with temporal IDs and with b-frames = 1
441 (i.e. IbPbPb display order), a decoder could decode all the frames for
442 full frame rate output or only the I and P frames (lowest temporal
443 layer) for a half frame rate output.
444  
445  
446 =head2 Tiles => Str
447  
448 Enable use of tiles, allowing horizontal as well as vertical
449 subdivision of the encoded pictures.
450  
451  
452 =head2 UnregisteredSeiTimecode => Str
453  
454 Inserts timecode for each frame as 4 bytes of an unregistered SEI
455 message.
456  
457  
458 =head2 WriteMp4PackagingType => Str
459  
460 If the location of parameter set NAL units doesn't matter in your
461 workflow, ignore this setting. Use this setting only with CMAF or DASH
462 outputs, or with standalone file outputs in an MPEG-4 container (MP4
463 outputs). Choose HVC1 to mark your output as HVC1. This makes your
464 output compliant with the following specification: ISO IECJTC1 SC29
465 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the
466 service stores parameter set NAL units in the sample headers but not in
467 the samples directly. For MP4 outputs, when you choose HVC1, your
468 output video might not work properly with some downstream systems and
469 video players. The service defaults to marking your output as HEV1. For
470 these outputs, the service writes parameter set NAL units directly into
471 the samples.
472  
473  
474  
475 =head1 SEE ALSO
476  
477 This class forms part of L<Paws>, describing an object used in L<Paws::MediaConvert>
478  
479 =head1 BUGS and CONTRIBUTIONS
480  
481 The source code is located here: L<https://github.com/pplu/aws-sdk-perl>
482  
483 Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues>
484  
485 =cut
486