| # ail |
| |
| ail is a small library for working with the image (and buffer) layouts |
| encountered with AGX hardware. Its design is inspired by isl. In |
| particular, ail strives to use isl unit suffixes and to represent |
| quantities in a canonical, API-agnostic fashion. |
| |
| ail conventions differ slightly from isl. See the isl documentation in |
| mesa/docs/isl for the conventions that inspired ail, in particular |
| mesa/docs/isl/units.rst. |
| |
| In ail, we have the following units: |
| |
| **Bytes (B)**: 8-bits. |
| |
| **Samples (sa)**: An individual sample. The number of bytes per sample depends |
| on the format. |
| |
| **Pixels (px)**: The unit everything starts as from the API. A pixel contains a |
| fixed number of samples, given as the layout's `sample_count_sa`. For twiddled |
| layouts, these samples are stored together in emmory. |
| |
| **Elements (el)**: For a block-compressed format, a single compression block |
| containing multiple pixels. Otherwise, equal to a single pixel. |
| |
| **Tiles (tiles)**: Defined only for tiled/twiddled layouts. A group of elements |
| forming the layout-specific tile. |
| |
| We do not support any multisampled block-compressed layouts, so either pixels |
| equals either samples or elements. |
