1 .. Permission is granted to copy, distribute and/or modify this
2 .. document under the terms of the GNU Free Documentation License,
3 .. Version 1.1 or any later version published by the Free Software
4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
5 .. and no Back-Cover Texts. A copy of the license is included at
6 .. Documentation/media/uapi/fdl-appendix.rst.
8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
10 .. _v4l2-selection-targets:
16 The precise meaning of the selection targets may be dependent on which
17 of the two interfaces they are used.
20 .. _v4l2-selection-targets-table:
22 .. tabularcolumns:: |p{6.0cm}|p{1.4cm}|p{7.4cm}|p{1.2cm}|p{1.4cm}|
24 .. flat-table:: Selection target definitions
32 - Valid for V4L2 subdev
33 * - ``V4L2_SEL_TGT_CROP``
35 - Crop rectangle. Defines the cropped area.
38 * - ``V4L2_SEL_TGT_CROP_DEFAULT``
40 - Suggested cropping rectangle that covers the "whole picture".
43 * - ``V4L2_SEL_TGT_CROP_BOUNDS``
45 - Bounds of the crop rectangle. All valid crop rectangles fit inside
46 the crop bounds rectangle.
49 * - ``V4L2_SEL_TGT_NATIVE_SIZE``
51 - The native size of the device, e.g. a sensor's pixel array.
52 ``left`` and ``top`` fields are zero for this target.
55 * - ``V4L2_SEL_TGT_COMPOSE``
57 - Compose rectangle. Used to configure scaling and composition.
60 * - ``V4L2_SEL_TGT_COMPOSE_DEFAULT``
62 - Suggested composition rectangle that covers the "whole picture".
65 * - ``V4L2_SEL_TGT_COMPOSE_BOUNDS``
67 - Bounds of the compose rectangle. All valid compose rectangles fit
68 inside the compose bounds rectangle.
71 * - ``V4L2_SEL_TGT_COMPOSE_PADDED``
73 - The active area and all padding pixels that are inserted or