From patchwork Wed Feb 3 17:08:11 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Guennadi Liakhovetski X-Patchwork-Id: 8205531 Return-Path: X-Original-To: patchwork-linux-media@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id CBEF99F4DD for ; Wed, 3 Feb 2016 17:08:25 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 8F65F20266 for ; Wed, 3 Feb 2016 17:08:24 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 4819420251 for ; Wed, 3 Feb 2016 17:08:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933197AbcBCRIV (ORCPT ); Wed, 3 Feb 2016 12:08:21 -0500 Received: from mout.gmx.net ([212.227.15.15]:61638 "EHLO mout.gmx.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932881AbcBCRIU (ORCPT ); Wed, 3 Feb 2016 12:08:20 -0500 Received: from axis700.grange ([89.0.111.231]) by mail.gmx.com (mrgmx001) with ESMTPSA (Nemesis) id 0Me8di-1ah1aV0Sf0-00PvF4; Wed, 03 Feb 2016 18:08:13 +0100 Received: by axis700.grange (Postfix, from userid 1000) id 0F6CFFF63; Wed, 3 Feb 2016 18:08:11 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by axis700.grange (Postfix) with ESMTP id 0C59D13EC9; Wed, 3 Feb 2016 18:08:11 +0100 (CET) Date: Wed, 3 Feb 2016 18:08:11 +0100 (CET) From: Guennadi Liakhovetski X-X-Sender: lyakh@axis700.grange To: Linux Media Mailing List cc: Sakari Ailus , Aviv Greenberg , Hans Verkuil Subject: [PATCH v2 1/2] V4L: add Y12I, Y8I and Z16 pixel format documentation In-Reply-To: Message-ID: References: MIME-Version: 1.0 X-Provags-ID: V03:K0:/Ks+aT7qETYOOhde45ZhHK+rB3HxcYO3+aBeRtqwg09w7LqjtTi iucU6fh2DXkKe6D3FwpC37WpDiiIdp6wghVtzpz7gmn8uDed3S+i5zbsJtDmt6so04e0INS 7yrcwbhl+cAA6131+0irxub2jywZgUQqzdScc3I25vn2H5yzvkxwMoyMVt+xam7ww/GqRRx ek4N5lrsCoq6srHFqkSwQ== X-UI-Out-Filterresults: notjunk:1; V01:K0:Z/Bg3lYJhCA=:N+v5HPMAl285quBg5e1OUa I0JKmJq6KWFNC3/RRghgT4xgHNxTXV9Xj4RTNbLaNN6/2lpSaNwiFRou0B8njNHJZz/izrCvA FTJqCHRpt4Kaa/uAt9NBPb5OgT27mzoNEHydff459pRqpMXQLwqc+B6b1m+NWkaUohszcFsQe WVZD2jJZB6w47TTJXJkgJOXYzyEmT/As7meubdaCUfRFDHsNaKCM8c6NeusGfyj7hNywCDm8E nxlJUFH5dMUU1fz9eFqkaAU9MqERrRuysJoo1mLLcY0dLSKjCOVIQRr+IaVqY30kAymj9+Qn0 jxQsJxCQy3Xlw4lDNZqFgN7IEp12VYobpC7gIQNrM5OXo/UspGFRWZ7vf+XeSoRK0xPLUfjPc aEAEBijTqFCHfsG0L2JcMIfAW0Uz6NbBWUD11ayniy9lsJuczKzPRh53VLQ3CX9s4NhVg/bvl +iGM0c6R1vAgARTr1lA0yiUTOCxUp47qy55FNpgTfw05ajwWfmZk5NRCz4TLjvLTNxwWAVVFz svNK6XCcObiJCgQLbUpvuZfXsXTRl0EBJSC0jNLvlxSNzaFqMsqpuKLEHHJsvElAAAVbQ0eVA RJ4w1/BFQw/aCqExdGgHNFNwpnzertg5Xp7SdM83oTxAOjn/tbKDez6jjdpS7tlmYsAPbh2JC 3q3vEM83AvDtmqFo6s7t+Wml+IJ4HQ+sADFlxgp1ObsEAjUnFGGwpzOaRjJcWnZnumtrET7l3 FzD8xmWkLRuRC3vgaUKqeCOA2pzQK4Rk+0WcJ0WXMiIcWAsvVSQbjn75JHh1A/QJ2rzCD9ymg pTg6Hr1 Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Spam-Status: No, score=-5.8 required=5.0 tests=BAYES_00,FREEMAIL_FROM, MALFORMED_FREEMAIL, RCVD_IN_DNSWL_HI, RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add documentation for 3 formats, used by RealSense cameras like R200. Signed-off-by: Guennadi Liakhovetski Acked-by: Sakari Ailus --- Documentation/DocBook/media/v4l/pixfmt-y12i.xml | 49 +++++++++++++++ Documentation/DocBook/media/v4l/pixfmt-y8i.xml | 80 ++++++++++++++++++++++++ Documentation/DocBook/media/v4l/pixfmt-z16.xml | 81 +++++++++++++++++++++++++ Documentation/DocBook/media/v4l/pixfmt.xml | 10 +++ 4 files changed, 220 insertions(+) create mode 100644 Documentation/DocBook/media/v4l/pixfmt-y12i.xml create mode 100644 Documentation/DocBook/media/v4l/pixfmt-y8i.xml create mode 100644 Documentation/DocBook/media/v4l/pixfmt-z16.xml diff --git a/Documentation/DocBook/media/v4l/pixfmt-y12i.xml b/Documentation/DocBook/media/v4l/pixfmt-y12i.xml new file mode 100644 index 0000000..4a2d1e5 --- /dev/null +++ b/Documentation/DocBook/media/v4l/pixfmt-y12i.xml @@ -0,0 +1,49 @@ + + + V4L2_PIX_FMT_Y12I ('Y12I') + &manvol; + + + V4L2_PIX_FMT_Y12I + Interleaved grey-scale image, e.g. from a stereo-pair + + + Description + + This is a grey-scale image with a depth of 12 bits per pixel, but with +pixels from 2 sources interleaved and bit-packed. Each pixel is stored in a +24-bit word in the little-endian order. On a little-endian machine these pixels +can be deinterlaced using + + + +__u8 *buf; +left0 = 0xfff & *(__u16 *)buf; +right0 = *(__u16 *)(buf + 1) >> 4; + + + + + <constant>V4L2_PIX_FMT_Y12I</constant> 2 pixel data stream taking 3 bytes + + + Bit-packed representation + pixels cross the byte boundary and have a ratio of 3 bytes for each + interleaved pixel. + + + + + + Y'0left[7:0] + Y'0right[3:0]Y'0left[11:8] + Y'0right[11:4] + + + + + + + + + diff --git a/Documentation/DocBook/media/v4l/pixfmt-y8i.xml b/Documentation/DocBook/media/v4l/pixfmt-y8i.xml new file mode 100644 index 0000000..99f389d --- /dev/null +++ b/Documentation/DocBook/media/v4l/pixfmt-y8i.xml @@ -0,0 +1,80 @@ + + + V4L2_PIX_FMT_Y8I ('Y8I ') + &manvol; + + + V4L2_PIX_FMT_Y8I + Interleaved grey-scale image, e.g. from a stereo-pair + + + Description + + This is a grey-scale image with a depth of 8 bits per pixel, but with +pixels from 2 sources interleaved. Each pixel is stored in a 16-bit word. E.g. +the R200 RealSense camera stores pixel from the left sensor in lower and from +the right sensor in the higher 8 bits. + + + <constant>V4L2_PIX_FMT_Y8I</constant> 4 × 4 +pixel image + + + Byte Order. + Each cell is one byte. + + + + + + start + 0: + Y'00left + Y'00right + Y'01left + Y'01right + Y'02left + Y'02right + Y'03left + Y'03right + + + start + 8: + Y'10left + Y'10right + Y'11left + Y'11right + Y'12left + Y'12right + Y'13left + Y'13right + + + start + 16: + Y'20left + Y'20right + Y'21left + Y'21right + Y'22left + Y'22right + Y'23left + Y'23right + + + start + 24: + Y'30left + Y'30right + Y'31left + Y'31right + Y'32left + Y'32right + Y'33left + Y'33right + + + + + + + + + diff --git a/Documentation/DocBook/media/v4l/pixfmt-z16.xml b/Documentation/DocBook/media/v4l/pixfmt-z16.xml new file mode 100644 index 0000000..3d87e4b --- /dev/null +++ b/Documentation/DocBook/media/v4l/pixfmt-z16.xml @@ -0,0 +1,81 @@ + + + V4L2_PIX_FMT_Z16 ('Z16 ') + &manvol; + + + V4L2_PIX_FMT_Z16 + Interleaved grey-scale image, e.g. from a stereo-pair + + + Description + + This is a 16-bit format, representing depth data. Each pixel is a +distance to the respective point in the image coordinates. Distance unit can +vary and has to be negotiated with the device separately. Each pixel is stored +in a 16-bit word in the little endian byte order. + + + + <constant>V4L2_PIX_FMT_Z16</constant> 4 × 4 +pixel image + + + Byte Order. + Each cell is one byte. + + + + + + start + 0: + Z00low + Z00high + Z01low + Z01high + Z02low + Z02high + Z03low + Z03high + + + start + 8: + Z10low + Z10high + Z11low + Z11high + Z12low + Z12high + Z13low + Z13high + + + start + 16: + Z20low + Z20high + Z21low + Z21high + Z22low + Z22high + Z23low + Z23high + + + start + 24: + Z30low + Z30high + Z31low + Z31high + Z32low + Z32high + Z33low + Z33high + + + + + + + + + diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml index d871245..9924732 100644 --- a/Documentation/DocBook/media/v4l/pixfmt.xml +++ b/Documentation/DocBook/media/v4l/pixfmt.xml @@ -1620,6 +1620,8 @@ information. &sub-y10b; &sub-y16; &sub-y16-be; + &sub-y8i; + &sub-y12i; &sub-uv8; &sub-yuyv; &sub-uyvy; @@ -1641,6 +1643,14 @@ information. &sub-m420; +
+ Depth Formats + Depth data provides distance to points, mapped onto the image plane + + + &sub-z16; +
+
Compressed Formats