Received: by 2002:a05:7412:31a9:b0:e2:908c:2ebd with SMTP id et41csp4196783rdb; Thu, 14 Sep 2023 15:08:20 -0700 (PDT) X-Google-Smtp-Source: AGHT+IER45jJnVkj7erdbwwwPbaaPZwqbXrtDedQth8fisy9sgWN2MLycqhAC1DOp797t/gzQta3 X-Received: by 2002:a05:6a00:2d87:b0:68f:ece2:ac3b with SMTP id fb7-20020a056a002d8700b0068fece2ac3bmr7487639pfb.5.1694729300343; Thu, 14 Sep 2023 15:08:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1694729300; cv=none; d=google.com; s=arc-20160816; b=SF5g08XoloIyTkCXXztO/elq9GLqgj0S5VxyR4MmP9Yh0WGifqnSyMNK/sxXmSafvI imFO5eNfJRl4H9kTrobZLy+1QGSk1EPOwJ5Ja5mSlaJuwdsIod5P8rF9mXJkRhhoIfGt iZOBYvGb2kQdIThg2Arg+fn/MeBLwah7InVUIkgVUjojGCCL2b4+J7spNRHb6Z45vyq3 45Yfwu4Jomm+aTvAjf6JoDPCe0/crDIC6rspJpYsy6opiiO2/kHRS9Rx8taY2CX+3Ps+ OJV7fMqSEak97YeSkdsh4yTucDsnsLI1pU+FTQwW8AVHl4hgjolNY06aRBNuXQFj/rRz cKdg== 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=0xNixy28HwTS7wpOk7KBd8y/pGwyFly1/E+wTZTmQRQ=; fh=W7zqh2Ha6zZLgHDo+1d+6f4id2gtprpli4ZX9tBLgmE=; b=nXt2jGH2JVCPQ8ig9O7KSIn+TOZVeKPjaPl21geLgyX90lYQH6dQGHUODMN6bhSMeA pYnBzc4aPBkzBY5QmG84UvpeW9/D172eoyssU32iHrgbffheAEjt9v4Cr15f5ts8IfL/ k5heCL2f7Ck2vIEMEG06GQI/kbcjY90p5U303AOK8V26PY/TsLMFv2sBfImxbCBuV097 RHY0jc3p6UwVNAogEsAx0NdXMqkp3Zf54ZiA9K9ELIqKN3tB8twPiK1uUwi54ETHwDy6 fAxdLLBYZlePSav/2fZQO3nTVgoAm7lZszj4dSkwFU5wqOM4jKdP0uY7Rz9Wei+fawm5 cMFg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=aYvz0Usy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=collabora.com Return-Path: Received: from howler.vger.email (howler.vger.email. [23.128.96.34]) by mx.google.com with ESMTPS id f26-20020a65629a000000b0057777451a5csi349452pgv.374.2023.09.14.15.08.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Sep 2023 15:08:20 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 as permitted sender) client-ip=23.128.96.34; Authentication-Results: mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=aYvz0Usy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=collabora.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by howler.vger.email (Postfix) with ESMTP id D90DA8766AA3; Thu, 14 Sep 2023 08:07:47 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at howler.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240743AbjINPHs (ORCPT + 99 others); Thu, 14 Sep 2023 11:07:48 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33390 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S240748AbjINPHp (ORCPT ); Thu, 14 Sep 2023 11:07:45 -0400 Received: from madras.collabora.co.uk (madras.collabora.co.uk [IPv6:2a00:1098:0:82:1000:25:2eeb:e5ab]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9131C1FDC; Thu, 14 Sep 2023 08:07:41 -0700 (PDT) Received: from whitebuilder.lan (unknown [IPv6:2606:6d00:15:bae9::c73]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: nicolas) by madras.collabora.co.uk (Postfix) with ESMTPSA id 86F33660734A; Thu, 14 Sep 2023 16:07:39 +0100 (BST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1694704060; bh=BPugKkNBgf1YBf9yRnKNsGKQzDLc0irbpk9bgkgeaHI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=aYvz0UsyRSgAzXnKQNmj8etXWDX28i+xdHMyhlv77lQBOuYgt1QJtiJ47HBEtBluU /revLxhv5nzbUlK3JCmor28S6M63lPwrschrn2LoxjF6Bh/AR04g/tGrvX5VDHbtQG 8BorSdRlj7+t0sppDo7z9A812PVdTIHCSxxDIH/AEpyzBKsA4/6Oqo8OFSglNO/m9X 4cXthznYHQ14Bhvi3wNZTmL4QFT8qzOPk49jFf2k3YdT2QyJamgjE/V2qOPj7wmh6c ObTRNqGr6yMaztL+lEpOGOsgrmG8IUMkdLzigHBLVxoGV/EkXoTmVcg81R8W+PooRs waquA3//hmcgQ== From: Nicolas Dufresne To: Mauro Carvalho Chehab Cc: kernel@collabora.com, Nicolas Dufresne , linux-media@vger.kernel.org, Andrzej Pietrasiewicz , linux-kernel@vger.kernel.org Subject: [PATCH v2 2/5] docs: uapi: media: Move NV12_10BE_8L128 to NV15 section Date: Thu, 14 Sep 2023 11:06:48 -0400 Message-Id: <20230914150651.3114134-3-nicolas.dufresne@collabora.com> X-Mailer: git-send-email 2.40.1 In-Reply-To: <20230914150651.3114134-1-nicolas.dufresne@collabora.com> References: <20230914150651.3114134-1-nicolas.dufresne@collabora.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (howler.vger.email [0.0.0.0]); Thu, 14 Sep 2023 08:07:48 -0700 (PDT) This is a 15 bits per pixel (or packed 10 bit format), so move it into the relevant section. Signed-off-by: Nicolas Dufresne Reviewed-by: Andrzej Pietrasiewicz --- .../media/v4l/pixfmt-yuv-planar.rst | 36 ++++++++++--------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst index fb826923ff1d6..1d43532095c07 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst @@ -295,8 +295,6 @@ of the luma plane. .. _V4L2-PIX-FMT-NV12-32L32: .. _V4L2-PIX-FMT-NV12M-8L128: .. _V4L2-PIX-FMT-NV12-8L128: -.. _V4L2-PIX-FMT-NV12M-10BE-8L128: -.. _V4L2-PIX-FMT-NV12-10BE-8L128: .. _V4L2-PIX-FMT-MM21: Tiled NV12 @@ -361,6 +359,25 @@ The layouts of the luma and chroma planes are identical. ``V4L2_PIX_FMT_NV12_8L128`` is similar to ``V4L2_PIX_FMT_NV12M_8L128`` but stores two planes in one memory. +``V4L2_PIX_FMT_MM21`` store luma pixel in 16x32 tiles, and chroma pixels +in 16x16 tiles. The line stride must be aligned to a multiple of 16 and the +image height must be aligned to a multiple of 32. The number of luma and chroma +tiles are identical, even though the tile size differ. The image is formed of +two non-contiguous planes. + + +.. _V4L2-PIX-FMT-NV15-4L4: +.. _V4L2-PIX-FMT-NV12M-10BE-8L128: +.. _V4L2-PIX-FMT-NV12-10BE-8L128: + +Tiled NV15 +---------- + +``V4L2_PIX_FMT_NV15_4L4`` Semi-planar 10-bit YUV 4:2:0 formats, using 4x4 tiling. +All components are packed without any padding between each other. +As a side-effect, each group of 4 components are stored over 5 bytes +(YYYY or UVUV = 4 * 10 bits = 40 bits = 5 bytes). + ``V4L2_PIX_FMT_NV12M_10BE_8L128`` is similar to ``V4L2_PIX_FMT_NV12M`` but stores 10 bits pixels in 2D 8x128 tiles, and stores tiles linearly in memory. the data is arranged in big endian order. @@ -379,21 +396,6 @@ byte 4: Y3(bits 7-0) ``V4L2_PIX_FMT_NV12_10BE_8L128`` is similar to ``V4L2_PIX_FMT_NV12M_10BE_8L128`` but stores two planes in one memory. -``V4L2_PIX_FMT_MM21`` store luma pixel in 16x32 tiles, and chroma pixels -in 16x16 tiles. The line stride must be aligned to a multiple of 16 and the -image height must be aligned to a multiple of 32. The number of luma and chroma -tiles are identical, even though the tile size differ. The image is formed of -two non-contiguous planes. - -.. _V4L2-PIX-FMT-NV15-4L4: - -Tiled NV15 ----------- - -Semi-planar 10-bit YUV 4:2:0 formats, using 4x4 tiling. -All components are packed without any padding between each other. -As a side-effect, each group of 4 components are stored over 5 bytes -(YYYY or UVUV = 4 * 10 bits = 40 bits = 5 bytes). .. _V4L2-PIX-FMT-NV16: .. _V4L2-PIX-FMT-NV61: -- 2.40.1