PAL / ALP / LHT / SHD: paletas y tablas de consulta de color

Total Annihilation distribuyó todo su mundo en 256 colores. El archivo .pal contiene esa paleta; los archivos .alp, .shd y .lht son tablas de consulta construidas a partir de ella que el motor usa para mezclar, sombrear e iluminar píxeles sin salir del espacio de color indexado.

Ninguno de los cuatro tiene cabecera, campo de versión ni compresión. Un .pal ocupa 1024 bytes (256 × RGBx); un .alp, 65 536 bytes (256 filas de 256 índices de la paleta), y .shd / .lht, 8192 bytes cada uno (32 filas de 256 índices de la paleta).

palettes/palette.pal, renderizada con 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)
}

Estructura en 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

No hay firma ni versión. El juego carga palettes/<name>.pal así (el pal.LoadNamed de kbot-io hace lo mismo, y el studio y el explorador de recursos cargan palette.pal a través de él en todos los renderizados de TA: pool de casillas, minimapas, terreno del sandbox, elementos, texturas y colores de los modelos):

• 1024 bytes o más: los primeros 1024 bytes son la paleta; el resto se ignora.
• Vacío o ausente: la paleta se toma de palettes/<name>.pcx: los últimos 768 bytes de ese archivo, vaya o no precedidos de una marca 0x0C. Después, TA 3.1c reconstruye las tablas .alp, .shd y .lht para esos colores.
• De 1 a 1023 bytes: no sirve; el juego lee 1024 bytes y se sale del final del archivo. kbot da un error (y el studio recurre a la paleta de TA integrada).

.pal: la paleta canónica de TA#

Los bytes R, G, B, A de cada entrada significan literalmente rojo, verde, azul, sin uso. El índice 0 es un negro normal. Las casillas del terreno, los minimapas y los fondos lo dibujan opaco (62 de los 275 mapas de la versión comercial lo usan en sus casillas). La transparencia se decide en cada imagen, no en la paleta: el byte clave de un fotograma GAF (a menudo 9, a veces 0) y sus píxeles saltados son transparentes, y las texturas de los modelos se muestrean sin color clave.

.alp / .shd / .lht: tablas de consulta de color#

Estos tres archivos no son datos RGB: cada byte es un índice de la paleta. Cada tabla tiene una fila de 256 entradas por cada color con el que se mezcla o por cada nivel, y sus columnas son los 256 colores de origen:

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 la práctica: el motor nunca mezcla colores aritméticamente, sino que consulta una tabla, así que el píxel resultante es siempre un índice real de la paleta que se puede dibujar con el proceso de 8 bpp existente. Por eso todas las sombras de TA parecen una versión más oscura de la misma rampa de color, y no «negro al 50 % superpuesto»: cada resultado sombreado es el índice de la paleta más cercano a esa mezcla matemática.

El juego solo usa un archivo de tabla cuando su tamaño es exacto; una tabla que falta o que tiene cualquier otro tamaño se reconstruye a partir de la paleta. Por eso kbot pal lookup rechaza los archivos de cualquier otro tamaño. TA: Kingdoms distribuye tablas de los mismos tamaños para casi todas las paletas de su carpeta palettes/; la mayoría de esas paletas son archivos PCX, y kbot pal lookup --palette acepta tanto un .pcx como un .pal.

Ejemplo desarrollado: palette.pal#

Las 16 primeras entradas de la paleta original de TA:

kbot pal describe palettes/palette.pal imprime la tabla completa.

Ejemplo desarrollado: palette.alp y palette.shd como tablas de consulta#

Las tablas renderizadas con la paleta como fuente de color (kbot pal lookup … --cell 2):

palette.alp: 256 × 256 celdas. La fila a, columna b muestra la mezcla de los colores a y b;
la diagonal reproduce cada color.

palette.shd: 256 × 32 celdas. Cada columna es un color de origen;
las filas van del negro (fila 0), pasando por el propio color, hasta tonos más claros.

Cómo leer la tabla de sombras: la columna 80 (gris medio) empieza en negro en la fila 0, sube por los grises más oscuros de su rampa, llega a sí misma hacia las filas 14 y 15 y después se aclara. El motor nunca necesita multiplicar valores RGB: solo lee shd[level][c].

Convertir paletas para los editores#

kbot pal convert entiende varios formatos de salida cómodos para los editores:

La dirección contraria (importar un .gpl o un .pal JASC de vuelta a un .pal binario de TA) funciona siempre que el origen tenga 256 entradas.

Escollos#

• El índice 0 no es transparente por sí mismo. El terreno, los minimapas y los fondos lo dibujan negro; un fotograma de sprite solo es transparente donde lo indica su propio color clave (o un tramo de salto). Los renderizados de terreno y minimapa de kbot usan una paleta opaca.
• Sin números mágicos, la validación es débil. La única forma de comprobar que un .pal es razonable es exigir al menos 1024 bytes y (opcionalmente) que el byte alfa sea cero en todas las entradas.
• El juego ignora una tabla de consulta de tamaño incorrecto y la reconstruye a partir de la paleta.
• .alp / .lht / .shd no son intercambiables. Están ajustadas para efectos distintos; si las intercambias, obtendrás sombras o iluminación visiblemente incorrectas.
• TA: Kingdoms usa paletas por bando incrustadas en PCX, no el sistema del .pal global. Consulta PCX para ver el truco del PCX portador.

Tamaños habituales#

Véase también#

• PCX: archivos con paletas incrustadas (y la convención de PCX portadores de paleta de TA:K).
• GAF: animaciones que usan una paleta pero no la incluyen.
• TNT, SCT: datos de casillas con paleta en disco.
• Glosario: paletted image, lookup table.