8.1.1. Selection targets

The precise meaning of the selection targets may be dependent on which of the two interfaces they are used.

Selection target definitions
Target name id Definition Valid for V4L2 Valid for V4L2 subdev
V4L2_SEL_TGT_CROP 0x0000 Crop rectangle. Defines the cropped area. Yes Yes
V4L2_SEL_TGT_CROP_DEFAULT 0x0001 Suggested cropping rectangle that covers the “whole picture”. Yes No
V4L2_SEL_TGT_CROP_BOUNDS 0x0002 Bounds of the crop rectangle. All valid crop rectangles fit inside the crop bounds rectangle. Yes Yes
V4L2_SEL_TGT_NATIVE_SIZE 0x0003 The native size of the device, e.g. a sensor’s pixel array. left and top fields are zero for this target. Setting the native size will generally only make sense for memory to memory devices where the software can create a canvas of a given size in which for example a video frame can be composed. In that case V4L2_SEL_TGT_NATIVE_SIZE can be used to configure the size of that canvas. Yes Yes
V4L2_SEL_TGT_COMPOSE 0x0100 Compose rectangle. Used to configure scaling and composition. Yes Yes
V4L2_SEL_TGT_COMPOSE_DEFAULT 0x0101 Suggested composition rectangle that covers the “whole picture”. Yes No
V4L2_SEL_TGT_COMPOSE_BOUNDS 0x0102 Bounds of the compose rectangle. All valid compose rectangles fit inside the compose bounds rectangle. Yes Yes
V4L2_SEL_TGT_COMPOSE_PADDED 0x0103 The active area and all padding pixels that are inserted or modified by hardware. Yes No