libbgi: W0-атласы спрайтов — загрузчик, движок, упаковщик (все проверки PASS)

Реализация §3.1/§9в: атлас = один .atl-файл = одна EMM-страница, подключаемая в W0 на время блита. - atlas_load: read() файла целиком в страницу через W3 + патч ISR-стаба (0x38: JP _gfx_w0_isr; 0x66: RETN); atlas_free/atlas_image/ atlas_sprite_init; gfx_w0_map/unmap для ручных вызовов. - _gfx_w0_isr (стаб из tests/w0page): свап на ядро DSS → честный 0x38 → restore спрайт-страницы; покрывает IM1 и IM2-чейн. - sprite_t.page (0 = обычная память); sprite_update в блит-проходе мапит страницу по смене (один OUT на атлас), эпилог возвращает DSS (+52 Б на движок — цена фичи). - toolchain/mkatlas.py: PNG (indexed) / raw → .atl; заголовок 0x100, каталог 0x68 (19 лент), файл-офсет == офсет страницы == W0-адрес. - Сплит _gfx_sprite_fns → _gfx_blit_fn.c + _gfx_heal_fn.c (1 указатель = 1 модуль): putsprite-only программа не тянет heal-ядро (spriteclip ловил +292 Б; теперь −68 Б от эталона). tests/atlas (MAME dev, PASS): загрузка (count/страница), каталог и данные по W0-адресам (заголовок ленты через gfx_w0_map), 3 спрайта из двух лент через движок — пиксели проверены read_vram побайтно (0x10/0x12/0x21, прозрачный угол = фон). docs: §9г — предложение авто-анимации (кадровая ±step без умножений, tween-Брезенхэм порциями, тикер через funcptr) — ОБСУЖДАЕТСЯ. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-13 15:52:00 +03:00
parent c4a512200f
commit 0e935343d9
22 changed files with 648 additions and 29 deletions
@@ -0,0 +1,68 @@
+/*
+ * atlas_load — загрузить .atl-файл в свежую EMM-страницу (§3.1/§9в
+ * дизайна, вариант II: файл-офсет == офсет страницы == W0-адрес).
+ *
+ * Порядок: выделить страницу (mem_alloc_pages) → замапить в W3 →
+ * read() файла ЦЕЛИКОМ в 0xC000 (ESTEX READ пишет в W3 — проверено
+ * tests/w0page P1) → проверить магию 'SPA1' → пропатчить ISR-стаб
+ * (0x38: JP _gfx_w0_isr; 0x66: RETN — место зарезервировано в
+ * заголовке файла) → вернуть W3.  Никакого пересчёта офсетов: каталог
+ * и ленты уже лежат по своим W0-адресам.
+ *
+ * Вызывать ВНЕ рендера (W3 на время загрузки занята страницей атласа).
+ * Ошибки: -1 + errno (open/read/alloc; EINVAL — не .atl).
+ */
+#include <fcntl.h>
+#include <unistd.h>
+#include <errno.h>
+#include <sprinter.h>
+#include <sprinter_mem.h>
+#include <sprite.h>
+#include "../_bgi.h"
+
+int atlas_load(atlas_t *a, const char *path)
+{
+    uint8_t *pg = (uint8_t *)0xC000;
+    uint8_t saved_w3, blk, ok;
+    uint16_t stub;
+    int fd, n;
+
+    fd = open(path, O_RDONLY);
+    if (fd < 0) return -1;
+
+    blk = mem_alloc_pages(1);
+    if (!blk) { close(fd); return -1; }
+
+    if (!_gfx_w0_dss)
+        _gfx_w0_dss = _io_page_w0;      /* снять страницу ядра DSS */
+
+    a->blk  = blk;
+    a->page = mem_get_page(blk, 0);
+
+    saved_w3 = _io_page_w3;
+    sprinter_page_w3(a->page);
+
+    n  = read(fd, pg, 16384);
+    ok = (n >= (int)_ATL_DATA_OFF &&
+          pg[0] == 'S' && pg[1] == 'P' && pg[2] == 'A' && pg[3] == '1');
+    if (ok) {
+        a->count = pg[4];
+        stub = (uint16_t)&_gfx_w0_isr;
+        pg[0x38] = 0xC3;                /* JP _gfx_w0_isr */
+        pg[0x39] = (uint8_t)(stub & 0xFF);
+        pg[0x3A] = (uint8_t)(stub >> 8);
+        pg[0x66] = 0xED;                /* RETN (NMI)     */
+        pg[0x67] = 0x45;
+    }
+
+    sprinter_page_w3(saved_w3);
+    close(fd);
+
+    if (!ok) {
+        mem_free_block(blk);
+        a->page = 0;
+        errno = EINVAL;
+        return -1;
+    }
+    return 0;
+}