Changes in videodev2.h.rst.exceptions

a5bd42aa - media: v4l2-ctrls: add support for V4L2_CTRL_WHICH_MIN/MAX_VAL

Mon, 03 Feb 2025 11:55:38 +0000

media: v4l2-ctrls: add support for V4L2_CTRL_WHICH_MIN/MAX_VALAdd the capability of retrieving the min and max values of acompound control.[Ricardo: Added static to v4l2_ctrl_type_op_(maximum|minimum) proto][Ricardo: Fix documentation]Signed-off-by: Yunke Cao Tested-by: Yunke Cao Signed-off-by: Ricardo Ribalda Link: https://lore.kernel.org/r/20250203-uvc-roi-v17-2-5900a9fed613@chromium.orgSigned-off-by: Hans de Goede Signed-off-by: Hans Verkuil [hverkuil: fix small alignment checkpatch warning] List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

3b9d7340 - media: v4l2_ctrl: Add V4L2_CTRL_TYPE_RECT

Mon, 03 Feb 2025 11:55:37 +0000

media: v4l2_ctrl: Add V4L2_CTRL_TYPE_RECTAdd p_rect to struct v4l2_ext_control with basic support inv4l2-ctrls.Reviewed-by: Laurent Pinchart Reviewed-by: Ricardo Ribalda Reviewed-by: Sergey Senozhatsky Reviewed-by: Daniel Scally Signed-off-by: Yunke Cao Reviewed-by: Hans Verkuil Tested-by: Yunke Cao Signed-off-by: Ricardo Ribalda Link: https://lore.kernel.org/r/20250203-uvc-roi-v17-1-5900a9fed613@chromium.orgSigned-off-by: Hans de Goede Signed-off-by: Hans Verkuil List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

06f55319 - media: videodev2: Add flag to unconditionally enumerate pixel formats

Mon, 26 Aug 2024 17:24:09 +0000

media: videodev2: Add flag to unconditionally enumerate pixel formatsWhen the index is ORed with V4L2_FMTDESC_FLAG_ENUM_ALL thedriver clears the flag and enumerate all the possible formats,ignoring any limitations from the current configuration.Drivers which do not support this flag yet always return an EINVAL.Signed-off-by: Benjamin Gaignard Signed-off-by: Hans Verkuil [hverkuil: improved doc when the new flag is not supported by the driver] List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

d2f2ce00 - media: docs: Add V4L2_CAP_EDID

Fri, 11 Nov 2022 13:29:03 +0000

media: docs: Add V4L2_CAP_EDIDAdd documentation for the new edid capability.Signed-off-by: Erling Ljunggren Signed-off-by: Hans Verkuil Reviewed-by: Sebastian Fricke Reviewed-by: Ricardo Ribalda Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

89345c2a - media: v4l: Support line-based metadata capture

Tue, 21 Feb 2023 17:37:29 +0000

media: v4l: Support line-based metadata captureMany camera sensors, among other devices, transmit embedded data and imagedata for each CSI-2 frame. This embedded data typically contains registerconfiguration of the sensor that has been used to capture the image dataof the same frame.The embedded data is received by the CSI-2 receiver and has the sameproperties as the image data, including that it is line based: it haswidth, height and bytesperline (stride).Add these fields to struct v4l2_meta_format and document them.Also add V4L2_FMT_FLAG_META_LINE_BASED to tell a given format isline-based i.e. these fields of struct v4l2_meta_format are valid for it.Signed-off-by: Sakari Ailus Reviewed-by: Laurent Pinchart Signed-off-by: Hans Verkuil List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

9de30f57 - media: Add AV1 uAPI

Mon, 06 Mar 2023 16:18:50 +0000

media: Add AV1 uAPIThis patch adds the AOMedia Video 1 (AV1) kernel uAPI.This design is based on currently available AV1 API implementations andaims to support the development of AV1 stateless video codecson Linux.Signed-off-by: Daniel Almeida Co-developed-by: Nicolas Dufresne Signed-off-by: Nicolas Dufresne Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

43cc0ec3 - media: v4l2-ctrls: add change flag for when dimensions change

Mon, 11 Jul 2022 10:21:10 +0000

media: v4l2-ctrls: add change flag for when dimensions changeAdd a new V4L2_EVENT_CTRL_CH_DIMENSIONS change flag that is issuedwhen the dimensions of an array change as a result of a__v4l2_ctrl_modify_dimensions() call.This will inform userspace that there are new dimensions.Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

4b923373 - media: videodev2.h.rst.exceptions: add missing exceptions

Fri, 15 Jul 2022 15:10:33 +0000

media: videodev2.h.rst.exceptions: add missing exceptionsAdd new exceptions for V4L2_COLORSPACE_LAST, V4L2_XFER_FUNC_LASTand V4L2_YCBCR_ENC_LAST.This fixes documentation warnings:Documentation/output/videodev2.h.rst:6: WARNING: undefined label: v4l2-colorspace-lastDocumentation/output/videodev2.h.rst:6: WARNING: undefined label: v4l2-xfer-func-lastDocumentation/output/videodev2.h.rst:6: WARNING: undefined label: v4l2-ycbcr-enc-lastSigned-off-by: Hans Verkuil Reviewed-by: Laurent Pinchart Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

16e2d220 - media: uapi: Move the HEVC stateless control type out of staging

Fri, 08 Jul 2022 16:21:51 +0000

media: uapi: Move the HEVC stateless control type out of stagingMove the HEVC stateless controls types out of staging,and re-number them.Signed-off-by: Benjamin Gaignard Reviewed-by: Ezequiel Garcia Acked-by: Nicolas Dufresne Tested-by: Jernej Skrabec Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

64fe675e - media: videodev2.h: add V4L2_CTRL_FLAG_DYNAMIC_ARRAY

Fri, 08 Jul 2022 16:21:40 +0000

media: videodev2.h: add V4L2_CTRL_FLAG_DYNAMIC_ARRAYAdd a new flag that indicates that this control is a dynamically sizedarray. 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 framecan be divided in many slices, so you want to provide an array containingslice information for each slice. Typically the number of slices is small,but the standard allow for hundreds or thousands of slices. Dynamic arraysare a good solution since sizing the array for the worst case would wastesubstantial amounts of memory.Acked-by: Nicolas Dufresne Tested-by: Benjamin Gaignard Tested-by: Jernej Skrabec Reviewed-by: Laurent Pinchart Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

b88dbe38 - media: uapi: Add VP9 stateless decoder controls

Tue, 16 Nov 2021 14:38:35 +0000

media: uapi: Add VP9 stateless decoder controlsAdd the VP9 stateless decoder controls plus the documentation that goeswith it.Signed-off-by: Boris Brezillon Co-developed-by: Ezequiel Garcia Signed-off-by: Ezequiel Garcia Signed-off-by: Adrian Ratiu Signed-off-by: Andrzej Pietrasiewicz Co-developed-by: Daniel Almeida Signed-off-by: Daniel Almeida Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

78eee7b5 - media: Rename V4L2_PIX_FMT_HM12 to V4L2_PIX_FMT_NV12_16L16

Thu, 05 Aug 2021 02:47:50 +0000

media: Rename V4L2_PIX_FMT_HM12 to V4L2_PIX_FMT_NV12_16L16The V4L2_PIX_FMT_HM12 format is actually a simple NV12 tiled format,with 16x16 linear tiles. Rename the format and move its documentationtogether with the other tiled NV12 formats.Keep V4L2_PIX_FMT_HM12 for application compatibility.Signed-off-by: Ezequiel Garcia Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

b84f60a3 - media: Rename V4L2_PIX_FMT_SUNXI_TILED_NV12 to V4L2_PIX_FMT_NV12_32L32

Thu, 05 Aug 2021 02:47:49 +0000

media: Rename V4L2_PIX_FMT_SUNXI_TILED_NV12 to V4L2_PIX_FMT_NV12_32L32The V4L2_PIX_FMT_SUNXI_TILED_NV12 format is actually a fairlycommon NV12 tiled format, with 32x32 linear tiles. Rename the formatand move its documentation together with the other tiled NV12 formats.Keep V4L2_PIX_FMT_SUNXI_TILED_NV12 for application compatibility.Signed-off-by: Ezequiel Garcia Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

45f97ba1 - media: uapi: mpeg2: Remove V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS

Thu, 29 Apr 2021 14:48:15 +0000

media: uapi: mpeg2: Remove V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMSThe Hantro and Cedrus drivers work in frame-mode,meaning they expect all the slices in a picture (either frameor field structure) to be passed in each OUTPUT buffer.These two are the only V4L2 MPEG-2 stateless decoders currentlysupported. Given the VA-API drivers also work per-frame,coalescing all the MPEG-2 slices in a buffer before the decodingoperation, it makes sense to not expect slice-mode drivers andtherefore remove V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS.This is done to avoid carrying an unused interface. If needed,this control can be added without breaking backwards compatibility.Note that this would mean introducing a enumerator control tospecify the decoding mode (see V4L2_CID_STATELESS_H264_DECODE_MODE).Signed-off-by: Ezequiel Garcia Co-developed-by: Nicolas Dufresne Signed-off-by: Nicolas Dufresne Tested-by: Jernej Skrabec Reviewed-by: Jernej Skrabec Tested-by: Daniel Almeida Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

f329e21e - media: uapi: mpeg2: Split sequence and picture parameters

Thu, 29 Apr 2021 14:48:12 +0000

media: uapi: mpeg2: Split sequence and picture parametersTypically, bitstreams are composed of a sequence header,followed by a number of picture header and picture coding extensionheaders. Each picture can be composed of a number of slices.Let's split the MPEG-2 uAPI to follow these semantics more closely,allowing more usage flexibility. Having these controls split upallows applications to set a sequence control at the beginningof a sequence, and then set a picture control for each frame.While here add padding fields where needed, and documentthe uAPI header thoroughly.Note that the V4L2_CTRL_TYPE_{} defines had to be moved becauseit clashes with existing ones. This is not really an issuesince they will be re-defined when the controls are movedout of staging.Signed-off-by: Ezequiel Garcia Tested-by: Jonas Karlman Tested-by: Jernej Skrabec Reviewed-by: Jernej Skrabec Tested-by: Daniel Almeida Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

118f3e15 - media: uapi: mpeg2: Rename "quantization" to "quantisation"

Thu, 29 Apr 2021 14:48:09 +0000

media: uapi: mpeg2: Rename "quantization" to "quantisation"The MPEG-2 specification refers to the quantisation matricesusing the word "quantisation". Make the V4L2 interface moreergonomic by matching the MPEG-2 spec.Signed-off-by: Ezequiel Garcia Tested-by: Jernej Skrabec Reviewed-by: Jernej Skrabec Tested-by: Daniel Almeida Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

5f8beb7d - media: docs: Document CLL and Mastering display colorimetry controls

Tue, 19 Jan 2021 15:08:59 +0000

media: docs: Document CLL and Mastering display colorimetry controlsDocument Content Light Level and Mastering Display v4l2 colorimetrycontrols.Signed-off-by: Stanimir Varbanov Reviewed-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

363240ce - media: uapi: move VP8 stateless controls out of staging

Thu, 04 Mar 2021 14:07:55 +0000

media: uapi: move VP8 stateless controls out of stagingUntil now, the VP8 V4L2 API was not exported as a public API,and only defined in a private media header (media/vp8-ctrls.h).The reason for this was a concern about the API not completeand ready to support VP8 decoding hardware accelerators.After reviewing the VP8 specification in detail, and nowthat the API is able to support Cedrus and Hantro G1,we can consider this ready.Signed-off-by: Ezequiel Garcia Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

4a85d1cb - media: userspace-api/media: finalize stateless FWHT codec docs

Thu, 26 Nov 2020 13:27:17 +0000

media: userspace-api/media: finalize stateless FWHT codec docsDocument V4L2_CTRL_TYPE_FWHT_PARAMS and p_fwht_params. Alsoimprove the V4L2_PIX_FMT_FWHT_STATELESS description.Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions

ee6fcc67 - media: doc: Replace symbol for V4L2_CTRL_TYPE_H264_PRED_WEIGHTS

Thu, 26 Nov 2020 09:36:14 +0000

media: doc: Replace symbol for V4L2_CTRL_TYPE_H264_PRED_WEIGHTSWhen V4L2_CTRL_TYPE_H264_PRED_WEIGHTS was added, adding a replacesymbol directive in videodev2.h.rst.exceptions was missed.Now that the control type is destaged, it's important to fix this.Signed-off-by: Ezequiel Garcia Signed-off-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab List of files: /linux-6.15/Documentation/userspace-api/media/videodev2.h.rst.exceptions