From patchwork Tue Dec 8 14:59:30 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stanimir Varbanov X-Patchwork-Id: 339748 Delivered-To: patch@linaro.org Received: by 2002:a02:85a7:0:0:0:0:0 with SMTP id d36csp3761108jai; Tue, 8 Dec 2020 07:02:50 -0800 (PST) X-Google-Smtp-Source: ABdhPJwUR+OF97uqf4SeA0g/MmtWfXTf5/+4He8JtD9e3BWgLauQX/560ZAd0r9mssBXRH6UcGTO X-Received: by 2002:a17:906:5f92:: with SMTP id a18mr24128214eju.126.1607439770696; Tue, 08 Dec 2020 07:02:50 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1607439770; cv=none; d=google.com; s=arc-20160816; b=jbOpt5O4+Pbqb0Mac+dELDwTI639D9Q4DWb/Rtpg7PGlo/TOADGhKHVxuHaEZOUdHW tZKi5cfNL6/7HjCoqof9U/OCltenQ7kJNfhR7GQoQC7cfVbd5a9bPi2jV7MfXY+oxd0b bYlmRS/cBRT5KKBCTaIy2epQU0/vi1XknsRJ5/Ao6Mqp2fOFf7ZUGJMbXdCLHnb9HOP9 KHnS+mxUxsy6WPKg8Sbjsni0dloZrMmpaDyXB277SLaoyV1s+dBO0iuTuJQU/GU22y34 dSEzz8O4cRLXtMIoRsU18MT6+E4MEwV+1KFk2ZToqo14cOJc3Y7zIHRFBXenNDWqD6mE lBGw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:references:in-reply-to:message-id:date:subject :cc:to:from:dkim-signature; bh=7HFxBojNQoqoo0yNgEgAcHxbiciKdGO1hKU1kqE+B2w=; b=kQahqr8vfLO0Bdlk7D25+SjVPh4EOYRb7bTsuALvSdxD0wdLcRP80FJedu95FTVhgY YWZeczGHc8+GTFugd43WBK+G1n5g8SUJZuX/2qqEMh2X5ohYNgSJVMC6ODS9qADhHlGl wkGO2vmSdMTdrpdVgnhGZBE1vlkDBB8lTtQoz604gzA3XVXDNWqRCXTdjefP5PL4UgTR wcfoo1/bbENbiXAu3k+NhBA6KE81eQmOyzrLnULQfDK8v2hJwZM9tso+jJdFMteqpvpM PMJOU1kj+bzK//c/Pblher2EmU5UU73D9tuAHxDGSI2kFib+62kKQ6cu8mmP9u/aB98T jzkw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=pqk8czet; spf=pass (google.com: domain of linux-media-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-media-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 f12si8507024ejk.142.2020.12.08.07.02.50; Tue, 08 Dec 2020 07:02:50 -0800 (PST) Received-SPF: pass (google.com: domain of linux-media-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=pqk8czet; spf=pass (google.com: domain of linux-media-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-media-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 S1729877AbgLHPBX (ORCPT + 4 others); Tue, 8 Dec 2020 10:01:23 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42472 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729471AbgLHPBW (ORCPT ); Tue, 8 Dec 2020 10:01:22 -0500 Received: from mail-ej1-x642.google.com (mail-ej1-x642.google.com [IPv6:2a00:1450:4864:20::642]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4E145C061285 for ; Tue, 8 Dec 2020 07:00:07 -0800 (PST) Received: by mail-ej1-x642.google.com with SMTP id lt17so25061742ejb.3 for ; Tue, 08 Dec 2020 07:00:07 -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; bh=7HFxBojNQoqoo0yNgEgAcHxbiciKdGO1hKU1kqE+B2w=; b=pqk8czetThRSoershteSnEiS66FA3iyQRjlsfhktU9/99V4/gMEka3cZ6iZAhkDL9R xMo0qev7dV9r46ltGcMPUGdnFNjkiaeteZd8l/RwYQPb6MPZDeituddxiMrs3qX0Be45 O5IJtW4O0Fc6chj4dv2QwW/wICWzlKffE9pCGYfMCKpBwfFsduPykB3GWv+ByRTIGHMy FOOlWfCRFoQjM9S/ciFGtXo9NiRzi4zdLNsRhC6y8eG1RChjg2cL8jRz3NvW62j4V6YI QTdCWwFrkvvPV/OKSY2SZV5V1UVGYCutAhWJM7SYKr1ZWS693xRfY+E8RdTFJi8nl2W0 RKPA== 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; bh=7HFxBojNQoqoo0yNgEgAcHxbiciKdGO1hKU1kqE+B2w=; b=uR2PJ2nURnVoWbgFOhXmMHOsXhk0FKdW+3Vx1+DbgG0WUthNpZW8DYBagtjRbnCdFu msd5BMrB1V8EK/ESJSUq5YrTpdoY47pacHc61hBYMtxtqL7TpZ+5MbR4tGGRpN1rdZ7b PlrtPdw+MqtfWLXnUEt685QOHh+rPa2dvt95zJ3U6oFaLS54ToptNnxeKLK6MLrSxjXC Lp8a+OeKik56T1pomVQ1Wykodi+WzAmhGKs7wEaQKLvJNM76ap2HYRVYkuJMWRDSdGik KzdefLH8iVx1qHUW+vA9UpUMmQ5+dltXgF7kz3uBSPOqQP2SGPLBRAP63qlqFUvVY2Uh dj6w== X-Gm-Message-State: AOAM532pNjdGufrV/h+hbVQMYRIpULxDq7jcupNFo24hRSWkpBaIvDsE u/4mSxm+9tr5Y8KaOcdsAHiKQZh/hO/yh8Ha X-Received: by 2002:a17:906:7f0b:: with SMTP id d11mr23980915ejr.7.1607439604976; Tue, 08 Dec 2020 07:00:04 -0800 (PST) Received: from localhost.localdomain (hst-221-90.medicom.bg. [84.238.221.90]) by smtp.gmail.com with ESMTPSA id qn4sm4968292ejb.50.2020.12.08.07.00.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Dec 2020 07:00:04 -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 v3 2/3] docs: media: Document CLL and Mastering display Date: Tue, 8 Dec 2020 16:59:30 +0200 Message-Id: <20201208145931.6187-3-stanimir.varbanov@linaro.org> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20201208145931.6187-1-stanimir.varbanov@linaro.org> References: <20201208145931.6187-1-stanimir.varbanov@linaro.org> Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Document Content light level and Mastering display colour volume. Signed-off-by: Stanimir Varbanov --- .../userspace-api/media/v4l/common.rst | 1 + .../media/v4l/ext-ctrls-colorimetry.rst | 88 +++++++++++++++++++ 2 files changed, 89 insertions(+) create mode 100644 Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst -- 2.17.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..16d9ddadbab6 --- /dev/null +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst @@ -0,0 +1,88 @@ +.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later + +.. _colorimetry-controls: + +***************************** +Colorimetry Control Reference +***************************** + +Below are controls within the Colorimetry control class. + +Colorimetry Control IDs +----------------------- + +.. _colorimetry-control-id: + +``V4L2_CID_COLORIMETRY_CLASS (class)`` + The Colorimetry class descriptor. + +``V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (struct)`` + The Content Light Level defines upper bounds for the nominal target + brightness light level of the pictures. + +.. c:type:: v4l2_ctrl_hdr10_cll_info + +.. cssclass:: longtable + +.. flat-table:: struct v4l2_ctrl_hdr10_cll_info + :header-rows: 0 + :stub-columns: 0 + :widths: 1 1 2 + + * - __u16 + - ``max_content_light_level`` + - An upper bound on the maximum light level among all individual + samples for the pictures of coded video sequence, cd/m2. When + equal to 0 no such uppper bound is present. + * - __u16 + - ``max_pic_average_light_level`` + - An upper bound on the maximum average light level among the + samples for any individual picture of coded video sequence, cd/m2. + When equal to 0 no such uppper bound is present. + +``V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (struct)`` + The mastering display defines the colour volume (the colour primaries, + white point and luminance range) of a display considered to be the + mastering display for current video content. + +.. c:type:: v4l2_ctrl_hdr10_mastering_display + +.. cssclass:: longtable + +.. flat-table:: struct v4l2_ctrl_hdr10_mastering_display + :header-rows: 0 + :stub-columns: 0 + :widths: 1 1 2 + + * - __u16 + - ``display_primaries_x[3]`` + - Specifies the normalized x chromaticity coordinate of the colour + primary component c of the mastering display in increments of 0.00002. + For describing mastering display that use Red, Green and Blue colour + primaries, index value c equal to 0 correspond to Green primary, c + equal to 1 correspond to Blue primary and c equal to 2 correspond to + Red colour primary. + * - __u16 + - ``display_primaries_y[3]`` + - Specifies the normalized y chromaticity coordinate of the colour + primary component c of the mastering display in increments of 0.00002. + For describing mastering display that use Red, Green and Blue colour + primaries, index value c equal to 0 correspond to Green primary, c + equal to 1 correspond to Blue primary and c equal to 2 correspond to + Red colour primary. + * - __u16 + - ``white_point_x`` + - Specifies the normalized x chromaticity coordinate of the white + point of the mastering display in increments of 0.00002. + * - __u16 + - ``white_point_y`` + - Specifies the normalized y chromaticity coordinate of the white + point of the mastering display in increments of 0.00002. + * - __u32 + - ``max_luminance`` + - Specifies the nominal maximum display luminance of the mastering + display in units of 0.0001 cd/m2. + * - __u32 + - ``min_luminance`` + - specifies the nominal minimum display luminance of the mastering + display in units of 0.0001 cd/m2.