From 5acf398b5a759676f1c6e9c7d58402a67b1397d0 Mon Sep 17 00:00:00 2001 From: Alyssa Rosenzweig Date: Thu, 9 Jan 2025 15:18:31 -0500 Subject: [PATCH] docs/asahi: add some section headers Signed-off-by: Alyssa Rosenzweig Part-of: --- docs/drivers/asahi.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/drivers/asahi.rst b/docs/drivers/asahi.rst index 36d4f1b8682..f4695f28951 100644 --- a/docs/drivers/asahi.rst +++ b/docs/drivers/asahi.rst @@ -209,6 +209,9 @@ Image layouts AGX supports several image layouts, described here. To work with image layouts in the drivers, use the ail library, located in ``src/asahi/layout``. +Strided linear +`````````````` + The simplest layout is **strided linear**. Pixels are stored in raster-order in memory with a software-controlled stride. Strided linear images are useful for working with modifier-unaware window systems, however performance will suffer. @@ -230,6 +233,9 @@ With these limitations, addressing into a strided linear image is as simple as In practice, this suffices for window system integration and little else. +Twiddled +```````` + The most common uncompressed layout is **twiddled**. The image is divided into power-of-two sized tiles. The tiles themselves are stored in raster-order. Within each tile, elements (pixels/blocks) are stored in Morton (Z) order.