[media] v4l: Add packed Bayer raw10 pixel formats
authorAviv Greenberg <aviv.d.greenberg@intel.com>
Wed, 3 Dec 2014 11:14:09 +0000 (08:14 -0300)
committerMauro Carvalho Chehab <mchehab@osg.samsung.com>
Tue, 23 Dec 2014 12:57:09 +0000 (10:57 -0200)
These formats are just like 10-bit raw bayer formats that exist already, but
the pixels are not padded to byte boundaries. Instead, the eight high order
bits of four consecutive pixels are stored in four bytes, followed by a byte
of two low order bits of each of the four pixels.

Signed-off-by: Aviv Greenberg <aviv.d.greenberg@intel.com>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
Documentation/DocBook/media/v4l/pixfmt-srggb10p.xml [new file with mode: 0644]
Documentation/DocBook/media/v4l/pixfmt.xml
include/uapi/linux/videodev2.h

diff --git a/Documentation/DocBook/media/v4l/pixfmt-srggb10p.xml b/Documentation/DocBook/media/v4l/pixfmt-srggb10p.xml
new file mode 100644 (file)
index 0000000..30aa635
--- /dev/null
@@ -0,0 +1,99 @@
+    <refentry id="pixfmt-srggb10p">
+      <refmeta>
+       <refentrytitle>V4L2_PIX_FMT_SRGGB10P ('pRAA'),
+        V4L2_PIX_FMT_SGRBG10P ('pgAA'),
+        V4L2_PIX_FMT_SGBRG10P ('pGAA'),
+        V4L2_PIX_FMT_SBGGR10P ('pBAA'),
+        </refentrytitle>
+       &manvol;
+      </refmeta>
+      <refnamediv>
+       <refname id="V4L2-PIX-FMT-SRGGB10P"><constant>V4L2_PIX_FMT_SRGGB10P</constant></refname>
+       <refname id="V4L2-PIX-FMT-SGRBG10P"><constant>V4L2_PIX_FMT_SGRBG10P</constant></refname>
+       <refname id="V4L2-PIX-FMT-SGBRG10P"><constant>V4L2_PIX_FMT_SGBRG10P</constant></refname>
+       <refname id="V4L2-PIX-FMT-SBGGR10P"><constant>V4L2_PIX_FMT_SBGGR10P</constant></refname>
+       <refpurpose>10-bit packed Bayer formats</refpurpose>
+      </refnamediv>
+      <refsect1>
+       <title>Description</title>
+
+       <para>These four pixel formats are packed raw sRGB /
+       Bayer formats with 10 bits per colour. Every four consecutive
+       colour components are packed into 5 bytes. Each of the first 4
+       bytes contain the 8 high order bits of the pixels, and the
+       fifth byte contains the two least significants bits of each
+       pixel, in the same order.</para>
+
+       <para>Each n-pixel row contains n/2 green samples and n/2 blue
+       or red samples, with alternating green-red and green-blue
+       rows. They are conventionally described as GRGR... BGBG...,
+       RGRG... GBGB..., etc. Below is an example of one of these
+       formats:</para>
+
+    <example>
+      <title><constant>V4L2_PIX_FMT_SBGGR10P</constant> 4 &times; 4
+      pixel image</title>
+
+      <formalpara>
+       <title>Byte Order.</title>
+       <para>Each cell is one byte.
+         <informaltable frame="topbot" colsep="1" rowsep="1">
+           <tgroup cols="5" align="center" border="1">
+             <colspec align="left" colwidth="2*" />
+             <tbody valign="top">
+               <row>
+                 <entry>start&nbsp;+&nbsp;0:</entry>
+                 <entry>B<subscript>00high</subscript></entry>
+                 <entry>G<subscript>01high</subscript></entry>
+                 <entry>B<subscript>02high</subscript></entry>
+                 <entry>G<subscript>03high</subscript></entry>
+                 <entry>B<subscript>00low</subscript>(bits 7--6)
+                        G<subscript>01low</subscript>(bits 5--4)
+                        B<subscript>02low</subscript>(bits 3--2)
+                        G<subscript>03low</subscript>(bits 1--0)
+                 </entry>
+               </row>
+               <row>
+                 <entry>start&nbsp;+&nbsp;5:</entry>
+                 <entry>G<subscript>10high</subscript></entry>
+                 <entry>R<subscript>11high</subscript></entry>
+                 <entry>G<subscript>12high</subscript></entry>
+                 <entry>R<subscript>13high</subscript></entry>
+                 <entry>G<subscript>10low</subscript>(bits 7--6)
+                        R<subscript>11low</subscript>(bits 5--4)
+                        G<subscript>12low</subscript>(bits 3--2)
+                        R<subscript>13low</subscript>(bits 1--0)
+                 </entry>
+               </row>
+               <row>
+                 <entry>start&nbsp;+&nbsp;10:</entry>
+                 <entry>B<subscript>20high</subscript></entry>
+                 <entry>G<subscript>21high</subscript></entry>
+                 <entry>B<subscript>22high</subscript></entry>
+                 <entry>G<subscript>23high</subscript></entry>
+                 <entry>B<subscript>20low</subscript>(bits 7--6)
+                        G<subscript>21low</subscript>(bits 5--4)
+                        B<subscript>22low</subscript>(bits 3--2)
+                        G<subscript>23low</subscript>(bits 1--0)
+                 </entry>
+               </row>
+               <row>
+                 <entry>start&nbsp;+&nbsp;15:</entry>
+                 <entry>G<subscript>30high</subscript></entry>
+                 <entry>R<subscript>31high</subscript></entry>
+                 <entry>G<subscript>32high</subscript></entry>
+                 <entry>R<subscript>33high</subscript></entry>
+                 <entry>G<subscript>30low</subscript>(bits 7--6)
+                        R<subscript>31low</subscript>(bits 5--4)
+                        G<subscript>32low</subscript>(bits 3--2)
+                        R<subscript>33low</subscript>(bits 1--0)
+                 </entry>
+               </row>
+             </tbody>
+           </tgroup>
+         </informaltable>
+       </para>
+      </formalpara>
+    </example>
+  </refsect1>
+</refentry>
index d5eca4b8f74b41f8635c596d4747295213d0169f..5e0352c5032414bf7e89ed34ed4c1b875998798d 100644 (file)
@@ -1405,6 +1405,7 @@ access the palette, this must be done with ioctls of the Linux framebuffer API.<
     &sub-srggb8;
     &sub-sbggr16;
     &sub-srggb10;
+    &sub-srggb10p;
     &sub-srggb10alaw8;
     &sub-srggb10dpcm8;
     &sub-srggb12;
index f0b94b8fcdfb26a99aff56daeadb74fd50bccf72..fbdc3602ee2706201e9225097e73571b7f74c4ea 100644 (file)
@@ -463,6 +463,11 @@ struct v4l2_pix_format {
 #define V4L2_PIX_FMT_SGBRG10 v4l2_fourcc('G', 'B', '1', '0') /* 10  GBGB.. RGRG.. */
 #define V4L2_PIX_FMT_SGRBG10 v4l2_fourcc('B', 'A', '1', '0') /* 10  GRGR.. BGBG.. */
 #define V4L2_PIX_FMT_SRGGB10 v4l2_fourcc('R', 'G', '1', '0') /* 10  RGRG.. GBGB.. */
+       /* 10bit raw bayer packed, 5 bytes for every 4 pixels */
+#define V4L2_PIX_FMT_SBGGR10P v4l2_fourcc('p', 'B', 'A', 'A')
+#define V4L2_PIX_FMT_SGBRG10P v4l2_fourcc('p', 'G', 'A', 'A')
+#define V4L2_PIX_FMT_SGRBG10P v4l2_fourcc('p', 'g', 'A', 'A')
+#define V4L2_PIX_FMT_SRGGB10P v4l2_fourcc('p', 'R', 'A', 'A')
        /* 10bit raw bayer a-law compressed to 8 bits */
 #define V4L2_PIX_FMT_SBGGR10ALAW8 v4l2_fourcc('a', 'B', 'A', '8')
 #define V4L2_PIX_FMT_SGBRG10ALAW8 v4l2_fourcc('a', 'G', 'A', '8')