Lines Matching +full:is +full:- +full:decoded +full:- +full:cs
4 <para>Devices typically have a number of user-settable controls
16 and higher values. The pre-defined control IDs have the prefix
18 linkend="control-id" />. The ID is used when querying the attributes of
23 name string the user is supposed to understand. When the purpose is
24 non-intuitive the driver writer should provide a user manual, a user
25 interface plug-in or a driver specific panel application. Predefined
40 also do not change ⪚ when the device is opened or closed, when the
41 tuner radio frequency is changed or generally never without
48 After another process called &VIDIOC-S-CTRL; or another ioctl changing
49 shared properties the &func-select; function would indicate
50 readability until any ioctl (querying the properties) is
58 <table pgwide="1" frame="none" id="control-id">
61 &cs-def;
142 <constant>V4L2_CID_BRIGHTNESS</constant>). This control is deprecated
153 <entry>This is an action control. When set (the value is
177 <entry>Whiteness for grey-scale devices. This is a synonym
178 for <constant>V4L2_CID_GAMMA</constant>. This control is deprecated
209 <entry>Horizontal image centering. This control is
211 linkend="camera-controls">Camera class controls</link>
220 <entry>Vertical image centering. Centering is intended to
223 control is deprecated. New drivers and applications should use the
224 <link linkend="camera-controls">Camera class controls</link>
229 <row id="v4l2-power-line-frequency">
244 hue control is enabled is undefined, drivers should ignore such
278 is disabled).</entry>
285 <row id="v4l2-colorfx">
306 and width of the display window. It is necessary to set the new height and
307 width of the picture using the &VIDIOC-S-FMT; ioctl according to
315 supplied 32 bit value is interpreted as bits 0-7 Red color information,
316 bits 8-15 Green color information, bits 16-23 Blue color
317 information and bits 24-31 must be zero.</entry>
329 <entry>This is a read-only control that can be read by the application
331 The value is the minimum number of CAPTURE buffers that is necessary for hardware
337 <entry>This is a read-only control that can be read by the application
339 The value is the minimum number of OUTPUT buffers that is necessary for hardware
342 <row id="v4l2-alpha-component">
346 the capture buffer queue of a mem-to-mem device. When a mem-to-mem
348 (e.g. <link linkend="rgb-formats">packed RGB image formats</link>)
349 and the alpha value is not defined by the mem-to-mem input data
351 pixels. It is applicable to any pixel format that contains an alpha
373 &VIDIOC-QUERYCTRL; and &VIDIOC-QUERYMENU; ioctls, get and set a
374 control value with the &VIDIOC-G-CTRL; and &VIDIOC-S-CTRL; ioctls.
385 &v4l2-queryctrl; queryctrl;
386 &v4l2-querymenu; querymenu;
399 if (0 == ioctl (fd, &VIDIOC-QUERYMENU;, &querymenu)) {
410 if (0 == ioctl (fd, &VIDIOC-QUERYCTRL;, &queryctrl)) {
429 if (0 == ioctl (fd, &VIDIOC-QUERYCTRL;, &queryctrl)) {
452 &v4l2-queryctrl; queryctrl;
453 &v4l2-control; control;
458 if (-1 == ioctl (fd, &VIDIOC-QUERYCTRL;, &queryctrl)) {
463 printf ("V4L2_CID_BRIGHTNESS is not supported\n");
466 printf ("V4L2_CID_BRIGHTNESS is not supported\n");
472 if (-1 == ioctl (fd, &VIDIOC-S-CTRL;, &control)) {
481 if (0 == ioctl (fd, &VIDIOC-G-CTRL;, &control)) {
486 if (-1 == ioctl (fd, &VIDIOC-S-CTRL;, &control)
491 /* Ignore if V4L2_CID_CONTRAST is unsupported */
506 <section id="extended-controls">
520 standard is quite large and the currently supported hardware MPEG
522 many parameters relating to how the video is encoded into an MPEG
525 video is actually encoded into that format.</para>
541 <para>Three new ioctls are available: &VIDIOC-G-EXT-CTRLS;,
542 &VIDIOC-S-EXT-CTRLS; and &VIDIOC-TRY-EXT-CTRLS;. These ioctls act on
543 arrays of controls (as opposed to the &VIDIOC-G-CTRL; and
544 &VIDIOC-S-CTRL; ioctls that act on a single control). This is needed
545 since it is often required to atomically change several controls at
549 &v4l2-ext-controls;. This structure contains a pointer to the control
560 specified control class. An error is returned if this is not the
563 <para>It is also possible to use an empty control array (count
564 == 0) to check whether the specified control class is
567 <para>The control array is a &v4l2-ext-control; array. The
568 <structname>v4l2_ext_control</structname> structure is very similar to
569 &v4l2-control;, except for the fact that it also allows for 64-bit
572 <para>It is important to realize that due to the flexibility of
573 controls it is necessary to check whether the control you want to set
574 actually is supported in the driver and what the valid range of values
575 is. So use the &VIDIOC-QUERYCTRL; and &VIDIOC-QUERYMENU; ioctls to
576 check this. Also note that it is possible that some of the menu
579 return an error). A good example is the list of supported MPEG audio
592 controls is by using &VIDIOC-QUERYCTRL; in combination with the
597 &v4l2-queryctrl; qctrl;
600 while (0 == ioctl (fd, &VIDIOC-QUERYCTRL;, &qctrl)) {
607 <para>The initial control ID is set to 0 ORed with the
611 are found an error is returned.</para>
617 control class is found:</para>
622 while (0 == ioctl (fd, &VIDIOC-QUERYCTRL;, &qctrl)) {
631 <para>The 32-bit <structfield>qctrl.id</structfield> value is
637 class. It is guaranteed that these last 16 bits are always non-zero
639 driver-specific controls. The macro
647 1.8). But if it is supported, then it is guaranteed to enumerate over
648 all controls, including driver-private controls.</para>
654 <para>It is possible to create control panels for a graphical
663 <para>The flags field of &v4l2-queryctrl; also contains hints on
664 the behavior of the control. See the &VIDIOC-QUERYCTRL; documentation
668 <section id="mpeg-controls">
678 <table pgwide="1" frame="none" id="mpeg-control-id">
700 descriptor. Calling &VIDIOC-QUERYCTRL; for this control will return a
705 <row id="v4l2-mpeg-stream-type">
708 </row><row><entry spanname="descr">The MPEG-1, -2 or -4
711 stream types. This control is specific to multiplexed MPEG streams.
719 <entry>MPEG-2 program stream</entry>
723 <entry>MPEG-2 transport stream</entry>
727 <entry>MPEG-1 system stream</entry>
731 <entry>MPEG-2 DVD-compatible stream</entry>
735 <entry>MPEG-1 VCD-compatible stream</entry>
739 <entry>MPEG-2 SVCD-compatible stream</entry>
787 <row id="v4l2-mpeg-stream-vbi-fmt">
813 <row id="v4l2-mpeg-audio-sampling-freq">
838 <row id="v4l2-mpeg-audio-encoding">
842 This control is specific to multiplexed MPEG streams.
850 <entry>MPEG-1/2 Layer I encoding</entry>
854 <entry>MPEG-1/2 Layer II encoding</entry>
858 <entry>MPEG-1/2 Layer III encoding</entry>
862 <entry>MPEG-2/4 AAC (Advanced Audio Coding)</entry>
866 <entry>AC-3 aka ATSC A/52 encoding</entry>
872 <row id="v4l2-mpeg-audio-l1-bitrate">
875 </row><row><entry spanname="descr">MPEG-1/2 Layer I bitrate.
940 <row id="v4l2-mpeg-audio-l2-bitrate">
943 </row><row><entry spanname="descr">MPEG-1/2 Layer II bitrate.
1009 <row id="v4l2-mpeg-audio-l3-bitrate">
1012 </row><row><entry spanname="descr">MPEG-1/2 Layer III bitrate.
1084 <row id="v4l2-mpeg-audio-ac3-bitrate">
1087 </row><row><entry spanname="descr">AC-3 bitrate.
1173 <row id="v4l2-mpeg-audio-mode">
1202 <row id="v4l2-mpeg-audio-mode-extension">
1208 III is not (yet) supported. Possible values
1216 <entry>Subbands 4-31 in intensity stereo</entry>
1220 <entry>Subbands 8-31 in intensity stereo</entry>
1224 <entry>Subbands 12-31 in intensity stereo</entry>
1228 <entry>Subbands 16-31 in intensity stereo</entry>
1234 <row id="v4l2-mpeg-audio-emphasis">
1259 <row id="v4l2-mpeg-audio-crc">
1284 capturing. This is not done by muting audio hardware, which can still
1289 <row id="v4l2-mpeg-video-encoding">
1293 method. This control is specific to multiplexed MPEG streams.
1301 <entry>MPEG-1 Video encoding</entry>
1305 <entry>MPEG-2 Video encoding</entry>
1309 <entry>MPEG-4 AVC (H.264) Video encoding</entry>
1315 <row id="v4l2-mpeg-video-aspect">
1343 </row><row><entry spanname="descr">Number of B-Frames
1368 <row id="v4l2-mpeg-video-bitrate-mode">
1401 It is ignored if the video bitrate mode is set to constant
1417 fixed color when capturing. This is useful for testing, to produce a
1425 of the video. The supplied 32-bit integer is interpreted as follows (bit
1472 <row id="v4l2-mpeg-video-h264-vui-sar-idc">
1477 is defined in the table E-1 in the standard. Applicable to the H264 encoder.</entry>
1578 <row id="v4l2-mpeg-video-h264-level">
1658 <row id="v4l2-mpeg-video-mpeg4-level">
1706 <row id="v4l2-mpeg-video-h264-profile">
1791 <row id="v4l2-mpeg-video-mpeg4-profile">
1837 <row id="v4l2-mpeg-video-multi-slice-mode">
1870 <constant>V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE</constant> is set to <constant>V4L2_MPEG_VIDEO_MULTI…
1880 <constant>V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE</constant> is set to <constant>V4L2_MPEG_VIDEO_MULTI…
1885 <row id="v4l2-mpeg-video-h264-loop-filter-mode">
1897 <entry>Loop filter is enabled.</entry>
1901 <entry>Loop filter is disabled.</entry>
1905 <entry>Loop filter is disabled at the slice boundary.</entry>
1930 <row id="v4l2-mpeg-video-h264-entropy-mode">
1934 <row><entry spanname="descr">Entropy coding mode for H264 - CABAC/CAVALC.
1966 …<row><entry spanname="descr">Cyclic intra macroblock refresh. This is the number of continuous mac…
1967 refreshed every frame. Each frame a succesive set of macroblocks is refreshed until the cycle compl…
1977 If this control is disabled then the quantization parameter for each frame type is constant and set…
1979 If frame rate control is enabled then quantization parameter is adjusted to meet the chosen bitrate…
2126 …<row><entry spanname="descr">The Video Buffer Verifier size in kilobytes, it is used as a limitati…
2127 The VBV is defined in the standard as a mean to verify that the produced stream will be succesfully…
2128 The standard describes it as "Part of a hypothetical decoder that is conceptually connected to the
2129 output of the encoder. Its purpose is to provide a constraint on the variability of the data rate t…
2139 …<row><entry spanname="descr">The Coded Picture Buffer size in kilobytes, it is used as a limitatio…
2140 The CPB is defined in the H264 standard as a mean to verify that the produced stream will be succes…
2149 …<row><entry spanname="descr">Period between I-frames in the open GOP for H264. In case of an open …
2150 this is the period between two I-frames. The period between IDR (Instantaneous Decoding Refresh) fr…
2151 An IDR frame, which stands for Instantaneous Decoding Refresh is an I-frame after which no prior fr…
2157 <row id="v4l2-mpeg-video-header-mode">
2161 … <row><entry spanname="descr">Determines whether the header is returned as the first buffer or is
2170 <entry>The stream header is returned separately in the first buffer.</entry>
2174 <entry>The stream header is returned together with the first encoded frame.</entry>
2212 <table pgwide="1" frame="none" id="mfc51-control-id">
2233 …</row><row><entry spanname="descr">If the display delay is enabled then the decoder has to return a
2234 CAPTURE buffer after processing a certain number of OUTPUT buffers. If this number is low, then it …
2245 The decoder is forced to return a decoded frame after the set 'display delay' number of frames. If …
2261 …</row><row><entry spanname="descr">Padding enable in the encoder - use a color instead of repeatin…
2268 …Padding color in the encoder. Applicable to encoders. The supplied 32-bit integer is interpreted a…
2298 <para>Note 1: Valid only when the frame level RC is enabled.</para>
2301 <para>Note 3: It is not recommended to use the greater number than FRAME_RATE * (10^9 / BIT_RATE).<…
2309 Valid only when H.264 and macroblock level RC is enabled (<constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABL…
2317 Valid only when H.264 and macroblock level RC is enabled (<constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABL…
2325 Valid only when H.264 and macroblock level RC is enabled (<constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABL…
2333 Valid only when H.264 and macroblock level RC is enabled (<constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABL…
2337 <row id="v4l2-mpeg-mfc51-video-frame-skip-mode">
2351 <entry>Frame skip mode is disabled.</entry>
2355 …<entry>Frame skip mode enabled and buffer limit is set by the chosen level and is defined by the s…
2359 …<entry>Frame skip mode enabled and buffer limit is set by the VBV (MPEG1/2/4) or CPB (H264) buffer…
2368 </row><row><entry spanname="descr">Enable rate-control with fixed target bit.
2369 If this setting is enabled, then the rate control logic of the encoder will calculate the average b…
2372 the average bitrate for the whole stream will be smaller then the set bitrate. This is caused becau…
2373 average is calculated for smaller number of frames, on the other hand enabling this setting will en…
2378 <row id="v4l2-mpeg-mfc51-video-force-frame-type">
2394 <entry>Force an I-frame.</entry>
2398 <entry>Force a non-coded frame.</entry>
2415 <table pgwide="1" frame="none" id="cx2341x-control-id">
2433 <row id="v4l2-mpeg-cx2341x-video-spatial-filter-mode">
2457 <entry>integer (0-15)</entry>
2459 Spatial Filter. 0 = off, 15 = maximum. (Default is 0.)</entry>
2462 <row id="luma-spatial-filter-type">
2478 <entry>One-dimensional horizontal</entry>
2482 <entry>One-dimensional vertical</entry>
2486 <entry>Two-dimensional separable</entry>
2490 <entry>Two-dimensional symmetrical
2491 non-separable</entry>
2497 <row id="chroma-spatial-filter-type">
2513 <entry>One-dimensional horizontal</entry>
2519 <row id="v4l2-mpeg-cx2341x-video-temporal-filter-mode">
2543 <entry>integer (0-31)</entry>
2545 Temporal Filter. 0 = off, 31 = maximum. (Default is 8 for full-scale
2549 <row id="v4l2-mpeg-cx2341x-video-median-filter-type">
2584 <entry>integer (0-255)</entry>
2586 the luminance median filter is enabled (default 0)</entry>
2591 <entry>integer (0-255)</entry>
2593 the luminance median filter is enabled (default 255)</entry>
2598 <entry>integer (0-255)</entry>
2600 the chroma median filter is enabled (default 0)</entry>
2605 <entry>integer (0-255)</entry>
2607 the chroma median filter is enabled (default 255)</entry>
2615 can insert one empty MPEG-2 PES packet into the stream between every
2616 four video frames. The packet size is 2048 bytes, including the
2617 packet_start_code_prefix and stream_id fields. The stream_id is 0xBF
2627 <section id="camera-controls">
2634 <table pgwide="1" frame="none" id="camera-control-id">
2656 descriptor. Calling &VIDIOC-QUERYCTRL; for this control will return a
2661 <row id="v4l2-exposure-auto-type">
2667 features are enabled is undefined, drivers should ignore such
2699 time of the camera sensor. The exposure time is limited by the frame
2710 <constant>V4L2_CID_EXPOSURE_AUTO</constant> is set to
2713 rate. By default this feature is disabled (0) and the frame rate must
2722 camera horizontally by the specified amount. The unit is undefined. A
2725 cause motion. This is a write-only control.</entry>
2733 camera vertically by the specified amount. The unit is undefined. A
2735 zero does not cause motion. This is a write-only control.</entry>
2742 </row><row><entry spanname="descr">When this control is set,
2750 </row><row><entry spanname="descr">When this control is set,
2762 seconds, with valid values between -180 * 3600 and +180 * 3600
2773 values as arc seconds, with valid values between -180 * 3600 and +180
2782 focal point of the camera to the specified position. The unit is
2792 focal point of the camera by the specified amount. The unit is
2794 negative values towards infinity. This is a write-only control.</entry>
2803 is enabled is undefined, drivers should ignore such requests.</entry>
2811 focal length as an absolute value. The zoom unit is driver-specific and its
2822 wide-angle direction. The zoom unit is driver-specific. This is a write-only control.</entry>
2834 wide-angle direction. The zoom speed unit is driver-specific.</entry>
2842 camera's aperture to the specified value. The unit is undefined.
2851 camera's aperture by the specified amount. The unit is undefined.
2853 it one step further. This is a write-only control.</entry>
2861 by the camera. When this control is set to <constant>TRUE</constant> (1), no
2864 device is not restricted to these methods. Devices that implement the privacy
2871 </row><row><entry spanname="descr">Switch the band-stop filter of a
2872 camera sensor on or off, or specify its strength. Such band-stop filters can
2881 <section id="fm-tx-controls">
2889 <table pgwide="1" frame="none" id="fm-tx-control-id">
2912 descriptor. Calling &VIDIOC-QUERYCTRL; for this control will return a
2920 The range and step are driver-specific.</entry>
2934 This encodes up to 31 pre-defined programme types.</entry>
2941 It is intended for static display on a receiver. It is the primary aid to listeners in programme se…
2943 there is a full description of the correct character encoding for Programme Service name strings.
2944 Also from RDS specification, PS is usually a single eight character text. However, it is also possi…
2946 with steps of 8 characters. The result is it must always contain a string with size multiple of 8.<…
2952 …<row><entry spanname="descr">Sets the Radio Text info for transmission. It is a textual descriptio…
2953 what is being broadcasted. RDS Radio Text can be applied when broadcaster wishes to transmit longer…
2954 programme-related information or any other text. In these cases, RadioText should be used in additi…
2955 <constant>V4L2_CID_RDS_TX_PS_NAME</constant>. The encoding for Radio Text strings is also fully des…
2956 …of <xref linkend="en50067" />. The length of Radio Text strings depends on which RDS Block is being
2957 used to transmit it, either 32 (2A block) or 64 (2B block). However, it is also possible
2959 with steps of 32 or 64 characters. The result is it must always contain a string with size multiple…
2966 The limiter is useful when trying to maximize the audio volume, minimize receiver-generated
2975 Unit is in useconds. Step and range are driver-specific.</entry>
2982 The range and step are driver-specific.</entry>
2996 <row><entry spanname="descr">Sets the gain for audio compression feature. It is
2997 a dB value. The range and step are driver-specific.</entry>
3004 It is a dB value. The range and step are driver-specific.</entry>
3011 It is a useconds value. The range and step are driver-specific.</entry>
3018 It is a useconds value. The range and step are driver-specific.</entry>
3030 <row><entry spanname="descr">Configures pilot tone frequency deviation level. Unit is
3031 in Hz. The range and step are driver-specific.</entry>
3037 <row><entry spanname="descr">Configures pilot tone frequency value. Unit is
3038 in Hz. The range and step are driver-specific.</entry>
3044 …<row id="v4l2-preemphasis"><entry spanname="descr">Configures the pre-emphasis value for broadcast…
3045 A pre-emphasis filter is applied to the broadcast to accentuate the high audio frequencies.
3046 Depending on the region, a time constant of either 50 or 75 useconds is used. The enum v4l2_pr…
3047 defines possible values for pre-emphasis. Here they are:</entry>
3053 <entry>No pre-emphasis is applied.</entry>
3057 <entry>A pre-emphasis of 50 uS is used.</entry>
3061 <entry>A pre-emphasis of 75 uS is used.</entry>
3072 Unit is in dBuV. Range and step are driver-specific.</entry>
3079 manually or automatically if set to zero. Unit, range and step are driver-specific.</entry>
3090 <section id="flash-controls">
3096 <para>This is an <link linkend="experimental">experimental</link>
3108 of writing this, there is no xenon flash driver using this
3112 <section id="flash-controls-use-cases">
3119 Unsynchronised LED flash is controlled directly by the
3122 it ends. The host is fully responsible for the timing of
3133 The synchronised LED flash is pre-programmed by the host
3158 <table pgwide="1" frame="none" id="flash-control-id">
3188 <row id="v4l2-flash-led-mode">
3190 the high-power white LED attached to the flash controller.
3216 <row id="v4l2-flash-strobe-source"><entry
3225 <entry>The flash strobe is triggered by using
3230 <entry>The flash strobe is triggered by an
3231 external source. Typically this is a sensor,
3244 V4L2_CID_FLASH_LED_MODE is set to
3246 is set to V4L2_FLASH_STROBE_SOURCE_SOFTWARE. Setting this
3262 is strobing at the moment or not. This is a read-only
3271 flash strobe is stopped after this period of time has
3280 the flash LED is in flash mode
3313 V4L2_CID_FLASH_LED_MODE is set to V4L2_FLASH_LED_MODE_NONE
3315 have such an effect is chip dependent. Reading the faults
3331 the timeout set by the user ---
3332 V4L2_CID_FLASH_TIMEOUT control --- has expired.
3370 <entry spanname="descr">Is the flash ready to strobe?
3374 possible. This is a read-only control.</entry>