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". This includes only active pixels and excludes other non-active pixels such as black pixels.	Yes	Yes
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.	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
V4L2_SEL_TGT_ROI	0x0200	Current Region of Interest rectangle and auto-controls value.	Yes	No
V4L2_SEL_TGT_ROI_DEFAULT	0x0201	Suggested Region of Interest rectangle and auto-controls value.	Yes	No
V4L2_SEL_TGT_ROI_BOUNDS_MIN	0x0202	Minimum bounds of the Region of Interest rectangle and minimum auto-controls value. All valid ROI rectangles and auto-controls should be within minimum-maximum range.	Yes	No
V4L2_SEL_TGT_ROI_BOUNDS_MAX	0x0203	Maximum bounds of the Region of Interest rectangle and maximum auto-controls value. All valid ROI rectangles and auto-controls should be within minimum-maximum range.	Yes	No