162306a36Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 262306a36Sopenharmony_ci 362306a36Sopenharmony_ci.. _v4l2-selection-targets: 462306a36Sopenharmony_ci 562306a36Sopenharmony_ci***************** 662306a36Sopenharmony_ciSelection targets 762306a36Sopenharmony_ci***************** 862306a36Sopenharmony_ci 962306a36Sopenharmony_ciThe precise meaning of the selection targets may be dependent on which 1062306a36Sopenharmony_ciof the two interfaces they are used. 1162306a36Sopenharmony_ci 1262306a36Sopenharmony_ci 1362306a36Sopenharmony_ci.. _v4l2-selection-targets-table: 1462306a36Sopenharmony_ci 1562306a36Sopenharmony_ci.. raw:: latex 1662306a36Sopenharmony_ci 1762306a36Sopenharmony_ci \small 1862306a36Sopenharmony_ci 1962306a36Sopenharmony_ci.. tabularcolumns:: |p{6.2cm}|p{1.4cm}|p{7.3cm}|p{1.2cm}|p{0.8cm}| 2062306a36Sopenharmony_ci 2162306a36Sopenharmony_ci.. cssclass:: longtable 2262306a36Sopenharmony_ci 2362306a36Sopenharmony_ci.. flat-table:: Selection target definitions 2462306a36Sopenharmony_ci :header-rows: 1 2562306a36Sopenharmony_ci :stub-columns: 0 2662306a36Sopenharmony_ci 2762306a36Sopenharmony_ci * - Target name 2862306a36Sopenharmony_ci - id 2962306a36Sopenharmony_ci - Definition 3062306a36Sopenharmony_ci - Valid for V4L2 3162306a36Sopenharmony_ci - Valid for V4L2 subdev 3262306a36Sopenharmony_ci * - ``V4L2_SEL_TGT_CROP`` 3362306a36Sopenharmony_ci - 0x0000 3462306a36Sopenharmony_ci - Crop rectangle. Defines the cropped area. 3562306a36Sopenharmony_ci - Yes 3662306a36Sopenharmony_ci - Yes 3762306a36Sopenharmony_ci * - ``V4L2_SEL_TGT_CROP_DEFAULT`` 3862306a36Sopenharmony_ci - 0x0001 3962306a36Sopenharmony_ci - Suggested cropping rectangle that covers the "whole picture". 4062306a36Sopenharmony_ci This includes only active pixels and excludes other non-active 4162306a36Sopenharmony_ci pixels such as black pixels. 4262306a36Sopenharmony_ci - Yes 4362306a36Sopenharmony_ci - Yes 4462306a36Sopenharmony_ci * - ``V4L2_SEL_TGT_CROP_BOUNDS`` 4562306a36Sopenharmony_ci - 0x0002 4662306a36Sopenharmony_ci - Bounds of the crop rectangle. All valid crop rectangles fit inside 4762306a36Sopenharmony_ci the crop bounds rectangle. 4862306a36Sopenharmony_ci - Yes 4962306a36Sopenharmony_ci - Yes 5062306a36Sopenharmony_ci * - ``V4L2_SEL_TGT_NATIVE_SIZE`` 5162306a36Sopenharmony_ci - 0x0003 5262306a36Sopenharmony_ci - The native size of the device, e.g. a sensor's pixel array. 5362306a36Sopenharmony_ci ``left`` and ``top`` fields are zero for this target. 5462306a36Sopenharmony_ci - Yes 5562306a36Sopenharmony_ci - Yes 5662306a36Sopenharmony_ci * - ``V4L2_SEL_TGT_COMPOSE`` 5762306a36Sopenharmony_ci - 0x0100 5862306a36Sopenharmony_ci - Compose rectangle. Used to configure scaling and composition. 5962306a36Sopenharmony_ci - Yes 6062306a36Sopenharmony_ci - Yes 6162306a36Sopenharmony_ci * - ``V4L2_SEL_TGT_COMPOSE_DEFAULT`` 6262306a36Sopenharmony_ci - 0x0101 6362306a36Sopenharmony_ci - Suggested composition rectangle that covers the "whole picture". 6462306a36Sopenharmony_ci - Yes 6562306a36Sopenharmony_ci - No 6662306a36Sopenharmony_ci * - ``V4L2_SEL_TGT_COMPOSE_BOUNDS`` 6762306a36Sopenharmony_ci - 0x0102 6862306a36Sopenharmony_ci - Bounds of the compose rectangle. All valid compose rectangles fit 6962306a36Sopenharmony_ci inside the compose bounds rectangle. 7062306a36Sopenharmony_ci - Yes 7162306a36Sopenharmony_ci - Yes 7262306a36Sopenharmony_ci * - ``V4L2_SEL_TGT_COMPOSE_PADDED`` 7362306a36Sopenharmony_ci - 0x0103 7462306a36Sopenharmony_ci - The active area and all padding pixels that are inserted or 7562306a36Sopenharmony_ci modified by hardware. 7662306a36Sopenharmony_ci - Yes 7762306a36Sopenharmony_ci - No 7862306a36Sopenharmony_ci 7962306a36Sopenharmony_ci.. raw:: latex 8062306a36Sopenharmony_ci 8162306a36Sopenharmony_ci \normalsize 82