Received: by 2002:a05:7412:31a9:b0:e2:908c:2ebd with SMTP id et41csp4250597rdb; Thu, 14 Sep 2023 17:17:07 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEi5GxryyhyWzlT5w0+iGjR4BsyI3/v7e8B/urLDqN8H/1qc+67IuRxPwOKDfml4qegEj7b X-Received: by 2002:a05:6a21:193:b0:159:f884:4d6e with SMTP id le19-20020a056a21019300b00159f8844d6emr414924pzb.40.1694737026811; Thu, 14 Sep 2023 17:17:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1694737026; cv=none; d=google.com; s=arc-20160816; b=E9UJD/rPSafBCig9Ia7bPVgsIDAdJrhK/iWs6McyH2FiR+4A6xJPd0AxDNL2obFgDO AoLIO5oWMpoHxoCUECnVlDalO8oNDbpHn/pmRKeG86M17uH+I6mg2LVcDabxP7oWI9kU VelICA4Cw5Hbygyc2tsu+50vtOx9+OktAk7VDTkhzgKRbPpkx45/kCW7s+qwdrtbI7hy yGev1e03WQ3DL98OitUcdD4c89YE/r6xVoHp0PkPaBFOcJSkT3LQJ8BIZ9MpzTPu00GL lVMjs2wesyTgnZffW6fZSsRbkOT5jrAIOvl6VDPT0gPLjhNHKgg42S8B5WMZgg3UoEzo 9UwA== 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=Sr+XWQLao9lSsX61s4/aUxYl5uuEWTVD+nFdTxFlbHo=; fh=W7zqh2Ha6zZLgHDo+1d+6f4id2gtprpli4ZX9tBLgmE=; b=DmBPip2jGy8VhLkJkbpEZ3wk/G4BkTn5tMiIBnd5OhfBz847MCZIWu9HC5CEfXTGfU 5S6ZSoQX4KYlU25TTusRJ6NLNDGePCS0cI1Kx6heykazh1Pic/SWQk7RAmn3x2rg7IAE yiVeqe11FHm3SUjW326hMXmOIKPnS+1YNaE4Gy0NpzEYp7c/XByU/l/7iBc4FveJ6llZ NYNrsYuZUbKoefgIudW+vwEy8Jt6FX5myj8sB888hWXFyzPVNVkEVM0f/Tzx/N1r8W+y U/ZipblklMDAIP/VrWGKI9ZNkip5YtyysKxPXiAEKdIgmHUJs2sgTRMuacR18qbbg+Pz iBlw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=ak5YGKIt; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 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 snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id g8-20020a056a0023c800b0068fba70d25dsi2482840pfc.33.2023.09.14.17.17.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Sep 2023 17:17:06 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=ak5YGKIt; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 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 snail.vger.email (Postfix) with ESMTP id D142A81E14FB; Thu, 14 Sep 2023 08:07:42 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240130AbjINPHn (ORCPT + 99 others); Thu, 14 Sep 2023 11:07:43 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51296 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S240687AbjINPHl (ORCPT ); Thu, 14 Sep 2023 11:07:41 -0400 Received: from madras.collabora.co.uk (madras.collabora.co.uk [46.235.227.172]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A5225A8; Thu, 14 Sep 2023 08:07:37 -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 D31A86607346; Thu, 14 Sep 2023 16:07:35 +0100 (BST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1694704056; bh=fY/r2diqs96P/mQNHqPsnegumIKHR6/vp+KeaEc/UlQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ak5YGKItlPbrHeTfF9OJXFwSYn4rVT4A0E92UyKlbUsmPG+Nrd8m9ADYb4SK0LNoa RMU5QHZEX4td+ryGnWep6IloB3MJ0pOp9ARP1W5ObVKyvRQCwFZi0k52V4ZX7bclz7 k6MC9CUnmslgqaitY6nAWTadO8jsJ+EnvZYrLtqIfvCyoQ+8ICKehdlQH/UfYkdC6r eMPLJ1NO7cOzvnjCqQxXP4ZSbFFOO1NqhbPDh/1UyzAt2XMGVkMc6incSfQ4QsRO7s Coy34QNbpzKv5UrygzoVLP/WWVnED8OQXfrkb/gSpx4LLzRLo+fVGlD0HYH2yQ3JP5 HBbxbm2nnD1YQ== 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 1/5] docs: uapi: media: Properly locate NV12MT diagram Date: Thu, 14 Sep 2023 11:06:47 -0400 Message-Id: <20230914150651.3114134-2-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 (snail.vger.email [0.0.0.0]); Thu, 14 Sep 2023 08:07:42 -0700 (PDT) The diagram have been pushed back at the end of a list of unrelated pixels formats. Move it back next its related pixel format. Signed-off-by: Nicolas Dufresne Reviewed-by: Andrzej Pietrasiewicz --- .../media/v4l/pixfmt-yuv-planar.rst | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst index 1840224faa412..fb826923ff1d6 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst @@ -322,6 +322,22 @@ If the vertical resolution is an odd number of tiles, the last row of tiles is stored in linear order. The layouts of the luma and chroma planes are identical. +.. _nv12mt: + +.. kernel-figure:: nv12mt.svg + :alt: nv12mt.svg + :align: center + + V4L2_PIX_FMT_NV12MT macroblock Z shape memory layout + +.. _nv12mt_ex: + +.. kernel-figure:: nv12mt_example.svg + :alt: nv12mt_example.svg + :align: center + + Example V4L2_PIX_FMT_NV12MT memory layout of tiles + ``V4L2_PIX_FMT_NV12_4L4`` stores pixels in 4x4 tiles, and stores tiles linearly in memory. The line stride and image height must be aligned to a multiple of 4. The layouts of the luma and chroma planes are @@ -369,22 +385,6 @@ 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. -.. _nv12mt: - -.. kernel-figure:: nv12mt.svg - :alt: nv12mt.svg - :align: center - - V4L2_PIX_FMT_NV12MT macroblock Z shape memory layout - -.. _nv12mt_ex: - -.. kernel-figure:: nv12mt_example.svg - :alt: nv12mt_example.svg - :align: center - - Example V4L2_PIX_FMT_NV12MT memory layout of tiles - .. _V4L2-PIX-FMT-NV15-4L4: Tiled NV15 -- 2.40.1