xref: /aosp_15_r20/external/mesa3d/docs/drivers/panfrost/texcomp.rst (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1*61046927SAndroid Build Coastguard WorkerCompressed texture support
2*61046927SAndroid Build Coastguard Worker==========================
3*61046927SAndroid Build Coastguard Worker
4*61046927SAndroid Build Coastguard WorkerIn the driver, Panfrost supports ASTC, ETC, and all BCn formats (e.g. RGTC,
5*61046927SAndroid Build Coastguard WorkerS3TC, etc.) However, Panfrost depends on the hardware to support these formats
6*61046927SAndroid Build Coastguard Workerefficiently.  All supported Mali architectures support these formats, but not
7*61046927SAndroid Build Coastguard Workerevery system-on-chip with a Mali GPU support all these formats. Many lower-end
8*61046927SAndroid Build Coastguard Workersystems lack support for some BCn formats, which can cause problems when playing
9*61046927SAndroid Build Coastguard Workerdesktop games with Panfrost. To check whether this issue applies to your
10*61046927SAndroid Build Coastguard Workersystem-on-chip, Panfrost includes a ``panfrost_texfeatures`` tool to query
11*61046927SAndroid Build Coastguard Workersupported formats.
12*61046927SAndroid Build Coastguard Worker
13*61046927SAndroid Build Coastguard WorkerTo use this tool, include the option ``-Dtools=panfrost`` when configuring Mesa.
14*61046927SAndroid Build Coastguard WorkerThen inside your Mesa build directory, the tool is located at
15*61046927SAndroid Build Coastguard Worker``src/panfrost/tools/panfrost_texfeatures``. Copy it to your target device,
16*61046927SAndroid Build Coastguard Workerset as executable as necessary, and run on the target device. A table of
17*61046927SAndroid Build Coastguard Workersupported formats will be printed to standard output.
18