| 1 |
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later |
| 2 |
.. c:namespace:: V4L |
| 3 |
|
| 4 |
.. _v4l2-selection-flags: |
| 5 |
|
| 6 |
*************** |
| 7 |
Selection flags |
| 8 |
*************** |
| 9 |
|
| 10 |
.. _v4l2-selection-flags-table: |
| 11 |
|
| 12 |
.. raw:: latex |
| 13 |
|
| 14 |
\small |
| 15 |
|
| 16 |
.. tabularcolumns:: |p{5.6cm}|p{2.0cm}|p{6.5cm}|p{1.2cm}|p{1.2cm}| |
| 17 |
|
| 18 |
.. cssclass:: longtable |
| 19 |
|
| 20 |
.. flat-table:: Selection flag definitions |
| 21 |
:header-rows: 1 |
| 22 |
:stub-columns: 0 |
| 23 |
|
| 24 |
* - Flag name |
| 25 |
- id |
| 26 |
- Definition |
| 27 |
- Valid for V4L2 |
| 28 |
- Valid for V4L2 subdev |
| 29 |
* - ``V4L2_SEL_FLAG_GE`` |
| 30 |
- (1 << 0) |
| 31 |
- Suggest the driver it should choose greater or equal rectangle (in |
| 32 |
size) than was requested. Albeit the driver may choose a lesser |
| 33 |
size, it will only do so due to hardware limitations. Without this |
| 34 |
flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the |
| 35 |
closest possible rectangle. |
| 36 |
- Yes |
| 37 |
- Yes |
| 38 |
* - ``V4L2_SEL_FLAG_LE`` |
| 39 |
- (1 << 1) |
| 40 |
- Suggest the driver it should choose lesser or equal rectangle (in |
| 41 |
size) than was requested. Albeit the driver may choose a greater |
| 42 |
size, it will only do so due to hardware limitations. |
| 43 |
- Yes |
| 44 |
- Yes |
| 45 |
* - ``V4L2_SEL_FLAG_KEEP_CONFIG`` |
| 46 |
- (1 << 2) |
| 47 |
- The configuration must not be propagated to any further processing |
| 48 |
steps. If this flag is not given, the configuration is propagated |
| 49 |
inside the subdevice to all further processing steps. |
| 50 |
- No |
| 51 |
- Yes |
| 52 |
|
| 53 |
.. raw:: latex |
| 54 |
|
| 55 |
\normalsize |