From patchwork Mon Jan 18 14:32:55 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Guennadi Liakhovetski X-Patchwork-Id: 8055111 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 E96B89F818 for ; Mon, 18 Jan 2016 14:33:12 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 2A5FA20430 for ; Mon, 18 Jan 2016 14:33:11 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 173B120382 for ; Mon, 18 Jan 2016 14:33:09 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755164AbcAROdH (ORCPT ); Mon, 18 Jan 2016 09:33:07 -0500 Received: from mout.gmx.net ([212.227.15.19]:59162 "EHLO mout.gmx.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755037AbcAROdF (ORCPT ); Mon, 18 Jan 2016 09:33:05 -0500 Received: from axis700.grange ([89.0.116.187]) by mail.gmx.com (mrgmx001) with ESMTPSA (Nemesis) id 0MKprU-1aLArZ3r16-0002ih; Mon, 18 Jan 2016 15:32:58 +0100 Received: by axis700.grange (Postfix, from userid 1000) id B5E55FF63; Mon, 18 Jan 2016 15:32:55 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by axis700.grange (Postfix) with ESMTP id A7D9713EC9; Mon, 18 Jan 2016 15:32:55 +0100 (CET) Date: Mon, 18 Jan 2016 15:32:55 +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] V4L: add Y12I, Y8I and Z16 pixel format documentation Message-ID: MIME-Version: 1.0 X-Provags-ID: V03:K0:rkTJIXOnI1+JRuxlojlN0XY+qqEIJLrat+9nBoJFGzMuMtQn6eB NFPSrsrrQScLYA8+dskklGNHX5EWzy7mQldOy5sNsnz3ZbS00XUh1RDZuWuQVNl+MDBdhk3 Vca1nSLgcpKtKrQobYut2xVTKzI2/Z4yF6A0mNyQAU4Y8psA4Ebu/GL1FCMduavH3yF3/Je lAxlcp0Ka/WTHm49961Zw== X-UI-Out-Filterresults: notjunk:1; V01:K0:3+oBcfknX0g=:8DcTG+J3epm+0QBLKqZpNh NFgYepXwL5Z+i/01dM9UTTfW6koK1xFYeo0dOLWZhNLZKKjVCO34Zt5r70NCdj5GyAeqLnBQv BSaiL0z3U7q6rVYMdBlC6jdjoOesN6TwRoSE304vfQ75Kqt7q6tOWoue0gpJYka5hHP+Cl2bo kVzhGdn3le0cI86pXNzs8LGz1eRNaSn9HASqcPHwKqjuFsfsJK/luk8s6h9GIASmXUogzAGw8 2RVKjQwClPouVHmVd67uaHBHAqkOIVT6YnGjllXTru1PqO29Dr413SSCzf8ZtZYpfdNZKyxYg 5OnkkVsgA8KbmRBKJwChrPMOmjpXCmekUj8uHdecByDWqbNtqp4FzW/c2VZGNplPl5c5eCwTJ 8wuJ/PeR8rjHOLltC1F1XrbcNV82hPPIMn0Oh2FGIJ8NG8HhpZ3ekfYqyYirDn/Sl2aiTBI8o zigf4JCC1sPsJdAaZzfFOgguiynQQm2n9uzUrzXy+4Ui2WO6Nx5erYZ/JDmkkN4ou6f8kdYUL hHGoeDj5/oLg4BPQsg4QvG7GoECYMSSQrqCVYVFYRKR6DDqYqEpSY9nXnNKGMIkpPX4J+Zimn 8dEKx0YWmFft0yPdlQ3+FwyihyjXq02NZbY3UmYf5VQE0u+o2iPoI7JOQCWwZUj/sWyysdw+u Up4kOo4vV1g75YhQpyaj0Pn7osra0hmd9+dBtJsb1lYncGPOHt3mj9fNxhuf/BjyqQt0WOrkn kltDNDbh8dNFig/r0MGDUXqgawvTmaHrV+4o3dzCysqJ27D3kO/5axQakaGoopJ8Ou+e3n3nL wgga5SC Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM, 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