docs/asahi: add some section headers

Signed-off-by: Alyssa Rosenzweig <alyssa@rosenzweig.io>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/33682>
This commit is contained in:
Alyssa Rosenzweig
2025-01-09 15:18:31 -05:00
committed by Marge Bot
parent dfebd94259
commit 5acf398b5a

View File

@@ -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.