From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: Received: from mx1.emlix.com ([193.175.82.87]:37906 "EHLO mx1.emlix.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755173AbZCZPFk (ORCPT ); Thu, 26 Mar 2009 11:05:40 -0400 Date: Thu, 26 Mar 2009 16:05:38 +0100 From: Daniel =?iso-8859-1?Q?Gl=F6ckner?= To: Mauro Carvalho Chehab Cc: linux-media@vger.kernel.org Subject: [patch] add documentation for planar YUV 4:4:4 format Message-ID: <20090326150538.GB28126@emlix.com> References: <1238077846-25751-1-git-send-email-dg@emlix.com> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <1238077846-25751-1-git-send-email-dg@emlix.com> Sender: linux-media-owner@vger.kernel.org List-ID: This patch adds the planar YUV 4:4:4 format to the v4l2 specification. Signed-off-by: Daniel Glöckner diff -r 55df63b82fef -r bd23aedbd597 v4l2-spec/Makefile --- a/v4l2-spec/Makefile Thu Mar 26 09:13:40 2009 +0100 +++ b/v4l2-spec/Makefile Thu Mar 26 14:06:09 2009 +0100 @@ -48,6 +48,7 @@ pixfmt-yuv411p.sgml \ pixfmt-yuv420.sgml \ pixfmt-yuv422p.sgml \ + pixfmt-yuv444p.sgml \ pixfmt-yuyv.sgml \ pixfmt-yvyu.sgml \ pixfmt.sgml \ diff -r 55df63b82fef -r bd23aedbd597 v4l2-spec/pixfmt-yuv444p.sgml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/v4l2-spec/pixfmt-yuv444p.sgml Thu Mar 26 14:06:09 2009 +0100 @@ -0,0 +1,171 @@ + + + V4L2_PIX_FMT_YUV444P ('444P') + &manvol; + + + V4L2_PIX_FMT_YUV444P + Format with full horizontal and vertical chroma resolution, +also known as YUV 4:4:4. Planar layout + + + Description + + This format is not commonly used. The three components are +separated into three sub-images or planes. The Y plane is first. The Cb plane +immediately follows the Y plane in memory. Following the Cb plane is the Cr +plane. All planes have on byte per pixel. + + If the Y plane has pad bytes after each row, then the Cr +and Cb planes have the same number of pad bytes after their rows. In other +words, one Cx row (including padding) is exactly as long as one Y row +(including padding). + + + <constant>V4L2_PIX_FMT_YUV444P</constant> 4 × 4 +pixel image + + + Byte Order. + Each cell is one byte. + + + + + + start + 0: + Y'00 + Y'01 + Y'02 + Y'03 + + + start + 4: + Y'10 + Y'11 + Y'12 + Y'13 + + + start + 8: + Y'20 + Y'21 + Y'22 + Y'23 + + + start + 12: + Y'30 + Y'31 + Y'32 + Y'33 + + + start + 16: + Cb00 + Cb01 + Cb02 + Cb03 + + + start + 20: + Cb10 + Cb11 + Cb12 + Cb13 + + + start + 24: + Cb20 + Cb21 + Cb22 + Cb23 + + + start + 28: + Cb30 + Cb31 + Cb32 + Cb33 + + + start + 32: + Cr00 + Cr01 + Cr02 + Cr03 + + + start + 36: + Cr10 + Cr11 + Cr12 + Cr13 + + + start + 40: + Cr20 + Cr21 + Cr22 + Cr23 + + + start + 44: + Cr30 + Cr31 + Cr32 + Cr33 + + + + + + + + + Color Sample Location. + + + + + + + 01 + 23 + + + 0 + Y/CY/C + Y/CY/C + + + 1 + Y/CY/C + Y/CY/C + + + 2 + Y/CY/C + Y/CY/C + + + 3 + Y/CY/C + Y/CY/C + + + + + + + + + + + diff -r 55df63b82fef -r bd23aedbd597 v4l2-spec/pixfmt.sgml --- a/v4l2-spec/pixfmt.sgml Thu Mar 26 09:13:40 2009 +0100 +++ b/v4l2-spec/pixfmt.sgml Thu Mar 26 14:06:09 2009 +0100 @@ -596,6 +596,7 @@ &sub-y41p; &sub-yuv420; &sub-yuv410; + &sub-yuv444p; &sub-yuv422p; &sub-yuv411p; &sub-nv12;