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