PAL / ALP / LHT / SHD — Palette e tabelle di ricerca dei colori

Total Annihilation disegna il suo intero mondo con 256 colori. Il file .pal contiene quella palette; i file .alp, .shd e .lht sono tabelle di ricerca costruite a partire da essa, che il motore usa per fondere, ombreggiare e illuminare i pixel senza uscire dallo spazio dei colori indicizzati.

Nessuno dei quattro ha un'intestazione, un campo di versione o una compressione. Un .pal è di 1.024 byte (256 × RGBx); un .alp è di 65.536 byte (256 righe di 256 indici della palette) e .shd / .lht sono di 8.192 byte ciascuno (32 righe di 256 indici della palette).

palettes/palette.pal — disegnata da 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)
}

Struttura su disco (.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

Non c'è né una firma né una versione. Il gioco carica palettes/<name>.pal in questo modo (pal.LoadNamed di kbot-io fa lo stesso, e lo studio e l'esploratore di asset caricano palette.pal tramite questa funzione per ogni rendering di TA: pool dei tile, minimappe, terreno della sandbox, elementi, texture e colori dei modelli):

• 1.024 byte o più: i primi 1.024 byte sono la palette; il resto viene ignorato.
• Vuoto o mancante: la palette viene invece da palettes/<name>.pcx, dagli ultimi 768 byte di quel file, che siano preceduti o no da un marcatore 0x0C. TA 3.1c ricostruisce poi le tabelle .alp, .shd e .lht per quei colori.
• Da 1 a 1.023 byte: inutilizzabile; il gioco legge 1.024 byte, oltre la fine del file. kbot segnala un errore (e lo studio ripiega sulla palette di TA integrata).

.pal — la palette canonica di TA#

I byte R, G, B, A di ogni voce significano letteralmente rosso, verde, blu, inutilizzato. L'indice 0 è un normale nero. Tile del terreno, minimappe e fondali lo disegnano opaco (62 delle 275 mappe originali lo usano nei loro tile). La trasparenza si decide immagine per immagine, non nella palette: il byte chiave di un frame GAF (spesso 9, a volte 0) e i suoi pixel saltati sono trasparenti, e le texture dei modelli vengono campionate senza chiave.

.alp / .shd / .lht — tabelle di ricerca dei colori#

Questi tre file non sono dati RGB: ogni byte è un indice della palette. Ogni tabella ha una riga di 256 voci per ogni partner di fusione o livello, e le sue colonne sono i 256 colori di partenza:

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

In pratica il motore non fonde mai i colori aritmeticamente: fa una ricerca in tabella, quindi il pixel risultante è sempre un vero indice della palette che si può disegnare con la pipeline esistente a 8 bpp. È per questo che tutte le ombre di TA sembrano una versione più scura della stessa sfumatura di colore, e non un "nero al 50% sovrapposto": ogni risultato ombreggiato è l'indice della palette più vicino a quella miscela matematica.

Il gioco usa un file di tabella solo quando la sua dimensione è esatta; una tabella mancante o di qualsiasi altra dimensione viene ricostruita dalla palette. Per questo kbot pal lookup rifiuta i file di qualsiasi altra dimensione. TA: Kingdoms distribuisce tabelle delle stesse dimensioni per quasi ogni palette della sua cartella palettes/; la maggior parte di quelle palette sono file PCX, e kbot pal lookup --palette accetta un .pcx oltre che un .pal.

Esempio svolto — palette.pal#

Le prime 16 voci della palette standard di TA:

kbot pal describe palettes/palette.pal stampa la tabella completa.

Esempio svolto — palette.alp e palette.shd come tabelle di ricerca#

Disegnando le tabelle con la palette come fonte dei colori (kbot pal lookup … --cell 2):

palette.alp: 256 × 256 celle. La riga a, colonna b mostra la fusione dei colori a e b;
la diagonale riproduce ciascun colore.

palette.shd: 256 × 32 celle. Ogni colonna è un colore di partenza;
le righe vanno dal nero (riga 0), passano per il colore stesso e arrivano a tonalità più chiare.

Come leggere la tabella delle ombre: la colonna 80 (grigio medio) parte dal nero nella riga 0, sale attraverso i grigi più scuri della sua sfumatura, raggiunge sé stessa intorno alle righe 14 e 15 e poi si schiarisce. Il motore non ha mai bisogno di moltiplicare valori RGB: legge semplicemente shd[level][c].

Convertire le palette per gli editor#

kbot pal convert conosce diversi formati di output adatti agli editor:

La direzione inversa, cioè importare un .gpl o un .pal (JASC) di nuovo in un .pal binario di TA, funziona purché il file di partenza abbia 256 voci.

Insidie#

• L'indice 0 non è trasparente di per sé. Terreno, minimappe e fondali lo disegnano nero; un frame di uno sprite è trasparente solo dove lo dice la sua chiave (o un run saltato). I rendering di terreno e minimappa di kbot usano una palette opaca.
• Niente magic number significa validazione debole. L'unico modo per verificare la plausibilità di un .pal è richiedere almeno 1024 byte e (facoltativamente) che il byte dell'alfa sia zero in ogni voce.
• Il gioco ignora una tabella di ricerca della dimensione sbagliata e la ricostruisce dalla palette.
• .alp / .lht / .shd non sono intercambiabili. Sono tarati per effetti diversi; scambiarli produce ombre o illuminazione visibilmente sbagliate.
• TA: Kingdoms usa palette per fazione incorporate in file PCX, non il flusso di lavoro con il .pal globale. Vedi PCX per il trucco dei PCX che fanno da contenitori di palette.

Dimensioni tipiche#

Vedi anche#

• PCX: file con palette incorporate (e la convenzione di TA:K dei PCX come contenitori di palette).
• GAF: animazioni che usano una palette ma non ne contengono una.
• TNT, SCT: dati dei tile con palette su disco.
• Glossario: immagine con palette (paletted image), tabella di ricerca (lookup table).