1 .. -*- coding: utf-8; mode: rst -*-
3 .. _v4l2-selection-targets:
9 The precise meaning of the selection targets may be dependent on which
10 of the two interfaces they are used.
13 .. _v4l2-selection-targets-table:
15 .. tabularcolumns:: |p{5.8cm}|p{1.4cm}|p{6.5cm}|p{1.2cm}|p{1.6cm}|
17 .. flat-table:: Selection target definitions
32 - Valid for V4L2 subdev
36 - ``V4L2_SEL_TGT_CROP``
40 - Crop rectangle. Defines the cropped area.
48 - ``V4L2_SEL_TGT_CROP_DEFAULT``
52 - Suggested cropping rectangle that covers the "whole picture".
60 - ``V4L2_SEL_TGT_CROP_BOUNDS``
64 - Bounds of the crop rectangle. All valid crop rectangles fit inside
65 the crop bounds rectangle.
73 - ``V4L2_SEL_TGT_NATIVE_SIZE``
77 - The native size of the device, e.g. a sensor's pixel array.
78 ``left`` and ``top`` fields are zero for this target. Setting the
79 native size will generally only make sense for memory to memory
80 devices where the software can create a canvas of a given size in
81 which for example a video frame can be composed. In that case
82 V4L2_SEL_TGT_NATIVE_SIZE can be used to configure the size of
91 - ``V4L2_SEL_TGT_COMPOSE``
95 - Compose rectangle. Used to configure scaling and composition.
103 - ``V4L2_SEL_TGT_COMPOSE_DEFAULT``
107 - Suggested composition rectangle that covers the "whole picture".
115 - ``V4L2_SEL_TGT_COMPOSE_BOUNDS``
119 - Bounds of the compose rectangle. All valid compose rectangles fit
120 inside the compose bounds rectangle.
128 - ``V4L2_SEL_TGT_COMPOSE_PADDED``
132 - The active area and all padding pixels that are inserted or
133 modified by hardware.