PAL / ALP / LHT / SHD — палітри й таблиці пошуку кольорів

Увесь світ Total Annihilation вміщено в 256 кольорів. Файл .pal містить цю палітру; файли .alp, .shd і .lht — це побудовані на її основі таблиці пошуку, за допомогою яких рушій змішує, затінює й освітлює пікселі, не виходячи за межі простору індексованих кольорів.

Жоден із чотирьох форматів не має ні заголовка, ні поля версії, ні стиснення. .pal займає 1 024 байти (256 × RGBx); .alp — 65 536 байтів (256 рядків по 256 індексів палітри), а .shd / .lht — по 8 192 байти (32 рядки по 256 індексів палітри).

palettes/palette.pal — відрендерено командою 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)
}

Структура на диску (.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

Немає ні сигнатури, ні версії. Гра завантажує palettes/<name>.pal так (pal.LoadNamed у kbot-io робить те саме, і студія та оглядач ресурсів завантажують через нього palette.pal для кожного рендеру TA: пулу тайлів, мінімап, рельєфу в пісочниці, об'єктів, текстур і кольорів моделей):

• 1 024 байти або більше: перші 1 024 байти — це палітра, решта ігнорується.
• Порожній або відсутній: палітра натомість береться з palettes/<name>.pcx — це останні 768 байтів того файлу, незалежно від того, чи стоїть перед ними маркер 0x0C. Після цього TA 3.1c будує заново таблиці .alp, .shd і .lht для цих кольорів.
• Від 1 до 1 023 байтів: непридатний; гра читає 1 024 байти, виходячи за кінець файлу. kbot повідомляє про помилку (а студія повертається до вбудованої палітри TA).

.pal — канонічна палітра TA#

Байти R, G, B, A у кожному записі буквально означають червоний, зелений, синій, не використовується. Індекс 0 — звичайний чорний. Тайли рельєфу, мінімапи й фони малюють його непрозорим (62 з 275 релізних мап використовують його у своїх тайлах). Прозорість визначається для кожного зображення окремо, а не палітрою: прозорими є ключовий байт кадру GAF (часто 9, інколи 0) і його пропущені пікселі, а текстури моделей вибираються без ключа.

.alp / .shd / .lht — таблиці пошуку кольорів#

Ці три файли не є RGB-даними: кожен байт — це індекс палітри. Кожна таблиця має по одному рядку з 256 записів на кожного партнера змішування чи рівень, а її стовпці — це 256 вихідних кольорів:

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

На практиці рушій ніколи не змішує кольори арифметично — він звертається до таблиці, тож отриманий піксель завжди є справжнім індексом палітри, який можна намалювати через наявний 8-бітний конвеєр. Ось чому всі тіні в TA виглядають як темніший варіант того самого градієнта, а не як «накладений 50-відсотковий чорний»: кожен затінений результат — це індекс палітри, найближчий до відповідної математичної суміші.

Гра використовує файл таблиці, лише якщо його розмір точний; відсутня таблиця або таблиця будь-якого іншого розміру будується заново з палітри. Тому kbot pal lookup відхиляє файли будь-якого іншого розміру. TA: Kingdoms постачає таблиці тих самих розмірів майже для кожної палітри у своїй теці palettes/; більшість цих палітр — файли PCX, і kbot pal lookup --palette приймає .pcx так само, як і .pal.

Розібраний приклад — palette.pal#

Перші 16 записів стандартної палітри TA:

kbot pal describe palettes/palette.pal виводить повну таблицю.

Розібраний приклад — palette.alp і palette.shd як таблиці пошуку#

Рендеринг таблиць із палітрою як джерелом кольорів (kbot pal lookup … --cell 2):

palette.alp: 256 × 256 клітинок. Рядок a, стовпець b показує суміш кольорів a і b;
діагональ відтворює кожен колір.

palette.shd: 256 × 32 клітинки. Кожен стовпець — вихідний колір;
рядки йдуть від чорного (рядок 0) через сам колір до світліших відтінків.

Як читати таблицю затінення: стовпець 80 (середньо-сірий) у рядку 0 починається з чорного, піднімається через темніші сірі свого градієнта, досягає самого себе приблизно в рядках 14 і 15, а далі світлішає. Рушію ніколи не треба множити значення RGB — він просто читає shd[level][c].

Конвертація палітр для редакторів#

kbot pal convert підтримує кілька вихідних форматів, зручних для редакторів:

Зворотний напрямок — імпорт .gpl чи .pal (JASC) назад у двійковий .pal для TA — працює, якщо джерело має 256 записів.

Підводні камені#

• Індекс 0 сам по собі не прозорий. Рельєф, мінімапи й фони малюють його чорним; кадр спрайта прозорий лише там, де це визначає його власний ключ (або серія пропуску). Рендери рельєфу й мінімап у kbot використовують непрозору палітру.
• Без магічних чисел перевірка слабка. Єдиний спосіб перевірити .pal на адекватність — вимагати щонайменше 1024 байти й (за бажанням) нульовий байт альфи в кожному записі.
• Таблицю пошуку неправильного розміру гра ігнорує й будує заново з палітри.
• .alp / .lht / .shd не взаємозамінні. Їх налаштовано для різних ефектів; якщо їх поміняти місцями, тіні чи освітлення будуть помітно неправильними.
• TA: Kingdoms використовує палітри, вбудовані в PCX окремих сторін, а не робочий процес із глобальним .pal. Прийом із PCX-носіями див. на сторінці PCX.

Типові розміри#

Див. також#

• PCX — файли з вбудованими палітрами (і домовленість TA:K про PCX-носії палітр).
• GAF — анімації, що використовують палітру, але не містять її.
• TNT, SCT — палітрові дані тайлів на диску.
• Глосарій — paletted image, lookup table.