^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) .. _v4l2-selection-targets:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) *****************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Selection targets
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) *****************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) The precise meaning of the selection targets may be dependent on which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) of the two interfaces they are used.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) .. _v4l2-selection-targets-table:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) .. tabularcolumns:: |p{6.0cm}|p{1.4cm}|p{7.4cm}|p{1.2cm}|p{1.4cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) .. flat-table:: Selection target definitions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) :header-rows: 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) * - Target name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) - id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) - Definition
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) - Valid for V4L2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) - Valid for V4L2 subdev
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) * - ``V4L2_SEL_TGT_CROP``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) - 0x0000
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) - Crop rectangle. Defines the cropped area.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) * - ``V4L2_SEL_TGT_CROP_DEFAULT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) - 0x0001
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) - Suggested cropping rectangle that covers the "whole picture".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) This includes only active pixels and excludes other non-active
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) pixels such as black pixels.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) * - ``V4L2_SEL_TGT_CROP_BOUNDS``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) - 0x0002
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) - Bounds of the crop rectangle. All valid crop rectangles fit inside
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) the crop bounds rectangle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) * - ``V4L2_SEL_TGT_NATIVE_SIZE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) - 0x0003
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) - The native size of the device, e.g. a sensor's pixel array.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) ``left`` and ``top`` fields are zero for this target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) * - ``V4L2_SEL_TGT_COMPOSE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) - 0x0100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) - Compose rectangle. Used to configure scaling and composition.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) * - ``V4L2_SEL_TGT_COMPOSE_DEFAULT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) - 0x0101
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) - Suggested composition rectangle that covers the "whole picture".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) - No
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) * - ``V4L2_SEL_TGT_COMPOSE_BOUNDS``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) - 0x0102
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) - Bounds of the compose rectangle. All valid compose rectangles fit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) inside the compose bounds rectangle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) * - ``V4L2_SEL_TGT_COMPOSE_PADDED``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) - 0x0103
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) - The active area and all padding pixels that are inserted or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) modified by hardware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) - Yes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) - No