PAL / ALP / LHT / SHD — palettes et tables de correspondance de couleurs

Total Annihilation a livré tout son monde en 256 couleurs. Le fichier .pal contient cette palette ; les fichiers .alp, .shd et .lht sont des tables de correspondance construites à partir d'elle, dont le moteur se sert pour mélanger, ombrer et éclairer les pixels sans quitter l'espace de couleurs indexées.

Aucun des quatre n'a d'en-tête, de champ de version ni de compression. Un .pal fait 1 024 octets (256 × RGBx) ; un .alp fait 65 536 octets (256 lignes de 256 index de palette) et les .shd / .lht font 8 192 octets chacun (32 lignes de 256 index de palette).

palettes/palette.pal — rendu par kbot pal swatch

kbot pal info     palettes/palette.pal              # one-liner
kbot pal describe palettes/palette.pal              # full RGB dump
kbot pal swatch   palettes/palette.pal -o pal.png --cell 24

# Render a lookup table, coloured by the palette:
# .alp as 256×256 cells, .shd / .lht as 256×32 cells
kbot pal lookup   palettes/palette.alp --palette palettes/palette.pal --target alp.png
kbot pal lookup   palettes/palette.shd --target shd.png
# TA: Kingdoms: the palette is usually a PCX next to its tables
kbot pal lookup   palettes/aramon.alp --palette palettes/aramon.pcx --target aramon.png

# Round-trip to editor-friendly formats
kbot pal convert  palettes/palette.pal -o palette.gpl                  # GIMP
kbot pal convert  palettes/palette.pal -o palette.txt --format jasc    # JASC

import "github.com/coreprime/kbot/formats/pal"

p, _ := pal.LoadFromFile("palettes/palette.pal")
fmt.Printf("RGB[0] = %v (black; sprites key it per frame)\n", p.Colors[0])
for i, c := range p.Colors {
    fmt.Printf("%3d  #%02x%02x%02x\n", i, c.R, c.G, c.B)
}

Disposition sur le disque (.pal)#

typedef struct {
    uint8 R;
    uint8 G;
    uint8 B;
    uint8 A;     // Unused. Cavedog files have this as 0 throughout.
} PALEntry;

PALEntry entries[256];   // 256 × 4 = 1024 bytes

Il n'y a ni signature ni version. Le jeu charge palettes/<name>.pal de la façon suivante (le pal.LoadNamed de kbot-io fait de même, et le studio et l'explorateur de ressources chargent palette.pal par son intermédiaire pour chaque rendu de TA : pool de tuiles, minicartes, terrain du bac à sable, éléments de décor, textures et couleurs des modèles) :

• 1 024 octets ou plus : les 1 024 premiers octets forment la palette ; le reste est ignoré.
• Vide ou absent : la palette vient alors de palettes/<name>.pcx — les 768 derniers octets de ce fichier, qu'un marqueur 0x0C les précède ou non. TA 3.1c reconstruit ensuite les tables .alp, .shd et .lht pour ces couleurs.
• De 1 à 1 023 octets : inutilisable ; le jeu lit 1 024 octets au-delà de la fin du fichier. kbot signale une erreur (et le studio se rabat sur la palette de TA intégrée).

.pal — la palette de référence de TA#

Les octets R, G, B, A de chaque entrée signifient littéralement rouge, vert, bleu, inutilisé. L'index 0 est un noir ordinaire. Les tuiles de terrain, les minicartes et les fonds le dessinent opaque (62 des 275 cartes d'origine l'utilisent dans leurs tuiles). La transparence se décide image par image, pas par la palette : l'octet clé d'une frame GAF (souvent 9, parfois 0) et ses pixels sautés sont transparents, et les textures des modèles sont échantillonnées sans clé.

.alp / .shd / .lht — tables de correspondance de couleurs#

Ces trois fichiers ne sont pas des données RVB : chaque octet est un index de palette. Chaque table a une ligne de 256 entrées par partenaire de mélange ou par niveau, et ses colonnes sont les 256 couleurs sources :

uint8 alp[256][256];   // blend = alp[a][b]
uint8 shd[32][256];    // shaded = shd[level][c]
uint8 lht[32][256];    // lit    = lht[level][c]

En pratique, le moteur ne mélange jamais les couleurs par le calcul : il consulte une table, si bien que le pixel obtenu est toujours un vrai index de palette, dessinable par la chaîne 8 bpp existante. C'est pourquoi toutes les ombres de TA ressemblent à une version plus sombre du même dégradé de couleurs, et non à « 50 % de noir superposé » : chaque résultat ombré est l'index de palette le plus proche de ce mélange mathématique.

Le jeu n'utilise un fichier de table que si sa taille est exacte ; une table absente, ou d'une autre taille, est reconstruite à partir de la palette. kbot pal lookup rejette donc les fichiers de toute autre taille. TA: Kingdoms livre des tables de mêmes tailles pour presque chaque palette de son dossier palettes/ ; la plupart de ces palettes sont des fichiers PCX, et kbot pal lookup --palette accepte un .pcx aussi bien qu'un .pal.

Exemple commenté — palette.pal#

Les 16 premières entrées de la palette d'origine de TA :

kbot pal describe palettes/palette.pal affiche la table complète.

Exemple commenté — palette.alp et palette.shd comme tables#

Rendu des tables avec la palette comme source de couleurs (kbot pal lookup … --cell 2) :

palette.alp : 256 × 256 cases. La ligne a, colonne b montre le mélange des couleurs a et b ;
la diagonale reproduit chaque couleur.

palette.shd : 256 × 32 cases. Chaque colonne est une couleur source ;
les lignes vont du noir (ligne 0) à des teintes plus claires, en passant par la couleur elle-même.

Lecture de la table des ombres : la colonne 80 (gris moyen) commence noire à la ligne 0, remonte les gris plus sombres de son dégradé, atteint sa propre couleur vers les lignes 14 et 15, puis s'éclaircit. Le moteur n'a jamais besoin de multiplier des valeurs RVB : il lit simplement shd[level][c].

Convertir les palettes pour les éditeurs#

kbot pal convert connaît plusieurs formats de sortie adaptés aux éditeurs :

Le sens inverse — importer un .gpl ou un .pal (JASC) dans un .pal binaire de TA — fonctionne tant que la source a 256 entrées.

Pièges#

• L'index 0 n'est pas transparent en soi. Le terrain, les minicartes et les fonds le dessinent en noir ; une frame de sprite n'est transparente que là où sa propre clé (ou une plage sautée) l'indique. Les rendus de terrain et de minicarte de kbot utilisent une palette opaque.
• Pas de nombre magique, donc une validation faible. La seule façon de vérifier un .pal est d'exiger au moins 1 024 octets et (éventuellement) que l'octet alpha soit nul dans chaque entrée.
• Une table de correspondance de mauvaise taille est ignorée par le jeu et reconstruite à partir de la palette.
• .alp / .lht / .shd ne sont pas interchangeables. Ils sont réglés pour des effets différents ; les échanger produit des ombres ou un éclairage visiblement faux.
• TA: Kingdoms utilise des palettes par camp intégrées à des PCX, et non le fonctionnement par .pal global. Voir PCX pour l'astuce des PCX porteurs de palette.

Tailles typiques#

Voir aussi#

• PCX — les fichiers à palette intégrée (et la convention des porteurs de palette de TA:K).
• GAF — des animations qui utilisent une palette sans en contenir.
• TNT, SCT — des données de tuiles à palette sur le disque.
• Glossaire — image à palette, table de correspondance.