1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _codec-controls:
4
5***********************
6Codec Control Reference
7***********************
8
9Below all controls within the Codec control class are described. First
10the generic controls, then controls specific for certain hardware.
11
12.. note::
13
14   These controls are applicable to all codecs and not just MPEG. The
15   defines are prefixed with V4L2_CID_MPEG/V4L2_MPEG as the controls
16   were originally made for MPEG codecs and later extended to cover all
17   encoding formats.
18
19
20Generic Codec Controls
21======================
22
23
24.. _mpeg-control-id:
25
26Codec Control IDs
27-----------------
28
29``V4L2_CID_CODEC_CLASS (class)``
30    The Codec class descriptor. Calling
31    :ref:`VIDIOC_QUERYCTRL` for this control will
32    return a description of this control class. This description can be
33    used as the caption of a Tab page in a GUI, for example.
34
35.. _v4l2-mpeg-stream-type:
36
37``V4L2_CID_MPEG_STREAM_TYPE``
38    (enum)
39
40enum v4l2_mpeg_stream_type -
41    The MPEG-1, -2 or -4 output stream type. One cannot assume anything
42    here. Each hardware MPEG encoder tends to support different subsets
43    of the available MPEG stream types. This control is specific to
44    multiplexed MPEG streams. The currently defined stream types are:
45
46
47
48.. flat-table::
49    :header-rows:  0
50    :stub-columns: 0
51
52    * - ``V4L2_MPEG_STREAM_TYPE_MPEG2_PS``
53      - MPEG-2 program stream
54    * - ``V4L2_MPEG_STREAM_TYPE_MPEG2_TS``
55      - MPEG-2 transport stream
56    * - ``V4L2_MPEG_STREAM_TYPE_MPEG1_SS``
57      - MPEG-1 system stream
58    * - ``V4L2_MPEG_STREAM_TYPE_MPEG2_DVD``
59      - MPEG-2 DVD-compatible stream
60    * - ``V4L2_MPEG_STREAM_TYPE_MPEG1_VCD``
61      - MPEG-1 VCD-compatible stream
62    * - ``V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD``
63      - MPEG-2 SVCD-compatible stream
64
65
66
67``V4L2_CID_MPEG_STREAM_PID_PMT (integer)``
68    Program Map Table Packet ID for the MPEG transport stream (default
69    16)
70
71``V4L2_CID_MPEG_STREAM_PID_AUDIO (integer)``
72    Audio Packet ID for the MPEG transport stream (default 256)
73
74``V4L2_CID_MPEG_STREAM_PID_VIDEO (integer)``
75    Video Packet ID for the MPEG transport stream (default 260)
76
77``V4L2_CID_MPEG_STREAM_PID_PCR (integer)``
78    Packet ID for the MPEG transport stream carrying PCR fields (default
79    259)
80
81``V4L2_CID_MPEG_STREAM_PES_ID_AUDIO (integer)``
82    Audio ID for MPEG PES
83
84``V4L2_CID_MPEG_STREAM_PES_ID_VIDEO (integer)``
85    Video ID for MPEG PES
86
87.. _v4l2-mpeg-stream-vbi-fmt:
88
89``V4L2_CID_MPEG_STREAM_VBI_FMT``
90    (enum)
91
92enum v4l2_mpeg_stream_vbi_fmt -
93    Some cards can embed VBI data (e. g. Closed Caption, Teletext) into
94    the MPEG stream. This control selects whether VBI data should be
95    embedded, and if so, what embedding method should be used. The list
96    of possible VBI formats depends on the driver. The currently defined
97    VBI format types are:
98
99
100
101.. tabularcolumns:: |p{6.6 cm}|p{10.9cm}|
102
103.. flat-table::
104    :header-rows:  0
105    :stub-columns: 0
106
107    * - ``V4L2_MPEG_STREAM_VBI_FMT_NONE``
108      - No VBI in the MPEG stream
109    * - ``V4L2_MPEG_STREAM_VBI_FMT_IVTV``
110      - VBI in private packets, IVTV format (documented in the kernel
111	sources in the file
112	``Documentation/userspace-api/media/drivers/cx2341x-uapi.rst``)
113
114
115
116.. _v4l2-mpeg-audio-sampling-freq:
117
118``V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ``
119    (enum)
120
121enum v4l2_mpeg_audio_sampling_freq -
122    MPEG Audio sampling frequency. Possible values are:
123
124
125
126.. flat-table::
127    :header-rows:  0
128    :stub-columns: 0
129
130    * - ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100``
131      - 44.1 kHz
132    * - ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000``
133      - 48 kHz
134    * - ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000``
135      - 32 kHz
136
137
138
139.. _v4l2-mpeg-audio-encoding:
140
141``V4L2_CID_MPEG_AUDIO_ENCODING``
142    (enum)
143
144enum v4l2_mpeg_audio_encoding -
145    MPEG Audio encoding. This control is specific to multiplexed MPEG
146    streams. Possible values are:
147
148
149
150.. flat-table::
151    :header-rows:  0
152    :stub-columns: 0
153
154    * - ``V4L2_MPEG_AUDIO_ENCODING_LAYER_1``
155      - MPEG-1/2 Layer I encoding
156    * - ``V4L2_MPEG_AUDIO_ENCODING_LAYER_2``
157      - MPEG-1/2 Layer II encoding
158    * - ``V4L2_MPEG_AUDIO_ENCODING_LAYER_3``
159      - MPEG-1/2 Layer III encoding
160    * - ``V4L2_MPEG_AUDIO_ENCODING_AAC``
161      - MPEG-2/4 AAC (Advanced Audio Coding)
162    * - ``V4L2_MPEG_AUDIO_ENCODING_AC3``
163      - AC-3 aka ATSC A/52 encoding
164
165
166
167.. _v4l2-mpeg-audio-l1-bitrate:
168
169``V4L2_CID_MPEG_AUDIO_L1_BITRATE``
170    (enum)
171
172enum v4l2_mpeg_audio_l1_bitrate -
173    MPEG-1/2 Layer I bitrate. Possible values are:
174
175
176
177.. flat-table::
178    :header-rows:  0
179    :stub-columns: 0
180
181    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_32K``
182      - 32 kbit/s
183    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_64K``
184      - 64 kbit/s
185    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_96K``
186      - 96 kbit/s
187    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_128K``
188      - 128 kbit/s
189    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_160K``
190      - 160 kbit/s
191    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_192K``
192      - 192 kbit/s
193    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_224K``
194      - 224 kbit/s
195    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_256K``
196      - 256 kbit/s
197    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_288K``
198      - 288 kbit/s
199    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_320K``
200      - 320 kbit/s
201    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_352K``
202      - 352 kbit/s
203    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_384K``
204      - 384 kbit/s
205    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_416K``
206      - 416 kbit/s
207    * - ``V4L2_MPEG_AUDIO_L1_BITRATE_448K``
208      - 448 kbit/s
209
210
211
212.. _v4l2-mpeg-audio-l2-bitrate:
213
214``V4L2_CID_MPEG_AUDIO_L2_BITRATE``
215    (enum)
216
217enum v4l2_mpeg_audio_l2_bitrate -
218    MPEG-1/2 Layer II bitrate. Possible values are:
219
220
221
222.. flat-table::
223    :header-rows:  0
224    :stub-columns: 0
225
226    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_32K``
227      - 32 kbit/s
228    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_48K``
229      - 48 kbit/s
230    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_56K``
231      - 56 kbit/s
232    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_64K``
233      - 64 kbit/s
234    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_80K``
235      - 80 kbit/s
236    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_96K``
237      - 96 kbit/s
238    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_112K``
239      - 112 kbit/s
240    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_128K``
241      - 128 kbit/s
242    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_160K``
243      - 160 kbit/s
244    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_192K``
245      - 192 kbit/s
246    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_224K``
247      - 224 kbit/s
248    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_256K``
249      - 256 kbit/s
250    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_320K``
251      - 320 kbit/s
252    * - ``V4L2_MPEG_AUDIO_L2_BITRATE_384K``
253      - 384 kbit/s
254
255
256
257.. _v4l2-mpeg-audio-l3-bitrate:
258
259``V4L2_CID_MPEG_AUDIO_L3_BITRATE``
260    (enum)
261
262enum v4l2_mpeg_audio_l3_bitrate -
263    MPEG-1/2 Layer III bitrate. Possible values are:
264
265
266
267.. flat-table::
268    :header-rows:  0
269    :stub-columns: 0
270
271    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_32K``
272      - 32 kbit/s
273    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_40K``
274      - 40 kbit/s
275    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_48K``
276      - 48 kbit/s
277    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_56K``
278      - 56 kbit/s
279    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_64K``
280      - 64 kbit/s
281    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_80K``
282      - 80 kbit/s
283    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_96K``
284      - 96 kbit/s
285    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_112K``
286      - 112 kbit/s
287    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_128K``
288      - 128 kbit/s
289    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_160K``
290      - 160 kbit/s
291    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_192K``
292      - 192 kbit/s
293    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_224K``
294      - 224 kbit/s
295    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_256K``
296      - 256 kbit/s
297    * - ``V4L2_MPEG_AUDIO_L3_BITRATE_320K``
298      - 320 kbit/s
299
300
301
302``V4L2_CID_MPEG_AUDIO_AAC_BITRATE (integer)``
303    AAC bitrate in bits per second.
304
305.. _v4l2-mpeg-audio-ac3-bitrate:
306
307``V4L2_CID_MPEG_AUDIO_AC3_BITRATE``
308    (enum)
309
310enum v4l2_mpeg_audio_ac3_bitrate -
311    AC-3 bitrate. Possible values are:
312
313
314
315.. flat-table::
316    :header-rows:  0
317    :stub-columns: 0
318
319    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_32K``
320      - 32 kbit/s
321    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_40K``
322      - 40 kbit/s
323    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_48K``
324      - 48 kbit/s
325    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_56K``
326      - 56 kbit/s
327    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_64K``
328      - 64 kbit/s
329    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_80K``
330      - 80 kbit/s
331    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_96K``
332      - 96 kbit/s
333    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_112K``
334      - 112 kbit/s
335    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_128K``
336      - 128 kbit/s
337    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_160K``
338      - 160 kbit/s
339    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_192K``
340      - 192 kbit/s
341    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_224K``
342      - 224 kbit/s
343    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_256K``
344      - 256 kbit/s
345    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_320K``
346      - 320 kbit/s
347    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_384K``
348      - 384 kbit/s
349    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_448K``
350      - 448 kbit/s
351    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_512K``
352      - 512 kbit/s
353    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_576K``
354      - 576 kbit/s
355    * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_640K``
356      - 640 kbit/s
357
358
359
360.. _v4l2-mpeg-audio-mode:
361
362``V4L2_CID_MPEG_AUDIO_MODE``
363    (enum)
364
365enum v4l2_mpeg_audio_mode -
366    MPEG Audio mode. Possible values are:
367
368
369
370.. flat-table::
371    :header-rows:  0
372    :stub-columns: 0
373
374    * - ``V4L2_MPEG_AUDIO_MODE_STEREO``
375      - Stereo
376    * - ``V4L2_MPEG_AUDIO_MODE_JOINT_STEREO``
377      - Joint Stereo
378    * - ``V4L2_MPEG_AUDIO_MODE_DUAL``
379      - Bilingual
380    * - ``V4L2_MPEG_AUDIO_MODE_MONO``
381      - Mono
382
383
384
385.. _v4l2-mpeg-audio-mode-extension:
386
387``V4L2_CID_MPEG_AUDIO_MODE_EXTENSION``
388    (enum)
389
390enum v4l2_mpeg_audio_mode_extension -
391    Joint Stereo audio mode extension. In Layer I and II they indicate
392    which subbands are in intensity stereo. All other subbands are coded
393    in stereo. Layer III is not (yet) supported. Possible values are:
394
395.. tabularcolumns:: |p{9.1cm}|p{8.4cm}|
396
397.. flat-table::
398    :header-rows:  0
399    :stub-columns: 0
400
401    * - ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4``
402      - Subbands 4-31 in intensity stereo
403    * - ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8``
404      - Subbands 8-31 in intensity stereo
405    * - ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12``
406      - Subbands 12-31 in intensity stereo
407    * - ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16``
408      - Subbands 16-31 in intensity stereo
409
410
411
412.. _v4l2-mpeg-audio-emphasis:
413
414``V4L2_CID_MPEG_AUDIO_EMPHASIS``
415    (enum)
416
417enum v4l2_mpeg_audio_emphasis -
418    Audio Emphasis. Possible values are:
419
420
421
422.. flat-table::
423    :header-rows:  0
424    :stub-columns: 0
425
426    * - ``V4L2_MPEG_AUDIO_EMPHASIS_NONE``
427      - None
428    * - ``V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS``
429      - 50/15 microsecond emphasis
430    * - ``V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17``
431      - CCITT J.17
432
433
434
435.. _v4l2-mpeg-audio-crc:
436
437``V4L2_CID_MPEG_AUDIO_CRC``
438    (enum)
439
440enum v4l2_mpeg_audio_crc -
441    CRC method. Possible values are:
442
443
444
445.. flat-table::
446    :header-rows:  0
447    :stub-columns: 0
448
449    * - ``V4L2_MPEG_AUDIO_CRC_NONE``
450      - None
451    * - ``V4L2_MPEG_AUDIO_CRC_CRC16``
452      - 16 bit parity check
453
454
455
456``V4L2_CID_MPEG_AUDIO_MUTE (boolean)``
457    Mutes the audio when capturing. This is not done by muting audio
458    hardware, which can still produce a slight hiss, but in the encoder
459    itself, guaranteeing a fixed and reproducible audio bitstream. 0 =
460    unmuted, 1 = muted.
461
462.. _v4l2-mpeg-audio-dec-playback:
463
464``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK``
465    (enum)
466
467enum v4l2_mpeg_audio_dec_playback -
468    Determines how monolingual audio should be played back. Possible
469    values are:
470
471
472
473.. tabularcolumns:: |p{9.8cm}|p{7.7cm}|
474
475.. flat-table::
476    :header-rows:  0
477    :stub-columns: 0
478
479    * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_AUTO``
480      - Automatically determines the best playback mode.
481    * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_STEREO``
482      - Stereo playback.
483    * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_LEFT``
484      - Left channel playback.
485    * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_RIGHT``
486      - Right channel playback.
487    * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_MONO``
488      - Mono playback.
489    * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_SWAPPED_STEREO``
490      - Stereo playback with swapped left and right channels.
491
492
493
494.. _v4l2-mpeg-audio-dec-multilingual-playback:
495
496``V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK``
497    (enum)
498
499enum v4l2_mpeg_audio_dec_playback -
500    Determines how multilingual audio should be played back.
501
502.. _v4l2-mpeg-video-encoding:
503
504``V4L2_CID_MPEG_VIDEO_ENCODING``
505    (enum)
506
507enum v4l2_mpeg_video_encoding -
508    MPEG Video encoding method. This control is specific to multiplexed
509    MPEG streams. Possible values are:
510
511
512
513.. flat-table::
514    :header-rows:  0
515    :stub-columns: 0
516
517    * - ``V4L2_MPEG_VIDEO_ENCODING_MPEG_1``
518      - MPEG-1 Video encoding
519    * - ``V4L2_MPEG_VIDEO_ENCODING_MPEG_2``
520      - MPEG-2 Video encoding
521    * - ``V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC``
522      - MPEG-4 AVC (H.264) Video encoding
523
524
525
526.. _v4l2-mpeg-video-aspect:
527
528``V4L2_CID_MPEG_VIDEO_ASPECT``
529    (enum)
530
531enum v4l2_mpeg_video_aspect -
532    Video aspect. Possible values are:
533
534
535
536.. flat-table::
537    :header-rows:  0
538    :stub-columns: 0
539
540    * - ``V4L2_MPEG_VIDEO_ASPECT_1x1``
541    * - ``V4L2_MPEG_VIDEO_ASPECT_4x3``
542    * - ``V4L2_MPEG_VIDEO_ASPECT_16x9``
543    * - ``V4L2_MPEG_VIDEO_ASPECT_221x100``
544
545
546
547``V4L2_CID_MPEG_VIDEO_B_FRAMES (integer)``
548    Number of B-Frames (default 2)
549
550``V4L2_CID_MPEG_VIDEO_GOP_SIZE (integer)``
551    GOP size (default 12)
552
553``V4L2_CID_MPEG_VIDEO_GOP_CLOSURE (boolean)``
554    GOP closure (default 1)
555
556``V4L2_CID_MPEG_VIDEO_PULLDOWN (boolean)``
557    Enable 3:2 pulldown (default 0)
558
559.. _v4l2-mpeg-video-bitrate-mode:
560
561``V4L2_CID_MPEG_VIDEO_BITRATE_MODE``
562    (enum)
563
564enum v4l2_mpeg_video_bitrate_mode -
565    Video bitrate mode. Possible values are:
566
567
568
569.. flat-table::
570    :header-rows:  0
571    :stub-columns: 0
572
573    * - ``V4L2_MPEG_VIDEO_BITRATE_MODE_VBR``
574      - Variable bitrate
575    * - ``V4L2_MPEG_VIDEO_BITRATE_MODE_CBR``
576      - Constant bitrate
577    * - ``V4L2_MPEG_VIDEO_BITRATE_MODE_CQ``
578      - Constant quality
579
580
581
582``V4L2_CID_MPEG_VIDEO_BITRATE (integer)``
583    Average video bitrate in bits per second.
584
585``V4L2_CID_MPEG_VIDEO_BITRATE_PEAK (integer)``
586    Peak video bitrate in bits per second. Must be larger or equal to
587    the average video bitrate. It is ignored if the video bitrate mode
588    is set to constant bitrate.
589
590``V4L2_CID_MPEG_VIDEO_CONSTANT_QUALITY (integer)``
591    Constant quality level control. This control is applicable when
592    ``V4L2_CID_MPEG_VIDEO_BITRATE_MODE`` value is
593    ``V4L2_MPEG_VIDEO_BITRATE_MODE_CQ``. Valid range is 1 to 100
594    where 1 indicates lowest quality and 100 indicates highest quality.
595    Encoder will decide the appropriate quantization parameter and
596    bitrate to produce requested frame quality.
597
598
599``V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE (enum)``
600
601enum v4l2_mpeg_video_frame_skip_mode -
602    Indicates in what conditions the encoder should skip frames. If
603    encoding a frame would cause the encoded stream to be larger then a
604    chosen data limit then the frame will be skipped. Possible values
605    are:
606
607
608.. tabularcolumns:: |p{8.2cm}|p{9.3cm}|
609
610.. raw:: latex
611
612    \small
613
614.. flat-table::
615    :header-rows:  0
616    :stub-columns: 0
617
618    * - ``V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_DISABLED``
619      - Frame skip mode is disabled.
620    * - ``V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT``
621      - Frame skip mode enabled and buffer limit is set by the chosen
622        level and is defined by the standard.
623    * - ``V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT``
624      - Frame skip mode enabled and buffer limit is set by the
625        :ref:`VBV (MPEG1/2/4) <v4l2-mpeg-video-vbv-size>` or
626        :ref:`CPB (H264) buffer size <v4l2-mpeg-video-h264-cpb-size>` control.
627
628.. raw:: latex
629
630    \normalsize
631
632``V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (integer)``
633    For every captured frame, skip this many subsequent frames (default
634    0).
635
636``V4L2_CID_MPEG_VIDEO_MUTE (boolean)``
637    "Mutes" the video to a fixed color when capturing. This is useful
638    for testing, to produce a fixed video bitstream. 0 = unmuted, 1 =
639    muted.
640
641``V4L2_CID_MPEG_VIDEO_MUTE_YUV (integer)``
642    Sets the "mute" color of the video. The supplied 32-bit integer is
643    interpreted as follows (bit 0 = least significant bit):
644
645
646
647.. flat-table::
648    :header-rows:  0
649    :stub-columns: 0
650
651    * - Bit 0:7
652      - V chrominance information
653    * - Bit 8:15
654      - U chrominance information
655    * - Bit 16:23
656      - Y luminance information
657    * - Bit 24:31
658      - Must be zero.
659
660
661
662.. _v4l2-mpeg-video-dec-pts:
663
664``V4L2_CID_MPEG_VIDEO_DEC_PTS (integer64)``
665    This read-only control returns the 33-bit video Presentation Time
666    Stamp as defined in ITU T-REC-H.222.0 and ISO/IEC 13818-1 of the
667    currently displayed frame. This is the same PTS as is used in
668    :ref:`VIDIOC_DECODER_CMD`.
669
670.. _v4l2-mpeg-video-dec-frame:
671
672``V4L2_CID_MPEG_VIDEO_DEC_FRAME (integer64)``
673    This read-only control returns the frame counter of the frame that
674    is currently displayed (decoded). This value is reset to 0 whenever
675    the decoder is started.
676
677``V4L2_CID_MPEG_VIDEO_DEC_CONCEAL_COLOR (integer64)``
678    This control sets the conceal color in YUV color space. It describes
679    the client preference of the error conceal color in case of an error
680    where the reference frame is missing. The decoder should fill the
681    reference buffer with the preferred color and use it for future
682    decoding. The control is using 16 bits per channel.
683    Applicable to decoders.
684
685.. flat-table::
686    :header-rows:  0
687    :stub-columns: 0
688
689    * -
690      - 8bit  format
691      - 10bit format
692      - 12bit format
693    * - Y luminance
694      - Bit 0:7
695      - Bit 0:9
696      - Bit 0:11
697    * - Cb chrominance
698      - Bit 16:23
699      - Bit 16:25
700      - Bit 16:27
701    * - Cr chrominance
702      - Bit 32:39
703      - Bit 32:41
704      - Bit 32:43
705    * - Must be zero
706      - Bit 48:63
707      - Bit 48:63
708      - Bit 48:63
709
710``V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE (boolean)``
711    If enabled the decoder expects to receive a single slice per buffer,
712    otherwise the decoder expects a single frame in per buffer.
713    Applicable to the decoder, all codecs.
714
715``V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE (boolean)``
716    If the display delay is enabled then the decoder is forced to return
717    a CAPTURE buffer (decoded frame) after processing a certain number
718    of OUTPUT buffers. The delay can be set through
719    ``V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY``. This
720    feature can be used for example for generating thumbnails of videos.
721    Applicable to the decoder.
722
723``V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY (integer)``
724    Display delay value for decoder. The decoder is forced to
725    return a decoded frame after the set 'display delay' number of
726    frames. If this number is low it may result in frames returned out
727    of display order, in addition the hardware may still be using the
728    returned buffer as a reference picture for subsequent frames.
729
730``V4L2_CID_MPEG_VIDEO_AU_DELIMITER (boolean)``
731    If enabled then, AUD (Access Unit Delimiter) NALUs will be generated.
732    That could be useful to find the start of a frame without having to
733    fully parse each NALU. Applicable to the H264 and HEVC encoders.
734
735``V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE (boolean)``
736    Enable writing sample aspect ratio in the Video Usability
737    Information. Applicable to the H264 encoder.
738
739.. _v4l2-mpeg-video-h264-vui-sar-idc:
740
741``V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC``
742    (enum)
743
744enum v4l2_mpeg_video_h264_vui_sar_idc -
745    VUI sample aspect ratio indicator for H.264 encoding. The value is
746    defined in the table E-1 in the standard. Applicable to the H264
747    encoder.
748
749
750
751.. flat-table::
752    :header-rows:  0
753    :stub-columns: 0
754
755    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED``
756      - Unspecified
757    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1``
758      - 1x1
759    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11``
760      - 12x11
761    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11``
762      - 10x11
763    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11``
764      - 16x11
765    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33``
766      - 40x33
767    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11``
768      - 24x11
769    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11``
770      - 20x11
771    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11``
772      - 32x11
773    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33``
774      - 80x33
775    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11``
776      - 18x11
777    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11``
778      - 15x11
779    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33``
780      - 64x33
781    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99``
782      - 160x99
783    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3``
784      - 4x3
785    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2``
786      - 3x2
787    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1``
788      - 2x1
789    * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED``
790      - Extended SAR
791
792
793
794``V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH (integer)``
795    Extended sample aspect ratio width for H.264 VUI encoding.
796    Applicable to the H264 encoder.
797
798``V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT (integer)``
799    Extended sample aspect ratio height for H.264 VUI encoding.
800    Applicable to the H264 encoder.
801
802.. _v4l2-mpeg-video-h264-level:
803
804``V4L2_CID_MPEG_VIDEO_H264_LEVEL``
805    (enum)
806
807enum v4l2_mpeg_video_h264_level -
808    The level information for the H264 video elementary stream.
809    Applicable to the H264 encoder. Possible values are:
810
811
812
813.. flat-table::
814    :header-rows:  0
815    :stub-columns: 0
816
817    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1_0``
818      - Level 1.0
819    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1B``
820      - Level 1B
821    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1_1``
822      - Level 1.1
823    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1_2``
824      - Level 1.2
825    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1_3``
826      - Level 1.3
827    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_2_0``
828      - Level 2.0
829    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_2_1``
830      - Level 2.1
831    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_2_2``
832      - Level 2.2
833    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_3_0``
834      - Level 3.0
835    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_3_1``
836      - Level 3.1
837    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_3_2``
838      - Level 3.2
839    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_4_0``
840      - Level 4.0
841    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_4_1``
842      - Level 4.1
843    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_4_2``
844      - Level 4.2
845    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_5_0``
846      - Level 5.0
847    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_5_1``
848      - Level 5.1
849    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_5_2``
850      - Level 5.2
851    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_6_0``
852      - Level 6.0
853    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_6_1``
854      - Level 6.1
855    * - ``V4L2_MPEG_VIDEO_H264_LEVEL_6_2``
856      - Level 6.2
857
858
859
860.. _v4l2-mpeg-video-mpeg2-level:
861
862``V4L2_CID_MPEG_VIDEO_MPEG2_LEVEL``
863    (enum)
864
865enum v4l2_mpeg_video_mpeg2_level -
866    The level information for the MPEG2 elementary stream. Applicable to
867    MPEG2 codecs. Possible values are:
868
869
870
871.. flat-table::
872    :header-rows:  0
873    :stub-columns: 0
874
875    * - ``V4L2_MPEG_VIDEO_MPEG2_LEVEL_LOW``
876      - Low Level (LL)
877    * - ``V4L2_MPEG_VIDEO_MPEG2_LEVEL_MAIN``
878      - Main Level (ML)
879    * - ``V4L2_MPEG_VIDEO_MPEG2_LEVEL_HIGH_1440``
880      - High-1440 Level (H-14)
881    * - ``V4L2_MPEG_VIDEO_MPEG2_LEVEL_HIGH``
882      - High Level (HL)
883
884
885
886.. _v4l2-mpeg-video-mpeg4-level:
887
888``V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL``
889    (enum)
890
891enum v4l2_mpeg_video_mpeg4_level -
892    The level information for the MPEG4 elementary stream. Applicable to
893    the MPEG4 encoder. Possible values are:
894
895
896
897.. flat-table::
898    :header-rows:  0
899    :stub-columns: 0
900
901    * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_0``
902      - Level 0
903    * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_0B``
904      - Level 0b
905    * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_1``
906      - Level 1
907    * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_2``
908      - Level 2
909    * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_3``
910      - Level 3
911    * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_3B``
912      - Level 3b
913    * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_4``
914      - Level 4
915    * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_5``
916      - Level 5
917
918
919
920.. _v4l2-mpeg-video-h264-profile:
921
922``V4L2_CID_MPEG_VIDEO_H264_PROFILE``
923    (enum)
924
925enum v4l2_mpeg_video_h264_profile -
926    The profile information for H264. Applicable to the H264 encoder.
927    Possible values are:
928
929.. raw:: latex
930
931    \small
932
933.. tabularcolumns:: |p{10.2cm}|p{7.3cm}|
934
935.. flat-table::
936    :header-rows:  0
937    :stub-columns: 0
938
939    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE``
940      - Baseline profile
941    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE``
942      - Constrained Baseline profile
943    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_MAIN``
944      - Main profile
945    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED``
946      - Extended profile
947    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH``
948      - High profile
949    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10``
950      - High 10 profile
951    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422``
952      - High 422 profile
953    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE``
954      - High 444 Predictive profile
955    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA``
956      - High 10 Intra profile
957    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA``
958      - High 422 Intra profile
959    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA``
960      - High 444 Intra profile
961    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA``
962      - CAVLC 444 Intra profile
963    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE``
964      - Scalable Baseline profile
965    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH``
966      - Scalable High profile
967    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA``
968      - Scalable High Intra profile
969    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH``
970      - Stereo High profile
971    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH``
972      - Multiview High profile
973    * - ``V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_HIGH``
974      - Constrained High profile
975
976.. raw:: latex
977
978    \normalsize
979
980.. _v4l2-mpeg-video-mpeg2-profile:
981
982``V4L2_CID_MPEG_VIDEO_MPEG2_PROFILE``
983    (enum)
984
985enum v4l2_mpeg_video_mpeg2_profile -
986    The profile information for MPEG2. Applicable to MPEG2 codecs.
987    Possible values are:
988
989.. raw:: latex
990
991    \small
992
993.. tabularcolumns:: |p{10.2cm}|p{7.3cm}|
994
995.. flat-table::
996    :header-rows:  0
997    :stub-columns: 0
998
999    * - ``V4L2_MPEG_VIDEO_MPEG2_PROFILE_SIMPLE``
1000      - Simple profile (SP)
1001    * - ``V4L2_MPEG_VIDEO_MPEG2_PROFILE_MAIN``
1002      - Main profile (MP)
1003    * - ``V4L2_MPEG_VIDEO_MPEG2_PROFILE_SNR_SCALABLE``
1004      - SNR Scalable profile (SNR)
1005    * - ``V4L2_MPEG_VIDEO_MPEG2_PROFILE_SPATIALLY_SCALABLE``
1006      - Spatially Scalable profile (Spt)
1007    * - ``V4L2_MPEG_VIDEO_MPEG2_PROFILE_HIGH``
1008      - High profile (HP)
1009    * - ``V4L2_MPEG_VIDEO_MPEG2_PROFILE_MULTIVIEW``
1010      - Multi-view profile (MVP)
1011
1012
1013.. raw:: latex
1014
1015    \normalsize
1016
1017.. _v4l2-mpeg-video-mpeg4-profile:
1018
1019``V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE``
1020    (enum)
1021
1022enum v4l2_mpeg_video_mpeg4_profile -
1023    The profile information for MPEG4. Applicable to the MPEG4 encoder.
1024    Possible values are:
1025
1026.. raw:: latex
1027
1028    \small
1029
1030.. tabularcolumns:: |p{11.8cm}|p{5.7cm}|
1031
1032.. flat-table::
1033    :header-rows:  0
1034    :stub-columns: 0
1035
1036    * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE``
1037      - Simple profile
1038    * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_SIMPLE``
1039      - Advanced Simple profile
1040    * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_CORE``
1041      - Core profile
1042    * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE_SCALABLE``
1043      - Simple Scalable profile
1044    * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_CODING_EFFICIENCY``
1045      - Advanced Coding Efficiency profile
1046
1047.. raw:: latex
1048
1049    \normalsize
1050
1051``V4L2_CID_MPEG_VIDEO_MAX_REF_PIC (integer)``
1052    The maximum number of reference pictures used for encoding.
1053    Applicable to the encoder.
1054
1055.. _v4l2-mpeg-video-multi-slice-mode:
1056
1057``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE``
1058    (enum)
1059
1060enum v4l2_mpeg_video_multi_slice_mode -
1061    Determines how the encoder should handle division of frame into
1062    slices. Applicable to the encoder. Possible values are:
1063
1064
1065
1066.. tabularcolumns:: |p{9.6cm}|p{7.9cm}|
1067
1068.. flat-table::
1069    :header-rows:  0
1070    :stub-columns: 0
1071
1072    * - ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE``
1073      - Single slice per frame.
1074    * - ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB``
1075      - Multiple slices with set maximum number of macroblocks per slice.
1076    * - ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES``
1077      - Multiple slice with set maximum size in bytes per slice.
1078
1079
1080
1081``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB (integer)``
1082    The maximum number of macroblocks in a slice. Used when
1083    ``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE`` is set to
1084    ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB``. Applicable to the
1085    encoder.
1086
1087``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES (integer)``
1088    The maximum size of a slice in bytes. Used when
1089    ``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE`` is set to
1090    ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES``. Applicable to the
1091    encoder.
1092
1093.. _v4l2-mpeg-video-h264-loop-filter-mode:
1094
1095``V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE``
1096    (enum)
1097
1098enum v4l2_mpeg_video_h264_loop_filter_mode -
1099    Loop filter mode for H264 encoder. Possible values are:
1100
1101.. raw:: latex
1102
1103    \small
1104
1105.. tabularcolumns:: |p{13.5cm}|p{4.0cm}|
1106
1107.. flat-table::
1108    :header-rows:  0
1109    :stub-columns: 0
1110
1111    * - ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED``
1112      - Loop filter is enabled.
1113    * - ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED``
1114      - Loop filter is disabled.
1115    * - ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY``
1116      - Loop filter is disabled at the slice boundary.
1117
1118.. raw:: latex
1119
1120    \normalsize
1121
1122
1123``V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA (integer)``
1124    Loop filter alpha coefficient, defined in the H264 standard.
1125    This value corresponds to the slice_alpha_c0_offset_div2 slice header
1126    field, and should be in the range of -6 to +6, inclusive. The actual alpha
1127    offset FilterOffsetA is twice this value.
1128    Applicable to the H264 encoder.
1129
1130``V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA (integer)``
1131    Loop filter beta coefficient, defined in the H264 standard.
1132    This corresponds to the slice_beta_offset_div2 slice header field, and
1133    should be in the range of -6 to +6, inclusive. The actual beta offset
1134    FilterOffsetB is twice this value.
1135    Applicable to the H264 encoder.
1136
1137.. _v4l2-mpeg-video-h264-entropy-mode:
1138
1139``V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE``
1140    (enum)
1141
1142enum v4l2_mpeg_video_h264_entropy_mode -
1143    Entropy coding mode for H264 - CABAC/CAVALC. Applicable to the H264
1144    encoder. Possible values are:
1145
1146
1147.. tabularcolumns:: |p{9.0cm}|p{8.5cm}|
1148
1149
1150.. flat-table::
1151    :header-rows:  0
1152    :stub-columns: 0
1153
1154    * - ``V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC``
1155      - Use CAVLC entropy coding.
1156    * - ``V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC``
1157      - Use CABAC entropy coding.
1158
1159
1160
1161``V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM (boolean)``
1162    Enable 8X8 transform for H264. Applicable to the H264 encoder.
1163
1164``V4L2_CID_MPEG_VIDEO_H264_CONSTRAINED_INTRA_PREDICTION (boolean)``
1165    Enable constrained intra prediction for H264. Applicable to the H264
1166    encoder.
1167
1168``V4L2_CID_MPEG_VIDEO_H264_CHROMA_QP_INDEX_OFFSET (integer)``
1169    Specify the offset that should be added to the luma quantization
1170    parameter to determine the chroma quantization parameter. Applicable
1171    to the H264 encoder.
1172
1173``V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB (integer)``
1174    Cyclic intra macroblock refresh. This is the number of continuous
1175    macroblocks refreshed every frame. Each frame a successive set of
1176    macroblocks is refreshed until the cycle completes and starts from
1177    the top of the frame. Setting this control to zero means that
1178    macroblocks will not be refreshed.  Note that this control will not
1179    take effect when ``V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD`` control
1180    is set to non zero value.
1181    Applicable to H264, H263 and MPEG4 encoder.
1182
1183``V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD (integer)``
1184    Intra macroblock refresh period. This sets the period to refresh
1185    the whole frame. In other words, this defines the number of frames
1186    for which the whole frame will be intra-refreshed.  An example:
1187    setting period to 1 means that the whole frame will be refreshed,
1188    setting period to 2 means that the half of macroblocks will be
1189    intra-refreshed on frameX and the other half of macroblocks
1190    will be refreshed in frameX + 1 and so on. Setting the period to
1191    zero means no period is specified.
1192    Note that if the client sets this control to non zero value the
1193    ``V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB`` control shall be
1194    ignored. Applicable to H264 and HEVC encoders.
1195
1196``V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE (boolean)``
1197    Frame level rate control enable. If this control is disabled then
1198    the quantization parameter for each frame type is constant and set
1199    with appropriate controls (e.g.
1200    ``V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP``). If frame rate control is
1201    enabled then quantization parameter is adjusted to meet the chosen
1202    bitrate. Minimum and maximum value for the quantization parameter
1203    can be set with appropriate controls (e.g.
1204    ``V4L2_CID_MPEG_VIDEO_H263_MIN_QP``). Applicable to encoders.
1205
1206``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE (boolean)``
1207    Macroblock level rate control enable. Applicable to the MPEG4 and
1208    H264 encoders.
1209
1210``V4L2_CID_MPEG_VIDEO_MPEG4_QPEL (boolean)``
1211    Quarter pixel motion estimation for MPEG4. Applicable to the MPEG4
1212    encoder.
1213
1214``V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP (integer)``
1215    Quantization parameter for an I frame for H263. Valid range: from 1
1216    to 31.
1217
1218``V4L2_CID_MPEG_VIDEO_H263_MIN_QP (integer)``
1219    Minimum quantization parameter for H263. Valid range: from 1 to 31.
1220
1221``V4L2_CID_MPEG_VIDEO_H263_MAX_QP (integer)``
1222    Maximum quantization parameter for H263. Valid range: from 1 to 31.
1223
1224``V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP (integer)``
1225    Quantization parameter for an P frame for H263. Valid range: from 1
1226    to 31.
1227
1228``V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP (integer)``
1229    Quantization parameter for an B frame for H263. Valid range: from 1
1230    to 31.
1231
1232``V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP (integer)``
1233    Quantization parameter for an I frame for H264. Valid range: from 0
1234    to 51.
1235
1236``V4L2_CID_MPEG_VIDEO_H264_MIN_QP (integer)``
1237    Minimum quantization parameter for H264. Valid range: from 0 to 51.
1238
1239``V4L2_CID_MPEG_VIDEO_H264_MAX_QP (integer)``
1240    Maximum quantization parameter for H264. Valid range: from 0 to 51.
1241
1242``V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP (integer)``
1243    Quantization parameter for an P frame for H264. Valid range: from 0
1244    to 51.
1245
1246``V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP (integer)``
1247    Quantization parameter for an B frame for H264. Valid range: from 0
1248    to 51.
1249
1250``V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MIN_QP (integer)``
1251    Minimum quantization parameter for the H264 I frame to limit I frame
1252    quality to a range. Valid range: from 0 to 51. If
1253    V4L2_CID_MPEG_VIDEO_H264_MIN_QP is also set, the quantization parameter
1254    should be chosen to meet both requirements.
1255
1256``V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MAX_QP (integer)``
1257    Maximum quantization parameter for the H264 I frame to limit I frame
1258    quality to a range. Valid range: from 0 to 51. If
1259    V4L2_CID_MPEG_VIDEO_H264_MAX_QP is also set, the quantization parameter
1260    should be chosen to meet both requirements.
1261
1262``V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MIN_QP (integer)``
1263    Minimum quantization parameter for the H264 P frame to limit P frame
1264    quality to a range. Valid range: from 0 to 51. If
1265    V4L2_CID_MPEG_VIDEO_H264_MIN_QP is also set, the quantization parameter
1266    should be chosen to meet both requirements.
1267
1268``V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MAX_QP (integer)``
1269    Maximum quantization parameter for the H264 P frame to limit P frame
1270    quality to a range. Valid range: from 0 to 51. If
1271    V4L2_CID_MPEG_VIDEO_H264_MAX_QP is also set, the quantization parameter
1272    should be chosen to meet both requirements.
1273
1274``V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MIN_QP (integer)``
1275    Minimum quantization parameter for the H264 B frame to limit B frame
1276    quality to a range. Valid range: from 0 to 51. If
1277    V4L2_CID_MPEG_VIDEO_H264_MIN_QP is also set, the quantization parameter
1278    should be chosen to meet both requirements.
1279
1280``V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MAX_QP (integer)``
1281    Maximum quantization parameter for the H264 B frame to limit B frame
1282    quality to a range. Valid range: from 0 to 51. If
1283    V4L2_CID_MPEG_VIDEO_H264_MAX_QP is also set, the quantization parameter
1284    should be chosen to meet both requirements.
1285
1286``V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP (integer)``
1287    Quantization parameter for an I frame for MPEG4. Valid range: from 1
1288    to 31.
1289
1290``V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP (integer)``
1291    Minimum quantization parameter for MPEG4. Valid range: from 1 to 31.
1292
1293``V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP (integer)``
1294    Maximum quantization parameter for MPEG4. Valid range: from 1 to 31.
1295
1296``V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP (integer)``
1297    Quantization parameter for an P frame for MPEG4. Valid range: from 1
1298    to 31.
1299
1300``V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP (integer)``
1301    Quantization parameter for an B frame for MPEG4. Valid range: from 1
1302    to 31.
1303
1304.. _v4l2-mpeg-video-vbv-size:
1305
1306``V4L2_CID_MPEG_VIDEO_VBV_SIZE (integer)``
1307    The Video Buffer Verifier size in kilobytes, it is used as a
1308    limitation of frame skip. The VBV is defined in the standard as a
1309    mean to verify that the produced stream will be successfully
1310    decoded. The standard describes it as "Part of a hypothetical
1311    decoder that is conceptually connected to the output of the encoder.
1312    Its purpose is to provide a constraint on the variability of the
1313    data rate that an encoder or editing process may produce.".
1314    Applicable to the MPEG1, MPEG2, MPEG4 encoders.
1315
1316.. _v4l2-mpeg-video-vbv-delay:
1317
1318``V4L2_CID_MPEG_VIDEO_VBV_DELAY (integer)``
1319    Sets the initial delay in milliseconds for VBV buffer control.
1320
1321.. _v4l2-mpeg-video-hor-search-range:
1322
1323``V4L2_CID_MPEG_VIDEO_MV_H_SEARCH_RANGE (integer)``
1324    Horizontal search range defines maximum horizontal search area in
1325    pixels to search and match for the present Macroblock (MB) in the
1326    reference picture. This V4L2 control macro is used to set horizontal
1327    search range for motion estimation module in video encoder.
1328
1329.. _v4l2-mpeg-video-vert-search-range:
1330
1331``V4L2_CID_MPEG_VIDEO_MV_V_SEARCH_RANGE (integer)``
1332    Vertical search range defines maximum vertical search area in pixels
1333    to search and match for the present Macroblock (MB) in the reference
1334    picture. This V4L2 control macro is used to set vertical search
1335    range for motion estimation module in video encoder.
1336
1337.. _v4l2-mpeg-video-force-key-frame:
1338
1339``V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME (button)``
1340    Force a key frame for the next queued buffer. Applicable to
1341    encoders. This is a general, codec-agnostic keyframe control.
1342
1343.. _v4l2-mpeg-video-h264-cpb-size:
1344
1345``V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE (integer)``
1346    The Coded Picture Buffer size in kilobytes, it is used as a
1347    limitation of frame skip. The CPB is defined in the H264 standard as
1348    a mean to verify that the produced stream will be successfully
1349    decoded. Applicable to the H264 encoder.
1350
1351``V4L2_CID_MPEG_VIDEO_H264_I_PERIOD (integer)``
1352    Period between I-frames in the open GOP for H264. In case of an open
1353    GOP this is the period between two I-frames. The period between IDR
1354    (Instantaneous Decoding Refresh) frames is taken from the GOP_SIZE
1355    control. An IDR frame, which stands for Instantaneous Decoding
1356    Refresh is an I-frame after which no prior frames are referenced.
1357    This means that a stream can be restarted from an IDR frame without
1358    the need to store or decode any previous frames. Applicable to the
1359    H264 encoder.
1360
1361.. _v4l2-mpeg-video-header-mode:
1362
1363``V4L2_CID_MPEG_VIDEO_HEADER_MODE``
1364    (enum)
1365
1366enum v4l2_mpeg_video_header_mode -
1367    Determines whether the header is returned as the first buffer or is
1368    it returned together with the first frame. Applicable to encoders.
1369    Possible values are:
1370
1371.. raw:: latex
1372
1373    \small
1374
1375.. tabularcolumns:: |p{10.3cm}|p{7.2cm}|
1376
1377.. flat-table::
1378    :header-rows:  0
1379    :stub-columns: 0
1380
1381    * - ``V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE``
1382      - The stream header is returned separately in the first buffer.
1383    * - ``V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME``
1384      - The stream header is returned together with the first encoded
1385	frame.
1386
1387.. raw:: latex
1388
1389    \normalsize
1390
1391
1392``V4L2_CID_MPEG_VIDEO_REPEAT_SEQ_HEADER (boolean)``
1393    Repeat the video sequence headers. Repeating these headers makes
1394    random access to the video stream easier. Applicable to the MPEG1, 2
1395    and 4 encoder.
1396
1397``V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER (boolean)``
1398    Enabled the deblocking post processing filter for MPEG4 decoder.
1399    Applicable to the MPEG4 decoder.
1400
1401``V4L2_CID_MPEG_VIDEO_MPEG4_VOP_TIME_RES (integer)``
1402    vop_time_increment_resolution value for MPEG4. Applicable to the
1403    MPEG4 encoder.
1404
1405``V4L2_CID_MPEG_VIDEO_MPEG4_VOP_TIME_INC (integer)``
1406    vop_time_increment value for MPEG4. Applicable to the MPEG4
1407    encoder.
1408
1409``V4L2_CID_MPEG_VIDEO_H264_SEI_FRAME_PACKING (boolean)``
1410    Enable generation of frame packing supplemental enhancement
1411    information in the encoded bitstream. The frame packing SEI message
1412    contains the arrangement of L and R planes for 3D viewing.
1413    Applicable to the H264 encoder.
1414
1415``V4L2_CID_MPEG_VIDEO_H264_SEI_FP_CURRENT_FRAME_0 (boolean)``
1416    Sets current frame as frame0 in frame packing SEI. Applicable to the
1417    H264 encoder.
1418
1419.. _v4l2-mpeg-video-h264-sei-fp-arrangement-type:
1420
1421``V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE``
1422    (enum)
1423
1424enum v4l2_mpeg_video_h264_sei_fp_arrangement_type -
1425    Frame packing arrangement type for H264 SEI. Applicable to the H264
1426    encoder. Possible values are:
1427
1428.. raw:: latex
1429
1430    \small
1431
1432.. tabularcolumns:: |p{12cm}|p{5.5cm}|
1433
1434.. flat-table::
1435    :header-rows:  0
1436    :stub-columns: 0
1437
1438    * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_CHEKERBOARD``
1439      - Pixels are alternatively from L and R.
1440    * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_COLUMN``
1441      - L and R are interlaced by column.
1442    * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_ROW``
1443      - L and R are interlaced by row.
1444    * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_SIDE_BY_SIDE``
1445      - L is on the left, R on the right.
1446    * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TOP_BOTTOM``
1447      - L is on top, R on bottom.
1448    * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TEMPORAL``
1449      - One view per frame.
1450
1451.. raw:: latex
1452
1453    \normalsize
1454
1455
1456
1457``V4L2_CID_MPEG_VIDEO_H264_FMO (boolean)``
1458    Enables flexible macroblock ordering in the encoded bitstream. It is
1459    a technique used for restructuring the ordering of macroblocks in
1460    pictures. Applicable to the H264 encoder.
1461
1462.. _v4l2-mpeg-video-h264-fmo-map-type:
1463
1464``V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE``
1465   (enum)
1466
1467enum v4l2_mpeg_video_h264_fmo_map_type -
1468    When using FMO, the map type divides the image in different scan
1469    patterns of macroblocks. Applicable to the H264 encoder. Possible
1470    values are:
1471
1472.. raw:: latex
1473
1474    \small
1475
1476.. tabularcolumns:: |p{12.5cm}|p{5.0cm}|
1477
1478.. flat-table::
1479    :header-rows:  0
1480    :stub-columns: 0
1481
1482    * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_INTERLEAVED_SLICES``
1483      - Slices are interleaved one after other with macroblocks in run
1484	length order.
1485    * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_SCATTERED_SLICES``
1486      - Scatters the macroblocks based on a mathematical function known to
1487	both encoder and decoder.
1488    * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_FOREGROUND_WITH_LEFT_OVER``
1489      - Macroblocks arranged in rectangular areas or regions of interest.
1490    * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_BOX_OUT``
1491      - Slice groups grow in a cyclic way from centre to outwards.
1492    * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_RASTER_SCAN``
1493      - Slice groups grow in raster scan pattern from left to right.
1494    * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_WIPE_SCAN``
1495      - Slice groups grow in wipe scan pattern from top to bottom.
1496    * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_EXPLICIT``
1497      - User defined map type.
1498
1499.. raw:: latex
1500
1501    \normalsize
1502
1503
1504
1505``V4L2_CID_MPEG_VIDEO_H264_FMO_SLICE_GROUP (integer)``
1506    Number of slice groups in FMO. Applicable to the H264 encoder.
1507
1508.. _v4l2-mpeg-video-h264-fmo-change-direction:
1509
1510``V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_DIRECTION``
1511    (enum)
1512
1513enum v4l2_mpeg_video_h264_fmo_change_dir -
1514    Specifies a direction of the slice group change for raster and wipe
1515    maps. Applicable to the H264 encoder. Possible values are:
1516
1517.. tabularcolumns:: |p{9.6cm}|p{7.9cm}|
1518
1519.. flat-table::
1520    :header-rows:  0
1521    :stub-columns: 0
1522
1523    * - ``V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_RIGHT``
1524      - Raster scan or wipe right.
1525    * - ``V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_LEFT``
1526      - Reverse raster scan or wipe left.
1527
1528
1529
1530``V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_RATE (integer)``
1531    Specifies the size of the first slice group for raster and wipe map.
1532    Applicable to the H264 encoder.
1533
1534``V4L2_CID_MPEG_VIDEO_H264_FMO_RUN_LENGTH (integer)``
1535    Specifies the number of consecutive macroblocks for the interleaved
1536    map. Applicable to the H264 encoder.
1537
1538``V4L2_CID_MPEG_VIDEO_H264_ASO (boolean)``
1539    Enables arbitrary slice ordering in encoded bitstream. Applicable to
1540    the H264 encoder.
1541
1542``V4L2_CID_MPEG_VIDEO_H264_ASO_SLICE_ORDER (integer)``
1543    Specifies the slice order in ASO. Applicable to the H264 encoder.
1544    The supplied 32-bit integer is interpreted as follows (bit 0 = least
1545    significant bit):
1546
1547
1548
1549.. flat-table::
1550    :header-rows:  0
1551    :stub-columns: 0
1552
1553    * - Bit 0:15
1554      - Slice ID
1555    * - Bit 16:32
1556      - Slice position or order
1557
1558
1559
1560``V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING (boolean)``
1561    Enables H264 hierarchical coding. Applicable to the H264 encoder.
1562
1563.. _v4l2-mpeg-video-h264-hierarchical-coding-type:
1564
1565``V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE``
1566    (enum)
1567
1568enum v4l2_mpeg_video_h264_hierarchical_coding_type -
1569    Specifies the hierarchical coding type. Applicable to the H264
1570    encoder. Possible values are:
1571
1572
1573
1574.. flat-table::
1575    :header-rows:  0
1576    :stub-columns: 0
1577
1578    * - ``V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_B``
1579      - Hierarchical B coding.
1580    * - ``V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_P``
1581      - Hierarchical P coding.
1582
1583
1584
1585``V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER (integer)``
1586    Specifies the number of hierarchical coding layers. Applicable to
1587    the H264 encoder.
1588
1589``V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER_QP (integer)``
1590    Specifies a user defined QP for each layer. Applicable to the H264
1591    encoder. The supplied 32-bit integer is interpreted as follows (bit
1592    0 = least significant bit):
1593
1594
1595
1596.. flat-table::
1597    :header-rows:  0
1598    :stub-columns: 0
1599
1600    * - Bit 0:15
1601      - QP value
1602    * - Bit 16:32
1603      - Layer number
1604
1605``V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L0_BR (integer)``
1606    Indicates bit rate (bps) for hierarchical coding layer 0 for H264 encoder.
1607
1608``V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L1_BR (integer)``
1609    Indicates bit rate (bps) for hierarchical coding layer 1 for H264 encoder.
1610
1611``V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L2_BR (integer)``
1612    Indicates bit rate (bps) for hierarchical coding layer 2 for H264 encoder.
1613
1614``V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L3_BR (integer)``
1615    Indicates bit rate (bps) for hierarchical coding layer 3 for H264 encoder.
1616
1617``V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L4_BR (integer)``
1618    Indicates bit rate (bps) for hierarchical coding layer 4 for H264 encoder.
1619
1620``V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L5_BR (integer)``
1621    Indicates bit rate (bps) for hierarchical coding layer 5 for H264 encoder.
1622
1623``V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L6_BR (integer)``
1624    Indicates bit rate (bps) for hierarchical coding layer 6 for H264 encoder.
1625
1626``V4L2_CID_FWHT_I_FRAME_QP (integer)``
1627    Quantization parameter for an I frame for FWHT. Valid range: from 1
1628    to 31.
1629
1630``V4L2_CID_FWHT_P_FRAME_QP (integer)``
1631    Quantization parameter for a P frame for FWHT. Valid range: from 1
1632    to 31.
1633
1634.. raw:: latex
1635
1636    \normalsize
1637
1638
1639MFC 5.1 MPEG Controls
1640=====================
1641
1642The following MPEG class controls deal with MPEG decoding and encoding
1643settings that are specific to the Multi Format Codec 5.1 device present
1644in the S5P family of SoCs by Samsung.
1645
1646
1647.. _mfc51-control-id:
1648
1649MFC 5.1 Control IDs
1650-------------------
1651
1652``V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE (boolean)``
1653    If the display delay is enabled then the decoder is forced to return
1654    a CAPTURE buffer (decoded frame) after processing a certain number
1655    of OUTPUT buffers. The delay can be set through
1656    ``V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY``. This
1657    feature can be used for example for generating thumbnails of videos.
1658    Applicable to the H264 decoder.
1659
1660    .. note::
1661
1662       This control is deprecated. Use the standard
1663       ``V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE`` control instead.
1664
1665``V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY (integer)``
1666    Display delay value for H264 decoder. The decoder is forced to
1667    return a decoded frame after the set 'display delay' number of
1668    frames. If this number is low it may result in frames returned out
1669    of display order, in addition the hardware may still be using the
1670    returned buffer as a reference picture for subsequent frames.
1671
1672    .. note::
1673
1674       This control is deprecated. Use the standard
1675       ``V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY`` control instead.
1676
1677``V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P (integer)``
1678    The number of reference pictures used for encoding a P picture.
1679    Applicable to the H264 encoder.
1680
1681``V4L2_CID_MPEG_MFC51_VIDEO_PADDING (boolean)``
1682    Padding enable in the encoder - use a color instead of repeating
1683    border pixels. Applicable to encoders.
1684
1685``V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV (integer)``
1686    Padding color in the encoder. Applicable to encoders. The supplied
1687    32-bit integer is interpreted as follows (bit 0 = least significant
1688    bit):
1689
1690
1691
1692.. flat-table::
1693    :header-rows:  0
1694    :stub-columns: 0
1695
1696    * - Bit 0:7
1697      - V chrominance information
1698    * - Bit 8:15
1699      - U chrominance information
1700    * - Bit 16:23
1701      - Y luminance information
1702    * - Bit 24:31
1703      - Must be zero.
1704
1705
1706
1707``V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF (integer)``
1708    Reaction coefficient for MFC rate control. Applicable to encoders.
1709
1710    .. note::
1711
1712       #. Valid only when the frame level RC is enabled.
1713
1714       #. For tight CBR, this field must be small (ex. 2 ~ 10). For
1715	  VBR, this field must be large (ex. 100 ~ 1000).
1716
1717       #. It is not recommended to use the greater number than
1718	  FRAME_RATE * (10^9 / BIT_RATE).
1719
1720``V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK (boolean)``
1721    Adaptive rate control for dark region. Valid only when H.264 and
1722    macroblock level RC is enabled
1723    (``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE``). Applicable to the H264
1724    encoder.
1725
1726``V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH (boolean)``
1727    Adaptive rate control for smooth region. Valid only when H.264 and
1728    macroblock level RC is enabled
1729    (``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE``). Applicable to the H264
1730    encoder.
1731
1732``V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC (boolean)``
1733    Adaptive rate control for static region. Valid only when H.264 and
1734    macroblock level RC is enabled
1735    (``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE``). Applicable to the H264
1736    encoder.
1737
1738``V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY (boolean)``
1739    Adaptive rate control for activity region. Valid only when H.264 and
1740    macroblock level RC is enabled
1741    (``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE``). Applicable to the H264
1742    encoder.
1743
1744.. _v4l2-mpeg-mfc51-video-frame-skip-mode:
1745
1746``V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE``
1747    (enum)
1748
1749    .. note::
1750
1751       This control is deprecated. Use the standard
1752       ``V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE`` control instead.
1753
1754enum v4l2_mpeg_mfc51_video_frame_skip_mode -
1755    Indicates in what conditions the encoder should skip frames. If
1756    encoding a frame would cause the encoded stream to be larger then a
1757    chosen data limit then the frame will be skipped. Possible values
1758    are:
1759
1760
1761.. tabularcolumns:: |p{9.4cm}|p{8.1cm}|
1762
1763.. raw:: latex
1764
1765    \small
1766
1767.. flat-table::
1768    :header-rows:  0
1769    :stub-columns: 0
1770
1771    * - ``V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_DISABLED``
1772      - Frame skip mode is disabled.
1773    * - ``V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT``
1774      - Frame skip mode enabled and buffer limit is set by the chosen
1775	level and is defined by the standard.
1776    * - ``V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT``
1777      - Frame skip mode enabled and buffer limit is set by the VBV
1778	(MPEG1/2/4) or CPB (H264) buffer size control.
1779
1780.. raw:: latex
1781
1782    \normalsize
1783
1784``V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT (integer)``
1785    Enable rate-control with fixed target bit. If this setting is
1786    enabled, then the rate control logic of the encoder will calculate
1787    the average bitrate for a GOP and keep it below or equal the set
1788    bitrate target. Otherwise the rate control logic calculates the
1789    overall average bitrate for the stream and keeps it below or equal
1790    to the set bitrate. In the first case the average bitrate for the
1791    whole stream will be smaller then the set bitrate. This is caused
1792    because the average is calculated for smaller number of frames, on
1793    the other hand enabling this setting will ensure that the stream
1794    will meet tight bandwidth constraints. Applicable to encoders.
1795
1796.. _v4l2-mpeg-mfc51-video-force-frame-type:
1797
1798``V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE``
1799    (enum)
1800
1801enum v4l2_mpeg_mfc51_video_force_frame_type -
1802    Force a frame type for the next queued buffer. Applicable to
1803    encoders. Possible values are:
1804
1805.. tabularcolumns:: |p{9.9cm}|p{7.6cm}|
1806
1807.. flat-table::
1808    :header-rows:  0
1809    :stub-columns: 0
1810
1811    * - ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_DISABLED``
1812      - Forcing a specific frame type disabled.
1813    * - ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_I_FRAME``
1814      - Force an I-frame.
1815    * - ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_NOT_CODED``
1816      - Force a non-coded frame.
1817
1818
1819CX2341x MPEG Controls
1820=====================
1821
1822The following MPEG class controls deal with MPEG encoding settings that
1823are specific to the Conexant CX23415 and CX23416 MPEG encoding chips.
1824
1825
1826.. _cx2341x-control-id:
1827
1828CX2341x Control IDs
1829-------------------
1830
1831.. _v4l2-mpeg-cx2341x-video-spatial-filter-mode:
1832
1833``V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE``
1834    (enum)
1835
1836enum v4l2_mpeg_cx2341x_video_spatial_filter_mode -
1837    Sets the Spatial Filter mode (default ``MANUAL``). Possible values
1838    are:
1839
1840
1841.. tabularcolumns:: |p{11.5cm}|p{6.0cm}|
1842
1843.. flat-table::
1844    :header-rows:  0
1845    :stub-columns: 0
1846
1847    * - ``V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL``
1848      - Choose the filter manually
1849    * - ``V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO``
1850      - Choose the filter automatically
1851
1852
1853
1854``V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER (integer (0-15))``
1855    The setting for the Spatial Filter. 0 = off, 15 = maximum. (Default
1856    is 0.)
1857
1858.. _luma-spatial-filter-type:
1859
1860``V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE``
1861    (enum)
1862
1863enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type -
1864    Select the algorithm to use for the Luma Spatial Filter (default
1865    ``1D_HOR``). Possible values:
1866
1867.. tabularcolumns:: |p{13.1cm}|p{4.4cm}|
1868
1869.. raw:: latex
1870
1871    \footnotesize
1872
1873.. flat-table::
1874    :header-rows:  0
1875    :stub-columns: 0
1876
1877    * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF``
1878      - No filter
1879    * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR``
1880      - One-dimensional horizontal
1881    * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT``
1882      - One-dimensional vertical
1883    * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE``
1884      - Two-dimensional separable
1885    * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE``
1886      - Two-dimensional symmetrical non-separable
1887
1888.. raw:: latex
1889
1890    \normalsize
1891
1892.. _chroma-spatial-filter-type:
1893
1894``V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE``
1895    (enum)
1896
1897enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type -
1898    Select the algorithm for the Chroma Spatial Filter (default
1899    ``1D_HOR``). Possible values are:
1900
1901.. raw:: latex
1902
1903    \footnotesize
1904
1905.. tabularcolumns:: |p{11.0cm}|p{6.5cm}|
1906
1907.. flat-table::
1908    :header-rows:  0
1909    :stub-columns: 0
1910
1911    * - ``V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF``
1912      - No filter
1913    * - ``V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR``
1914      - One-dimensional horizontal
1915
1916.. raw:: latex
1917
1918    \normalsize
1919
1920.. _v4l2-mpeg-cx2341x-video-temporal-filter-mode:
1921
1922``V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE``
1923    (enum)
1924
1925enum v4l2_mpeg_cx2341x_video_temporal_filter_mode -
1926    Sets the Temporal Filter mode (default ``MANUAL``). Possible values
1927    are:
1928
1929.. raw:: latex
1930
1931    \footnotesize
1932
1933.. flat-table::
1934    :header-rows:  0
1935    :stub-columns: 0
1936
1937    * - ``V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL``
1938      - Choose the filter manually
1939    * - ``V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO``
1940      - Choose the filter automatically
1941
1942.. raw:: latex
1943
1944    \normalsize
1945
1946``V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER (integer (0-31))``
1947    The setting for the Temporal Filter. 0 = off, 31 = maximum. (Default
1948    is 8 for full-scale capturing and 0 for scaled capturing.)
1949
1950.. _v4l2-mpeg-cx2341x-video-median-filter-type:
1951
1952``V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE``
1953    (enum)
1954
1955enum v4l2_mpeg_cx2341x_video_median_filter_type -
1956    Median Filter Type (default ``OFF``). Possible values are:
1957
1958
1959.. raw:: latex
1960
1961    \small
1962
1963.. tabularcolumns:: |p{11.0cm}|p{6.5cm}|
1964
1965.. flat-table::
1966    :header-rows:  0
1967    :stub-columns: 0
1968
1969    * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF``
1970      - No filter
1971    * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR``
1972      - Horizontal filter
1973    * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT``
1974      - Vertical filter
1975    * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT``
1976      - Horizontal and vertical filter
1977    * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG``
1978      - Diagonal filter
1979
1980.. raw:: latex
1981
1982    \normalsize
1983
1984``V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM (integer (0-255))``
1985    Threshold above which the luminance median filter is enabled
1986    (default 0)
1987
1988``V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP (integer (0-255))``
1989    Threshold below which the luminance median filter is enabled
1990    (default 255)
1991
1992``V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM (integer (0-255))``
1993    Threshold above which the chroma median filter is enabled (default
1994    0)
1995
1996``V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP (integer (0-255))``
1997    Threshold below which the chroma median filter is enabled (default
1998    255)
1999
2000``V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS (boolean)``
2001    The CX2341X MPEG encoder can insert one empty MPEG-2 PES packet into
2002    the stream between every four video frames. The packet size is 2048
2003    bytes, including the packet_start_code_prefix and stream_id
2004    fields. The stream_id is 0xBF (private stream 2). The payload
2005    consists of 0x00 bytes, to be filled in by the application. 0 = do
2006    not insert, 1 = insert packets.
2007
2008
2009VPX Control Reference
2010=====================
2011
2012The VPX controls include controls for encoding parameters of VPx video
2013codec.
2014
2015
2016.. _vpx-control-id:
2017
2018VPX Control IDs
2019---------------
2020
2021.. _v4l2-vpx-num-partitions:
2022
2023``V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS``
2024    (enum)
2025
2026enum v4l2_vp8_num_partitions -
2027    The number of token partitions to use in VP8 encoder. Possible
2028    values are:
2029
2030
2031
2032.. flat-table::
2033    :header-rows:  0
2034    :stub-columns: 0
2035
2036    * - ``V4L2_CID_MPEG_VIDEO_VPX_1_PARTITION``
2037      - 1 coefficient partition
2038    * - ``V4L2_CID_MPEG_VIDEO_VPX_2_PARTITIONS``
2039      - 2 coefficient partitions
2040    * - ``V4L2_CID_MPEG_VIDEO_VPX_4_PARTITIONS``
2041      - 4 coefficient partitions
2042    * - ``V4L2_CID_MPEG_VIDEO_VPX_8_PARTITIONS``
2043      - 8 coefficient partitions
2044
2045
2046
2047``V4L2_CID_MPEG_VIDEO_VPX_IMD_DISABLE_4X4 (boolean)``
2048    Setting this prevents intra 4x4 mode in the intra mode decision.
2049
2050.. _v4l2-vpx-num-ref-frames:
2051
2052``V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES``
2053    (enum)
2054
2055enum v4l2_vp8_num_ref_frames -
2056    The number of reference pictures for encoding P frames. Possible
2057    values are:
2058
2059.. tabularcolumns:: |p{7.5cm}|p{7.5cm}|
2060
2061.. raw:: latex
2062
2063    \small
2064
2065.. flat-table::
2066    :header-rows:  0
2067    :stub-columns: 0
2068
2069    * - ``V4L2_CID_MPEG_VIDEO_VPX_1_REF_FRAME``
2070      - Last encoded frame will be searched
2071    * - ``V4L2_CID_MPEG_VIDEO_VPX_2_REF_FRAME``
2072      - Two frames will be searched among the last encoded frame, the
2073	golden frame and the alternate reference (altref) frame. The
2074	encoder implementation will decide which two are chosen.
2075    * - ``V4L2_CID_MPEG_VIDEO_VPX_3_REF_FRAME``
2076      - The last encoded frame, the golden frame and the altref frame will
2077	be searched.
2078
2079.. raw:: latex
2080
2081    \normalsize
2082
2083
2084
2085``V4L2_CID_MPEG_VIDEO_VPX_FILTER_LEVEL (integer)``
2086    Indicates the loop filter level. The adjustment of the loop filter
2087    level is done via a delta value against a baseline loop filter
2088    value.
2089
2090``V4L2_CID_MPEG_VIDEO_VPX_FILTER_SHARPNESS (integer)``
2091    This parameter affects the loop filter. Anything above zero weakens
2092    the deblocking effect on the loop filter.
2093
2094``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD (integer)``
2095    Sets the refresh period for the golden frame. The period is defined
2096    in number of frames. For a value of 'n', every nth frame starting
2097    from the first key frame will be taken as a golden frame. For eg.
2098    for encoding sequence of 0, 1, 2, 3, 4, 5, 6, 7 where the golden
2099    frame refresh period is set as 4, the frames 0, 4, 8 etc will be
2100    taken as the golden frames as frame 0 is always a key frame.
2101
2102.. _v4l2-vpx-golden-frame-sel:
2103
2104``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL``
2105    (enum)
2106
2107enum v4l2_vp8_golden_frame_sel -
2108    Selects the golden frame for encoding. Possible values are:
2109
2110.. raw:: latex
2111
2112    \scriptsize
2113
2114.. tabularcolumns:: |p{8.6cm}|p{8.9cm}|
2115
2116.. flat-table::
2117    :header-rows:  0
2118    :stub-columns: 0
2119
2120    * - ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_PREV``
2121      - Use the (n-2)th frame as a golden frame, current frame index being
2122	'n'.
2123    * - ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_REF_PERIOD``
2124      - Use the previous specific frame indicated by
2125	``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD`` as a
2126	golden frame.
2127
2128.. raw:: latex
2129
2130    \normalsize
2131
2132
2133``V4L2_CID_MPEG_VIDEO_VPX_MIN_QP (integer)``
2134    Minimum quantization parameter for VP8.
2135
2136``V4L2_CID_MPEG_VIDEO_VPX_MAX_QP (integer)``
2137    Maximum quantization parameter for VP8.
2138
2139``V4L2_CID_MPEG_VIDEO_VPX_I_FRAME_QP (integer)``
2140    Quantization parameter for an I frame for VP8.
2141
2142``V4L2_CID_MPEG_VIDEO_VPX_P_FRAME_QP (integer)``
2143    Quantization parameter for a P frame for VP8.
2144
2145.. _v4l2-mpeg-video-vp8-profile:
2146
2147``V4L2_CID_MPEG_VIDEO_VP8_PROFILE``
2148    (enum)
2149
2150enum v4l2_mpeg_video_vp8_profile -
2151    This control allows selecting the profile for VP8 encoder.
2152    This is also used to enumerate supported profiles by VP8 encoder or decoder.
2153    Possible values are:
2154
2155.. flat-table::
2156    :header-rows:  0
2157    :stub-columns: 0
2158
2159    * - ``V4L2_MPEG_VIDEO_VP8_PROFILE_0``
2160      - Profile 0
2161    * - ``V4L2_MPEG_VIDEO_VP8_PROFILE_1``
2162      - Profile 1
2163    * - ``V4L2_MPEG_VIDEO_VP8_PROFILE_2``
2164      - Profile 2
2165    * - ``V4L2_MPEG_VIDEO_VP8_PROFILE_3``
2166      - Profile 3
2167
2168.. _v4l2-mpeg-video-vp9-profile:
2169
2170``V4L2_CID_MPEG_VIDEO_VP9_PROFILE``
2171    (enum)
2172
2173enum v4l2_mpeg_video_vp9_profile -
2174    This control allows selecting the profile for VP9 encoder.
2175    This is also used to enumerate supported profiles by VP9 encoder or decoder.
2176    Possible values are:
2177
2178.. flat-table::
2179    :header-rows:  0
2180    :stub-columns: 0
2181
2182    * - ``V4L2_MPEG_VIDEO_VP9_PROFILE_0``
2183      - Profile 0
2184    * - ``V4L2_MPEG_VIDEO_VP9_PROFILE_1``
2185      - Profile 1
2186    * - ``V4L2_MPEG_VIDEO_VP9_PROFILE_2``
2187      - Profile 2
2188    * - ``V4L2_MPEG_VIDEO_VP9_PROFILE_3``
2189      - Profile 3
2190
2191.. _v4l2-mpeg-video-vp9-level:
2192
2193``V4L2_CID_MPEG_VIDEO_VP9_LEVEL (enum)``
2194
2195enum v4l2_mpeg_video_vp9_level -
2196    This control allows selecting the level for VP9 encoder.
2197    This is also used to enumerate supported levels by VP9 encoder or decoder.
2198    More information can be found at
2199    `webmproject <https://www.webmproject.org/vp9/levels/>`__. Possible values are:
2200
2201.. flat-table::
2202    :header-rows:  0
2203    :stub-columns: 0
2204
2205    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_1_0``
2206      - Level 1
2207    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_1_1``
2208      - Level 1.1
2209    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_2_0``
2210      - Level 2
2211    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_2_1``
2212      - Level 2.1
2213    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_3_0``
2214      - Level 3
2215    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_3_1``
2216      - Level 3.1
2217    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_4_0``
2218      - Level 4
2219    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_4_1``
2220      - Level 4.1
2221    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_5_0``
2222      - Level 5
2223    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_5_1``
2224      - Level 5.1
2225    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_5_2``
2226      - Level 5.2
2227    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_6_0``
2228      - Level 6
2229    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_6_1``
2230      - Level 6.1
2231    * - ``V4L2_MPEG_VIDEO_VP9_LEVEL_6_2``
2232      - Level 6.2
2233
2234
2235High Efficiency Video Coding (HEVC/H.265) Control Reference
2236===========================================================
2237
2238The HEVC/H.265 controls include controls for encoding parameters of HEVC/H.265
2239video codec.
2240
2241
2242.. _hevc-control-id:
2243
2244HEVC/H.265 Control IDs
2245----------------------
2246
2247``V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP (integer)``
2248    Minimum quantization parameter for HEVC.
2249    Valid range: from 0 to 51 for 8 bit and from 0 to 63 for 10 bit.
2250
2251``V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP (integer)``
2252    Maximum quantization parameter for HEVC.
2253    Valid range: from 0 to 51 for 8 bit and from 0 to 63 for 10 bit.
2254
2255``V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_QP (integer)``
2256    Quantization parameter for an I frame for HEVC.
2257    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2258    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2259
2260``V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_QP (integer)``
2261    Quantization parameter for a P frame for HEVC.
2262    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2263    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2264
2265``V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_QP (integer)``
2266    Quantization parameter for a B frame for HEVC.
2267    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2268    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2269
2270``V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MIN_QP (integer)``
2271    Minimum quantization parameter for the HEVC I frame to limit I frame
2272    quality to a range. Valid range: from 0 to 51 for 8 bit and from 0 to 63 for 10 bit.
2273    If V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP is also set, the quantization parameter
2274    should be chosen to meet both requirements.
2275
2276``V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MAX_QP (integer)``
2277    Maximum quantization parameter for the HEVC I frame to limit I frame
2278    quality to a range. Valid range: from 0 to 51 for 8 bit and from 0 to 63 for 10 bit.
2279    If V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP is also set, the quantization parameter
2280    should be chosen to meet both requirements.
2281
2282``V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MIN_QP (integer)``
2283    Minimum quantization parameter for the HEVC P frame to limit P frame
2284    quality to a range. Valid range: from 0 to 51 for 8 bit and from 0 to 63 for 10 bit.
2285    If V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP is also set, the quantization parameter
2286    should be chosen to meet both requirements.
2287
2288``V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MAX_QP (integer)``
2289    Maximum quantization parameter for the HEVC P frame to limit P frame
2290    quality to a range. Valid range: from 0 to 51 for 8 bit and from 0 to 63 for 10 bit.
2291    If V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP is also set, the quantization parameter
2292    should be chosen to meet both requirements.
2293
2294``V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MIN_QP (integer)``
2295    Minimum quantization parameter for the HEVC B frame to limit B frame
2296    quality to a range. Valid range: from 0 to 51 for 8 bit and from 0 to 63 for 10 bit.
2297    If V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP is also set, the quantization parameter
2298    should be chosen to meet both requirements.
2299
2300``V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MAX_QP (integer)``
2301    Maximum quantization parameter for the HEVC B frame to limit B frame
2302    quality to a range. Valid range: from 0 to 51 for 8 bit and from 0 to 63 for 10 bit.
2303    If V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP is also set, the quantization parameter
2304    should be chosen to meet both requirements.
2305
2306``V4L2_CID_MPEG_VIDEO_HEVC_HIER_QP (boolean)``
2307    HIERARCHICAL_QP allows the host to specify the quantization parameter
2308    values for each temporal layer through HIERARCHICAL_QP_LAYER. This is
2309    valid only if HIERARCHICAL_CODING_LAYER is greater than 1. Setting the
2310    control value to 1 enables setting of the QP values for the layers.
2311
2312.. _v4l2-hevc-hier-coding-type:
2313
2314``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_TYPE``
2315    (enum)
2316
2317enum v4l2_mpeg_video_hevc_hier_coding_type -
2318    Selects the hierarchical coding type for encoding. Possible values are:
2319
2320.. raw:: latex
2321
2322    \footnotesize
2323
2324.. tabularcolumns:: |p{8.2cm}|p{9.3cm}|
2325
2326.. flat-table::
2327    :header-rows:  0
2328    :stub-columns: 0
2329
2330    * - ``V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_B``
2331      - Use the B frame for hierarchical coding.
2332    * - ``V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_P``
2333      - Use the P frame for hierarchical coding.
2334
2335.. raw:: latex
2336
2337    \normalsize
2338
2339
2340``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_LAYER (integer)``
2341    Selects the hierarchical coding layer. In normal encoding
2342    (non-hierarchial coding), it should be zero. Possible values are [0, 6].
2343    0 indicates HIERARCHICAL CODING LAYER 0, 1 indicates HIERARCHICAL CODING
2344    LAYER 1 and so on.
2345
2346``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_QP (integer)``
2347    Indicates quantization parameter for hierarchical coding layer 0.
2348    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2349    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2350
2351``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_QP (integer)``
2352    Indicates quantization parameter for hierarchical coding layer 1.
2353    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2354    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2355
2356``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_QP (integer)``
2357    Indicates quantization parameter for hierarchical coding layer 2.
2358    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2359    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2360
2361``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_QP (integer)``
2362    Indicates quantization parameter for hierarchical coding layer 3.
2363    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2364    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2365
2366``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_QP (integer)``
2367    Indicates quantization parameter for hierarchical coding layer 4.
2368    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2369    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2370
2371``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_QP (integer)``
2372    Indicates quantization parameter for hierarchical coding layer 5.
2373    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2374    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2375
2376``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_QP (integer)``
2377    Indicates quantization parameter for hierarchical coding layer 6.
2378    Valid range: [V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP,
2379    V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP].
2380
2381.. _v4l2-hevc-profile:
2382
2383``V4L2_CID_MPEG_VIDEO_HEVC_PROFILE``
2384    (enum)
2385
2386enum v4l2_mpeg_video_hevc_profile -
2387    Select the desired profile for HEVC encoder.
2388
2389.. raw:: latex
2390
2391    \footnotesize
2392
2393.. tabularcolumns:: |p{9.0cm}|p{8.5cm}|
2394
2395.. flat-table::
2396    :header-rows:  0
2397    :stub-columns: 0
2398
2399    * - ``V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN``
2400      - Main profile.
2401    * - ``V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_STILL_PICTURE``
2402      - Main still picture profile.
2403    * - ``V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_10``
2404      - Main 10 profile.
2405
2406.. raw:: latex
2407
2408    \normalsize
2409
2410
2411.. _v4l2-hevc-level:
2412
2413``V4L2_CID_MPEG_VIDEO_HEVC_LEVEL``
2414    (enum)
2415
2416enum v4l2_mpeg_video_hevc_level -
2417    Selects the desired level for HEVC encoder.
2418
2419==================================	=========
2420``V4L2_MPEG_VIDEO_HEVC_LEVEL_1``	Level 1.0
2421``V4L2_MPEG_VIDEO_HEVC_LEVEL_2``	Level 2.0
2422``V4L2_MPEG_VIDEO_HEVC_LEVEL_2_1``	Level 2.1
2423``V4L2_MPEG_VIDEO_HEVC_LEVEL_3``	Level 3.0
2424``V4L2_MPEG_VIDEO_HEVC_LEVEL_3_1``	Level 3.1
2425``V4L2_MPEG_VIDEO_HEVC_LEVEL_4``	Level 4.0
2426``V4L2_MPEG_VIDEO_HEVC_LEVEL_4_1``	Level 4.1
2427``V4L2_MPEG_VIDEO_HEVC_LEVEL_5``	Level 5.0
2428``V4L2_MPEG_VIDEO_HEVC_LEVEL_5_1``	Level 5.1
2429``V4L2_MPEG_VIDEO_HEVC_LEVEL_5_2``	Level 5.2
2430``V4L2_MPEG_VIDEO_HEVC_LEVEL_6``	Level 6.0
2431``V4L2_MPEG_VIDEO_HEVC_LEVEL_6_1``	Level 6.1
2432``V4L2_MPEG_VIDEO_HEVC_LEVEL_6_2``	Level 6.2
2433==================================	=========
2434
2435``V4L2_CID_MPEG_VIDEO_HEVC_FRAME_RATE_RESOLUTION (integer)``
2436    Indicates the number of evenly spaced subintervals, called ticks, within
2437    one second. This is a 16 bit unsigned integer and has a maximum value up to
2438    0xffff and a minimum value of 1.
2439
2440.. _v4l2-hevc-tier:
2441
2442``V4L2_CID_MPEG_VIDEO_HEVC_TIER``
2443    (enum)
2444
2445enum v4l2_mpeg_video_hevc_tier -
2446    TIER_FLAG specifies tiers information of the HEVC encoded picture. Tier
2447    were made to deal with applications that differ in terms of maximum bit
2448    rate. Setting the flag to 0 selects HEVC tier as Main tier and setting
2449    this flag to 1 indicates High tier. High tier is for applications requiring
2450    high bit rates.
2451
2452==================================	==========
2453``V4L2_MPEG_VIDEO_HEVC_TIER_MAIN``	Main tier.
2454``V4L2_MPEG_VIDEO_HEVC_TIER_HIGH``	High tier.
2455==================================	==========
2456
2457
2458``V4L2_CID_MPEG_VIDEO_HEVC_MAX_PARTITION_DEPTH (integer)``
2459    Selects HEVC maximum coding unit depth.
2460
2461.. _v4l2-hevc-loop-filter-mode:
2462
2463``V4L2_CID_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE``
2464    (enum)
2465
2466enum v4l2_mpeg_video_hevc_loop_filter_mode -
2467    Loop filter mode for HEVC encoder. Possible values are:
2468
2469.. raw:: latex
2470
2471    \footnotesize
2472
2473.. tabularcolumns:: |p{12.1cm}|p{5.4cm}|
2474
2475.. flat-table::
2476    :header-rows:  0
2477    :stub-columns: 0
2478
2479    * - ``V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED``
2480      - Loop filter is disabled.
2481    * - ``V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_ENABLED``
2482      - Loop filter is enabled.
2483    * - ``V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY``
2484      - Loop filter is disabled at the slice boundary.
2485
2486.. raw:: latex
2487
2488    \normalsize
2489
2490
2491``V4L2_CID_MPEG_VIDEO_HEVC_LF_BETA_OFFSET_DIV2 (integer)``
2492    Selects HEVC loop filter beta offset. The valid range is [-6, +6].
2493
2494``V4L2_CID_MPEG_VIDEO_HEVC_LF_TC_OFFSET_DIV2 (integer)``
2495    Selects HEVC loop filter tc offset. The valid range is [-6, +6].
2496
2497.. _v4l2-hevc-refresh-type:
2498
2499``V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_TYPE``
2500    (enum)
2501
2502enum v4l2_mpeg_video_hevc_hier_refresh_type -
2503    Selects refresh type for HEVC encoder.
2504    Host has to specify the period into
2505    V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_PERIOD.
2506
2507.. raw:: latex
2508
2509    \footnotesize
2510
2511.. tabularcolumns:: |p{6.2cm}|p{11.3cm}|
2512
2513.. flat-table::
2514    :header-rows:  0
2515    :stub-columns: 0
2516
2517    * - ``V4L2_MPEG_VIDEO_HEVC_REFRESH_NONE``
2518      - Use the B frame for hierarchical coding.
2519    * - ``V4L2_MPEG_VIDEO_HEVC_REFRESH_CRA``
2520      - Use CRA (Clean Random Access Unit) picture encoding.
2521    * - ``V4L2_MPEG_VIDEO_HEVC_REFRESH_IDR``
2522      - Use IDR (Instantaneous Decoding Refresh) picture encoding.
2523
2524.. raw:: latex
2525
2526    \normalsize
2527
2528
2529``V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_PERIOD (integer)``
2530    Selects the refresh period for HEVC encoder.
2531    This specifies the number of I pictures between two CRA/IDR pictures.
2532    This is valid only if REFRESH_TYPE is not 0.
2533
2534``V4L2_CID_MPEG_VIDEO_HEVC_LOSSLESS_CU (boolean)``
2535    Indicates HEVC lossless encoding. Setting it to 0 disables lossless
2536    encoding. Setting it to 1 enables lossless encoding.
2537
2538``V4L2_CID_MPEG_VIDEO_HEVC_CONST_INTRA_PRED (boolean)``
2539    Indicates constant intra prediction for HEVC encoder. Specifies the
2540    constrained intra prediction in which intra largest coding unit (LCU)
2541    prediction is performed by using residual data and decoded samples of
2542    neighboring intra LCU only. Setting the value to 1 enables constant intra
2543    prediction and setting the value to 0 disables constant intra prediction.
2544
2545``V4L2_CID_MPEG_VIDEO_HEVC_WAVEFRONT (boolean)``
2546    Indicates wavefront parallel processing for HEVC encoder. Setting it to 0
2547    disables the feature and setting it to 1 enables the wavefront parallel
2548    processing.
2549
2550``V4L2_CID_MPEG_VIDEO_HEVC_GENERAL_PB (boolean)``
2551    Setting the value to 1 enables combination of P and B frame for HEVC
2552    encoder.
2553
2554``V4L2_CID_MPEG_VIDEO_HEVC_TEMPORAL_ID (boolean)``
2555    Indicates temporal identifier for HEVC encoder which is enabled by
2556    setting the value to 1.
2557
2558``V4L2_CID_MPEG_VIDEO_HEVC_STRONG_SMOOTHING (boolean)``
2559    Indicates bi-linear interpolation is conditionally used in the intra
2560    prediction filtering process in the CVS when set to 1. Indicates bi-linear
2561    interpolation is not used in the CVS when set to 0.
2562
2563``V4L2_CID_MPEG_VIDEO_HEVC_MAX_NUM_MERGE_MV_MINUS1 (integer)``
2564    Indicates maximum number of merge candidate motion vectors.
2565    Values are from 0 to 4.
2566
2567``V4L2_CID_MPEG_VIDEO_HEVC_TMV_PREDICTION (boolean)``
2568    Indicates temporal motion vector prediction for HEVC encoder. Setting it to
2569    1 enables the prediction. Setting it to 0 disables the prediction.
2570
2571``V4L2_CID_MPEG_VIDEO_HEVC_WITHOUT_STARTCODE (boolean)``
2572    Specifies if HEVC generates a stream with a size of the length field
2573    instead of start code pattern. The size of the length field is configurable
2574    through the V4L2_CID_MPEG_VIDEO_HEVC_SIZE_OF_LENGTH_FIELD control. Setting
2575    the value to 0 disables encoding without startcode pattern. Setting the
2576    value to 1 will enables encoding without startcode pattern.
2577
2578.. _v4l2-hevc-size-of-length-field:
2579
2580``V4L2_CID_MPEG_VIDEO_HEVC_SIZE_OF_LENGTH_FIELD``
2581(enum)
2582
2583enum v4l2_mpeg_video_hevc_size_of_length_field -
2584    Indicates the size of length field.
2585    This is valid when encoding WITHOUT_STARTCODE_ENABLE is enabled.
2586
2587.. raw:: latex
2588
2589    \footnotesize
2590
2591.. tabularcolumns:: |p{5.5cm}|p{12.0cm}|
2592
2593.. flat-table::
2594    :header-rows:  0
2595    :stub-columns: 0
2596
2597    * - ``V4L2_MPEG_VIDEO_HEVC_SIZE_0``
2598      - Generate start code pattern (Normal).
2599    * - ``V4L2_MPEG_VIDEO_HEVC_SIZE_1``
2600      - Generate size of length field instead of start code pattern and length is 1.
2601    * - ``V4L2_MPEG_VIDEO_HEVC_SIZE_2``
2602      - Generate size of length field instead of start code pattern and length is 2.
2603    * - ``V4L2_MPEG_VIDEO_HEVC_SIZE_4``
2604      - Generate size of length field instead of start code pattern and length is 4.
2605
2606.. raw:: latex
2607
2608    \normalsize
2609
2610``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_BR (integer)``
2611    Indicates bit rate for hierarchical coding layer 0 for HEVC encoder.
2612
2613``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_BR (integer)``
2614    Indicates bit rate for hierarchical coding layer 1 for HEVC encoder.
2615
2616``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_BR (integer)``
2617    Indicates bit rate for hierarchical coding layer 2 for HEVC encoder.
2618
2619``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_BR (integer)``
2620    Indicates bit rate for hierarchical coding layer 3 for HEVC encoder.
2621
2622``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_BR (integer)``
2623    Indicates bit rate for hierarchical coding layer 4 for HEVC encoder.
2624
2625``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_BR (integer)``
2626    Indicates bit rate for hierarchical coding layer 5 for HEVC encoder.
2627
2628``V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_BR (integer)``
2629    Indicates bit rate for hierarchical coding layer 6 for HEVC encoder.
2630
2631``V4L2_CID_MPEG_VIDEO_REF_NUMBER_FOR_PFRAMES (integer)``
2632    Selects number of P reference pictures required for HEVC encoder.
2633    P-Frame can use 1 or 2 frames for reference.
2634
2635``V4L2_CID_MPEG_VIDEO_PREPEND_SPSPPS_TO_IDR (integer)``
2636    Indicates whether to generate SPS and PPS at every IDR. Setting it to 0
2637    disables generating SPS and PPS at every IDR. Setting it to one enables
2638    generating SPS and PPS at every IDR.
2639
2640.. _v4l2-mpeg-hevc:
2641
2642``V4L2_CID_MPEG_VIDEO_HEVC_SPS (struct)``
2643    Specifies the Sequence Parameter Set fields (as extracted from the
2644    bitstream) for the associated HEVC slice data.
2645    These bitstream parameters are defined according to :ref:`hevc`.
2646    They are described in section 7.4.3.2 "Sequence parameter set RBSP
2647    semantics" of the specification.
2648
2649.. c:type:: v4l2_ctrl_hevc_sps
2650
2651.. raw:: latex
2652
2653    \small
2654
2655.. tabularcolumns:: |p{1.2cm}|p{9.2cm}|p{6.9cm}|
2656
2657.. cssclass:: longtable
2658
2659.. flat-table:: struct v4l2_ctrl_hevc_sps
2660    :header-rows:  0
2661    :stub-columns: 0
2662    :widths:       1 1 2
2663
2664    * - __u16
2665      - ``pic_width_in_luma_samples``
2666      -
2667    * - __u16
2668      - ``pic_height_in_luma_samples``
2669      -
2670    * - __u8
2671      - ``bit_depth_luma_minus8``
2672      -
2673    * - __u8
2674      - ``bit_depth_chroma_minus8``
2675      -
2676    * - __u8
2677      - ``log2_max_pic_order_cnt_lsb_minus4``
2678      -
2679    * - __u8
2680      - ``sps_max_dec_pic_buffering_minus1``
2681      -
2682    * - __u8
2683      - ``sps_max_num_reorder_pics``
2684      -
2685    * - __u8
2686      - ``sps_max_latency_increase_plus1``
2687      -
2688    * - __u8
2689      - ``log2_min_luma_coding_block_size_minus3``
2690      -
2691    * - __u8
2692      - ``log2_diff_max_min_luma_coding_block_size``
2693      -
2694    * - __u8
2695      - ``log2_min_luma_transform_block_size_minus2``
2696      -
2697    * - __u8
2698      - ``log2_diff_max_min_luma_transform_block_size``
2699      -
2700    * - __u8
2701      - ``max_transform_hierarchy_depth_inter``
2702      -
2703    * - __u8
2704      - ``max_transform_hierarchy_depth_intra``
2705      -
2706    * - __u8
2707      - ``pcm_sample_bit_depth_luma_minus1``
2708      -
2709    * - __u8
2710      - ``pcm_sample_bit_depth_chroma_minus1``
2711      -
2712    * - __u8
2713      - ``log2_min_pcm_luma_coding_block_size_minus3``
2714      -
2715    * - __u8
2716      - ``log2_diff_max_min_pcm_luma_coding_block_size``
2717      -
2718    * - __u8
2719      - ``num_short_term_ref_pic_sets``
2720      -
2721    * - __u8
2722      - ``num_long_term_ref_pics_sps``
2723      -
2724    * - __u8
2725      - ``chroma_format_idc``
2726      -
2727    * - __u8
2728      - ``sps_max_sub_layers_minus1``
2729      -
2730    * - __u64
2731      - ``flags``
2732      - See :ref:`Sequence Parameter Set Flags <hevc_sps_flags>`
2733
2734.. raw:: latex
2735
2736    \normalsize
2737
2738.. _hevc_sps_flags:
2739
2740``Sequence Parameter Set Flags``
2741
2742.. raw:: latex
2743
2744    \small
2745
2746.. cssclass:: longtable
2747
2748.. flat-table::
2749    :header-rows:  0
2750    :stub-columns: 0
2751    :widths:       1 1 2
2752
2753    * - ``V4L2_HEVC_SPS_FLAG_SEPARATE_COLOUR_PLANE``
2754      - 0x00000001
2755      -
2756    * - ``V4L2_HEVC_SPS_FLAG_SCALING_LIST_ENABLED``
2757      - 0x00000002
2758      -
2759    * - ``V4L2_HEVC_SPS_FLAG_AMP_ENABLED``
2760      - 0x00000004
2761      -
2762    * - ``V4L2_HEVC_SPS_FLAG_SAMPLE_ADAPTIVE_OFFSET``
2763      - 0x00000008
2764      -
2765    * - ``V4L2_HEVC_SPS_FLAG_PCM_ENABLED``
2766      - 0x00000010
2767      -
2768    * - ``V4L2_HEVC_SPS_FLAG_PCM_LOOP_FILTER_DISABLED``
2769      - 0x00000020
2770      -
2771    * - ``V4L2_HEVC_SPS_FLAG_LONG_TERM_REF_PICS_PRESENT``
2772      - 0x00000040
2773      -
2774    * - ``V4L2_HEVC_SPS_FLAG_SPS_TEMPORAL_MVP_ENABLED``
2775      - 0x00000080
2776      -
2777    * - ``V4L2_HEVC_SPS_FLAG_STRONG_INTRA_SMOOTHING_ENABLED``
2778      - 0x00000100
2779      -
2780
2781.. raw:: latex
2782
2783    \normalsize
2784
2785``V4L2_CID_MPEG_VIDEO_HEVC_PPS (struct)``
2786    Specifies the Picture Parameter Set fields (as extracted from the
2787    bitstream) for the associated HEVC slice data.
2788    These bitstream parameters are defined according to :ref:`hevc`.
2789    They are described in section 7.4.3.3 "Picture parameter set RBSP
2790    semantics" of the specification.
2791
2792.. c:type:: v4l2_ctrl_hevc_pps
2793
2794.. tabularcolumns:: |p{1.2cm}|p{8.6cm}|p{7.5cm}|
2795
2796.. cssclass:: longtable
2797
2798.. flat-table:: struct v4l2_ctrl_hevc_pps
2799    :header-rows:  0
2800    :stub-columns: 0
2801    :widths:       1 1 2
2802
2803    * - __u8
2804      - ``num_extra_slice_header_bits``
2805      -
2806    * - __u8
2807      - ``num_ref_idx_l0_default_active_minus1``
2808      - Specifies the inferred value of num_ref_idx_l0_active_minus1
2809    * - __u8
2810      - ``num_ref_idx_l1_default_active_minus1``
2811      - Specifies the inferred value of num_ref_idx_l1_active_minus1
2812    * - __s8
2813      - ``init_qp_minus26``
2814      -
2815    * - __u8
2816      - ``diff_cu_qp_delta_depth``
2817      -
2818    * - __s8
2819      - ``pps_cb_qp_offset``
2820      -
2821    * - __s8
2822      - ``pps_cr_qp_offset``
2823      -
2824    * - __u8
2825      - ``num_tile_columns_minus1``
2826      -
2827    * - __u8
2828      - ``num_tile_rows_minus1``
2829      -
2830    * - __u8
2831      - ``column_width_minus1[20]``
2832      -
2833    * - __u8
2834      - ``row_height_minus1[22]``
2835      -
2836    * - __s8
2837      - ``pps_beta_offset_div2``
2838      -
2839    * - __s8
2840      - ``pps_tc_offset_div2``
2841      -
2842    * - __u8
2843      - ``log2_parallel_merge_level_minus2``
2844      -
2845    * - __u8
2846      - ``padding[4]``
2847      - Applications and drivers must set this to zero.
2848    * - __u64
2849      - ``flags``
2850      - See :ref:`Picture Parameter Set Flags <hevc_pps_flags>`
2851
2852.. _hevc_pps_flags:
2853
2854``Picture Parameter Set Flags``
2855
2856.. raw:: latex
2857
2858    \small
2859
2860.. flat-table::
2861    :header-rows:  0
2862    :stub-columns: 0
2863    :widths:       1 1 2
2864
2865    * - ``V4L2_HEVC_PPS_FLAG_DEPENDENT_SLICE_SEGMENT_ENABLED``
2866      - 0x00000001
2867      -
2868    * - ``V4L2_HEVC_PPS_FLAG_OUTPUT_FLAG_PRESENT``
2869      - 0x00000002
2870      -
2871    * - ``V4L2_HEVC_PPS_FLAG_SIGN_DATA_HIDING_ENABLED``
2872      - 0x00000004
2873      -
2874    * - ``V4L2_HEVC_PPS_FLAG_CABAC_INIT_PRESENT``
2875      - 0x00000008
2876      -
2877    * - ``V4L2_HEVC_PPS_FLAG_CONSTRAINED_INTRA_PRED``
2878      - 0x00000010
2879      -
2880    * - ``V4L2_HEVC_PPS_FLAG_TRANSFORM_SKIP_ENABLED``
2881      - 0x00000020
2882      -
2883    * - ``V4L2_HEVC_PPS_FLAG_CU_QP_DELTA_ENABLED``
2884      - 0x00000040
2885      -
2886    * - ``V4L2_HEVC_PPS_FLAG_PPS_SLICE_CHROMA_QP_OFFSETS_PRESENT``
2887      - 0x00000080
2888      -
2889    * - ``V4L2_HEVC_PPS_FLAG_WEIGHTED_PRED``
2890      - 0x00000100
2891      -
2892    * - ``V4L2_HEVC_PPS_FLAG_WEIGHTED_BIPRED``
2893      - 0x00000200
2894      -
2895    * - ``V4L2_HEVC_PPS_FLAG_TRANSQUANT_BYPASS_ENABLED``
2896      - 0x00000400
2897      -
2898    * - ``V4L2_HEVC_PPS_FLAG_TILES_ENABLED``
2899      - 0x00000800
2900      -
2901    * - ``V4L2_HEVC_PPS_FLAG_ENTROPY_CODING_SYNC_ENABLED``
2902      - 0x00001000
2903      -
2904    * - ``V4L2_HEVC_PPS_FLAG_LOOP_FILTER_ACROSS_TILES_ENABLED``
2905      - 0x00002000
2906      -
2907    * - ``V4L2_HEVC_PPS_FLAG_PPS_LOOP_FILTER_ACROSS_SLICES_ENABLED``
2908      - 0x00004000
2909      -
2910    * - ``V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_OVERRIDE_ENABLED``
2911      - 0x00008000
2912      -
2913    * - ``V4L2_HEVC_PPS_FLAG_PPS_DISABLE_DEBLOCKING_FILTER``
2914      - 0x00010000
2915      -
2916    * - ``V4L2_HEVC_PPS_FLAG_LISTS_MODIFICATION_PRESENT``
2917      - 0x00020000
2918      -
2919    * - ``V4L2_HEVC_PPS_FLAG_SLICE_SEGMENT_HEADER_EXTENSION_PRESENT``
2920      - 0x00040000
2921      -
2922    * - ``V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT``
2923      - 0x00080000
2924      - Specifies the presence of deblocking filter control syntax elements in
2925        the PPS
2926    * - ``V4L2_HEVC_PPS_FLAG_UNIFORM_SPACING``
2927      - 0x00100000
2928      - Specifies that tile column boundaries and likewise tile row boundaries
2929        are distributed uniformly across the picture
2930
2931.. raw:: latex
2932
2933    \normalsize
2934
2935``V4L2_CID_MPEG_VIDEO_HEVC_SLICE_PARAMS (struct)``
2936    Specifies various slice-specific parameters, especially from the NAL unit
2937    header, general slice segment header and weighted prediction parameter
2938    parts of the bitstream.
2939    These bitstream parameters are defined according to :ref:`hevc`.
2940    They are described in section 7.4.7 "General slice segment header
2941    semantics" of the specification.
2942
2943.. c:type:: v4l2_ctrl_hevc_slice_params
2944
2945.. raw:: latex
2946
2947    \scriptsize
2948
2949.. tabularcolumns:: |p{5.4cm}|p{6.8cm}|p{5.1cm}|
2950
2951.. cssclass:: longtable
2952
2953.. flat-table:: struct v4l2_ctrl_hevc_slice_params
2954    :header-rows:  0
2955    :stub-columns: 0
2956    :widths:       1 1 2
2957
2958    * - __u32
2959      - ``bit_size``
2960      - Size (in bits) of the current slice data.
2961    * - __u32
2962      - ``data_bit_offset``
2963      - Offset (in bits) to the video data in the current slice data.
2964    * - __u8
2965      - ``nal_unit_type``
2966      -
2967    * - __u8
2968      - ``nuh_temporal_id_plus1``
2969      -
2970    * - __u8
2971      - ``slice_type``
2972      -
2973	(V4L2_HEVC_SLICE_TYPE_I, V4L2_HEVC_SLICE_TYPE_P or
2974	V4L2_HEVC_SLICE_TYPE_B).
2975    * - __u8
2976      - ``colour_plane_id``
2977      -
2978    * - __u16
2979      - ``slice_pic_order_cnt``
2980      -
2981    * - __u8
2982      - ``num_ref_idx_l0_active_minus1``
2983      -
2984    * - __u8
2985      - ``num_ref_idx_l1_active_minus1``
2986      -
2987    * - __u8
2988      - ``collocated_ref_idx``
2989      -
2990    * - __u8
2991      - ``five_minus_max_num_merge_cand``
2992      -
2993    * - __s8
2994      - ``slice_qp_delta``
2995      -
2996    * - __s8
2997      - ``slice_cb_qp_offset``
2998      -
2999    * - __s8
3000      - ``slice_cr_qp_offset``
3001      -
3002    * - __s8
3003      - ``slice_act_y_qp_offset``
3004      -
3005    * - __s8
3006      - ``slice_act_cb_qp_offset``
3007      -
3008    * - __s8
3009      - ``slice_act_cr_qp_offset``
3010      -
3011    * - __s8
3012      - ``slice_beta_offset_div2``
3013      -
3014    * - __s8
3015      - ``slice_tc_offset_div2``
3016      -
3017    * - __u8
3018      - ``pic_struct``
3019      -
3020    * - __u32
3021      - ``slice_segment_addr``
3022      -
3023    * - __u8
3024      - ``ref_idx_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3025      - The list of L0 reference elements as indices in the DPB.
3026    * - __u8
3027      - ``ref_idx_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3028      - The list of L1 reference elements as indices in the DPB.
3029    * - __u8
3030      - ``padding``
3031      - Applications and drivers must set this to zero.
3032    * - struct :c:type:`v4l2_hevc_pred_weight_table`
3033      - ``pred_weight_table``
3034      - The prediction weight coefficients for inter-picture prediction.
3035    * - __u64
3036      - ``flags``
3037      - See :ref:`Slice Parameters Flags <hevc_slice_params_flags>`
3038
3039.. raw:: latex
3040
3041    \normalsize
3042
3043.. _hevc_slice_params_flags:
3044
3045``Slice Parameters Flags``
3046
3047.. raw:: latex
3048
3049    \scriptsize
3050
3051.. flat-table::
3052    :header-rows:  0
3053    :stub-columns: 0
3054    :widths:       1 1 2
3055
3056    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_LUMA``
3057      - 0x00000001
3058      -
3059    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_CHROMA``
3060      - 0x00000002
3061      -
3062    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_TEMPORAL_MVP_ENABLED``
3063      - 0x00000004
3064      -
3065    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_MVD_L1_ZERO``
3066      - 0x00000008
3067      -
3068    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_CABAC_INIT``
3069      - 0x00000010
3070      -
3071    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_COLLOCATED_FROM_L0``
3072      - 0x00000020
3073      -
3074    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_USE_INTEGER_MV``
3075      - 0x00000040
3076      -
3077    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_DEBLOCKING_FILTER_DISABLED``
3078      - 0x00000080
3079      -
3080    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_LOOP_FILTER_ACROSS_SLICES_ENABLED``
3081      - 0x00000100
3082      -
3083    * - ``V4L2_HEVC_SLICE_PARAMS_FLAG_DEPENDENT_SLICE_SEGMENT``
3084      - 0x00000200
3085      -
3086
3087.. raw:: latex
3088
3089    \normalsize
3090
3091``V4L2_CID_MPEG_VIDEO_HEVC_SCALING_MATRIX (struct)``
3092    Specifies the HEVC scaling matrix parameters used for the scaling process
3093    for transform coefficients.
3094    These matrix and parameters are defined according to :ref:`hevc`.
3095    They are described in section 7.4.5 "Scaling list data semantics" of
3096    the specification.
3097
3098.. c:type:: v4l2_ctrl_hevc_scaling_matrix
3099
3100.. raw:: latex
3101
3102    \scriptsize
3103
3104.. tabularcolumns:: |p{5.4cm}|p{6.8cm}|p{5.1cm}|
3105
3106.. cssclass:: longtable
3107
3108.. flat-table:: struct v4l2_ctrl_hevc_scaling_matrix
3109    :header-rows:  0
3110    :stub-columns: 0
3111    :widths:       1 1 2
3112
3113    * - __u8
3114      - ``scaling_list_4x4[6][16]``
3115      - Scaling list is used for the scaling process for transform
3116        coefficients. The values on each scaling list are expected
3117        in raster scan order.
3118    * - __u8
3119      - ``scaling_list_8x8[6][64]``
3120      - Scaling list is used for the scaling process for transform
3121        coefficients. The values on each scaling list are expected
3122        in raster scan order.
3123    * - __u8
3124      - ``scaling_list_16x16[6][64]``
3125      - Scaling list is used for the scaling process for transform
3126        coefficients. The values on each scaling list are expected
3127        in raster scan order.
3128    * - __u8
3129      - ``scaling_list_32x32[2][64]``
3130      - Scaling list is used for the scaling process for transform
3131        coefficients. The values on each scaling list are expected
3132        in raster scan order.
3133    * - __u8
3134      - ``scaling_list_dc_coef_16x16[6]``
3135      - Scaling list is used for the scaling process for transform
3136        coefficients. The values on each scaling list are expected
3137        in raster scan order.
3138    * - __u8
3139      - ``scaling_list_dc_coef_32x32[2]``
3140      - Scaling list is used for the scaling process for transform
3141        coefficients. The values on each scaling list are expected
3142        in raster scan order.
3143
3144.. raw:: latex
3145
3146    \normalsize
3147
3148.. c:type:: v4l2_hevc_dpb_entry
3149
3150.. raw:: latex
3151
3152    \small
3153
3154.. tabularcolumns:: |p{1.0cm}|p{4.2cm}|p{12.1cm}|
3155
3156.. flat-table:: struct v4l2_hevc_dpb_entry
3157    :header-rows:  0
3158    :stub-columns: 0
3159    :widths:       1 1 2
3160
3161    * - __u64
3162      - ``timestamp``
3163      - Timestamp of the V4L2 capture buffer to use as reference, used
3164        with B-coded and P-coded frames. The timestamp refers to the
3165	``timestamp`` field in struct :c:type:`v4l2_buffer`. Use the
3166	:c:func:`v4l2_timeval_to_ns()` function to convert the struct
3167	:c:type:`timeval` in struct :c:type:`v4l2_buffer` to a __u64.
3168    * - __u8
3169      - ``flags``
3170      - Long term flag for the reference frame
3171        (V4L2_HEVC_DPB_ENTRY_LONG_TERM_REFERENCE). The flag is set as
3172        described in the ITU HEVC specification chapter "8.3.2 Decoding
3173        process for reference picture set".
3174    * - __u8
3175      - ``field_pic``
3176      - Whether the reference is a field picture or a frame.
3177    * - __u16
3178      - ``pic_order_cnt[2]``
3179      - The picture order count of the reference. Only the first element of the
3180        array is used for frame pictures, while the first element identifies the
3181        top field and the second the bottom field in field-coded pictures.
3182    * - __u8
3183      - ``padding[2]``
3184      - Applications and drivers must set this to zero.
3185
3186.. raw:: latex
3187
3188    \normalsize
3189
3190.. c:type:: v4l2_hevc_pred_weight_table
3191
3192.. raw:: latex
3193
3194    \footnotesize
3195
3196.. tabularcolumns:: |p{0.8cm}|p{10.6cm}|p{5.9cm}|
3197
3198.. flat-table:: struct v4l2_hevc_pred_weight_table
3199    :header-rows:  0
3200    :stub-columns: 0
3201    :widths:       1 1 2
3202
3203    * - __u8
3204      - ``luma_log2_weight_denom``
3205      -
3206    * - __s8
3207      - ``delta_chroma_log2_weight_denom``
3208      -
3209    * - __s8
3210      - ``delta_luma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3211      -
3212    * - __s8
3213      - ``luma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3214      -
3215    * - __s8
3216      - ``delta_chroma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2]``
3217      -
3218    * - __s8
3219      - ``chroma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2]``
3220      -
3221    * - __s8
3222      - ``delta_luma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3223      -
3224    * - __s8
3225      - ``luma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3226      -
3227    * - __s8
3228      - ``delta_chroma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2]``
3229      -
3230    * - __s8
3231      - ``chroma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2]``
3232      -
3233    * - __u8
3234      - ``padding[6]``
3235      - Applications and drivers must set this to zero.
3236
3237.. raw:: latex
3238
3239    \normalsize
3240
3241``V4L2_CID_MPEG_VIDEO_HEVC_DECODE_MODE (enum)``
3242    Specifies the decoding mode to use. Currently exposes slice-based and
3243    frame-based decoding but new modes might be added later on.
3244    This control is used as a modifier for V4L2_PIX_FMT_HEVC_SLICE
3245    pixel format. Applications that support V4L2_PIX_FMT_HEVC_SLICE
3246    are required to set this control in order to specify the decoding mode
3247    that is expected for the buffer.
3248    Drivers may expose a single or multiple decoding modes, depending
3249    on what they can support.
3250
3251    .. note::
3252
3253       This menu control is not yet part of the public kernel API and
3254       it is expected to change.
3255
3256.. c:type:: v4l2_mpeg_video_hevc_decode_mode
3257
3258.. raw:: latex
3259
3260    \small
3261
3262.. tabularcolumns:: |p{9.4cm}|p{0.6cm}|p{7.3cm}|
3263
3264.. flat-table::
3265    :header-rows:  0
3266    :stub-columns: 0
3267    :widths:       1 1 2
3268
3269    * - ``V4L2_MPEG_VIDEO_HEVC_DECODE_MODE_SLICE_BASED``
3270      - 0
3271      - Decoding is done at the slice granularity.
3272        The OUTPUT buffer must contain a single slice.
3273    * - ``V4L2_MPEG_VIDEO_HEVC_DECODE_MODE_FRAME_BASED``
3274      - 1
3275      - Decoding is done at the frame granularity.
3276        The OUTPUT buffer must contain all slices needed to decode the
3277        frame. The OUTPUT buffer must also contain both fields.
3278
3279.. raw:: latex
3280
3281    \normalsize
3282
3283``V4L2_CID_MPEG_VIDEO_HEVC_START_CODE (enum)``
3284    Specifies the HEVC slice start code expected for each slice.
3285    This control is used as a modifier for V4L2_PIX_FMT_HEVC_SLICE
3286    pixel format. Applications that support V4L2_PIX_FMT_HEVC_SLICE
3287    are required to set this control in order to specify the start code
3288    that is expected for the buffer.
3289    Drivers may expose a single or multiple start codes, depending
3290    on what they can support.
3291
3292    .. note::
3293
3294       This menu control is not yet part of the public kernel API and
3295       it is expected to change.
3296
3297.. c:type:: v4l2_mpeg_video_hevc_start_code
3298
3299.. tabularcolumns:: |p{9.2cm}|p{0.6cm}|p{7.5cm}|
3300
3301.. flat-table::
3302    :header-rows:  0
3303    :stub-columns: 0
3304    :widths:       1 1 2
3305
3306    * - ``V4L2_MPEG_VIDEO_HEVC_START_CODE_NONE``
3307      - 0
3308      - Selecting this value specifies that HEVC slices are passed
3309        to the driver without any start code. The bitstream data should be
3310        according to :ref:`hevc` 7.3.1.1 General NAL unit syntax, hence
3311        contains emulation prevention bytes when required.
3312    * - ``V4L2_MPEG_VIDEO_HEVC_START_CODE_ANNEX_B``
3313      - 1
3314      - Selecting this value specifies that HEVC slices are expected
3315        to be prefixed by Annex B start codes. According to :ref:`hevc`
3316        valid start codes can be 3-bytes 0x000001 or 4-bytes 0x00000001.
3317
3318``V4L2_CID_MPEG_VIDEO_BASELAYER_PRIORITY_ID (integer)``
3319    Specifies a priority identifier for the NAL unit, which will be applied to
3320    the base layer. By default this value is set to 0 for the base layer,
3321    and the next layer will have the priority ID assigned as 1, 2, 3 and so on.
3322    The video encoder can't decide the priority id to be applied to a layer,
3323    so this has to come from client.
3324    This is applicable to H264 and valid Range is from 0 to 63.
3325    Source Rec. ITU-T H.264 (06/2019); G.7.4.1.1, G.8.8.1.
3326
3327``V4L2_CID_MPEG_VIDEO_LTR_COUNT (integer)``
3328    Specifies the maximum number of Long Term Reference (LTR) frames at any
3329    given time that the encoder can keep.
3330    This is applicable to the H264 and HEVC encoders.
3331
3332``V4L2_CID_MPEG_VIDEO_FRAME_LTR_INDEX (integer)``
3333    After setting this control the frame that will be queued next
3334    will be marked as a Long Term Reference (LTR) frame
3335    and given this LTR index which ranges from 0 to LTR_COUNT-1.
3336    This is applicable to the H264 and HEVC encoders.
3337    Source Rec. ITU-T H.264 (06/2019); Table 7.9
3338
3339``V4L2_CID_MPEG_VIDEO_USE_LTR_FRAMES (bitmask)``
3340    Specifies the Long Term Reference (LTR) frame(s) to be used for
3341    encoding the next frame queued after setting this control.
3342    This provides a bitmask which consists of bits [0, LTR_COUNT-1].
3343    This is applicable to the H264 and HEVC encoders.
3344
3345``V4L2_CID_MPEG_VIDEO_HEVC_DECODE_PARAMS (struct)``
3346    Specifies various decode parameters, especially the references picture order
3347    count (POC) for all the lists (short, long, before, current, after) and the
3348    number of entries for each of them.
3349    These parameters are defined according to :ref:`hevc`.
3350    They are described in section 8.3 "Slice decoding process" of the
3351    specification.
3352
3353.. c:type:: v4l2_ctrl_hevc_decode_params
3354
3355.. cssclass:: longtable
3356
3357.. flat-table:: struct v4l2_ctrl_hevc_decode_params
3358    :header-rows:  0
3359    :stub-columns: 0
3360    :widths:       1 1 2
3361
3362    * - __s32
3363      - ``pic_order_cnt_val``
3364      - PicOrderCntVal as described in section 8.3.1 "Decoding process
3365        for picture order count" of the specification.
3366    * - __u8
3367      - ``num_active_dpb_entries``
3368      - The number of entries in ``dpb``.
3369    * - struct :c:type:`v4l2_hevc_dpb_entry`
3370      - ``dpb[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3371      - The decoded picture buffer, for meta-data about reference frames.
3372    * - __u8
3373      - ``num_poc_st_curr_before``
3374      - The number of reference pictures in the short-term set that come before
3375        the current frame.
3376    * - __u8
3377      - ``num_poc_st_curr_after``
3378      - The number of reference pictures in the short-term set that come after
3379        the current frame.
3380    * - __u8
3381      - ``num_poc_lt_curr``
3382      - The number of reference pictures in the long-term set.
3383    * - __u8
3384      - ``poc_st_curr_before[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3385      - PocStCurrBefore as described in section 8.3.2 "Decoding process for reference
3386        picture set": provides the index of the short term before references in DPB array.
3387    * - __u8
3388      - ``poc_st_curr_after[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3389      - PocStCurrAfter as described in section 8.3.2 "Decoding process for reference
3390        picture set": provides the index of the short term after references in DPB array.
3391    * - __u8
3392      - ``poc_lt_curr[V4L2_HEVC_DPB_ENTRIES_NUM_MAX]``
3393      - PocLtCurr as described in section 8.3.2 "Decoding process for reference
3394        picture set": provides the index of the long term references in DPB array.
3395    * - __u64
3396      - ``flags``
3397      - See :ref:`Decode Parameters Flags <hevc_decode_params_flags>`
3398
3399.. _hevc_decode_params_flags:
3400
3401``Decode Parameters Flags``
3402
3403.. cssclass:: longtable
3404
3405.. flat-table::
3406    :header-rows:  0
3407    :stub-columns: 0
3408    :widths:       1 1 2
3409
3410    * - ``V4L2_HEVC_DECODE_PARAM_FLAG_IRAP_PIC``
3411      - 0x00000001
3412      -
3413    * - ``V4L2_HEVC_DECODE_PARAM_FLAG_IDR_PIC``
3414      - 0x00000002
3415      -
3416    * - ``V4L2_HEVC_DECODE_PARAM_FLAG_NO_OUTPUT_OF_PRIOR``
3417      - 0x00000004
3418      -
3419