From bd08a0cd5f546916a9454ae2c35756ed77957458 Mon Sep 17 00:00:00 2001
From: Kamil Debski <k.debski@samsung.com>
Date: Fri, 11 Mar 2011 06:16:22 -0300
Subject: [PATCH] [media] v4l: Documentation for the NV12MT format

Added documentation for V4L2_PIX_FMT_NV12MT format. This is a YUV 4:2:0
format with macro block size of 64x32 and specific order of macro blocks
in the memory.

Signed-off-by: Kamil Debski <k.debski@samsung.com>
Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
---
 Documentation/DocBook/media-entities.tmpl    |   1 +
 Documentation/DocBook/v4l/nv12mt.gif         | Bin 0 -> 2108 bytes
 Documentation/DocBook/v4l/nv12mt_example.gif | Bin 0 -> 6858 bytes
 Documentation/DocBook/v4l/pixfmt-nv12mt.xml  |  74 +++++++++++++++++++
 Documentation/DocBook/v4l/pixfmt.xml         |   1 +
 5 files changed, 76 insertions(+)
 create mode 100644 Documentation/DocBook/v4l/nv12mt.gif
 create mode 100644 Documentation/DocBook/v4l/nv12mt_example.gif
 create mode 100644 Documentation/DocBook/v4l/pixfmt-nv12mt.xml

diff --git a/Documentation/DocBook/media-entities.tmpl b/Documentation/DocBook/media-entities.tmpl
index 40158ee3d369..5d259c632cdf 100644
--- a/Documentation/DocBook/media-entities.tmpl
+++ b/Documentation/DocBook/media-entities.tmpl
@@ -272,6 +272,7 @@
 <!ENTITY sub-grey SYSTEM "v4l/pixfmt-grey.xml">
 <!ENTITY sub-nv12 SYSTEM "v4l/pixfmt-nv12.xml">
 <!ENTITY sub-nv12m SYSTEM "v4l/pixfmt-nv12m.xml">
+<!ENTITY sub-nv12mt SYSTEM "v4l/pixfmt-nv12mt.xml">
 <!ENTITY sub-nv16 SYSTEM "v4l/pixfmt-nv16.xml">
 <!ENTITY sub-packed-rgb SYSTEM "v4l/pixfmt-packed-rgb.xml">
 <!ENTITY sub-packed-yuv SYSTEM "v4l/pixfmt-packed-yuv.xml">
diff --git a/Documentation/DocBook/v4l/nv12mt.gif b/Documentation/DocBook/v4l/nv12mt.gif
new file mode 100644
index 0000000000000000000000000000000000000000..ef2d4cf8367b97293eb9139de0f33d0a2ac236be
GIT binary patch
literal 2108
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
E0Zx`1>Hq)$

literal 0
HcmV?d00001

diff --git a/Documentation/DocBook/v4l/nv12mt_example.gif b/Documentation/DocBook/v4l/nv12mt_example.gif
new file mode 100644
index 0000000000000000000000000000000000000000..df81d68108eeb66569417b475984aa634385eebb
GIT binary patch
literal 6858
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
QV!O*W^7g0fL%`$z05eKhng9R*

literal 0
HcmV?d00001

diff --git a/Documentation/DocBook/v4l/pixfmt-nv12mt.xml b/Documentation/DocBook/v4l/pixfmt-nv12mt.xml
new file mode 100644
index 000000000000..5cb5bec8b653
--- /dev/null
+++ b/Documentation/DocBook/v4l/pixfmt-nv12mt.xml
@@ -0,0 +1,74 @@
+    <refentry>
+      <refmeta>
+	<refentrytitle>V4L2_PIX_FMT_NV12MT ('TM12')</refentrytitle>
+	&manvol;
+      </refmeta>
+      <refnamediv>
+	<refname id="V4L2-PIX-FMT-NV12MT"><constant>V4L2_PIX_FMT_NV12MT
+</constant></refname>
+	<refpurpose>Formats with &frac12; horizontal and vertical
+chroma resolution. This format has two planes - one for luminance and one for
+chrominance. Chroma samples are interleaved. The difference to
+<constant>V4L2_PIX_FMT_NV12</constant> is the memory layout. Pixels are
+grouped in macroblocks of 64x32 size. The order of macroblocks in memory is
+also not standard.
+	</refpurpose>
+      </refnamediv>
+      <refsect1>
+	<title>Description</title>
+
+	<para>This is the two-plane versions of the YUV 4:2:0 format where data
+is grouped into 64x32 macroblocks. The three components are separated into two
+sub-images or planes. The Y plane has one byte per pixel and pixels are grouped
+into 64x32 macroblocks. The CbCr plane has the same width, in bytes, as the Y
+plane (and the image), but is half as tall in pixels. The chroma plane is also
+grouped into 64x32 macroblocks.</para>
+	<para>Width of the buffer has to be aligned to the multiple of 128, and
+height alignment is 32. Every four adjactent buffers - two horizontally and two
+vertically are grouped together and are located in memory in Z or flipped Z
+order. </para>
+	<para>Layout of macroblocks in memory is presented in the following
+figure.</para>
+	<para><figure id="nv12mt">
+	    <title><constant>V4L2_PIX_FMT_NV12MT</constant> macroblock Z shape
+memory layout</title>
+	    <mediaobject>
+	      <imageobject>
+		<imagedata fileref="nv12mt.gif" format="GIF" />
+	      </imageobject>
+	    </mediaobject>
+	</figure>
+	The requirement that width is multiple of 128 is implemented because,
+the Z shape cannot be cut in half horizontally. In case the vertical resolution
+of macroblocks is odd then the last row of macroblocks is arranged in a linear
+order.  </para>
+	<para>In case of chroma the layout is identical. Cb and Cr samples are
+interleaved. Height of the buffer is aligned to 32.
+	</para>
+	<example>
+	  <title>Memory layout of macroblocks in <constant>V4L2_PIX_FMT_NV12
+</constant> format pixel image - extreme case</title>
+	<para>
+	<figure id="nv12mt">
+	    <title>Example <constant>V4L2_PIX_FMT_NV12MT</constant> memory
+layout of macroblocks</title>
+	    <mediaobject>
+	      <imageobject>
+		<imagedata fileref="nv12mt_example.gif" format="GIF" />
+	      </imageobject>
+	    </mediaobject>
+	</figure>
+	Memory layout of macroblocks of <constant>V4L2_PIX_FMT_NV12MT
+</constant> format in most extreme case.
+	</para>
+	</example>
+      </refsect1>
+    </refentry>
+
+  <!--
+Local Variables:
+mode: sgml
+sgml-parent-document: "pixfmt.sgml"
+indent-tabs-mode: nil
+End:
+  -->
diff --git a/Documentation/DocBook/v4l/pixfmt.xml b/Documentation/DocBook/v4l/pixfmt.xml
index f8436dcb7414..c6fdcbbd1b41 100644
--- a/Documentation/DocBook/v4l/pixfmt.xml
+++ b/Documentation/DocBook/v4l/pixfmt.xml
@@ -709,6 +709,7 @@ information.</para>
     &sub-yuv411p;
     &sub-nv12;
     &sub-nv12m;
+    &sub-nv12mt;
     &sub-nv16;
   </section>
 
-- 
2.50.1