From patchwork Sun Mar 6 23:29:08 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Johannes Stezenbach X-Patchwork-Id: 8514271 Return-Path: X-Original-To: patchwork-linux-media@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork2.web.kernel.org (Postfix) with ESMTP id 4C046C0553 for ; Sun, 6 Mar 2016 23:30:19 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id D55AC201EC for ; Sun, 6 Mar 2016 23:30:15 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 7C0AF2017E for ; Sun, 6 Mar 2016 23:30:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751054AbcCFX36 (ORCPT ); Sun, 6 Mar 2016 18:29:58 -0500 Received: from mail.sig21.net ([80.244.240.74]:60411 "EHLO mail.sig21.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750885AbcCFX34 (ORCPT ); Sun, 6 Mar 2016 18:29:56 -0500 Received: from [84.190.178.56] (helo=abc.local) by mail.sig21.net with esmtpsa (TLS1.1:RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from ) id 1aci7H-0004FP-Oo; Mon, 07 Mar 2016 00:29:44 +0100 Received: from js by abc.local with local (Exim 4.86_2) (envelope-from ) id 1aci6m-0001BJ-4s; Mon, 07 Mar 2016 00:29:08 +0100 Date: Mon, 7 Mar 2016 00:29:08 +0100 From: Johannes Stezenbach To: Mauro Carvalho Chehab Cc: Jani Nikula , Keith Packard , Jonathan Corbet , LKML , linux-doc@vger.kernel.org, Daniel Vetter , Hans Verkuil , linux-media@vger.kernel.org, Graham Whaley Subject: Re: Kernel docs: muddying the waters a bit Message-ID: <20160306232908.GA3732@linuxtv.org> References: <20160213145317.247c63c7@lwn.net> <87y49zr74t.fsf@intel.com> <20160303071305.247e30b1@lwn.net> <20160303155037.705f33dd@recife.lan> <86egbrm9hw.fsf@hiro.keithp.com> <20160303221930.32558496@recife.lan> <87si06r6i3.fsf@intel.com> <20160304095950.3358a2cb@recife.lan> <20160304140909.GA15636@linuxtv.org> <20160305232937.74678dd0@recife.lan> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20160305232937.74678dd0@recife.lan> User-Agent: Mutt/1.5.24 (2015-08-30) X-Spam-21-Score: -2.9 (--) X-Spam-21-Report: No, score=-2.9 required=8.0 tests=ALL_TRUSTED=-1, BAYES_00=-1.9, URIBL_BLOCKED=0.001 autolearn=ham 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, RCVD_IN_DNSWL_HI, RP_MATCHES_RCVD, T_TVD_MIME_EPI, 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 On Sat, Mar 05, 2016 at 11:29:37PM -0300, Mauro Carvalho Chehab wrote: > > I converted one of the big tables to CSV. At least now it recognized > it as a table. Yet, the table was very badly formated: > https://mchehab.fedorapeople.org/media-kabi-docs-test/rst_tests/packed-rgb.html > > This is how this table should look like: > https://linuxtv.org/downloads/v4l-dvb-apis/packed-rgb.html > > Also, as this table has merged cells at the legend. I've no idea how > to tell sphinx to do that on csv format. > > The RST files are on this git tree: > https://git.linuxtv.org/mchehab/v4l2-docs-poc.git/ Yeah, seems it can't do merged cells in csv. Attached patch converts it back to grid table format and fixes the table definition. The html output looks usable, but clearly it is no fun to work with tables in Sphinx. Sphinx' latex writer can't handle nested tables, though. Python's docutils rst2latex can, but that doesn't help here. rst2pdf also supports it. But I have doubts such a large table would render OK in pdf without using landscape orientation. I have not tried because I used python3-sphinx but rst2pdf is only availble for Python2 in Debian so it does not integrate with Sphinx. Johannes From 61674b398e778bd5ff644ffd493d5ff1cfaca0ef Mon Sep 17 00:00:00 2001 From: Johannes Stezenbach Date: Sun, 6 Mar 2016 23:55:19 +0100 Subject: [PATCH] some progress for html output --- _static/borderless.css | 3 -- _static/v4l2tables.css | 9 +++++ _templates/layout.html | 9 +---- packed-rgb.rst | 88 +++++++++++++++++++++++++++++----------------- pixfmt-yuyv.rst | 2 +- v4l-table-within-table.rst | 72 +++++++++++++++++++------------------ 6 files changed, 105 insertions(+), 78 deletions(-) delete mode 100644 _static/borderless.css create mode 100644 _static/v4l2tables.css diff --git a/_static/borderless.css b/_static/borderless.css deleted file mode 100644 index bfd4b01..0000000 --- a/_static/borderless.css +++ /dev/null @@ -1,3 +0,0 @@ -table#table-borderless { - border: 1px solid black; -} diff --git a/_static/v4l2tables.css b/_static/v4l2tables.css new file mode 100644 index 0000000..c045e45 --- /dev/null +++ b/_static/v4l2tables.css @@ -0,0 +1,9 @@ +table.noborder { + border: 1px solid black; + background: white; + white-space: nowrap; +} + +table.noborder td, table.noborder th { + padding: 0px; +} diff --git a/_templates/layout.html b/_templates/layout.html index b6bf12b..637332d 100644 --- a/_templates/layout.html +++ b/_templates/layout.html @@ -1,9 +1,2 @@ {% extends "!layout.html" %} -{% block tables %} - -{{ super() }} -{% endblock %} +{% set css_files = css_files + ["_static/v4l2tables.css"] %} diff --git a/packed-rgb.rst b/packed-rgb.rst index 352b91c..b4fcf3e 100644 --- a/packed-rgb.rst +++ b/packed-rgb.rst @@ -9,25 +9,46 @@ graphics frame buffers. They occupy 8, 16, 24 or 32 bits per pixel. These are all packed-pixel formats, meaning all the data for a pixel lie next to each other in memory. -.. csv-table:: Table: Packed RGB Image Formats - :header: Identifier,Code, ,Byte 0 in memory,Byte 1,Byte 2,Byte 3 +.. table:: Packed RGB Image Formats + :class: noborder - ``V4L2_PIX_FMT_RGB332``,'RGB1',,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`1`,b\ :sub:`0` - ``V4L2_PIX_FMT_ARGB444``,'AR12',,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,,a\ :sub:`3`,a\ :sub:`2`,a\ :sub:`1`,a\ :sub:`0`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0` - ``V4L2_PIX_FMT_XRGB444``,'XR12',,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,,-,-,-,-,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0` - ``V4L2_PIX_FMT_ARGB555``,'AR15',,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,,a,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,g\ :sub:`4`,g\ :sub:`3` - ``V4L2_PIX_FMT_XRGB555``,'XR15',,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,,-,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,g\ :sub:`4`,g\ :sub:`3` - ``V4L2_PIX_FMT_RGB565``,'RGBP',,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,g\ :sub:`5`,g\ :sub:`4`,g\ :sub:`3` - ``V4L2_PIX_FMT_ARGB555X``,'AR15' | (1<<31),,a,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,g\ :sub:`4`,g\ :sub:`3`,,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0` - ``V4L2_PIX_FMT_XRGB555X``,'XR15' | (1<<31),,-,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,g\ :sub:`4`,g\ :sub:`3`,,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0` - ``V4L2_PIX_FMT_RGB565X``,'RGBR',,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,g\ :sub:`5`,g\ :sub:`4`,g\ :sub:`3`,,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0` - ``V4L2_PIX_FMT_BGR24``,'BGR3',,b\ :sub:`7`,b\ :sub:`6`,b\ :sub:`5`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,,g\ :sub:`7`,g\ :sub:`6`,g\ :sub:`5`,g\ :sub:`4`,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,,r\ :sub:`7`,r\ :sub:`6`,r\ :sub:`5`,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0` - ``V4L2_PIX_FMT_RGB24``,'RGB3',,r\ :sub:`7`,r\ :sub:`6`,r\ :sub:`5`,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,,g\ :sub:`7`,g\ :sub:`6`,g\ :sub:`5`,g\ :sub:`4`,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,,b\ :sub:`7`,b\ :sub:`6`,b\ :sub:`5`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0` - ``V4L2_PIX_FMT_BGR666``,'BGRH',,b\ :sub:`5`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,g\ :sub:`5`,g\ :sub:`4`,,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,r\ :sub:`5`,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,,r\ :sub:`1`,r\ :sub:`0`,-,-,-,-,-,-,,-,-,-,-,-,-,-,- - ``V4L2_PIX_FMT_ABGR32``,'AR24',,b\ :sub:`7`,b\ :sub:`6`,b\ :sub:`5`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,,g\ :sub:`7`,g\ :sub:`6`,g\ :sub:`5`,g\ :sub:`4`,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,,r\ :sub:`7`,r\ :sub:`6`,r\ :sub:`5`,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,,a\ :sub:`7`,a\ :sub:`6`,a\ :sub:`5`,a\ :sub:`4`,a\ :sub:`3`,a\ :sub:`2`,a\ :sub:`1`,a\ :sub:`0` - ``V4L2_PIX_FMT_XBGR32``,'XR24',,b\ :sub:`7`,b\ :sub:`6`,b\ :sub:`5`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0`,,g\ :sub:`7`,g\ :sub:`6`,g\ :sub:`5`,g\ :sub:`4`,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,,r\ :sub:`7`,r\ :sub:`6`,r\ :sub:`5`,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,,-,-,-,-,-,-,-,- - ``V4L2_PIX_FMT_ARGB32``,'BA24',,a\ :sub:`7`,a\ :sub:`6`,a\ :sub:`5`,a\ :sub:`4`,a\ :sub:`3`,a\ :sub:`2`,a\ :sub:`1`,a\ :sub:`0`,,r\ :sub:`7`,r\ :sub:`6`,r\ :sub:`5`,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,,g\ :sub:`7`,g\ :sub:`6`,g\ :sub:`5`,g\ :sub:`4`,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,,b\ :sub:`7`,b\ :sub:`6`,b\ :sub:`5`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0` - ``V4L2_PIX_FMT_XRGB32``,'BX24',,-,-,-,-,-,-,-,-,,r\ :sub:`7`,r\ :sub:`6`,r\ :sub:`5`,r\ :sub:`4`,r\ :sub:`3`,r\ :sub:`2`,r\ :sub:`1`,r\ :sub:`0`,,g\ :sub:`7`,g\ :sub:`6`,g\ :sub:`5`,g\ :sub:`4`,g\ :sub:`3`,g\ :sub:`2`,g\ :sub:`1`,g\ :sub:`0`,,b\ :sub:`7`,b\ :sub:`6`,b\ :sub:`5`,b\ :sub:`4`,b\ :sub:`3`,b\ :sub:`2`,b\ :sub:`1`,b\ :sub:`0` + +-----------------------------+-----------------------+-----+------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | Identifier | Code |   | Byte 0 in memory | Byte 1 | Byte 2 | Byte 3 | + | | +-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | | | Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | + +=============================+=======================+=====+====================+===============+===============+===============+===============+===============+===============+===============+=====+===============+===============+===============+===============+===============+===============+===============+===============+=====+===============+===============+===============+===============+===============+===============+===============+===============+=====+===============+===============+===============+===============+===============+===============+===============+===============+ + | ``V4L2_PIX_FMT_RGB332`` | 'RGB1' | | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`1` | b\ :sub:`0` | | | | | | | | | | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_ARGB444`` | 'AR12' | | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_XRGB444`` | 'XR12' | | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | \- | \- | \- | \- | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_ARGB555`` | 'AR15' | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | a | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`4` | g\ :sub:`3` | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_XRGB555`` | 'XR15' | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | \- | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`4` | g\ :sub:`3` | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_RGB565`` | 'RGBP' | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_ARGB555X`` | 'AR15' | (1 << 31) | | a | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`4` | g\ :sub:`3` | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_XRGB555X`` | 'XR15' | (1 << 31) | | \- | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`4` | g\ :sub:`3` | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_RGB565X`` | 'RGBR' | | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | | | | | | | | | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_BGR24`` | 'BGR3' | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_RGB24`` | 'RGB3' | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | | | | | | | | | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_BGR666`` | 'BGRH' | | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | g\ :sub:`5` | g\ :sub:`4` | | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | | r\ :sub:`1` | r\ :sub:`0` | \- | \- | \- | \- | \- | \- | | \- | \- | \- | \- | \- | \- | \- | \- | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_ABGR32`` | 'AR24' | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | a\ :sub:`7` | a\ :sub:`6` | a\ :sub:`5` | a\ :sub:`4` | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_XBGR32`` | 'XR24' | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | \- | \- | \- | \- | \- | \- | \- | \- | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_ARGB32`` | 'BA24' | | a\ :sub:`7` | a\ :sub:`6` | a\ :sub:`5` | a\ :sub:`4` | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_XRGB32`` | 'BX24' | | \- | \- | \- | \- | \- | \- | \- | \- | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | + +-----------------------------+-----------------------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ Bit 7 is the most significant bit. @@ -74,21 +95,24 @@ They are documented here for reference. The meaning of their alpha bits (a) is ill-defined and interpreted as in either the corresponding ARGB or XRGB format, depending on the driver. -+----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ -| Identifier | Code |   | Byte 0 in memory | Byte 1 | Byte 2 | Byte 3 | -+============================+==========+=====+====================+===============+===============+===============+===============+===============+===============+===============+====+===============+===============+===============+===============+===============+===============+===============+===============+====+===============+===============+===============+===============+===============+===============+===============+===============+====+===============+===============+===============+===============+===============+===============+===============+===============+ -| ``V4L2_PIX_FMT_RGB444`` | 'R444' | | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | -+----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ -| ``V4L2_PIX_FMT_RGB555`` | 'RGBO' | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | a | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`4` | g\ :sub:`3` | -+----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ -| ``V4L2_PIX_FMT_RGB555X`` | 'RGBQ' | | a | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`4` | g\ :sub:`3` | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | -+----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ -| ``V4L2_PIX_FMT_BGR32`` | 'BGR4' | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | a\ :sub:`7` | a\ :sub:`6` | a\ :sub:`5` | a\ :sub:`4` | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | -+----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ -| ``V4L2_PIX_FMT_RGB32`` | 'RGB4' | | a\ :sub:`7` | a\ :sub:`6` | a\ :sub:`5` | a\ :sub:`4` | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | -+----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ +.. table:: Deprecated Packed RGB Image Formats + :class: noborder -Table: Deprecated Packed RGB Image Formats + +----------------------------+----------+-----+------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | Identifier | Code |   | Byte 0 in memory | Byte 1 | Byte 2 | Byte 3 | + | | +-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | | | Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | + +============================+==========+=====+====================+===============+===============+===============+===============+===============+===============+===============+=====+===============+===============+===============+===============+===============+===============+===============+===============+=====+===============+===============+===============+===============+===============+===============+===============+===============+=====+===============+===============+===============+===============+===============+===============+===============+===============+ + | ``V4L2_PIX_FMT_RGB444`` | 'R444' | | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | | | | | | | | | | | | | | | | | | + +----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_RGB555`` | 'RGBO' | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | a | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`4` | g\ :sub:`3` | | | | | | | | | | | | | | | | | | | + +----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_RGB555X`` | 'RGBQ' | | a | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | g\ :sub:`4` | g\ :sub:`3` | | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | | | | | | | | | | | | | | | | | | + +----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_BGR32`` | 'BGR4' | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | a\ :sub:`7` | a\ :sub:`6` | a\ :sub:`5` | a\ :sub:`4` | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | + +----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ + | ``V4L2_PIX_FMT_RGB32`` | 'RGB4' | | a\ :sub:`7` | a\ :sub:`6` | a\ :sub:`5` | a\ :sub:`4` | a\ :sub:`3` | a\ :sub:`2` | a\ :sub:`1` | a\ :sub:`0` | | r\ :sub:`7` | r\ :sub:`6` | r\ :sub:`5` | r\ :sub:`4` | r\ :sub:`3` | r\ :sub:`2` | r\ :sub:`1` | r\ :sub:`0` | | g\ :sub:`7` | g\ :sub:`6` | g\ :sub:`5` | g\ :sub:`4` | g\ :sub:`3` | g\ :sub:`2` | g\ :sub:`1` | g\ :sub:`0` | | b\ :sub:`7` | b\ :sub:`6` | b\ :sub:`5` | b\ :sub:`4` | b\ :sub:`3` | b\ :sub:`2` | b\ :sub:`1` | b\ :sub:`0` | + +----------------------------+----------+-----+--------------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+-----+---------------+---------------+---------------+---------------+---------------+---------------+---------------+---------------+ A test utility to determine which RGB formats a driver actually supports is available from the LinuxTV v4l-dvb repository. See V4L-DVB for access diff --git a/pixfmt-yuyv.rst b/pixfmt-yuyv.rst index 9ec268d..9e4b6dd 100644 --- a/pixfmt-yuyv.rst +++ b/pixfmt-yuyv.rst @@ -11,7 +11,7 @@ In this format each four bytes is two pixels. Each four bytes is two Y's, a Cb and a Cr. Each Y goes to one of the pixels, and the Cb and Cr belong to both pixels. As you can see, the Cr and Cb components have half the horizontal resolution of the Y component. -``V4L2_PIX_FMT_YUYV `` is known in the Windows environment as YUY2. +``V4L2_PIX_FMT_YUYV`` is known in the Windows environment as YUY2. **Byte Order..** diff --git a/v4l-table-within-table.rst b/v4l-table-within-table.rst index d2a6079..c8e1b21 100644 --- a/v4l-table-within-table.rst +++ b/v4l-table-within-table.rst @@ -1,37 +1,41 @@ V4l2 CID table example ====================== -============================== ============== ========= -ID Type Definition -============================== ============== ========= -V4L2_CID_COLOR_KILLER boolean Enable the color killer (i. e. force a black & white image in case of a weak video signal). -V4L2_CID_COLORFX enum Selects a color effect. The following values are defined: - - ============================== ===================== - Value Definition - ============================== ===================== - V4L2_COLORFX_NONE Color effect is disabled. - V4L2_COLORFX_ANTIQUE An aging (old photo) effect. - V4L2_COLORFX_ART_FREEZE Frost color effect. - V4L2_COLORFX_AQUA Water color, cool tone. - V4L2_COLORFX_BW Black and white. - V4L2_COLORFX_EMBOSS Emboss, the highlights and shadows replace light/dark - boundaries and low contrast areas are set to a gray background. - V4L2_COLORFX_GRASS_GREEN Grass green. - V4L2_COLORFX_NEGATIVE Negative. - V4L2_COLORFX_SEPIA Sepia tone. - V4L2_COLORFX_SKETCH Sketch. - V4L2_COLORFX_SKIN_WHITEN Skin whiten. - V4L2_COLORFX_SKY_BLUE Sky blue. - V4L2_COLORFX_SOLARIZATION Solarization, the image is partially reversed in tone, only - color values above or below a certain threshold are inverted. - V4L2_COLORFX_SILHOUETTE Silhouette (outline). - V4L2_COLORFX_VIVID Vivid colors. - V4L2_COLORFX_SET_CBCR The Cb and Cr chroma components are replaced by fixed coefficients - determined by V4L2_CID_COLORFX_CBCR control. - ============================== ===================== -V4L2_CID_COLORFX_CBCR integer Determines the Cb and Cr coefficients for V4L2_COLORFX_SET_CBCR - color effect. Bits [7:0] of the supplied 32 bit value are interpreted as - Cr component, bits [15:8] as Cb component and bits [31:16] must be zero. -V4L2_CID_AUTOBRIGHTNESS boolean Enable Automatic Brightness. -============================== ============== ========= +.. tabularcolumns:: |l|l|p{20cm}| +.. table:: + :class: noborder + + ============================== ============== ========= + ID Type Definition + ============================== ============== ========= + V4L2_CID_COLOR_KILLER boolean Enable the color killer (i. e. force a black & white image in case of a weak video signal). + V4L2_CID_COLORFX enum Selects a color effect. The following values are defined: + + ============================== ===================== + Value Definition + ============================== ===================== + V4L2_COLORFX_NONE Color effect is disabled. + V4L2_COLORFX_ANTIQUE An aging (old photo) effect. + V4L2_COLORFX_ART_FREEZE Frost color effect. + V4L2_COLORFX_AQUA Water color, cool tone. + V4L2_COLORFX_BW Black and white. + V4L2_COLORFX_EMBOSS Emboss, the highlights and shadows replace light/dark + boundaries and low contrast areas are set to a gray background. + V4L2_COLORFX_GRASS_GREEN Grass green. + V4L2_COLORFX_NEGATIVE Negative. + V4L2_COLORFX_SEPIA Sepia tone. + V4L2_COLORFX_SKETCH Sketch. + V4L2_COLORFX_SKIN_WHITEN Skin whiten. + V4L2_COLORFX_SKY_BLUE Sky blue. + V4L2_COLORFX_SOLARIZATION Solarization, the image is partially reversed in tone, only + color values above or below a certain threshold are inverted. + V4L2_COLORFX_SILHOUETTE Silhouette (outline). + V4L2_COLORFX_VIVID Vivid colors. + V4L2_COLORFX_SET_CBCR The Cb and Cr chroma components are replaced by fixed coefficients + determined by V4L2_CID_COLORFX_CBCR control. + ============================== ===================== + V4L2_CID_COLORFX_CBCR integer Determines the Cb and Cr coefficients for V4L2_COLORFX_SET_CBCR + color effect. Bits [7:0] of the supplied 32 bit value are interpreted as + Cr component, bits [15:8] as Cb component and bits [31:16] must be zero. + V4L2_CID_AUTOBRIGHTNESS boolean Enable Automatic Brightness. + ============================== ============== ========= -- 2.7.0