videodev2.h: add V4L2_CTRL_FLAG_DYNAMIC_ARRAY
authorHans Verkuil <hverkuil-cisco@xs4all.nl>
Wed, 14 Apr 2021 13:01:16 +0000 (15:01 +0200)
committerDom Cobley <popcornmix@gmail.com>
Mon, 21 Mar 2022 16:04:20 +0000 (16:04 +0000)
commit8cb89ec1479f41ff12d48af4f9b58dbf374f008f
treebf631e2590a6162e797bbf26cf1ff034e7cf544c
parentd18b037ec2e315a8ad8b0f393470641760441c86
videodev2.h: add V4L2_CTRL_FLAG_DYNAMIC_ARRAY

Add a new flag that indicates that this control is a dynamically sized
array. Also document this flag.

Currently dynamically sized arrays are limited to one dimensional arrays,
but that might change in the future if there is a need for it.

The initial use-case of dynamic arrays are stateless codecs. A frame
can be divided in many slices, so you want to provide an array containing
slice information for each slice. Typically the number of slices is small,
but the standard allow for hundreds or thousands of slices. Dynamic arrays
are a good solution since sizing the array for the worst case would waste
substantial amounts of memory.

Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
(cherry picked from commit c095ad310b223b9de38d491c9f66533d05586b45)
Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst
include/uapi/linux/videodev2.h