libbgi: спрайтовый движок v2 + accel-блит/heal leaf'ы + noclip-путь

Спрайтовая графика поверх accel block-copy (docs/sprite-api-design.md):

- Ядро блиттинга: leaf'ы _bgi_blit_rows_raw (dst фикс, только src-страйд) /
  _bgi_copy_rows_raw (getimage) / _bgi_heal_rows_raw (src==dst). DI один на
  спрайт (санкция: малый спрайт под одним DI аудио не рвёт); src[0]-фикс
  снят (точная MAME подавляет CPU-байт триггера записи — на железе
  перепроверить; для heal был избыточен и снят безусловно).
- Общие bracket-free ядра _gfx_blit_full/_gfx_heal_full (полная ширина:
  клип по экрану + split >256 для putimage) + лин _gfx_blit_sprite/
  _gfx_heal_sprite (кадр ≤64, без split, 8-бит w/h) + noclip-варианты
  (клип-кода нет → полный codegen-win).  Имя *_full (не *_clip) — «clip»
  двусмысленно (sprite-ядра тоже клипуют; различитель — ширина/split).
- Движок retained-модели <sprite.h>: sprite_init/update/flip + inline
  move/frame/show/hide/touch; drawn[2] per-page внутри структуры; кадр —
  двухпроходно heal ВСЕ -> блит ВСЕ под одной W3-скобкой/банком на проход.
- Флаг gfx_sprite_clip(on/off): приложение, само следящее за границами,
  отключает клип (~+19% на анимации; диспетч пока через if — funcptr далее).
- putsprite/movesprite/gfx_blit/putimage(COPY)/getimage переведены на ядро.

Тесты: examples/balls (движок, дабл-буфер, boundary-тест клипа),
tests/sprites (RAM PASS, клип 4 края, атлас), tests/blitw (trig-leak),
tests/spriteclip (hardware-probe: железо НЕ режет за краем -> клип нужен),
tests/blitperf, tests/gfxbanks. size-baseline обновлён (53 программы).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-12 21:47:37 +03:00
parent 78161561e7
commit 72ce66275e
42 changed files with 2835 additions and 32 deletions
+36
View File
@@ -0,0 +1,36 @@
/*
* _gfx_heal_full — bracket-free ядро heal прямоугольника экрана из
* ОЗУ-копии (см. gfx_heal). Клип по экрану + нарезка на полосы ≤256 +
* вызов accel-leaf'а _bgi_heal_rows_raw (src == dst, strides 0). БЕЗ
* _bgi_begin/_bgi_end и БЕЗ смены банка — вызывающий обязан замапить W3
* и выставить банк GFX_BANK_NORMAL (0x50) ДО вызова.
*
* Вынесено из gfx_heal (2026-07-12) ради batch-пасса движка v2:
* sprite_update лечит ВСЕ старые позиции под одной W3-скобкой и одним
* банком 0x50 (docs/sprite-api-design.md §9.1). gfx_heal теперь =
* save-банк + set 0x50 + _bgi_begin + это ядро + _bgi_end + restore.
*
* Clip fast-path: целиком на экране → 4 сравнения вместо полного пути.
*/
#include "../_bgi.h"
void _gfx_heal_full(int x, int y, int w, int h)
{
uint8_t *scr;
if (x < 0 || y < 0 || x + w > _bgi_maxx + 1 || y + h > _bgi_maxy + 1) {
if (x < 0) { w += x; x = 0; }
if (y < 0) { h += y; y = 0; }
if (x + w > _bgi_maxx + 1) w = _bgi_maxx + 1 - x;
if (y + h > _bgi_maxy + 1) h = _bgi_maxy + 1 - y;
if (w <= 0 || h <= 0) return;
}
scr = (uint8_t *)(_gfx_addr_base + x);
while (w > 256) {
_bgi_heal_rows_raw(scr, y, 0 /* =256 */, (uint8_t)h);
scr += 256;
w -= 256;
}
_bgi_heal_rows_raw(scr, y, (uint8_t)w, (uint8_t)h);
}