From patchwork Tue Mar 23 13:40:37 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stanimir Varbanov X-Patchwork-Id: 406881 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp4464430jai; Tue, 23 Mar 2021 06:41:41 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz3b8QBLL3uWB7lc69O7G79gtPwAJbVG7PuT1LGMsb0XxJAP6oBKTUkRH3Wb99EfNH6xQ8t X-Received: by 2002:aa7:c6da:: with SMTP id b26mr4761864eds.254.1616506901039; Tue, 23 Mar 2021 06:41:41 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1616506901; cv=none; d=google.com; s=arc-20160816; b=Inh2FeXCvtitC5TIctpGV4hC+BQ4xTpwkGEDGHAH4GqhwELEZHawyyyU3WZ/Ou3+F8 VwNeoKJrbEgo0Zp3sB1EtI8GZQx+J2jaNsMAMsSstTiDhr4BmdJrDO2XmzQ4OP4fevuO QiTdsSBi9lX5YuHrT5qL+d/7n7REIIgQQGP0KGE5z+32G5K/w8aeak24KnuDJtGfMkbS 4akPFG1BcxhKXSgWqMi7g1ZYoK8hAAlIatrUybiyYJcEycdBUr55xCWUeJhm0e3XiMel iA5q6IkDYgrgfSOrUkXa4pPzPthNatRB+HvceL7WDJB75yYC79YvwLuuzYPeRNh4Qvdr 8BVg== 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=1Dh8Wzu8kVq+/wNWGF7WLux54WatKazjsRYvC0lfLjg=; b=SORU35fUWnhlCdz2yJ3FhYogIDD/E++tyMdV7horHJzLauFLe8kYLtK2IN/vGlvnqV plXJibL9izbV0jzBaGLZHHtX5YgWAsickXTVkbeFmNWSh4L4hIA425g8VYCINzCSg2vK rjRXBWGSFroHSBXT7EwogSjODfSCFnf45NVF7nMWFVuOP6ylNncWqZeH8tw7E28Zg3ox jHpOs7/43FkA0b0qtmOGQ3N2StZEF5x8jD6Jgw39R8bfjDh5Py8Uwzi4udxyQrSoAL73 zXH48DKs4N1b/3GRr7vkGGu0Oj9z0kMrgO2nJmWcoMGOoiVqLjnVA5Eevv75DflVrSQ0 LZeA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=UcOizWiB; 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 gv29si12878544ejc.61.2021.03.23.06.41.40; Tue, 23 Mar 2021 06:41:41 -0700 (PDT) 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=UcOizWiB; 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 S231152AbhCWNlJ (ORCPT + 17 others); Tue, 23 Mar 2021 09:41:09 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38118 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231627AbhCWNk6 (ORCPT ); Tue, 23 Mar 2021 09:40:58 -0400 Received: from mail-ej1-x630.google.com (mail-ej1-x630.google.com [IPv6:2a00:1450:4864:20::630]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8FB14C061763 for ; Tue, 23 Mar 2021 06:40:57 -0700 (PDT) Received: by mail-ej1-x630.google.com with SMTP id u5so27167946ejn.8 for ; Tue, 23 Mar 2021 06:40:57 -0700 (PDT) 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=1Dh8Wzu8kVq+/wNWGF7WLux54WatKazjsRYvC0lfLjg=; b=UcOizWiBt0Aa8UBzGS9dnt74F83HWzTX3vxSrX/wIRebamGz4BrbMxPq8k3UyleY41 JEtukybV3OF1bUgVFnmF2akQQ1jSTsmdsmhPWPzk6QqOvKp8IEM0UhvI37dSTts2MqNr qSb2waumwU9GdELkguv9sY9t+RTiLqj22T6ENj4mtGuv8rVXcGW2kqDGTWk5PlykpLwH iW+JL8SL50XkGRffY7DuIyWXICb0hjUxhBYMplOocuzOdUuGhgqmQLrXbs4sJXA4oROX wPt7QSjZ8FbhJyYkyfb07dfHDYgsMXRR8rl8n7PByEK94yUjCEAdr0aeDo8tpdzL8NP/ areg== 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=1Dh8Wzu8kVq+/wNWGF7WLux54WatKazjsRYvC0lfLjg=; b=pO8zzkj3TJvv8vdL3lB7laOwvJ0yfSHWy6pl+gAtcCnhQsY5FujVLlRPPkwIsQoCy+ fTDDvWW09wQZAtnU+kYbGUDN0x/BeccTwjspKFZCoqoGwAk7fbRAdjJjTfrmhNPlsoR/ hTl6MC/yg7F4pOTwVEfO/2z+zpT9Ep0oSGvW7h5IIusVbSPa2JaNfSSkSvhSDxB5onpz 1aHmwTyMr82fp7CDiFg2FAfwnG4t7+n4vwfcFjCcU2lpEnTupPkKbOg7rPzvOerHAk8U MoqNeyulwxiZGHX9QOQptNHE16Lu4mV8c1EBkdVDuib/Y3aQxZHO0QZR/zYx9LYylfln qvlw== X-Gm-Message-State: AOAM533sikmRkdeu+eX2Qrrqw0ypu69ogw+YvYhG6EMzdFx/ZwKQeE3a iUSgCWMxNwTGUkW8j8sAJ2dJoNmcJLrYcud/ X-Received: by 2002:a17:906:eda3:: with SMTP id sa3mr4965869ejb.147.1616506856297; Tue, 23 Mar 2021 06:40:56 -0700 (PDT) Received: from localhost.localdomain (hst-221-13.medicom.bg. [84.238.221.13]) by smtp.gmail.com with ESMTPSA id r10sm11207317eju.66.2021.03.23.06.40.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 23 Mar 2021 06:40:56 -0700 (PDT) From: Stanimir Varbanov To: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org Cc: hverkuil-cisco@xs4all.nl, ezequiel@collabora.com, nicolas.dufresne@collabora.com, Stanimir Varbanov Subject: [PATCH v6 2/5] docs: Document colorimetry class Date: Tue, 23 Mar 2021 15:40:37 +0200 Message-Id: <20210323134040.943757-3-stanimir.varbanov@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210323134040.943757-1-stanimir.varbanov@linaro.org> References: <20210323134040.943757-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 Reviewed-by: Hans Verkuil --- .../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 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 01773f01c4a7..15291be55299 100644 --- a/Documentation/userspace-api/media/v4l/vidioc-g-ext-ctrls.rst +++ b/Documentation/userspace-api/media/v4l/vidioc-g-ext-ctrls.rst @@ -404,6 +404,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 ============