1 .. SPDX-License-Identifier: GFDL-1.1-no-invari !! 1 .. Permission is granted to copy, distribute and/or modify this
>> 2 .. document under the terms of the GNU Free Documentation License,
>> 3 .. Version 1.1 or any later version published by the Free Software
>> 4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
>> 5 .. and no Back-Cover Texts. A copy of the license is included at
>> 6 .. Documentation/userspace-api/media/fdl-appendix.rst.
>> 7 ..
>> 8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
2 9
3 .. _v4l2-selection-flags: 10 .. _v4l2-selection-flags:
4 11
5 *************** 12 ***************
6 Selection flags 13 Selection flags
7 *************** 14 ***************
8 15
9 .. _v4l2-selection-flags-table: !! 16 .. tabularcolumns:: |p{5.2cm}|p{2.0cm}|p{6.5cm}|p{1.2cm}|p{1.6cm}|
10 <<
11 .. raw:: latex <<
12 <<
13 \small <<
14 <<
15 .. tabularcolumns:: |p{5.6cm}|p{2.0cm}|p{6.5cm <<
16 17
17 .. cssclass:: longtable !! 18 .. _v4l2-selection-flags-table:
18 19
19 .. flat-table:: Selection flag definitions 20 .. flat-table:: Selection flag definitions
20 :header-rows: 1 21 :header-rows: 1
21 :stub-columns: 0 22 :stub-columns: 0
22 23
23 * - Flag name 24 * - Flag name
24 - id 25 - id
25 - Definition 26 - Definition
26 - Valid for V4L2 27 - Valid for V4L2
27 - Valid for V4L2 subdev 28 - Valid for V4L2 subdev
28 * - ``V4L2_SEL_FLAG_GE`` 29 * - ``V4L2_SEL_FLAG_GE``
29 - (1 << 0) 30 - (1 << 0)
30 - Suggest the driver it should choose gr 31 - Suggest the driver it should choose greater or equal rectangle (in
31 size) than was requested. Albeit the d 32 size) than was requested. Albeit the driver may choose a lesser
32 size, it will only do so due to hardwa 33 size, it will only do so due to hardware limitations. Without this
33 flag (and ``V4L2_SEL_FLAG_LE``) the be 34 flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the
34 closest possible rectangle. 35 closest possible rectangle.
35 - Yes 36 - Yes
36 - Yes 37 - Yes
37 * - ``V4L2_SEL_FLAG_LE`` 38 * - ``V4L2_SEL_FLAG_LE``
38 - (1 << 1) 39 - (1 << 1)
39 - Suggest the driver it should choose le 40 - Suggest the driver it should choose lesser or equal rectangle (in
40 size) than was requested. Albeit the d 41 size) than was requested. Albeit the driver may choose a greater
41 size, it will only do so due to hardwa 42 size, it will only do so due to hardware limitations.
42 - Yes 43 - Yes
43 - Yes 44 - Yes
44 * - ``V4L2_SEL_FLAG_KEEP_CONFIG`` 45 * - ``V4L2_SEL_FLAG_KEEP_CONFIG``
45 - (1 << 2) 46 - (1 << 2)
46 - The configuration must not be propagat 47 - The configuration must not be propagated to any further processing
47 steps. If this flag is not given, the 48 steps. If this flag is not given, the configuration is propagated
48 inside the subdevice to all further pr 49 inside the subdevice to all further processing steps.
49 - No 50 - No
50 - Yes 51 - Yes
51 <<
52 .. raw:: latex <<
53 <<
54 \normalsize <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.