1 .. SPDX-License-Identifier: GFDL-1.1-no-invari 1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 2
3 .. _v4l2-selection-targets: 3 .. _v4l2-selection-targets:
4 4
5 ***************** 5 *****************
6 Selection targets 6 Selection targets
7 ***************** 7 *****************
8 8
9 The precise meaning of the selection targets m 9 The precise meaning of the selection targets may be dependent on which
10 of the two interfaces they are used. 10 of the two interfaces they are used.
11 11
12 12
13 .. _v4l2-selection-targets-table: 13 .. _v4l2-selection-targets-table:
14 14
15 .. raw:: latex 15 .. raw:: latex
16 16
17 \small 17 \small
18 18
19 .. tabularcolumns:: |p{6.2cm}|p{1.4cm}|p{7.3cm 19 .. tabularcolumns:: |p{6.2cm}|p{1.4cm}|p{7.3cm}|p{1.2cm}|p{0.8cm}|
20 20
21 .. cssclass:: longtable 21 .. cssclass:: longtable
22 22
23 .. flat-table:: Selection target definitions 23 .. flat-table:: Selection target definitions
24 :header-rows: 1 24 :header-rows: 1
25 :stub-columns: 0 25 :stub-columns: 0
26 26
27 * - Target name 27 * - Target name
28 - id 28 - id
29 - Definition 29 - Definition
30 - Valid for V4L2 30 - Valid for V4L2
31 - Valid for V4L2 subdev 31 - Valid for V4L2 subdev
32 * - ``V4L2_SEL_TGT_CROP`` 32 * - ``V4L2_SEL_TGT_CROP``
33 - 0x0000 33 - 0x0000
34 - Crop rectangle. Defines the cropped ar 34 - Crop rectangle. Defines the cropped area.
35 - Yes 35 - Yes
36 - Yes 36 - Yes
37 * - ``V4L2_SEL_TGT_CROP_DEFAULT`` 37 * - ``V4L2_SEL_TGT_CROP_DEFAULT``
38 - 0x0001 38 - 0x0001
39 - Suggested cropping rectangle that cove 39 - Suggested cropping rectangle that covers the "whole picture".
40 This includes only active pixels and e 40 This includes only active pixels and excludes other non-active
41 pixels such as black pixels. 41 pixels such as black pixels.
42 - Yes 42 - Yes
43 - Yes 43 - Yes
44 * - ``V4L2_SEL_TGT_CROP_BOUNDS`` 44 * - ``V4L2_SEL_TGT_CROP_BOUNDS``
45 - 0x0002 45 - 0x0002
46 - Bounds of the crop rectangle. All vali 46 - Bounds of the crop rectangle. All valid crop rectangles fit inside
47 the crop bounds rectangle. 47 the crop bounds rectangle.
48 - Yes 48 - Yes
49 - Yes 49 - Yes
50 * - ``V4L2_SEL_TGT_NATIVE_SIZE`` 50 * - ``V4L2_SEL_TGT_NATIVE_SIZE``
51 - 0x0003 51 - 0x0003
52 - The native size of the device, e.g. a 52 - The native size of the device, e.g. a sensor's pixel array.
53 ``left`` and ``top`` fields are zero f 53 ``left`` and ``top`` fields are zero for this target.
54 - Yes 54 - Yes
55 - Yes 55 - Yes
56 * - ``V4L2_SEL_TGT_COMPOSE`` 56 * - ``V4L2_SEL_TGT_COMPOSE``
57 - 0x0100 57 - 0x0100
58 - Compose rectangle. Used to configure s 58 - Compose rectangle. Used to configure scaling and composition.
59 - Yes 59 - Yes
60 - Yes 60 - Yes
61 * - ``V4L2_SEL_TGT_COMPOSE_DEFAULT`` 61 * - ``V4L2_SEL_TGT_COMPOSE_DEFAULT``
62 - 0x0101 62 - 0x0101
63 - Suggested composition rectangle that c 63 - Suggested composition rectangle that covers the "whole picture".
64 - Yes 64 - Yes
65 - No 65 - No
66 * - ``V4L2_SEL_TGT_COMPOSE_BOUNDS`` 66 * - ``V4L2_SEL_TGT_COMPOSE_BOUNDS``
67 - 0x0102 67 - 0x0102
68 - Bounds of the compose rectangle. All v 68 - Bounds of the compose rectangle. All valid compose rectangles fit
69 inside the compose bounds rectangle. 69 inside the compose bounds rectangle.
70 - Yes 70 - Yes
71 - Yes 71 - Yes
72 * - ``V4L2_SEL_TGT_COMPOSE_PADDED`` 72 * - ``V4L2_SEL_TGT_COMPOSE_PADDED``
73 - 0x0103 73 - 0x0103
74 - The active area and all padding pixels 74 - The active area and all padding pixels that are inserted or
75 modified by hardware. 75 modified by hardware.
76 - Yes 76 - Yes
77 - No 77 - No
78 78
79 .. raw:: latex 79 .. raw:: latex
80 80
81 \normalsize 81 \normalsize
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.