From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751397AbcGOP2y (ORCPT ); Fri, 15 Jul 2016 11:28:54 -0400 Received: from lists.s-osg.org ([54.187.51.154]:36352 "EHLO lists.s-osg.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751215AbcGOP2w (ORCPT ); Fri, 15 Jul 2016 11:28:52 -0400 Date: Fri, 15 Jul 2016 12:28:45 -0300 From: Mauro Carvalho Chehab To: Ricardo Ribalda Delgado Cc: Hans Verkuil , Laurent Pinchart , Sakari Ailus , Antti Palosaari , Guennadi Liakhovetski , Helen Mae Koike Fornazier , Philipp Zabel , Shuah Khan , linux-media@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 2/6] [media] Documentation: Add HSV format Message-ID: <20160715122845.7f357277@recife.lan> In-Reply-To: <1468595816-31272-3-git-send-email-ricardo.ribalda@gmail.com> References: <1468595816-31272-1-git-send-email-ricardo.ribalda@gmail.com> <1468595816-31272-3-git-send-email-ricardo.ribalda@gmail.com> Organization: Samsung X-Mailer: Claws Mail 3.13.2 (GTK+ 2.24.30; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi Ricardo, I'm not seeing patch 1. Anyway, please send documentation patches against the rst files. They're at the "docs-next" branch and will be merged upstream on this merge window. After its merge, we'll drop the DocBook. Thanks, Mauro Em Fri, 15 Jul 2016 17:16:52 +0200 Ricardo Ribalda Delgado escreveu: > Describe the HSV formats. > > Signed-off-by: Ricardo Ribalda Delgado > --- > .../DocBook/media/v4l/pixfmt-packed-hsv.xml | 195 +++++++++++++++++++++ > Documentation/DocBook/media/v4l/pixfmt.xml | 13 ++ > Documentation/DocBook/media/v4l/v4l2.xml | 8 + > 3 files changed, 216 insertions(+) > create mode 100644 Documentation/DocBook/media/v4l/pixfmt-packed-hsv.xml > > diff --git a/Documentation/DocBook/media/v4l/pixfmt-packed-hsv.xml b/Documentation/DocBook/media/v4l/pixfmt-packed-hsv.xml > new file mode 100644 > index 000000000000..3b41d567e32b > --- /dev/null > +++ b/Documentation/DocBook/media/v4l/pixfmt-packed-hsv.xml > @@ -0,0 +1,195 @@ > + > + > + Packed HSV formats > + &manvol; > + > + > + Packed HSV formats > + Packed HSV formats > + > + > + Description > + > + The HUE (h) is meassured in degrees, one LSB represents two > +degrees. The SATURATION (s) and the VALUE (v) are meassured in percentage > +of the cylinder: 0 being the smallest value and 255 the maximum. > + The values are packed in 24 or 32 bit formats. > + > + > + Packed YUV Image Formats > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + > + Identifier > + Code > +   > + Byte 0 in memory > + Byte 1 > + Byte 2 > + Byte 3 > + > + > +   > +   > + Bit > + 7 > + 6 > + 5 > + 4 > + 3 > + 2 > + 1 > + 0 > +   > + 7 > + 6 > + 5 > + 4 > + 3 > + 2 > + 1 > + 0 > +   > + 7 > + 6 > + 5 > + 4 > + 3 > + 2 > + 1 > + 0 > +   > + 7 > + 6 > + 5 > + 4 > + 3 > + 2 > + 1 > + 0 > + > + > + > + > + V4L2_PIX_FMT_HSV32 > + 'HSV4' > + > + - > + - > + - > + - > + - > + - > + - > + - > + > + h7 > + h6 > + h5 > + h4 > + h3 > + h2 > + h1 > + h0 > + > + s7 > + s6 > + s5 > + s4 > + s3 > + s2 > + s1 > + s0 > + > + v7 > + v6 > + v5 > + v4 > + v3 > + v2 > + v1 > + v0 > + > + > + V4L2_PIX_FMT_HSV24 > + 'HSV3' > + > + h7 > + h6 > + h5 > + h4 > + h3 > + h2 > + h1 > + h0 > + > + s7 > + s6 > + s5 > + s4 > + s3 > + s2 > + s1 > + s0 > + > + v7 > + v6 > + v5 > + v4 > + v3 > + v2 > + v1 > + v0 > + > + > + > +
> + > + Bit 7 is the most significant bit. > + > + > + > diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml > index 5a08aeea4360..7b081a6bdc61 100644 > --- a/Documentation/DocBook/media/v4l/pixfmt.xml > +++ b/Documentation/DocBook/media/v4l/pixfmt.xml > @@ -1740,6 +1740,19 @@ extended control V4L2_CID_MPEG_STREAM_TYPE, see > > > > +
> + HSV Formats > + > + These formats store the color information of the image > +in a geometrical representation. The colors are mapped into a > +cylinder, where the angle is the HUE, the height is the VALUE > +and the distance to the center is the SATURATION. This is a very > +useful format for image segmentation algorithms. > + > + &packed-hsv; > + > +
> + >
> SDR Formats > > diff --git a/Documentation/DocBook/media/v4l/v4l2.xml b/Documentation/DocBook/media/v4l/v4l2.xml > index 42e626d6c936..f38039b7c338 100644 > --- a/Documentation/DocBook/media/v4l/v4l2.xml > +++ b/Documentation/DocBook/media/v4l/v4l2.xml > @@ -152,6 +152,14 @@ structs, ioctls) must be noted in more detail in the history chapter > (compat.xml), along with the possible impact on existing drivers and > applications. --> > > + 4.8 > + 2016-07-15 > + rr > + Introduce HSV formats. > + > + > + > + > 4.5 > 2015-10-29 > rr -- Thanks, Mauro