snark13
0e935343d9
Реализация §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>
83 lines
4.2 KiB
C
83 lines
4.2 KiB
C
/*
|
|
* sprite_update — отрисовать кадр сцены на ТЕКУЩЕЙ draw-странице p
|
|
* (gfx_get_draw_page). Ядро batch-пасса движка v2 (см.
|
|
* docs/sprite-api-design.md §9.1): вся работа кадра — здесь, двухпроходно
|
|
* «heal ВСЕ → блит ВСЕ», под ОДНОЙ W3-скобкой и ОДНИМ банком на проход.
|
|
*
|
|
* Дисциплина двух проходов ОБЯЗАТЕЛЬНА: слияние heal+блит per-sprite не
|
|
* работает на перекрытиях (heal соседа выкусывает только что
|
|
* нарисованный спрайт — проверено на examples/balls 2026-07-11).
|
|
*
|
|
* Что перерисовывается: спрайт, у которого страница p ГРЯЗНАЯ (dbit —
|
|
* взведён sprite_move/frame/show/hide/touch) ИЛИ флаг SPR_ALWAYS.
|
|
* Неизменившиеся с прошлого визита этой страницы (и без SPR_ALWAYS) не
|
|
* трогаются — суть retained-модели.
|
|
*
|
|
* Проход 1 (банк 0x50): heal старой позиции drawn[p] у тех, кто нарисован
|
|
* (drawn[p].on) и требует обновления → снять drawn[p].on.
|
|
* Проход 2 (банк 0x5C): блит видимых, требующих обновления, в (x,y) кадром
|
|
* (sx,sy) → записать drawn[p] = (x,y), on = 1; снять dbit (страница p
|
|
* актуальна для этого спрайта). z-order = порядок массива.
|
|
*
|
|
* DI живёт внутри leaf'ов (по строке) — скобка _bgi_begin/_bgi_end
|
|
* прерывания НЕ трогает (только мапит W3), поэтому длина прохода не
|
|
* влияет на аудио-ISR. w,h кадра ≤ 255 (см. sprite.h).
|
|
*/
|
|
#include <sprinter.h>
|
|
#include "../_bgi.h"
|
|
#include <sprite.h>
|
|
|
|
void sprite_update(sprite_t *arr, uint8_t count)
|
|
{
|
|
uint8_t p = gfx_get_draw_page(); /* 0 / 1 */
|
|
uint8_t dbit = p ? _SPR_DIRTY1 : _SPR_DIRTY0;
|
|
uint8_t saved = gfx_get_bank();
|
|
uint8_t i;
|
|
sprite_t *s;
|
|
|
|
/* Проход 1: heal ВСЕХ старых позиций, требующих обновления. */
|
|
gfx_set_bank(GFX_BANK_NORMAL);
|
|
_bgi_begin();
|
|
for (i = 0, s = arr; i < count; i++, s++) {
|
|
if (s->drawn[p].on && (s->flags & (dbit | SPR_ALWAYS))) {
|
|
(*_gfx_heal_fn)(s->drawn[p].x, s->drawn[p].y, s->w, s->h);
|
|
s->drawn[p].on = 0;
|
|
}
|
|
}
|
|
_bgi_end();
|
|
|
|
/* Проход 2: блит ВСЕХ видимых, требующих обновления. Спрайты из
|
|
* W0-атласов (s->page): подключить страницу перед блитом — один OUT
|
|
* на СМЕНУ страницы (спрайты одного атласа подряд = один OUT);
|
|
* порядок «_gfx_w0_cur, затем OUT» закрывает гонку с ISR-стабом
|
|
* (он восстановит уже новую). heal-проходу страница не нужна
|
|
* (img не читается). */
|
|
gfx_set_bank(GFX_BANK_SPRITE);
|
|
_bgi_begin();
|
|
{
|
|
uint8_t mapped = 0; /* 0 = W0 не тронута (там ядро DSS) */
|
|
|
|
for (i = 0, s = arr; i < count; i++, s++) {
|
|
if (s->flags & (dbit | SPR_ALWAYS)) {
|
|
if (s->flags & SPR_VISIBLE) {
|
|
if (s->page != mapped && s->page) {
|
|
_gfx_w0_cur = s->page;
|
|
_io_page_w0 = s->page;
|
|
mapped = s->page;
|
|
}
|
|
(*_gfx_blit_fn)(s->x, s->y, s->img, s->sx, s->sy, s->w, s->h);
|
|
s->drawn[p].x = s->x;
|
|
s->drawn[p].y = s->y;
|
|
s->drawn[p].on = 1;
|
|
}
|
|
s->flags &= ~dbit; /* страница p обновлена для спрайта */
|
|
}
|
|
}
|
|
if (mapped)
|
|
_io_page_w0 = _gfx_w0_dss; /* вернуть ядро DSS */
|
|
}
|
|
_bgi_end();
|
|
|
|
gfx_set_bank(saved);
|
|
}
|