From patchwork Tue Dec 15 16:46:08 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Guennadi Liakhovetski X-Patchwork-Id: 7855921 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 14BF19F349 for ; Tue, 15 Dec 2015 16:46:22 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id D0202203C0 for ; Tue, 15 Dec 2015 16:46:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 8A7F3203DA for ; Tue, 15 Dec 2015 16:46:18 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S964775AbbLOQqP (ORCPT ); Tue, 15 Dec 2015 11:46:15 -0500 Received: from mout.gmx.net ([212.227.15.19]:55098 "EHLO mout.gmx.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751516AbbLOQqO (ORCPT ); Tue, 15 Dec 2015 11:46:14 -0500 Received: from axis700.grange ([87.79.223.12]) by mail.gmx.com (mrgmx003) with ESMTPSA (Nemesis) id 0M0PdN-1aU8S70XHh-00uabK; Tue, 15 Dec 2015 17:46:10 +0100 Received: by axis700.grange (Postfix, from userid 1000) id 82900FF63; Tue, 15 Dec 2015 17:46:08 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by axis700.grange (Postfix) with ESMTP id 7A5D413EC9; Tue, 15 Dec 2015 17:46:08 +0100 (CET) Date: Tue, 15 Dec 2015 17:46:08 +0100 (CET) From: Guennadi Liakhovetski X-X-Sender: lyakh@axis700.grange To: Linux Media Mailing List cc: Aviv Greenberg , Hans Verkuil Subject: [PATCH] V4L: add Y12I, Y8I and Z16 pixel format documentation Message-ID: MIME-Version: 1.0 X-Provags-ID: V03:K0:AN6Tx3uXRtHdNgIkCbL9IONJeKkvyel9u0wngfzuTxDMDsIVTp4 xXGkCVRQNeryFQD0leOrehOK4wTk2NG8RLe+XdcsQ0lwTsaxQHcv2hT1S2FEBCqzQIrXk4f /qpjnzc0hYmfdbGHqd6DOLdAXrjdcNp43aDCCIZqnGJePmmSZbgMGdGIKIi2RTTSAcGtdnw MDYf/tVWAEue/ra4ghRcg== X-UI-Out-Filterresults: notjunk:1; V01:K0:/JvjCMiEh/A=:iJCUJtuUX5Svgw3krVDPvC HKY0/FrhwVAXa88MGHAZWJOAZ1OZcyROVLMOULNDOF5qGqioiKH6SHOa0Q45NEYOi9b+vDkbu KKe6+1r30aXtPKjQO25YylEPfl+617pE+JXe9f4nkUUAaRDZHDRm+dmnixHtb3Vl5EHAHoXRx Tc7qo+RGw/LXRvFV4b/dKyeMsGmX2Xi+MIhwJ1BBnEkJwrxr2N6aVlhHdVsT7AxTRL6UsmF8v o6nq83M/ZpkoNG2vM5rJMje0qohgafStE2Pf72vbL3rWGrOIbxrWBLYG27Cg/sspZf7Aqq5QC UdDoXlMWXU9AakO0ImAWheNOOeTMgqWIA4/xBZW87fm2+Aj98F66Z1MXcO5hL9XDWPN/QTEBk o9oxJwnLxuEV+fsrotZz3lqsdvTu9th7JwHvBXoLSwkw5MuAnLZfry2DtsfIh3kVjhJV6Cckn sWS42ySmeMFqW7yb1iIrc+UOYsMfECIKmSYDerOYy4j8ElXHyGsU1Ea2Vh0FbrlWncaCeZdlI uvN0RisquS5VRdvZTXgqPHsrXWwlW8V7/yLjUUzsgVvys6Tjvgj57Pn0eCw91I0nGWNICTfGt I5JKiEe+9GUpPqfd25gy9X2QgDx4faO4MHtc/05itaAENfd6Ny7mY/NcIkA+xLrnWsRKk5QWU 8sQKwdiAbwKhifUhqX4RQq83VtFhqq2j2AOMXI/o1giXjP5dwxQkvtJDNZcHamIC4VyCPgV9G H3SaD+ZsLY/TxpxPAQ0jja9QxpOawGCieI69Z6wUNuSg4n3Og/4KrRSesSPW4dh5Za8ePEEsb N/gKU+G 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.4 required=5.0 tests=BAYES_00,FREEMAIL_FROM, MALFORMED_FREEMAIL, RCVD_IN_DNSWL_HI, T_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 --- Documentation/DocBook/media/v4l/pixfmt-y12i.xml | 49 +++++++++++++++ Documentation/DocBook/media/v4l/pixfmt-y8i.xml | 80 +++++++++++++++++++++++++ Documentation/DocBook/media/v4l/pixfmt-z16.xml | 79 ++++++++++++++++++++++++ Documentation/DocBook/media/v4l/pixfmt.xml | 10 ++++ 4 files changed, 218 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..443598d --- /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. E.g. data, stored by a R200 RealSense camera on a little-endian +machine can be deinterlaced using + + + +__u8 *buf; +left0 = 0xfff & *(__u16 *)buf; +rirhgt0 = *(__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..fac3c68 --- /dev/null +++ b/Documentation/DocBook/media/v4l/pixfmt-z16.xml @@ -0,0 +1,79 @@ + + + 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 in mm to the respective point in the image coordinates. 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