Lines Matching +full:sar +full:- +full:sensors
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _extended-controls:
71 it also allows for 64-bit values and pointers to be passed.
75 such as N-dimensional arrays and/or structures. You need to specify the
84 particular, this ioctl gives the dimensions of the N-dimensional array
113 .. code-block:: c
134 .. code-block:: c
144 The 32-bit ``qctrl.id`` value is subdivided into three bit ranges: the
150 non-zero for controls. The range of 0x1000 and up are reserved for
151 driver-specific controls. The macro ``V4L2_CTRL_ID2CLASS(id)`` returns
159 including driver-private controls.
173 The flags field of struct :ref:`v4l2_queryctrl <v4l2-queryctrl>` also
179 .. _mpeg-controls:
196 ----------------------
199 .. _mpeg-control-id:
210 .. _v4l2-mpeg-stream-type:
215 enum v4l2_mpeg_stream_type -
216 The MPEG-1, -2 or -4 output stream type. One cannot assume anything
223 .. flat-table::
224 :header-rows: 0
225 :stub-columns: 0
227 * - ``V4L2_MPEG_STREAM_TYPE_MPEG2_PS``
228 - MPEG-2 program stream
229 * - ``V4L2_MPEG_STREAM_TYPE_MPEG2_TS``
230 - MPEG-2 transport stream
231 * - ``V4L2_MPEG_STREAM_TYPE_MPEG1_SS``
232 - MPEG-1 system stream
233 * - ``V4L2_MPEG_STREAM_TYPE_MPEG2_DVD``
234 - MPEG-2 DVD-compatible stream
235 * - ``V4L2_MPEG_STREAM_TYPE_MPEG1_VCD``
236 - MPEG-1 VCD-compatible stream
237 * - ``V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD``
238 - MPEG-2 SVCD-compatible stream
262 .. _v4l2-mpeg-stream-vbi-fmt:
267 enum v4l2_mpeg_stream_vbi_fmt -
278 .. flat-table::
279 :header-rows: 0
280 :stub-columns: 0
282 * - ``V4L2_MPEG_STREAM_VBI_FMT_NONE``
283 - No VBI in the MPEG stream
284 * - ``V4L2_MPEG_STREAM_VBI_FMT_IVTV``
285 - VBI in private packets, IVTV format (documented in the kernel
287 ``Documentation/media/v4l-drivers/cx2341x.rst``)
291 .. _v4l2-mpeg-audio-sampling-freq:
296 enum v4l2_mpeg_audio_sampling_freq -
301 .. flat-table::
302 :header-rows: 0
303 :stub-columns: 0
305 * - ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100``
306 - 44.1 kHz
307 * - ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000``
308 - 48 kHz
309 * - ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000``
310 - 32 kHz
314 .. _v4l2-mpeg-audio-encoding:
319 enum v4l2_mpeg_audio_encoding -
325 .. flat-table::
326 :header-rows: 0
327 :stub-columns: 0
329 * - ``V4L2_MPEG_AUDIO_ENCODING_LAYER_1``
330 - MPEG-1/2 Layer I encoding
331 * - ``V4L2_MPEG_AUDIO_ENCODING_LAYER_2``
332 - MPEG-1/2 Layer II encoding
333 * - ``V4L2_MPEG_AUDIO_ENCODING_LAYER_3``
334 - MPEG-1/2 Layer III encoding
335 * - ``V4L2_MPEG_AUDIO_ENCODING_AAC``
336 - MPEG-2/4 AAC (Advanced Audio Coding)
337 * - ``V4L2_MPEG_AUDIO_ENCODING_AC3``
338 - AC-3 aka ATSC A/52 encoding
342 .. _v4l2-mpeg-audio-l1-bitrate:
347 enum v4l2_mpeg_audio_l1_bitrate -
348 MPEG-1/2 Layer I bitrate. Possible values are:
352 .. flat-table::
353 :header-rows: 0
354 :stub-columns: 0
356 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_32K``
357 - 32 kbit/s
358 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_64K``
359 - 64 kbit/s
360 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_96K``
361 - 96 kbit/s
362 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_128K``
363 - 128 kbit/s
364 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_160K``
365 - 160 kbit/s
366 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_192K``
367 - 192 kbit/s
368 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_224K``
369 - 224 kbit/s
370 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_256K``
371 - 256 kbit/s
372 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_288K``
373 - 288 kbit/s
374 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_320K``
375 - 320 kbit/s
376 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_352K``
377 - 352 kbit/s
378 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_384K``
379 - 384 kbit/s
380 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_416K``
381 - 416 kbit/s
382 * - ``V4L2_MPEG_AUDIO_L1_BITRATE_448K``
383 - 448 kbit/s
387 .. _v4l2-mpeg-audio-l2-bitrate:
392 enum v4l2_mpeg_audio_l2_bitrate -
393 MPEG-1/2 Layer II bitrate. Possible values are:
397 .. flat-table::
398 :header-rows: 0
399 :stub-columns: 0
401 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_32K``
402 - 32 kbit/s
403 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_48K``
404 - 48 kbit/s
405 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_56K``
406 - 56 kbit/s
407 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_64K``
408 - 64 kbit/s
409 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_80K``
410 - 80 kbit/s
411 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_96K``
412 - 96 kbit/s
413 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_112K``
414 - 112 kbit/s
415 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_128K``
416 - 128 kbit/s
417 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_160K``
418 - 160 kbit/s
419 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_192K``
420 - 192 kbit/s
421 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_224K``
422 - 224 kbit/s
423 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_256K``
424 - 256 kbit/s
425 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_320K``
426 - 320 kbit/s
427 * - ``V4L2_MPEG_AUDIO_L2_BITRATE_384K``
428 - 384 kbit/s
432 .. _v4l2-mpeg-audio-l3-bitrate:
437 enum v4l2_mpeg_audio_l3_bitrate -
438 MPEG-1/2 Layer III bitrate. Possible values are:
442 .. flat-table::
443 :header-rows: 0
444 :stub-columns: 0
446 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_32K``
447 - 32 kbit/s
448 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_40K``
449 - 40 kbit/s
450 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_48K``
451 - 48 kbit/s
452 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_56K``
453 - 56 kbit/s
454 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_64K``
455 - 64 kbit/s
456 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_80K``
457 - 80 kbit/s
458 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_96K``
459 - 96 kbit/s
460 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_112K``
461 - 112 kbit/s
462 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_128K``
463 - 128 kbit/s
464 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_160K``
465 - 160 kbit/s
466 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_192K``
467 - 192 kbit/s
468 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_224K``
469 - 224 kbit/s
470 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_256K``
471 - 256 kbit/s
472 * - ``V4L2_MPEG_AUDIO_L3_BITRATE_320K``
473 - 320 kbit/s
480 .. _v4l2-mpeg-audio-ac3-bitrate:
485 enum v4l2_mpeg_audio_ac3_bitrate -
486 AC-3 bitrate. Possible values are:
490 .. flat-table::
491 :header-rows: 0
492 :stub-columns: 0
494 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_32K``
495 - 32 kbit/s
496 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_40K``
497 - 40 kbit/s
498 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_48K``
499 - 48 kbit/s
500 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_56K``
501 - 56 kbit/s
502 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_64K``
503 - 64 kbit/s
504 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_80K``
505 - 80 kbit/s
506 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_96K``
507 - 96 kbit/s
508 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_112K``
509 - 112 kbit/s
510 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_128K``
511 - 128 kbit/s
512 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_160K``
513 - 160 kbit/s
514 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_192K``
515 - 192 kbit/s
516 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_224K``
517 - 224 kbit/s
518 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_256K``
519 - 256 kbit/s
520 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_320K``
521 - 320 kbit/s
522 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_384K``
523 - 384 kbit/s
524 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_448K``
525 - 448 kbit/s
526 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_512K``
527 - 512 kbit/s
528 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_576K``
529 - 576 kbit/s
530 * - ``V4L2_MPEG_AUDIO_AC3_BITRATE_640K``
531 - 640 kbit/s
535 .. _v4l2-mpeg-audio-mode:
540 enum v4l2_mpeg_audio_mode -
545 .. flat-table::
546 :header-rows: 0
547 :stub-columns: 0
549 * - ``V4L2_MPEG_AUDIO_MODE_STEREO``
550 - Stereo
551 * - ``V4L2_MPEG_AUDIO_MODE_JOINT_STEREO``
552 - Joint Stereo
553 * - ``V4L2_MPEG_AUDIO_MODE_DUAL``
554 - Bilingual
555 * - ``V4L2_MPEG_AUDIO_MODE_MONO``
556 - Mono
560 .. _v4l2-mpeg-audio-mode-extension:
565 enum v4l2_mpeg_audio_mode_extension -
572 .. flat-table::
573 :header-rows: 0
574 :stub-columns: 0
576 * - ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4``
577 - Subbands 4-31 in intensity stereo
578 * - ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8``
579 - Subbands 8-31 in intensity stereo
580 * - ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12``
581 - Subbands 12-31 in intensity stereo
582 * - ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16``
583 - Subbands 16-31 in intensity stereo
587 .. _v4l2-mpeg-audio-emphasis:
592 enum v4l2_mpeg_audio_emphasis -
597 .. flat-table::
598 :header-rows: 0
599 :stub-columns: 0
601 * - ``V4L2_MPEG_AUDIO_EMPHASIS_NONE``
602 - None
603 * - ``V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS``
604 - 50/15 microsecond emphasis
605 * - ``V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17``
606 - CCITT J.17
610 .. _v4l2-mpeg-audio-crc:
615 enum v4l2_mpeg_audio_crc -
620 .. flat-table::
621 :header-rows: 0
622 :stub-columns: 0
624 * - ``V4L2_MPEG_AUDIO_CRC_NONE``
625 - None
626 * - ``V4L2_MPEG_AUDIO_CRC_CRC16``
627 - 16 bit parity check
637 .. _v4l2-mpeg-audio-dec-playback:
642 enum v4l2_mpeg_audio_dec_playback -
650 .. flat-table::
651 :header-rows: 0
652 :stub-columns: 0
654 * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_AUTO``
655 - Automatically determines the best playback mode.
656 * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_STEREO``
657 - Stereo playback.
658 * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_LEFT``
659 - Left channel playback.
660 * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_RIGHT``
661 - Right channel playback.
662 * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_MONO``
663 - Mono playback.
664 * - ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_SWAPPED_STEREO``
665 - Stereo playback with swapped left and right channels.
669 .. _v4l2-mpeg-audio-dec-multilingual-playback:
674 enum v4l2_mpeg_audio_dec_playback -
677 .. _v4l2-mpeg-video-encoding:
682 enum v4l2_mpeg_video_encoding -
688 .. flat-table::
689 :header-rows: 0
690 :stub-columns: 0
692 * - ``V4L2_MPEG_VIDEO_ENCODING_MPEG_1``
693 - MPEG-1 Video encoding
694 * - ``V4L2_MPEG_VIDEO_ENCODING_MPEG_2``
695 - MPEG-2 Video encoding
696 * - ``V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC``
697 - MPEG-4 AVC (H.264) Video encoding
701 .. _v4l2-mpeg-video-aspect:
706 enum v4l2_mpeg_video_aspect -
711 .. flat-table::
712 :header-rows: 0
713 :stub-columns: 0
715 * - ``V4L2_MPEG_VIDEO_ASPECT_1x1``
716 * - ``V4L2_MPEG_VIDEO_ASPECT_4x3``
717 * - ``V4L2_MPEG_VIDEO_ASPECT_16x9``
718 * - ``V4L2_MPEG_VIDEO_ASPECT_221x100``
723 Number of B-Frames (default 2)
734 .. _v4l2-mpeg-video-bitrate-mode:
739 enum v4l2_mpeg_video_bitrate_mode -
744 .. flat-table::
745 :header-rows: 0
746 :stub-columns: 0
748 * - ``V4L2_MPEG_VIDEO_BITRATE_MODE_VBR``
749 - Variable bitrate
750 * - ``V4L2_MPEG_VIDEO_BITRATE_MODE_CBR``
751 - Constant bitrate
773 Sets the "mute" color of the video. The supplied 32-bit integer is
778 .. flat-table::
779 :header-rows: 0
780 :stub-columns: 0
782 * - Bit 0:7
783 - V chrominance information
784 * - Bit 8:15
785 - U chrominance information
786 * - Bit 16:23
787 - Y luminance information
788 * - Bit 24:31
789 - Must be zero.
793 .. _v4l2-mpeg-video-dec-pts:
796 This read-only control returns the 33-bit video Presentation Time
797 Stamp as defined in ITU T-REC-H.222.0 and ISO/IEC 13818-1 of the
801 .. _v4l2-mpeg-video-dec-frame:
804 This read-only control returns the frame counter of the frame that
817 .. _v4l2-mpeg-video-h264-vui-sar-idc:
822 enum v4l2_mpeg_video_h264_vui_sar_idc -
824 defined in the table E-1 in the standard. Applicable to the H264
829 .. flat-table::
830 :header-rows: 0
831 :stub-columns: 0
833 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED``
834 - Unspecified
835 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1``
836 - 1x1
837 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11``
838 - 12x11
839 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11``
840 - 10x11
841 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11``
842 - 16x11
843 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33``
844 - 40x33
845 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11``
846 - 24x11
847 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11``
848 - 20x11
849 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11``
850 - 32x11
851 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33``
852 - 80x33
853 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11``
854 - 18x11
855 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11``
856 - 15x11
857 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33``
858 - 64x33
859 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99``
860 - 160x99
861 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3``
862 - 4x3
863 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2``
864 - 3x2
865 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1``
866 - 2x1
867 * - ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED``
868 - Extended SAR
880 .. _v4l2-mpeg-video-h264-level:
885 enum v4l2_mpeg_video_h264_level -
891 .. flat-table::
892 :header-rows: 0
893 :stub-columns: 0
895 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1_0``
896 - Level 1.0
897 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1B``
898 - Level 1B
899 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1_1``
900 - Level 1.1
901 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1_2``
902 - Level 1.2
903 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_1_3``
904 - Level 1.3
905 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_2_0``
906 - Level 2.0
907 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_2_1``
908 - Level 2.1
909 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_2_2``
910 - Level 2.2
911 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_3_0``
912 - Level 3.0
913 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_3_1``
914 - Level 3.1
915 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_3_2``
916 - Level 3.2
917 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_4_0``
918 - Level 4.0
919 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_4_1``
920 - Level 4.1
921 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_4_2``
922 - Level 4.2
923 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_5_0``
924 - Level 5.0
925 * - ``V4L2_MPEG_VIDEO_H264_LEVEL_5_1``
926 - Level 5.1
930 .. _v4l2-mpeg-video-mpeg4-level:
935 enum v4l2_mpeg_video_mpeg4_level -
941 .. flat-table::
942 :header-rows: 0
943 :stub-columns: 0
945 * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_0``
946 - Level 0
947 * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_0B``
948 - Level 0b
949 * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_1``
950 - Level 1
951 * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_2``
952 - Level 2
953 * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_3``
954 - Level 3
955 * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_3B``
956 - Level 3b
957 * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_4``
958 - Level 4
959 * - ``V4L2_MPEG_VIDEO_MPEG4_LEVEL_5``
960 - Level 5
964 .. _v4l2-mpeg-video-h264-profile:
969 enum v4l2_mpeg_video_h264_profile -
975 .. flat-table::
976 :header-rows: 0
977 :stub-columns: 0
979 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE``
980 - Baseline profile
981 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE``
982 - Constrained Baseline profile
983 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_MAIN``
984 - Main profile
985 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED``
986 - Extended profile
987 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH``
988 - High profile
989 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10``
990 - High 10 profile
991 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422``
992 - High 422 profile
993 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE``
994 - High 444 Predictive profile
995 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA``
996 - High 10 Intra profile
997 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA``
998 - High 422 Intra profile
999 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA``
1000 - High 444 Intra profile
1001 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA``
1002 - CAVLC 444 Intra profile
1003 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE``
1004 - Scalable Baseline profile
1005 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH``
1006 - Scalable High profile
1007 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA``
1008 - Scalable High Intra profile
1009 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH``
1010 - Stereo High profile
1011 * - ``V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH``
1012 - Multiview High profile
1016 .. _v4l2-mpeg-video-mpeg4-profile:
1021 enum v4l2_mpeg_video_mpeg4_profile -
1027 .. flat-table::
1028 :header-rows: 0
1029 :stub-columns: 0
1031 * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE``
1032 - Simple profile
1033 * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_SIMPLE``
1034 - Advanced Simple profile
1035 * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_CORE``
1036 - Core profile
1037 * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE_SCALABLE``
1038 - Simple Scalable profile
1039 * - ``V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_CODING_EFFICIENCY``
1040 -
1048 .. _v4l2-mpeg-video-multi-slice-mode:
1053 enum v4l2_mpeg_video_multi_slice_mode -
1061 .. flat-table::
1062 :header-rows: 0
1063 :stub-columns: 0
1065 * - ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE``
1066 - Single slice per frame.
1067 * - ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB``
1068 - Multiple slices with set maximum number of macroblocks per slice.
1069 * - ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES``
1070 - Multiple slice with set maximum size in bytes per slice.
1086 .. _v4l2-mpeg-video-h264-loop-filter-mode:
1091 enum v4l2_mpeg_video_h264_loop_filter_mode -
1098 .. flat-table::
1099 :header-rows: 0
1100 :stub-columns: 0
1102 * - ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED``
1103 - Loop filter is enabled.
1104 * - ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED``
1105 - Loop filter is disabled.
1106 * - ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY``
1107 - Loop filter is disabled at the slice boundary.
1119 .. _v4l2-mpeg-video-h264-entropy-mode:
1124 enum v4l2_mpeg_video_h264_entropy_mode -
1125 Entropy coding mode for H264 - CABAC/CAVALC. Applicable to the H264
1130 .. flat-table::
1131 :header-rows: 0
1132 :stub-columns: 0
1134 * - ``V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC``
1135 - Use CAVLC entropy coding.
1136 * - ``V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC``
1137 - Use CABAC entropy coding.
1232 .. _v4l2-mpeg-video-vbv-delay:
1237 .. _v4l2-mpeg-video-hor-search-range:
1245 .. _v4l2-mpeg-video-vert-search-range:
1253 .. _v4l2-mpeg-video-force-key-frame:
1257 encoders. This is a general, codec-agnostic keyframe control.
1266 Period between I-frames in the open GOP for H264. In case of an open
1267 GOP this is the period between two I-frames. The period between IDR
1270 Refresh is an I-frame after which no prior frames are referenced.
1275 .. _v4l2-mpeg-video-header-mode:
1280 enum v4l2_mpeg_video_header_mode -
1289 .. flat-table::
1290 :header-rows: 0
1291 :stub-columns: 0
1293 * - ``V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE``
1294 - The stream header is returned separately in the first buffer.
1295 * - ``V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME``
1296 - The stream header is returned together with the first encoded
1328 .. _v4l2-mpeg-video-h264-sei-fp-arrangement-type:
1333 enum v4l2_mpeg_video_h264_sei_fp_arrangement_type -
1339 .. flat-table::
1340 :header-rows: 0
1341 :stub-columns: 0
1343 * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_CHEKERBOARD``
1344 - Pixels are alternatively from L and R.
1345 * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_COLUMN``
1346 - L and R are interlaced by column.
1347 * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_ROW``
1348 - L and R are interlaced by row.
1349 * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_SIDE_BY_SIDE``
1350 - L is on the left, R on the right.
1351 * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TOP_BOTTOM``
1352 - L is on top, R on bottom.
1353 * - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TEMPORAL``
1354 - One view per frame.
1363 .. _v4l2-mpeg-video-h264-fmo-map-type:
1368 enum v4l2_mpeg_video_h264_fmo_map_type -
1375 .. flat-table::
1376 :header-rows: 0
1377 :stub-columns: 0
1379 * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_INTERLEAVED_SLICES``
1380 - Slices are interleaved one after other with macroblocks in run
1382 * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_SCATTERED_SLICES``
1383 - Scatters the macroblocks based on a mathematical function known to
1385 * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_FOREGROUND_WITH_LEFT_OVER``
1386 - Macroblocks arranged in rectangular areas or regions of interest.
1387 * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_BOX_OUT``
1388 - Slice groups grow in a cyclic way from centre to outwards.
1389 * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_RASTER_SCAN``
1390 - Slice groups grow in raster scan pattern from left to right.
1391 * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_WIPE_SCAN``
1392 - Slice groups grow in wipe scan pattern from top to bottom.
1393 * - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_EXPLICIT``
1394 - User defined map type.
1401 .. _v4l2-mpeg-video-h264-fmo-change-direction:
1406 enum v4l2_mpeg_video_h264_fmo_change_dir -
1412 .. flat-table::
1413 :header-rows: 0
1414 :stub-columns: 0
1416 * - ``V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_RIGHT``
1417 - Raster scan or wipe right.
1418 * - ``V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_LEFT``
1419 - Reverse raster scan or wipe left.
1437 The supplied 32-bit integer is interpreted as follows (bit 0 = least
1442 .. flat-table::
1443 :header-rows: 0
1444 :stub-columns: 0
1446 * - Bit 0:15
1447 - Slice ID
1448 * - Bit 16:32
1449 - Slice position or order
1456 .. _v4l2-mpeg-video-h264-hierarchical-coding-type:
1461 enum v4l2_mpeg_video_h264_hierarchical_coding_type -
1467 .. flat-table::
1468 :header-rows: 0
1469 :stub-columns: 0
1471 * - ``V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_B``
1472 - Hierarchical B coding.
1473 * - ``V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_P``
1474 - Hierarchical P coding.
1484 encoder. The supplied 32-bit integer is interpreted as follows (bit
1489 .. flat-table::
1490 :header-rows: 0
1491 :stub-columns: 0
1493 * - Bit 0:15
1494 - QP value
1495 * - Bit 16:32
1496 - Layer number
1502 ---------------------
1509 .. _mfc51-control-id:
1534 Padding enable in the encoder - use a color instead of repeating
1539 32-bit integer is interpreted as follows (bit 0 = least significant
1544 .. flat-table::
1545 :header-rows: 0
1546 :stub-columns: 0
1548 * - Bit 0:7
1549 - V chrominance information
1550 * - Bit 8:15
1551 - U chrominance information
1552 * - Bit 16:23
1553 - Y luminance information
1554 * - Bit 24:31
1555 - Must be zero.
1596 .. _v4l2-mpeg-mfc51-video-frame-skip-mode:
1601 enum v4l2_mpeg_mfc51_video_frame_skip_mode -
1610 .. flat-table::
1611 :header-rows: 0
1612 :stub-columns: 0
1614 * - ``V4L2_MPEG_MFC51_FRAME_SKIP_MODE_DISABLED``
1615 - Frame skip mode is disabled.
1616 * - ``V4L2_MPEG_MFC51_FRAME_SKIP_MODE_LEVEL_LIMIT``
1617 - Frame skip mode enabled and buffer limit is set by the chosen
1619 * - ``V4L2_MPEG_MFC51_FRAME_SKIP_MODE_BUF_LIMIT``
1620 - Frame skip mode enabled and buffer limit is set by the VBV
1626 Enable rate-control with fixed target bit. If this setting is
1637 .. _v4l2-mpeg-mfc51-video-force-frame-type:
1642 enum v4l2_mpeg_mfc51_video_force_frame_type -
1648 .. flat-table::
1649 :header-rows: 0
1650 :stub-columns: 0
1652 * - ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_DISABLED``
1653 - Forcing a specific frame type disabled.
1654 * - ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_I_FRAME``
1655 - Force an I-frame.
1656 * - ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_NOT_CODED``
1657 - Force a non-coded frame.
1663 ---------------------
1669 .. _cx2341x-control-id:
1674 .. _v4l2-mpeg-cx2341x-video-spatial-filter-mode:
1679 enum v4l2_mpeg_cx2341x_video_spatial_filter_mode -
1685 .. flat-table::
1686 :header-rows: 0
1687 :stub-columns: 0
1689 * - ``V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL``
1690 - Choose the filter manually
1691 * - ``V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO``
1692 - Choose the filter automatically
1696 ``V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER (integer (0-15))``
1700 .. _luma-spatial-filter-type:
1705 enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type -
1713 .. flat-table::
1714 :header-rows: 0
1715 :stub-columns: 0
1717 * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF``
1718 - No filter
1719 * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR``
1720 - One-dimensional horizontal
1721 * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT``
1722 - One-dimensional vertical
1723 * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE``
1724 - Two-dimensional separable
1725 * - ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE``
1726 - Two-dimensional symmetrical non-separable
1730 .. _chroma-spatial-filter-type:
1735 enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type -
1741 .. flat-table::
1742 :header-rows: 0
1743 :stub-columns: 0
1745 * - ``V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF``
1746 - No filter
1747 * - ``V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR``
1748 - One-dimensional horizontal
1752 .. _v4l2-mpeg-cx2341x-video-temporal-filter-mode:
1757 enum v4l2_mpeg_cx2341x_video_temporal_filter_mode -
1763 .. flat-table::
1764 :header-rows: 0
1765 :stub-columns: 0
1767 * - ``V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL``
1768 - Choose the filter manually
1769 * - ``V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO``
1770 - Choose the filter automatically
1774 ``V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER (integer (0-31))``
1776 is 8 for full-scale capturing and 0 for scaled capturing.)
1778 .. _v4l2-mpeg-cx2341x-video-median-filter-type:
1783 enum v4l2_mpeg_cx2341x_video_median_filter_type -
1788 .. flat-table::
1789 :header-rows: 0
1790 :stub-columns: 0
1792 * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF``
1793 - No filter
1794 * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR``
1795 - Horizontal filter
1796 * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT``
1797 - Vertical filter
1798 * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT``
1799 - Horizontal and vertical filter
1800 * - ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG``
1801 - Diagonal filter
1805 ``V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM (integer (0-255))``
1809 ``V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP (integer (0-255))``
1813 ``V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM (integer (0-255))``
1817 ``V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP (integer (0-255))``
1822 The CX2341X MPEG encoder can insert one empty MPEG-2 PES packet into
1831 ---------------------
1837 .. _vpx-control-id:
1842 .. _v4l2-vpx-num-partitions:
1847 enum v4l2_vp8_num_partitions -
1853 .. flat-table::
1854 :header-rows: 0
1855 :stub-columns: 0
1857 * - ``V4L2_CID_MPEG_VIDEO_VPX_1_PARTITION``
1858 - 1 coefficient partition
1859 * - ``V4L2_CID_MPEG_VIDEO_VPX_2_PARTITIONS``
1860 - 2 coefficient partitions
1861 * - ``V4L2_CID_MPEG_VIDEO_VPX_4_PARTITIONS``
1862 - 4 coefficient partitions
1863 * - ``V4L2_CID_MPEG_VIDEO_VPX_8_PARTITIONS``
1864 - 8 coefficient partitions
1871 .. _v4l2-vpx-num-ref-frames:
1876 enum v4l2_vp8_num_ref_frames -
1882 .. flat-table::
1883 :header-rows: 0
1884 :stub-columns: 0
1886 * - ``V4L2_CID_MPEG_VIDEO_VPX_1_REF_FRAME``
1887 - Last encoded frame will be searched
1888 * - ``V4L2_CID_MPEG_VIDEO_VPX_2_REF_FRAME``
1889 - Two frames will be searched among the last encoded frame, the
1892 * - ``V4L2_CID_MPEG_VIDEO_VPX_3_REF_FRAME``
1893 - The last encoded frame, the golden frame and the altref frame will
1915 .. _v4l2-vpx-golden-frame-sel:
1920 enum v4l2_vp8_golden_frame_sel -
1929 .. flat-table::
1930 :header-rows: 0
1931 :stub-columns: 0
1933 * - ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_PREV``
1934 - Use the (n-2)th frame as a golden frame, current frame index being
1936 * - ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_REF_PERIOD``
1937 - Use the previous specific frame indicated by
1958 .. _v4l2-mpeg-video-vp8-profile:
1963 enum v4l2_mpeg_video_vp8_profile -
1968 .. flat-table::
1969 :header-rows: 0
1970 :stub-columns: 0
1972 * - ``V4L2_MPEG_VIDEO_VP8_PROFILE_0``
1973 - Profile 0
1974 * - ``V4L2_MPEG_VIDEO_VP8_PROFILE_1``
1975 - Profile 1
1976 * - ``V4L2_MPEG_VIDEO_VP8_PROFILE_2``
1977 - Profile 2
1978 * - ``V4L2_MPEG_VIDEO_VP8_PROFILE_3``
1979 - Profile 3
1981 .. _v4l2-mpeg-video-vp9-profile:
1986 enum v4l2_mpeg_video_vp9_profile -
1991 .. flat-table::
1992 :header-rows: 0
1993 :stub-columns: 0
1995 * - ``V4L2_MPEG_VIDEO_VP9_PROFILE_0``
1996 - Profile 0
1997 * - ``V4L2_MPEG_VIDEO_VP9_PROFILE_1``
1998 - Profile 1
1999 * - ``V4L2_MPEG_VIDEO_VP9_PROFILE_2``
2000 - Profile 2
2001 * - ``V4L2_MPEG_VIDEO_VP9_PROFILE_3``
2002 - Profile 3
2006 -----------------------------------------------------------
2012 .. _hevc-control-id:
2046 .. _v4l2-hevc-hier-coding-type:
2051 enum v4l2_mpeg_video_hevc_hier_coding_type -
2060 .. flat-table::
2061 :header-rows: 0
2062 :stub-columns: 0
2064 * - ``V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_B``
2065 - Use the B frame for hierarchical coding.
2066 * - ``V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_P``
2067 - Use the P frame for hierarchical coding.
2076 (non-hierarchial coding), it should be zero. Possible values are [0, 6].
2115 .. _v4l2-hevc-profile:
2120 enum v4l2_mpeg_video_hevc_profile -
2129 .. flat-table::
2130 :header-rows: 0
2131 :stub-columns: 0
2133 * - ``V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN``
2134 - Main profile.
2135 * - ``V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_STILL_PICTURE``
2136 - Main still picture profile.
2137 * - ``V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_10``
2138 - Main 10 profile.
2145 .. _v4l2-hevc-level:
2150 enum v4l2_mpeg_video_hevc_level -
2159 .. flat-table::
2160 :header-rows: 0
2161 :stub-columns: 0
2163 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_1``
2164 - Level 1.0
2165 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_2``
2166 - Level 2.0
2167 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_2_1``
2168 - Level 2.1
2169 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_3``
2170 - Level 3.0
2171 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_3_1``
2172 - Level 3.1
2173 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_4``
2174 - Level 4.0
2175 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_4_1``
2176 - Level 4.1
2177 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_5``
2178 - Level 5.0
2179 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_5_1``
2180 - Level 5.1
2181 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_5_2``
2182 - Level 5.2
2183 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_6``
2184 - Level 6.0
2185 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_6_1``
2186 - Level 6.1
2187 * - ``V4L2_MPEG_VIDEO_HEVC_LEVEL_6_2``
2188 - Level 6.2
2200 .. _v4l2-hevc-tier:
2205 enum v4l2_mpeg_video_hevc_tier -
2218 .. flat-table::
2219 :header-rows: 0
2220 :stub-columns: 0
2222 * - ``V4L2_MPEG_VIDEO_HEVC_TIER_MAIN``
2223 - Main tier.
2224 * - ``V4L2_MPEG_VIDEO_HEVC_TIER_HIGH``
2225 - High tier.
2235 .. _v4l2-hevc-loop-filter-mode:
2240 enum v4l2_mpeg_video_hevc_loop_filter_mode -
2249 .. flat-table::
2250 :header-rows: 0
2251 :stub-columns: 0
2253 * - ``V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED``
2254 - Loop filter is disabled.
2255 * - ``V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_ENABLED``
2256 - Loop filter is enabled.
2257 * - ``V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY``
2258 - Loop filter is disabled at the slice boundary.
2266 Selects HEVC loop filter beta offset. The valid range is [-6, +6].
2269 Selects HEVC loop filter tc offset. The valid range is [-6, +6].
2271 .. _v4l2-hevc-refresh-type:
2276 enum v4l2_mpeg_video_hevc_hier_refresh_type -
2287 .. flat-table::
2288 :header-rows: 0
2289 :stub-columns: 0
2291 * - ``V4L2_MPEG_VIDEO_HEVC_REFRESH_NONE``
2292 - Use the B frame for hierarchical coding.
2293 * - ``V4L2_MPEG_VIDEO_HEVC_REFRESH_CRA``
2294 - Use CRA (Clean Random Access Unit) picture encoding.
2295 * - ``V4L2_MPEG_VIDEO_HEVC_REFRESH_IDR``
2296 - Use IDR (Instantaneous Decoding Refresh) picture encoding.
2333 Indicates bi-linear interpolation is conditionally used in the intra
2334 prediction filtering process in the CVS when set to 1. Indicates bi-linear
2352 .. _v4l2-hevc-size-of-length-field:
2357 enum v4l2_mpeg_video_hevc_size_of_length_field -
2367 .. flat-table::
2368 :header-rows: 0
2369 :stub-columns: 0
2371 * - ``V4L2_MPEG_VIDEO_HEVC_SIZE_0``
2372 - Generate start code pattern (Normal).
2373 * - ``V4L2_MPEG_VIDEO_HEVC_SIZE_1``
2374 - Generate size of length field instead of start code pattern and length is 1.
2375 * - ``V4L2_MPEG_VIDEO_HEVC_SIZE_2``
2376 - Generate size of length field instead of start code pattern and length is 2.
2377 * - ``V4L2_MPEG_VIDEO_HEVC_SIZE_4``
2378 - Generate size of length field instead of start code pattern and length is 4.
2407 P-Frame can use 1 or 2 frames for reference.
2415 .. _camera-controls:
2421 digital) features of a device such as controllable lenses or sensors.
2424 .. _camera-control-id:
2427 ------------------
2434 .. _v4l2-exposure-auto-type:
2439 enum v4l2_exposure_auto_type -
2447 .. flat-table::
2448 :header-rows: 0
2449 :stub-columns: 0
2451 * - ``V4L2_EXPOSURE_AUTO``
2452 - Automatic exposure time, automatic iris aperture.
2453 * - ``V4L2_EXPOSURE_MANUAL``
2454 - Manual exposure time, manual iris.
2455 * - ``V4L2_EXPOSURE_SHUTTER_PRIORITY``
2456 - Manual exposure time, auto iris.
2457 * - ``V4L2_EXPOSURE_APERTURE_PRIORITY``
2458 - Auto exposure time, manual iris.
2486 .. _v4l2-exposure-metering:
2491 enum v4l2_exposure_metering -
2497 .. flat-table::
2498 :header-rows: 0
2499 :stub-columns: 0
2501 * - ``V4L2_EXPOSURE_METERING_AVERAGE``
2502 - Use the light information coming from the entire frame and average
2504 * - ``V4L2_EXPOSURE_METERING_CENTER_WEIGHTED``
2505 - Average the light information coming from the entire frame giving
2507 * - ``V4L2_EXPOSURE_METERING_SPOT``
2508 - Measure only very small area at the center of the frame.
2509 * - ``V4L2_EXPOSURE_METERING_MATRIX``
2510 - A multi-zone metering. The light intensity is measured in several
2521 left. A value of zero does not cause motion. This is a write-only
2528 a write-only control.
2542 interpret the values as arc seconds, with valid values between -180
2549 between -180 * 3600 and +180 * 3600 inclusive.
2560 write-only control.
2578 .. _v4l2-auto-focus-status:
2581 The automatic focus status. This is a read-only control.
2589 .. flat-table::
2590 :header-rows: 0
2591 :stub-columns: 0
2593 * - ``V4L2_AUTO_FOCUS_STATUS_IDLE``
2594 - Automatic focus is not active.
2595 * - ``V4L2_AUTO_FOCUS_STATUS_BUSY``
2596 - Automatic focusing is in progress.
2597 * - ``V4L2_AUTO_FOCUS_STATUS_REACHED``
2598 - Focus has been reached.
2599 * - ``V4L2_AUTO_FOCUS_STATUS_FAILED``
2600 - Automatic focus has failed, the driver will not transition from
2605 .. _v4l2-auto-focus-range:
2610 enum v4l2_auto_focus_range -
2615 .. flat-table::
2616 :header-rows: 0
2617 :stub-columns: 0
2619 * - ``V4L2_AUTO_FOCUS_RANGE_AUTO``
2620 - The camera automatically selects the focus range.
2621 * - ``V4L2_AUTO_FOCUS_RANGE_NORMAL``
2622 - Normal distance range, limited for best automatic focus
2624 * - ``V4L2_AUTO_FOCUS_RANGE_MACRO``
2625 - Macro (close-up) auto focus. The camera will use its minimum
2627 * - ``V4L2_AUTO_FOCUS_RANGE_INFINITY``
2628 - The lens is set to focus on an object at infinite distance.
2634 zoom unit is driver-specific and its value should be a positive
2640 telephoto direction, negative values towards the wide-angle
2641 direction. The zoom unit is driver-specific. This is a write-only
2650 wide-angle direction. The zoom speed unit is driver-specific.
2661 write-only control.
2672 Switch the band-stop filter of a camera sensor on or off, or specify
2673 its strength. Such band-stop filters can be used, for example, to
2676 .. _v4l2-auto-n-preset-white-balance:
2681 enum v4l2_auto_n_preset_white_balance -
2690 .. flat-table::
2691 :header-rows: 0
2692 :stub-columns: 0
2694 * - ``V4L2_WHITE_BALANCE_MANUAL``
2695 - Manual white balance.
2696 * - ``V4L2_WHITE_BALANCE_AUTO``
2697 - Automatic white balance adjustments.
2698 * - ``V4L2_WHITE_BALANCE_INCANDESCENT``
2699 - White balance setting for incandescent (tungsten) lighting. It
2702 * - ``V4L2_WHITE_BALANCE_FLUORESCENT``
2703 - White balance preset for fluorescent lighting. It corresponds
2705 * - ``V4L2_WHITE_BALANCE_FLUORESCENT_H``
2706 - With this setting the camera will compensate for fluorescent H
2708 * - ``V4L2_WHITE_BALANCE_HORIZON``
2709 - White balance setting for horizon daylight. It corresponds
2711 * - ``V4L2_WHITE_BALANCE_DAYLIGHT``
2712 - White balance preset for daylight (with clear sky). It corresponds
2714 * - ``V4L2_WHITE_BALANCE_FLASH``
2715 - With this setting the camera will compensate for the flash light.
2718 * - ``V4L2_WHITE_BALANCE_CLOUDY``
2719 - White balance preset for moderately overcast sky. This option
2722 * - ``V4L2_WHITE_BALANCE_SHADE``
2723 - White balance preset for shade or heavily overcast sky. It
2728 .. _v4l2-wide-dynamic-range:
2738 .. _v4l2-image-stabilization:
2756 .. _v4l2-iso-sensitivity-auto-type:
2761 enum v4l2_iso_sensitivity_type -
2766 .. flat-table::
2767 :header-rows: 0
2768 :stub-columns: 0
2770 * - ``V4L2_CID_ISO_SENSITIVITY_MANUAL``
2771 - Manual ISO sensitivity.
2772 * - ``V4L2_CID_ISO_SENSITIVITY_AUTO``
2773 - Automatic ISO sensitivity adjustments.
2777 .. _v4l2-scene-mode:
2782 enum v4l2_scene_mode -
2796 .. flat-table::
2797 :header-rows: 0
2798 :stub-columns: 0
2800 * - ``V4L2_SCENE_MODE_NONE``
2801 - The scene mode feature is disabled.
2802 * - ``V4L2_SCENE_MODE_BACKLIGHT``
2803 - Backlight. Compensates for dark shadows when light is coming from
2805 * - ``V4L2_SCENE_MODE_BEACH_SNOW``
2806 - Beach and snow. This mode compensates for all-white or bright
2812 * - ``V4L2_SCENE_MODE_CANDLELIGHT``
2813 - Candle light. The camera generally raises the ISO sensitivity and
2817 * - ``V4L2_SCENE_MODE_DAWN_DUSK``
2818 - Dawn and dusk. Preserves the colors seen in low natural light
2822 * - ``V4L2_SCENE_MODE_FALL_COLORS``
2823 - Fall colors. Increases saturation and adjusts white balance for
2826 * - ``V4L2_SCENE_MODE_FIREWORKS``
2827 - Fireworks. Long exposure times are used to capture the expanding
2830 * - ``V4L2_SCENE_MODE_LANDSCAPE``
2831 - Landscape. The camera may choose a small aperture to provide deep
2835 * - ``V4L2_SCENE_MODE_NIGHT``
2836 - Night, also known as Night Landscape. Designed for low light
2839 medium-to-high ISO sensitivity, with a relatively long exposure
2842 * - ``V4L2_SCENE_MODE_PARTY_INDOOR``
2843 - Party and indoor. Designed to capture indoor scenes that are lit
2847 * - ``V4L2_SCENE_MODE_PORTRAIT``
2848 - Portrait. The camera adjusts the aperture so that the depth of
2853 * - ``V4L2_SCENE_MODE_SPORTS``
2854 - Sports. Significantly increases ISO and uses a fast shutter speed
2855 to freeze motion of rapidly-moving subjects. Increased image noise
2857 * - ``V4L2_SCENE_MODE_SUNSET``
2858 - Sunset. Preserves deep hues seen in sunsets and sunrises. It bumps
2860 * - ``V4L2_SCENE_MODE_TEXT``
2861 - Text. It applies extra contrast and sharpness, it is typically a
2862 black-and-white mode optimized for readability. Automatic focus
2863 may be switched to close-up mode and this setting may also involve
2864 some lens-distortion correction.
2884 .. flat-table::
2885 :header-rows: 0
2886 :stub-columns: 0
2888 * - ``V4L2_LOCK_EXPOSURE``
2889 - Automatic exposure adjustments lock.
2890 * - ``V4L2_LOCK_WHITE_BALANCE``
2891 - Automatic white balance adjustments lock.
2892 * - ``V4L2_LOCK_FOCUS``
2893 - Automatic focus lock.
2911 .. _fm-tx-controls:
2922 .. _fm-tx-control-id:
2925 -----------------
2934 step are driver-specific.
2941 to 31 pre-defined programme types.
2959 programme-related information or any other text. In these cases,
3010 receiver-generated distortion and prevent overmodulation.
3014 useconds. Step and range are driver-specific.
3018 are driver-specific.
3028 range and step are driver-specific.
3032 value. The range and step are driver-specific.
3036 value. The range and step are driver-specific.
3040 useconds value. The range and step are driver-specific.
3047 range and step are driver-specific.
3051 step are driver-specific.
3056 enum v4l2_preemphasis -
3057 Configures the pre-emphasis value for broadcasting. A pre-emphasis
3061 values for pre-emphasis. Here they are:
3065 .. flat-table::
3066 :header-rows: 0
3067 :stub-columns: 0
3069 * - ``V4L2_PREEMPHASIS_DISABLED``
3070 - No pre-emphasis is applied.
3071 * - ``V4L2_PREEMPHASIS_50_uS``
3072 - A pre-emphasis of 50 uS is used.
3073 * - ``V4L2_PREEMPHASIS_75_uS``
3074 - A pre-emphasis of 75 uS is used.
3080 dBuV. Range and step are driver-specific.
3085 driver-specific.
3091 .. _flash-controls:
3104 .. _flash-controls-use-cases:
3107 -------------------
3124 The synchronised LED flash is pre-programmed by the host (power and
3139 .. _flash-control-id:
3148 Defines the mode of the flash LED, the high-power white LED attached
3154 .. flat-table::
3155 :header-rows: 0
3156 :stub-columns: 0
3158 * - ``V4L2_FLASH_LED_MODE_NONE``
3159 - Off.
3160 * - ``V4L2_FLASH_LED_MODE_FLASH``
3161 - Flash mode.
3162 * - ``V4L2_FLASH_LED_MODE_TORCH``
3163 - Torch mode. See V4L2_CID_FLASH_TORCH_INTENSITY.
3172 .. flat-table::
3173 :header-rows: 0
3174 :stub-columns: 0
3176 * - ``V4L2_FLASH_STROBE_SOURCE_SOFTWARE``
3177 - The flash strobe is triggered by using the
3179 * - ``V4L2_FLASH_STROBE_SOURCE_EXTERNAL``
3180 - The flash strobe is triggered by an external source. Typically
3198 This is a read-only control.
3231 .. flat-table::
3232 :header-rows: 0
3233 :stub-columns: 0
3235 * - ``V4L2_FLASH_FAULT_OVER_VOLTAGE``
3236 - Flash controller voltage to the flash LED has exceeded the limit
3238 * - ``V4L2_FLASH_FAULT_TIMEOUT``
3239 - The flash strobe was still on when the timeout set by the user ---
3240 V4L2_CID_FLASH_TIMEOUT control --- has expired. Not all flash
3242 * - ``V4L2_FLASH_FAULT_OVER_TEMPERATURE``
3243 - The flash controller has overheated.
3244 * - ``V4L2_FLASH_FAULT_SHORT_CIRCUIT``
3245 - The short circuit protection of the flash controller has been
3247 * - ``V4L2_FLASH_FAULT_OVER_CURRENT``
3248 - Current in the LED power supply has exceeded the limit specific to
3250 * - ``V4L2_FLASH_FAULT_INDICATOR``
3251 - The flash controller has detected a short or open circuit
3253 * - ``V4L2_FLASH_FAULT_UNDER_VOLTAGE``
3254 - Flash controller voltage to the flash LED has been below the
3256 * - ``V4L2_FLASH_FAULT_INPUT_VOLTAGE``
3257 - The input voltage of the flash controller is below the limit under
3260 * - ``V4L2_FLASH_FAULT_LED_OVER_TEMPERATURE``
3261 - The temperature of the LED has exceeded its allowed upper limit.
3272 is a read-only control.
3275 .. _jpeg-controls:
3286 .. _jpeg-control-id:
3289 ----------------
3299 spatial dimension. See :ref:`itu-t81`, clause A.1.1. for more
3306 .. flat-table::
3307 :header-rows: 0
3308 :stub-columns: 0
3310 * - ``V4L2_JPEG_CHROMA_SUBSAMPLING_444``
3311 - No chroma subsampling, each pixel has Y, Cr and Cb values.
3312 * - ``V4L2_JPEG_CHROMA_SUBSAMPLING_422``
3313 - Horizontally subsample Cr, Cb components by a factor of 2.
3314 * - ``V4L2_JPEG_CHROMA_SUBSAMPLING_420``
3315 - Subsample Cr, Cb components horizontally and vertically by 2.
3316 * - ``V4L2_JPEG_CHROMA_SUBSAMPLING_411``
3317 - Horizontally subsample Cr, Cb components by a factor of 4.
3318 * - ``V4L2_JPEG_CHROMA_SUBSAMPLING_410``
3319 - Subsample Cr, Cb components horizontally by 4 and vertically by 2.
3320 * - ``V4L2_JPEG_CHROMA_SUBSAMPLING_GRAY``
3321 - Use only luminance component.
3335 .. _jpeg-quality-control:
3338 ``V4L2_CID_JPEG_COMPRESSION_QUALITY`` control determines trade-off
3347 The value range of this control is driver-specific. Only positive,
3348 non-zero values are meaningful. The recommended range is 1 - 100,
3351 .. _jpeg-active-marker-control:
3359 .. flat-table::
3360 :header-rows: 0
3361 :stub-columns: 0
3363 * - ``V4L2_JPEG_ACTIVE_MARKER_APP0``
3364 - Application data segment APP\ :sub:`0`.
3365 * - ``V4L2_JPEG_ACTIVE_MARKER_APP1``
3366 - Application data segment APP\ :sub:`1`.
3367 * - ``V4L2_JPEG_ACTIVE_MARKER_COM``
3368 - Comment segment.
3369 * - ``V4L2_JPEG_ACTIVE_MARKER_DQT``
3370 - Quantization tables segment.
3371 * - ``V4L2_JPEG_ACTIVE_MARKER_DHT``
3372 - Huffman tables segment.
3376 For more details about JPEG specification, refer to :ref:`itu-t81`,
3377 :ref:`jfif`, :ref:`w3c-jpeg-jfif`.
3380 .. _image-source-controls:
3385 The Image Source control class is intended for low-level control of
3386 image source devices such as image sensors. The devices feature an
3391 .. _image-source-control-id:
3394 ------------------------
3404 same sub-device.
3429 .. _image-process-controls:
3434 The Image Process control class is intended for low-level control of
3440 .. _image-process-control-id:
3443 -------------------------
3463 ``V4L2_CID_PIXEL_RATE (64-bit integer)``
3465 read-only and its unit is pixels / second.
3474 driver specific and are documented in :ref:`v4l-drivers`.
3480 digital gain the control value needs to be 0x100. The no-gain
3484 .. _dv-controls:
3495 only exposed on the ``/dev/v4l-subdev*`` device node.
3503 Identification Data, :ref:`vesaedid`) and HDCP (High-bandwidth Digital
3513 .. _dv-control-id:
3516 -------------------------
3527 read-only control is applicable to DVI-D, HDMI and DisplayPort
3531 Rx Sense is the detection of pull-ups on the TMDS clock lines. This
3536 that pad will be 0. This read-only control is applicable to DVI-D
3544 EDIDs, then the bit for that pad will be 0. This read-only control
3545 is applicable to VGA, DVI-A/D, HDMI and DisplayPort connectors.
3550 enum v4l2_dv_tx_mode -
3551 HDMI transmitters can transmit in DVI-D mode (just video) or in HDMI
3559 enum v4l2_dv_rgb_range -
3565 standard correctly (unfortunately quite common for HDMI and DVI-D).
3567 range sets the range to (16 << (N-8)) - (235 << (N-8)) where N is
3569 DVI-A/D, HDMI and DisplayPort connectors.
3574 enum v4l2_dv_it_content_type -
3584 .. flat-table::
3585 :header-rows: 0
3586 :stub-columns: 0
3588 * - ``V4L2_DV_IT_CONTENT_TYPE_GRAPHICS``
3589 - Graphics content. Pixel data should be passed unfiltered and
3591 * - ``V4L2_DV_IT_CONTENT_TYPE_PHOTO``
3592 - Photo content. The content is derived from digital still pictures.
3595 * - ``V4L2_DV_IT_CONTENT_TYPE_CINEMA``
3596 - Cinema content.
3597 * - ``V4L2_DV_IT_CONTENT_TYPE_GAME``
3598 - Game content. Audio and video latency should be minimized.
3599 * - ``V4L2_DV_IT_CONTENT_TYPE_NO_ITC``
3600 - No IT Content information is available and the ITC bit in the AVI
3612 will be 0. This read-only control is applicable to DVI-D, HDMI and
3618 enum v4l2_dv_rgb_range -
3624 standard correctly (unfortunately quite common for HDMI and DVI-D).
3626 range sets the range to (16 << (N-8)) - (235 << (N-8)) where N is
3628 DVI-A/D, HDMI and DisplayPort connectors.
3633 enum v4l2_dv_it_content_type -
3642 .. _fm-rx-controls:
3651 .. _fm-rx-control-id:
3654 -----------------
3665 Gets RDS Programme Type field. This encodes up to 31 pre-defined
3683 wishes to transmit longer PS names, programme-related information or
3708 enum v4l2_deemphasis -
3709 Configures the de-emphasis value for reception. A de-emphasis filter
3713 values for de-emphasis. Here they are:
3717 .. flat-table::
3718 :header-rows: 0
3719 :stub-columns: 0
3721 * - ``V4L2_DEEMPHASIS_DISABLED``
3722 - No de-emphasis is applied.
3723 * - ``V4L2_DEEMPHASIS_50_uS``
3724 - A de-emphasis of 50 uS is used.
3725 * - ``V4L2_DEEMPHASIS_75_uS``
3726 - A de-emphasis of 75 uS is used.
3731 .. _detect-controls:
3740 .. _detect-control-id:
3743 ------------------
3755 .. flat-table::
3756 :header-rows: 0
3757 :stub-columns: 0
3759 * - ``V4L2_DETECT_MD_MODE_DISABLED``
3760 - Disable motion detection.
3761 * - ``V4L2_DETECT_MD_MODE_GLOBAL``
3762 - Use a single motion detection threshold.
3763 * - ``V4L2_DETECT_MD_MODE_THRESHOLD_GRID``
3764 - The image is divided into a grid, each cell with its own motion
3767 * - ``V4L2_DETECT_MD_MODE_REGION_GRID``
3768 - The image is divided into a grid, each cell with its own region
3769 value that specifies which per-region motion detection thresholds
3771 per-region thresholds are set up is driver-specific. The region
3785 top-left of the grid.
3791 top-left of the grid.
3794 .. _rf-tuner-controls:
3806 called Zero-IF tuners. Older tuners were typically simple PLL tuners
3818 .. _rf-tuner-control-id:
3821 --------------------
3837 range and step are driver-specific.
3854 range and step are driver-specific.
3862 driver-specific.
3866 located inside mixer block, where RF signal is down-converted by the
3868 The range and step are driver-specific.
3875 are driver-specific.
3879 when that control is set. This is a read-only control.