From patchwork Fri Jul 15 15:16:52 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ricardo Ribalda Delgado X-Patchwork-Id: 9232215 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 7BF9C60865 for ; Fri, 15 Jul 2016 15:18:11 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 6A5FC27CCB for ; Fri, 15 Jul 2016 15:18:11 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 5D1CB27FA4; Fri, 15 Jul 2016 15:18:11 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=2.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED,FREEMAIL_FROM,RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=unavailable version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id AD43827CCB for ; Fri, 15 Jul 2016 15:18:10 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751465AbcGOPRI (ORCPT ); Fri, 15 Jul 2016 11:17:08 -0400 Received: from mail-lf0-f67.google.com ([209.85.215.67]:33414 "EHLO mail-lf0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751388AbcGOPRE (ORCPT ); Fri, 15 Jul 2016 11:17:04 -0400 Received: by mail-lf0-f67.google.com with SMTP id f93so7217826lfi.0; Fri, 15 Jul 2016 08:17:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=ezCUTtF8E2w6OdJvYM9ia4YD/tdVy6mamm8393NFFUU=; b=n/lRVxSIvs0vkaxyyYBZSjr5okr19sEWwicMfrPkOe1ERQpHlFXNjsum6VZhEMduHT qrorYZ4X04w6Jp/mQyqOU5G6M4NHxDmm0mbZrdugtZynoZJQHObrf0c4iS/todKFB4xL 2qSSMwunu3wtGcc82020RAEU3mBNZiAXr+afYI2pLe3criY8mGL4TPSAIJ3aePLhPkCr ALKjTwefwq0xb+fPfhpdK1P681j6RkPq9DR5WpSbWlq6h+vFFu1WxeAlSSZKjr3q1D6K mh9/oqmudzEvgT+UvjARhllezEP5zJDur5nEEC64lsrPik9/NhS8xp28jnxBcyuksjrK WUhw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=ezCUTtF8E2w6OdJvYM9ia4YD/tdVy6mamm8393NFFUU=; b=JSpc/tGxMFF67Z+0NAz8bCOcBgse/9b4DFv+qzQLrlnx075Bmo+eD5IGYH2gcV2Vfx yXre33tu/QTNsCPoJMcLYYIyfhCD8vJtItW22mGdI5WxZa0ujBYiCSrCCrrVEITgnTud tuz91JufRpg9vKT1beLV2/kz9D5uWafvW9dTRg9U04I8uCQqKWbHX9A2wjIZmjk9r0BW 6ez5T4Hbe16J0eovYIVvosuJLva++Lcqk1TYiWXdsoovjqDP4pR/X2WhglIzQlvSzg+a zdmHx2upl0KBQSQbvQHI3jiHnacivqBukMzgefUEssJJiwPBzp8AROiQNwIu/78rNY8v 9GKQ== X-Gm-Message-State: ALyK8tJuDMdW8l3+dQZMRveFiURMrC7hpK4DwMQ4NmG7Oh18aWzSH1o8BWW+V82fbV9Q+w== X-Received: by 10.25.23.8 with SMTP id n8mr10781338lfi.205.1468595822635; Fri, 15 Jul 2016 08:17:02 -0700 (PDT) Received: from neopili.qtec.com (cpe.xe-3-0-1-778.vbrnqe10.dk.customer.tdc.net. [80.197.57.18]) by smtp.gmail.com with ESMTPSA id 62sm2041745ljj.3.2016.07.15.08.17.00 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 15 Jul 2016 08:17:01 -0700 (PDT) From: Ricardo Ribalda Delgado To: auro Carvalho Chehab , 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 Cc: Ricardo Ribalda Delgado Subject: [PATCH 2/6] [media] Documentation: Add HSV format Date: Fri, 15 Jul 2016 17:16:52 +0200 Message-Id: <1468595816-31272-3-git-send-email-ricardo.ribalda@gmail.com> X-Mailer: git-send-email 2.8.1 In-Reply-To: <1468595816-31272-1-git-send-email-ricardo.ribalda@gmail.com> References: <1468595816-31272-1-git-send-email-ricardo.ribalda@gmail.com> Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP 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