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>

libbgi/common/atlas_sprite_init.c

@@ -0,0 +1,30 @@
+/*
+ * atlas_sprite_init — инициализировать спрайт лентой idx W0-атласа.
+ * Аналог sprite_init, но img/размер КАДРА берутся из каталога атласа
+ * (заголовок ленты трогать нельзя — он в невидимой сейчас странице),
+ * а page = страница атласа (sprite_update подключит её сам).
+ * Кадр (0,0); кадр (i,j) ленты — sprite_frame(s, i*fw, j*fh).
+ */
+#include <sprinter.h>
+#include <sprite.h>
+#include "../_bgi.h"
+
+void atlas_sprite_init(sprite_t *s, const atlas_t *a, uint8_t idx)
+{
+    uint8_t saved = _io_page_w3;
+    const uint8_t *e;
+
+    sprinter_page_w3(a->page);
+    e = (const uint8_t *)(0xC000 + _ATL_DIR_OFF) + (uint16_t)idx * 8;
+    s->img = (const void *)(e[0] | (uint16_t)(e[1] << 8));
+    s->w   = e[2];                       /* fw — размер КАДРА */
+    s->h   = e[3];                       /* fh                */
+    sprinter_page_w3(saved);
+
+    s->x = 0;  s->y = 0;
+    s->sx = 0; s->sy = 0;
+    s->flags = 0;
+    s->page  = a->page;
+    s->drawn[0].on = 0;
+    s->drawn[1].on = 0;
+}