diff options
| author | Alyssa Rosenzweig <alyssa@collabora.com> | 2022-11-30 17:08:14 -0500 |
|---|---|---|
| committer | Marge Bot <emma+marge@anholt.net> | 2022-12-14 22:48:47 +0000 |
| commit | a8615016322572bbfbd031d39af46c3ee8969ad4 (patch) | |
| tree | 333a4968a615bfb5b96aa27abae98870b6e135fa /docs/drivers | |
| parent | dafbdd8a35fccb2dab768261a046893e8b4ca009 (diff) | |
| download | mesa-a8615016322572bbfbd031d39af46c3ee8969ad4.tar.gz | |
panfrost: Add tool to print supported texture formats
While all Panfrost-supported Mali GPUs support all the compressed texture
formats architecturally, the system integrator decides which formats will
actually be wired up in the production system-on-chip. In the past there may
have been legal considerations, I'm neither a lawyer nor a system integrator so
couldn't say.
It's useful for users to know which compressed texture formats are supported by
their hardware, to understand its performance characteristics (and perhaps to
buy systems that support their needs, especially if they need BCn formats which
are omitted in many Mali implementations).
To help with that, this commit adds a small standalone tool that prints which
formats are supported. It is tested so far on Mali-T860 and Mali-G57.
Signed-off-by: Alyssa Rosenzweig <alyssa@collabora.com>
Tested-by: Chris Healy <healych@amazon.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/20086>
Diffstat (limited to 'docs/drivers')
| -rw-r--r-- | docs/drivers/panfrost.rst | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/drivers/panfrost.rst b/docs/drivers/panfrost.rst index 9e739120d8a..0c51b20c001 100644 --- a/docs/drivers/panfrost.rst +++ b/docs/drivers/panfrost.rst @@ -57,6 +57,24 @@ Panfrost developers and users hang out on IRC at ``#panfrost`` on OFTC. Note that registering and authenticating with ``NickServ`` is required to prevent spam. `Join the chat. <https://webchat.oftc.net/?channels=panfrost>`_ +Compressed texture support +-------------------------- + +In the driver, Panfrost supports ASTC, ETC, and all BCn formats (e.g. RGTC, +S3TC, etc.) However, Panfrost depends on the hardware to support these formats +efficiently. All supported Mali architectures support these formats, but not +every system-on-chip with a Mali GPU support all these formats. Many lower-end +systems lack support for some BCn formats, which can cause problems when playing +desktop games with Panfrost. To check whether this issue applies to your +system-on-chip, Panfrost includes a ``panfrost_texfeatures`` tool to query +supported formats. + +To use this tool, include the option ``-Dtools=panfrost`` when configuring Mesa. +Then inside your Mesa build directory, the tool is located at +``src/panfrost/tools/panfrost_texfeatures``. Copy it to your target device, +set as executable as necessary, and run on the target device. A table of +supported formats will be printed to standard output. + drm-shim -------- |