162306a36Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
262306a36Sopenharmony_ci
362306a36Sopenharmony_ci.. _v4l2-selection-flags:
462306a36Sopenharmony_ci
562306a36Sopenharmony_ci***************
662306a36Sopenharmony_ciSelection flags
762306a36Sopenharmony_ci***************
862306a36Sopenharmony_ci
962306a36Sopenharmony_ci.. _v4l2-selection-flags-table:
1062306a36Sopenharmony_ci
1162306a36Sopenharmony_ci.. raw:: latex
1262306a36Sopenharmony_ci
1362306a36Sopenharmony_ci   \small
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_ci.. tabularcolumns:: |p{5.6cm}|p{2.0cm}|p{6.5cm}|p{1.2cm}|p{1.2cm}|
1662306a36Sopenharmony_ci
1762306a36Sopenharmony_ci.. cssclass:: longtable
1862306a36Sopenharmony_ci
1962306a36Sopenharmony_ci.. flat-table:: Selection flag definitions
2062306a36Sopenharmony_ci    :header-rows:  1
2162306a36Sopenharmony_ci    :stub-columns: 0
2262306a36Sopenharmony_ci
2362306a36Sopenharmony_ci    * - Flag name
2462306a36Sopenharmony_ci      - id
2562306a36Sopenharmony_ci      - Definition
2662306a36Sopenharmony_ci      - Valid for V4L2
2762306a36Sopenharmony_ci      - Valid for V4L2 subdev
2862306a36Sopenharmony_ci    * - ``V4L2_SEL_FLAG_GE``
2962306a36Sopenharmony_ci      - (1 << 0)
3062306a36Sopenharmony_ci      - Suggest the driver it should choose greater or equal rectangle (in
3162306a36Sopenharmony_ci	size) than was requested. Albeit the driver may choose a lesser
3262306a36Sopenharmony_ci	size, it will only do so due to hardware limitations. Without this
3362306a36Sopenharmony_ci	flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the
3462306a36Sopenharmony_ci	closest possible rectangle.
3562306a36Sopenharmony_ci      - Yes
3662306a36Sopenharmony_ci      - Yes
3762306a36Sopenharmony_ci    * - ``V4L2_SEL_FLAG_LE``
3862306a36Sopenharmony_ci      - (1 << 1)
3962306a36Sopenharmony_ci      - Suggest the driver it should choose lesser or equal rectangle (in
4062306a36Sopenharmony_ci	size) than was requested. Albeit the driver may choose a greater
4162306a36Sopenharmony_ci	size, it will only do so due to hardware limitations.
4262306a36Sopenharmony_ci      - Yes
4362306a36Sopenharmony_ci      - Yes
4462306a36Sopenharmony_ci    * - ``V4L2_SEL_FLAG_KEEP_CONFIG``
4562306a36Sopenharmony_ci      - (1 << 2)
4662306a36Sopenharmony_ci      - The configuration must not be propagated to any further processing
4762306a36Sopenharmony_ci	steps. If this flag is not given, the configuration is propagated
4862306a36Sopenharmony_ci	inside the subdevice to all further processing steps.
4962306a36Sopenharmony_ci      - No
5062306a36Sopenharmony_ci      - Yes
5162306a36Sopenharmony_ci
5262306a36Sopenharmony_ci.. raw:: latex
5362306a36Sopenharmony_ci
5462306a36Sopenharmony_ci   \normalsize
55