aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook/media/v4l/pixfmt.xml
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/DocBook/media/v4l/pixfmt.xml')
-rw-r--r--Documentation/DocBook/media/v4l/pixfmt.xml39
1 files changed, 39 insertions, 0 deletions
diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
index e58934c92895..bf94f417592c 100644
--- a/Documentation/DocBook/media/v4l/pixfmt.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt.xml
@@ -708,6 +708,7 @@ information.</para>
708 &sub-y41p; 708 &sub-y41p;
709 &sub-yuv420; 709 &sub-yuv420;
710 &sub-yuv420m; 710 &sub-yuv420m;
711 &sub-yvu420m;
711 &sub-yuv410; 712 &sub-yuv410;
712 &sub-yuv422p; 713 &sub-yuv422p;
713 &sub-yuv411p; 714 &sub-yuv411p;
@@ -757,6 +758,11 @@ extended control <constant>V4L2_CID_MPEG_STREAM_TYPE</constant>, see
757 <entry>'AVC1'</entry> 758 <entry>'AVC1'</entry>
758 <entry>H264 video elementary stream without start codes.</entry> 759 <entry>H264 video elementary stream without start codes.</entry>
759 </row> 760 </row>
761 <row id="V4L2-PIX-FMT-H264-MVC">
762 <entry><constant>V4L2_PIX_FMT_H264_MVC</constant></entry>
763 <entry>'MVC'</entry>
764 <entry>H264 MVC video elementary stream.</entry>
765 </row>
760 <row id="V4L2-PIX-FMT-H263"> 766 <row id="V4L2-PIX-FMT-H263">
761 <entry><constant>V4L2_PIX_FMT_H263</constant></entry> 767 <entry><constant>V4L2_PIX_FMT_H263</constant></entry>
762 <entry>'H263'</entry> 768 <entry>'H263'</entry>
@@ -792,6 +798,11 @@ extended control <constant>V4L2_CID_MPEG_STREAM_TYPE</constant>, see
792 <entry>'VC1L'</entry> 798 <entry>'VC1L'</entry>
793 <entry>VC1, SMPTE 421M Annex L compliant stream.</entry> 799 <entry>VC1, SMPTE 421M Annex L compliant stream.</entry>
794 </row> 800 </row>
801 <row id="V4L2-PIX-FMT-VP8">
802 <entry><constant>V4L2_PIX_FMT_VP8</constant></entry>
803 <entry>'VP8'</entry>
804 <entry>VP8 video elementary stream.</entry>
805 </row>
795 </tbody> 806 </tbody>
796 </tgroup> 807 </tgroup>
797 </table> 808 </table>
@@ -995,6 +1006,34 @@ the other bits are set to 0.</entry>
995 <entry>Old 6-bit greyscale format. Only the most significant 6 bits of each byte are used, 1006 <entry>Old 6-bit greyscale format. Only the most significant 6 bits of each byte are used,
996the other bits are set to 0.</entry> 1007the other bits are set to 0.</entry>
997 </row> 1008 </row>
1009 <row id="V4L2-PIX-FMT-S5C-UYVY-JPG">
1010 <entry><constant>V4L2_PIX_FMT_S5C_UYVY_JPG</constant></entry>
1011 <entry>'S5CI'</entry>
1012 <entry>Two-planar format used by Samsung S5C73MX cameras. The
1013first plane contains interleaved JPEG and UYVY image data, followed by meta data
1014in form of an array of offsets to the UYVY data blocks. The actual pointer array
1015follows immediately the interleaved JPEG/UYVY data, the number of entries in
1016this array equals the height of the UYVY image. Each entry is a 4-byte unsigned
1017integer in big endian order and it's an offset to a single pixel line of the
1018UYVY image. The first plane can start either with JPEG or UYVY data chunk. The
1019size of a single UYVY block equals the UYVY image's width multiplied by 2. The
1020size of a JPEG chunk depends on the image and can vary with each line.
1021<para>The second plane, at an offset of 4084 bytes, contains a 4-byte offset to
1022the pointer array in the first plane. This offset is followed by a 4-byte value
1023indicating size of the pointer array. All numbers in the second plane are also
1024in big endian order. Remaining data in the second plane is undefined. The
1025information in the second plane allows to easily find location of the pointer
1026array, which can be different for each frame. The size of the pointer array is
1027constant for given UYVY image height.</para>
1028<para>In order to extract UYVY and JPEG frames an application can initially set
1029a data pointer to the start of first plane and then add an offset from the first
1030entry of the pointers table. Such a pointer indicates start of an UYVY image
1031pixel line. Whole UYVY line can be copied to a separate buffer. These steps
1032should be repeated for each line, i.e. the number of entries in the pointer
1033array. Anything what's in between the UYVY lines is JPEG data and should be
1034concatenated to form the JPEG stream. </para>
1035</entry>
1036 </row>
998 </tbody> 1037 </tbody>
999 </tgroup> 1038 </tgroup>
1000 </table> 1039 </table>