[v2,0/5] Document MT2110T/R with other improvements

Message ID 20230914150651.3114134-1-nicolas.dufresne@collabora.com (mailing list archive)
Series Document MT2110T/R with other improvements |


Nicolas Dufresne Sept. 14, 2023, 3:06 p.m. UTC
  Patch 0 to 8 cleanup a little the tiled format documentation, moving
a diagram to its place and moving all 10 bits packed formats under
the "Tiled NV15" umbrella.

Finally the last patch moves MT2110T and MT2110R from reserved
format into planar format with the appropriate documentation. It
worth mentioning that these two formats have a software
implementation in GStreamer [0] and libyuv [1] and additional
documentation has been produced by Google [1].

[0] https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/3444
[1] https://chromium.googlesource.com/libyuv/libyuv/+/refs/heads/main/source/convert.cc#863
[2] https://tinyurl.com/mtk-10bit-video-format 

Changes in v2:
  - (patch 3, 5) Improved wording as per review comments
  - (patch 3) Document both little and big endian form of NV12
  - (patch 3, 5) Document bytes from upper bits to lower bits
  - (patch 4) Properly placed the lower bits parrition first
  - (patch 4) Added partion sizes in the diagram
  - (patch 4) Reworded to reduce confusion
  - (patch 3, 5) Fixed header-rows/stub-columns

Nicolas Dufresne (5):
  docs: uapi: media: Properly locate NV12MT diagram
  docs: uapi: media: Move NV12_10BE_8L128 to NV15 section
  docs: uapi: media: Add common documentation of tiled NV15
  docs: uapi: media: Add a layout diagram for MT2110T
  docs: uapi: media: Document Mediatek 10bit tiled formats

 .../userspace-api/media/v4l/mt2110t.svg       | 315 +++++++++++++++++
 .../media/v4l/pixfmt-reserved.rst             |  13 -
 .../media/v4l/pixfmt-yuv-planar.rst           | 317 ++++++++++++++++--
 3 files changed, 598 insertions(+), 47 deletions(-)
 create mode 100644 Documentation/userspace-api/media/v4l/mt2110t.svg