From patchwork Tue Feb 9 16:24:22 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stanimir Varbanov X-Patchwork-Id: 379361 Delivered-To: patch@linaro.org Received: by 2002:a02:b18a:0:0:0:0:0 with SMTP id t10csp375108jah; Tue, 9 Feb 2021 08:27:32 -0800 (PST) X-Google-Smtp-Source: ABdhPJxR2ihtbENCwlovwIUMmQmCus1Lhc+Y7IGLnCm+n1rns2ZqKgBl88El4qKpG3UqMYag77Pz X-Received: by 2002:aa7:d6d4:: with SMTP id x20mr24356399edr.8.1612888052224; Tue, 09 Feb 2021 08:27:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1612888052; cv=none; d=google.com; s=arc-20160816; b=kWyTe0ExaJ8B9I8HL7sdLiqyMppPkoFykorEaY02H9CcLs9a09u4SHF9YNh9nIbmID 13RS2b8HDvu/hB+cIbDEHd+K6TcrxwGAVFvUwlTub1G9Aa2BV/cYWB/5ImgLEEBnF58j 00MQazOph2BkNoSHBmnNxL67j9LshG8NsGaCY8lqOKvmivReMSgz+IE9ffaJxP1JPxuA tbUzzVO7lqhVbvlXV6O8xhkfIPuG8yyPjPdvLtTQqdSnc+yYM92usbQcrNRArD46Twad wj36E3X24rdTUAoi3j/mqjc6fMem/2LUJWJ+X6zZAjHE/pxXWgshwGvpxqxXmxR/n/Cg 98Kg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=EI1EcA+D88VC2CjRtNWFjgy2Ge54caq8DUdTYfEpBQs=; b=AbHzKQowMBnHuZT4dgBCntICodsxeOlB9948vxbPpTh7B7xBK4B60p2C2ofSrA0/am tMB5uBKfeQqdF5IcFmjQR9Vdx9sJU7Ue6l1jV47sVqxgy+tcb6rRyFQ4gY5kU659nQEF Y6rNfUXk4gbGYD7L1PKwib4hCIMj05km1LJh5JXyZ422/kHe4v/anEsPtJz4RML8lBZS Krrgk/Kpc2qDwpYhmxYKosJJ5quA2WIEtX5nZ5iwXRE1peNb8DL/r3urU6IoRIlUFFSA A6moVCo6KBudlYmu+gm/lsp4nPAi/doRKhTzgDGr5LZANRsO72Bk9SL4d0YIEx1OGJ20 tW5A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=jHpgpy17; spf=pass (google.com: domain of linux-arm-msm-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-arm-msm-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id x23si14071262ejv.558.2021.02.09.08.27.31; Tue, 09 Feb 2021 08:27:32 -0800 (PST) Received-SPF: pass (google.com: domain of linux-arm-msm-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=jHpgpy17; spf=pass (google.com: domain of linux-arm-msm-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-arm-msm-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232868AbhBIQ02 (ORCPT + 16 others); Tue, 9 Feb 2021 11:26:28 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38360 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232846AbhBIQ0L (ORCPT ); Tue, 9 Feb 2021 11:26:11 -0500 Received: from mail-wm1-x32f.google.com (mail-wm1-x32f.google.com [IPv6:2a00:1450:4864:20::32f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C502BC06178C for ; Tue, 9 Feb 2021 08:24:50 -0800 (PST) Received: by mail-wm1-x32f.google.com with SMTP id a16so2037129wmm.0 for ; Tue, 09 Feb 2021 08:24:50 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=EI1EcA+D88VC2CjRtNWFjgy2Ge54caq8DUdTYfEpBQs=; b=jHpgpy17JbMvJLjyX/xNOcYywv0BRkfKBFJWNCtbWcr0Iedj5o8Eq/hb0tnaxvfa0b 4sOwopQ8iTAlAtSmC5ciNAip9dPKL8/LueZLmRmhlVA2Qx0STeVeDjcW1QFtzIRfTALz 5VHXF7g8FzrAA5b1WMRQda49bZNEWpBA6EL4ZBPEr8MWGNz505/wVi1+2IZY429fIcrs p47E4XSx6i8pkTQLRzgp+Ipm8iMy3P8vzM6zqB0LPR+Q0EdM8dlvofN89V4iCLchso7G +bluxF/nKN61Vg8Xuhs/cTii1cWFtW3e2NZXHydsYZXbIxh9+Fr/QUg9s0Lt65ZceBfZ 8ahQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=EI1EcA+D88VC2CjRtNWFjgy2Ge54caq8DUdTYfEpBQs=; b=SaX/MaK0hxtolfkN33zCoS13Kjvv9+Tld754Q/PqEAG0Az/Tuzzob/Qr8GLCpfBrD4 F4+FDqZjWUg7bNvvpvsOdbQXcTfMJ9hz5hFSnytmjr8hdnB+IkiwO/+uL/ggkAgSqLx2 zMZS7V4pk09otF2sVtvhHQN6RzrI8FIu94ZbVSl6t0EPOfUm3ZY/DLyKGpfatxhco8sO UPWuHpKvP1Ll9SZSb1sMnhPHsCi1dvzU80YNVV7hQ7jU5c8W+rKxHjsfrxpAJWvfVTde 8cdwGrJXC0aAT0gjWjHT4Xxkb1U66n/z+R3DzyoU2Tb/cQlbPh0UfRIP5QtgKD8xUDhw T2ew== X-Gm-Message-State: AOAM5326G/Y1aASRJ/nuS1V38xTYtsthesGggqBBkwGQR3hZaaYpubI2 xN9YjE3H74mKfzyM16ElDSzYFA== X-Received: by 2002:a1c:e90d:: with SMTP id q13mr4192172wmc.136.1612887889436; Tue, 09 Feb 2021 08:24:49 -0800 (PST) Received: from localhost.localdomain (hst-221-125.medicom.bg. [84.238.221.125]) by smtp.gmail.com with ESMTPSA id w8sm45210wrm.21.2021.02.09.08.24.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Feb 2021 08:24:49 -0800 (PST) From: Stanimir Varbanov To: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org Cc: Hans Verkuil , Ezequiel Garcia , Nicolas Dufresne , Stanimir Varbanov Subject: [PATCH v5 2/5] docs: Document colorimetry class Date: Tue, 9 Feb 2021 18:24:22 +0200 Message-Id: <20210209162425.3970393-3-stanimir.varbanov@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210209162425.3970393-1-stanimir.varbanov@linaro.org> References: <20210209162425.3970393-1-stanimir.varbanov@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-arm-msm@vger.kernel.org Add a document for ext control colorimetry class. Signed-off-by: Stanimir Varbanov --- .../userspace-api/media/v4l/common.rst | 1 + .../media/v4l/ext-ctrls-colorimetry.rst | 22 +++++++++++++++++++ .../media/v4l/vidioc-g-ext-ctrls.rst | 4 ++++ 3 files changed, 27 insertions(+) create mode 100644 Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst -- 2.25.1 Reviewed-by: Hans Verkuil diff --git a/Documentation/userspace-api/media/v4l/common.rst b/Documentation/userspace-api/media/v4l/common.rst index 8c263c5a85d8..ea0435182e44 100644 --- a/Documentation/userspace-api/media/v4l/common.rst +++ b/Documentation/userspace-api/media/v4l/common.rst @@ -51,6 +51,7 @@ applicable to all devices. ext-ctrls-fm-tx ext-ctrls-fm-rx ext-ctrls-detect + ext-ctrls-colorimetry fourcc format planar-apis diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst b/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst new file mode 100644 index 000000000000..862f78b41b32 --- /dev/null +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst @@ -0,0 +1,22 @@ +.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later + +.. _colorimetry-controls: + +***************************** +Colorimetry Control Reference +***************************** + +The Colorimetry class includes controls for High Dynamic Range +imaging for representing colors in digital images and video. The +controls should be used for video and image encoding and decoding +as well as in HDMI receivers and transmitters. + +Colorimetry Control IDs +----------------------- + +.. _colorimetry-control-id: + +``V4L2_CID_COLORIMETRY_CLASS (class)`` + The Colorimetry class descriptor. Calling + :ref:`VIDIOC_QUERYCTRL` for this control will + return a description of this control class. diff --git a/Documentation/userspace-api/media/v4l/vidioc-g-ext-ctrls.rst b/Documentation/userspace-api/media/v4l/vidioc-g-ext-ctrls.rst index b9c62affbb5a..8a95ebdd499a 100644 --- a/Documentation/userspace-api/media/v4l/vidioc-g-ext-ctrls.rst +++ b/Documentation/userspace-api/media/v4l/vidioc-g-ext-ctrls.rst @@ -394,6 +394,10 @@ still cause this situation. - 0xa40000 - The class containing stateless codec controls. These controls are described in :ref:`codec-stateless-controls`. + * - ``V4L2_CTRL_CLASS_COLORIMETRY`` + - 0xa50000 + - The class containing colorimetry controls. These controls are + described in :ref:`colorimetry-controls`. Return Value ============