# Image plugin status

Snapshot: 2026-11-14. This is a qualitative inventory of the 18 image format
plugins configured in [RAPluginIMAGE.cmake](engine/RAPLUGIN/cmake/RAPluginIMAGE.cmake).
Their CMake options default to `OFF`; presets and runtime profiles may enable
them. A plugin must be built and loaded before it can be used.

## Tier scale

| Tier  | Meaning                                                                         |
|-------|---------------------------------------------------------------------------------|
| **S** | Broad format coverage with extensive independent compatibility evidence.        |
| **A** | Mature implementation with broad, focused regression coverage and bounded gaps. |
| **B** | Useful, tested implementation with significant format or feature limitations.   |
| **C** | Narrow or special-purpose implementation with focused validation.               |
| **D** | Early implementation, material correctness concerns, or little validation.      |
| **E** | Mostly stubbed or inert functionality.                                          |
| **F** | No working runtime, or a confirmed fundamental build/run failure.               |

These are qualitative maturity ratings, not compatibility guarantees. Tests
cover selected variants, not every file in a format. No plugin is rated S, E or F:
the evidence does not establish universal compatibility or, for these entries,
a reproduced fundamental build/run failure.

## Format plugins

I/O describes the plugin interface, not every consumer. **Native** means a
texture payload reader, not necessarily a decoded `raImage`. Source links point
to the implementation or its module documentation.

| Plugin | Tier | I/O | Current state |
|--------|:----:|-----|---------------|
| IMAGE.ASTC | C | Native | Raw 2D ASTC LDR blocks; no `raImage` decoder, 3D blocks or writing. Native texture tests cover all 2D footprints. |
| IMAGE.BMP | A | Read, write | Reads indexed 1/4/8-bit and 24/32-bit RGB; writes 8-bit indexed and 24/32-bit RGB(A). RLE is unsupported; focused round-trip and decoding tests exist. |
| IMAGE.BPP | B | Read, write, native | Image I/O supports Game Boy 2bpp tiles and 4/8bpp indexed data; native texture reading also supports 1/16/24/32bpp. Raw dimensions use a sidecar; layout and palette limits apply. |
| IMAGE.DDS | B | Read, native | Decodes a subset including BC1/2/3 and exposes arrays, cubes and volumes; native reads preserve supported BC1–7 and other mip chains. No writer; supported subsets differ by API. |
| IMAGE.EXR | C | Read | Uncompressed, single-part scanline RGB/Y with optional alpha and HALF/FLOAT/UINT samples. No compression, tiles or deep/multipart images; focused tests exist. |
| IMAGE.GIF | B | Read | Decodes the first GIF87a/89a frame with palettes, transparency and interlacing; requires `COMPRESSOR.LZW` version 2+. No animation playback or writer; focused tests exist. |
| IMAGE.HDR | C | Read | Radiance RGBE Y-major RLE or flat scanlines; float samples are retained, but the RGBA8 view clamps rather than tone maps. Focused tests exist. |
| IMAGE.HEX | D | Read, write | Reads raw bytes as a one-row indexed image and writes hexadecimal text, not a general image-file round trip. No local regression suite found. |
| IMAGE.JPG | B | Read | Baseline 8-bit sequential JPEG; progressive, CMYK and several other variants are unsupported. JPEG and texture integration are tested; no writer. |
| IMAGE.KTX2 | C | Native | Preserves supported native texture formats, mips, arrays, cubes and volumes; no `raImage` decoder, supercompression or Basis transcoding. Native texture tests exist. |
| IMAGE.PBM | B | Read | P1 and P4 bitmap decoding, including packed rows and comments; produces opaque RGBA. Focused tests cover variants and malformed input. No writer. |
| IMAGE.PCX | A | Read, write | Reads raw/RLE mono, CGA, EGA, indexed and RGB(A) planes; writes indexed, EGA and RGB(A) variants. Focused decoding and round-trip tests exist. |
| IMAGE.PGM | B | Read | P2/P5 grayscale with 1–65535 maximum, scaled to 8-bit RGBA. Focused tests cover plain, raw, 16-bit and malformed input. No writer. |
| IMAGE.PNG | A | Read | Decodes all standard color types and legal bit depths, including Adam7 and `tRNS`; 16-bit samples are reduced to 8 bits. Focused decoding/error tests exist; no writer. |
| IMAGE.PPM | B | Read | P3/P6 RGB with 1–65535 maximum, scaled to 8-bit RGBA. Focused tests cover plain, raw, 16-bit and malformed input. No writer. |
| IMAGE.TGA | B | Read | Indexed, grayscale and true-color raw or packet-RLE images with selected bit depths and origins; no writer. Focused tests exist. |
| IMAGE.TIFF | B | Read | Classic TIFF strips, uncompressed or PackBits, with selected grayscale, RGB and palette formats. No BigTIFF, tiles, CMYK or writer; focused tests exist. |
| IMAGE.WAL | C | Read | Quake II indexed base mip; requires a user-supplied PCX palette and the palette/PCX plugins. No archive lookup or writer; focused tests exist. |

## Availability and related plugins

`IMAGE.FILTER.BUILTIN` is configured separately in
[RAPluginIMAGEFILTER.cmake](engine/RAPLUGIN/cmake/RAPluginIMAGEFILTER.cmake);
it provides image filters, not a file format, and is not included in the 18
format-plugin tiers. WebP and SVG are not configured image format plugins in
this inventory.
