18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 28c2ecf20Sopenharmony_ci 38c2ecf20Sopenharmony_ci.. _v4l2-selection-targets: 48c2ecf20Sopenharmony_ci 58c2ecf20Sopenharmony_ci***************** 68c2ecf20Sopenharmony_ciSelection targets 78c2ecf20Sopenharmony_ci***************** 88c2ecf20Sopenharmony_ci 98c2ecf20Sopenharmony_ciThe precise meaning of the selection targets may be dependent on which 108c2ecf20Sopenharmony_ciof the two interfaces they are used. 118c2ecf20Sopenharmony_ci 128c2ecf20Sopenharmony_ci 138c2ecf20Sopenharmony_ci.. _v4l2-selection-targets-table: 148c2ecf20Sopenharmony_ci 158c2ecf20Sopenharmony_ci.. tabularcolumns:: |p{6.0cm}|p{1.4cm}|p{7.4cm}|p{1.2cm}|p{1.4cm}| 168c2ecf20Sopenharmony_ci 178c2ecf20Sopenharmony_ci.. flat-table:: Selection target definitions 188c2ecf20Sopenharmony_ci :header-rows: 1 198c2ecf20Sopenharmony_ci :stub-columns: 0 208c2ecf20Sopenharmony_ci 218c2ecf20Sopenharmony_ci * - Target name 228c2ecf20Sopenharmony_ci - id 238c2ecf20Sopenharmony_ci - Definition 248c2ecf20Sopenharmony_ci - Valid for V4L2 258c2ecf20Sopenharmony_ci - Valid for V4L2 subdev 268c2ecf20Sopenharmony_ci * - ``V4L2_SEL_TGT_CROP`` 278c2ecf20Sopenharmony_ci - 0x0000 288c2ecf20Sopenharmony_ci - Crop rectangle. Defines the cropped area. 298c2ecf20Sopenharmony_ci - Yes 308c2ecf20Sopenharmony_ci - Yes 318c2ecf20Sopenharmony_ci * - ``V4L2_SEL_TGT_CROP_DEFAULT`` 328c2ecf20Sopenharmony_ci - 0x0001 338c2ecf20Sopenharmony_ci - Suggested cropping rectangle that covers the "whole picture". 348c2ecf20Sopenharmony_ci This includes only active pixels and excludes other non-active 358c2ecf20Sopenharmony_ci pixels such as black pixels. 368c2ecf20Sopenharmony_ci - Yes 378c2ecf20Sopenharmony_ci - Yes 388c2ecf20Sopenharmony_ci * - ``V4L2_SEL_TGT_CROP_BOUNDS`` 398c2ecf20Sopenharmony_ci - 0x0002 408c2ecf20Sopenharmony_ci - Bounds of the crop rectangle. All valid crop rectangles fit inside 418c2ecf20Sopenharmony_ci the crop bounds rectangle. 428c2ecf20Sopenharmony_ci - Yes 438c2ecf20Sopenharmony_ci - Yes 448c2ecf20Sopenharmony_ci * - ``V4L2_SEL_TGT_NATIVE_SIZE`` 458c2ecf20Sopenharmony_ci - 0x0003 468c2ecf20Sopenharmony_ci - The native size of the device, e.g. a sensor's pixel array. 478c2ecf20Sopenharmony_ci ``left`` and ``top`` fields are zero for this target. 488c2ecf20Sopenharmony_ci - Yes 498c2ecf20Sopenharmony_ci - Yes 508c2ecf20Sopenharmony_ci * - ``V4L2_SEL_TGT_COMPOSE`` 518c2ecf20Sopenharmony_ci - 0x0100 528c2ecf20Sopenharmony_ci - Compose rectangle. Used to configure scaling and composition. 538c2ecf20Sopenharmony_ci - Yes 548c2ecf20Sopenharmony_ci - Yes 558c2ecf20Sopenharmony_ci * - ``V4L2_SEL_TGT_COMPOSE_DEFAULT`` 568c2ecf20Sopenharmony_ci - 0x0101 578c2ecf20Sopenharmony_ci - Suggested composition rectangle that covers the "whole picture". 588c2ecf20Sopenharmony_ci - Yes 598c2ecf20Sopenharmony_ci - No 608c2ecf20Sopenharmony_ci * - ``V4L2_SEL_TGT_COMPOSE_BOUNDS`` 618c2ecf20Sopenharmony_ci - 0x0102 628c2ecf20Sopenharmony_ci - Bounds of the compose rectangle. All valid compose rectangles fit 638c2ecf20Sopenharmony_ci inside the compose bounds rectangle. 648c2ecf20Sopenharmony_ci - Yes 658c2ecf20Sopenharmony_ci - Yes 668c2ecf20Sopenharmony_ci * - ``V4L2_SEL_TGT_COMPOSE_PADDED`` 678c2ecf20Sopenharmony_ci - 0x0103 688c2ecf20Sopenharmony_ci - The active area and all padding pixels that are inserted or 698c2ecf20Sopenharmony_ci modified by hardware. 708c2ecf20Sopenharmony_ci - Yes 718c2ecf20Sopenharmony_ci - No 72