Files
Dreierpack-Manager/docs/formats/VGA.md
T

1.2 KiB

Indexed bitmap: .VGA

src/formats/vga.cpp decodes eight-bit palette indices from a continuous run-length stream. Coordinates use a top-left origin.

Offset Type Meaning
0 u16 Width
2 u16 Height
4 u32 Encoded length, including one trailing byte
8 bytes Encoded pixel stream

For a control byte c >= 0x80, repeat the following byte c - 0x7f times. Otherwise copy the next c + 1 literal bytes. Decoding continues across row boundaries until width * height indices have been produced. The loader rejects truncated data and requires exactly one byte to remain within the declared stream afterwards. A run exceeding the pixel count is clipped by the decoder.

The default colours come from M3PC.COL. Certain full-screen resources append a 768-byte palette after the encoded stream; callers loading those resources must select that palette separately. decode_vga itself returns indices and does not interpret appended palette data.

Crest sheets use 38 by 38 pixel cells, eight per sheet. For a nine-bit crest ID, the file number is id >> 3 and the horizontal cell is id & 7. This describes the lookup scheme rather than any particular copyrighted crest or sheet content.