snark13
eb9ca0179d
Реализация §9г по требованиям пользователя: - sprite_anim(first,last,speed,mode): ANIM_LOOP / ANIM_PINGPONG / ANIM_ONCE (one-shot замирает на last), | ANIM_HORIZ для горизонтальных лент. Смена кадра в тике = ±an_step к оси ленты — без умножений (осевое смещение first считается в setup циклом). - sprite_moveto(tx,ty,max_step,interval): Брезенхэм порциями ≤max_step вдоль большей оси (меньшая — err-аккумулятором, нелинейные шаги Y сами собой), деления нет. - Одновременность кадровой и tween — независимые поля/биты. - Статус: sprite_anim_status() — битовое поле SPR_ANIM_ON/DONE + SPR_MOVE_ON/DONE; sprite_anim_frame() — текущий индекс кадра; sprite_moving(). - Стопы: sprite_anim_stop(frame | -1 = текущий); sprite_move_stop(0 = замереть / 1 = прыжок в цель + DONE). - Тикер _sprite_tick — проход 0 sprite_update через funcptr _spr_tick_fn (DCE: без sprite_anim/moveto код не линкуется, цена — один if на кадр; +40 Б программе с движком, sprite_t +18 Б). tests/spranim (MAME dev, все PASS): LOOP/PINGPONG (разворот на границе без удвоения краёв)/ONCE+DONE; пример (0,0)→(100,50), шаг 5, интервал 4 → ровно 80 кадров, Y идёт 3/2/3/2; стопы обоих видов. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
89 lines
4.5 KiB
C
89 lines
4.5 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;
|
|
|
|
/* Проход 0: тик авто-анимаций (§9г) — ДО heal/блита (двигает x/y и
|
|
* ось кадра, взводя dirty). Указатель ставят sprite_anim/
|
|
* sprite_moveto; без них — один if на кадр, код тикера не линкуется. */
|
|
if (_spr_tick_fn)
|
|
(*_spr_tick_fn)(arr, count);
|
|
|
|
/* Проход 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);
|
|
}
|