18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ci.. _v4l2-selection-flags:
48c2ecf20Sopenharmony_ci
58c2ecf20Sopenharmony_ci***************
68c2ecf20Sopenharmony_ciSelection flags
78c2ecf20Sopenharmony_ci***************
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_ci.. tabularcolumns:: |p{5.2cm}|p{2.0cm}|p{6.5cm}|p{1.2cm}|p{1.6cm}|
108c2ecf20Sopenharmony_ci
118c2ecf20Sopenharmony_ci.. _v4l2-selection-flags-table:
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_ci.. flat-table:: Selection flag definitions
148c2ecf20Sopenharmony_ci    :header-rows:  1
158c2ecf20Sopenharmony_ci    :stub-columns: 0
168c2ecf20Sopenharmony_ci
178c2ecf20Sopenharmony_ci    * - Flag name
188c2ecf20Sopenharmony_ci      - id
198c2ecf20Sopenharmony_ci      - Definition
208c2ecf20Sopenharmony_ci      - Valid for V4L2
218c2ecf20Sopenharmony_ci      - Valid for V4L2 subdev
228c2ecf20Sopenharmony_ci    * - ``V4L2_SEL_FLAG_GE``
238c2ecf20Sopenharmony_ci      - (1 << 0)
248c2ecf20Sopenharmony_ci      - Suggest the driver it should choose greater or equal rectangle (in
258c2ecf20Sopenharmony_ci	size) than was requested. Albeit the driver may choose a lesser
268c2ecf20Sopenharmony_ci	size, it will only do so due to hardware limitations. Without this
278c2ecf20Sopenharmony_ci	flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the
288c2ecf20Sopenharmony_ci	closest possible rectangle.
298c2ecf20Sopenharmony_ci      - Yes
308c2ecf20Sopenharmony_ci      - Yes
318c2ecf20Sopenharmony_ci    * - ``V4L2_SEL_FLAG_LE``
328c2ecf20Sopenharmony_ci      - (1 << 1)
338c2ecf20Sopenharmony_ci      - Suggest the driver it should choose lesser or equal rectangle (in
348c2ecf20Sopenharmony_ci	size) than was requested. Albeit the driver may choose a greater
358c2ecf20Sopenharmony_ci	size, it will only do so due to hardware limitations.
368c2ecf20Sopenharmony_ci      - Yes
378c2ecf20Sopenharmony_ci      - Yes
388c2ecf20Sopenharmony_ci    * - ``V4L2_SEL_FLAG_KEEP_CONFIG``
398c2ecf20Sopenharmony_ci      - (1 << 2)
408c2ecf20Sopenharmony_ci      - The configuration must not be propagated to any further processing
418c2ecf20Sopenharmony_ci	steps. If this flag is not given, the configuration is propagated
428c2ecf20Sopenharmony_ci	inside the subdevice to all further processing steps.
438c2ecf20Sopenharmony_ci      - No
448c2ecf20Sopenharmony_ci      - Yes
45