0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002
0003 .. _v4l2-selection-flags:
0004
0005 ***************
0006 Selection flags
0007 ***************
0008
0009 .. _v4l2-selection-flags-table:
0010
0011 .. raw:: latex
0012
0013 \small
0014
0015 .. tabularcolumns:: |p{5.6cm}|p{2.0cm}|p{6.5cm}|p{1.2cm}|p{1.2cm}|
0016
0017 .. cssclass:: longtable
0018
0019 .. flat-table:: Selection flag definitions
0020 :header-rows: 1
0021 :stub-columns: 0
0022
0023 * - Flag name
0024 - id
0025 - Definition
0026 - Valid for V4L2
0027 - Valid for V4L2 subdev
0028 * - ``V4L2_SEL_FLAG_GE``
0029 - (1 << 0)
0030 - Suggest the driver it should choose greater or equal rectangle (in
0031 size) than was requested. Albeit the driver may choose a lesser
0032 size, it will only do so due to hardware limitations. Without this
0033 flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the
0034 closest possible rectangle.
0035 - Yes
0036 - Yes
0037 * - ``V4L2_SEL_FLAG_LE``
0038 - (1 << 1)
0039 - Suggest the driver it should choose lesser or equal rectangle (in
0040 size) than was requested. Albeit the driver may choose a greater
0041 size, it will only do so due to hardware limitations.
0042 - Yes
0043 - Yes
0044 * - ``V4L2_SEL_FLAG_KEEP_CONFIG``
0045 - (1 << 2)
0046 - The configuration must not be propagated to any further processing
0047 steps. If this flag is not given, the configuration is propagated
0048 inside the subdevice to all further processing steps.
0049 - No
0050 - Yes
0051
0052 .. raw:: latex
0053
0054 \normalsize
