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>

libbgi/include/graphics.h

@@ -194,9 +194,30 @@ unsigned imagesize(int left, int top, int right, int bottom);
 void getimage(int left, int top, int right, int bottom, void *bitmap);
 
 /* Вывести образ левым-верхним углом в (left,top) операцией op
- * (COPY/XOR/OR/AND/NOT_PUT). */
+ * (COPY/XOR/OR/AND/NOT_PUT).  COPY_PUT — через акселератор, с
+ * клиппингом по экрану и текущим банком gfx_set_bank (см. <gfx.h>);
+ * XOR/OR/AND/NOT — по-пиксельно, без клиппинга. */
 void putimage(int left, int top, const void *bitmap, int op);
 
+/* ---- Спрайты (аппаратная прозрачность; docs/sprite-api-design.md) - *
+ * Спрайт — тот же буфер getimage-формата; прозрачные точки в данных =
+ * байты 0xFF (GFX_TRANSPARENT).  Прозрачность и сохранность фона
+ * обеспечивает железо (банк GFX_BANK_SPRITE = 0x5C): прозрачные байты
+ * не записываются, ОЗУ-копия фона не трогается — стирание без
+ * save-буфера через gfx_heal (см. <gfx.h>).
+ * ВАЖНО: фон/сцену рисовать ОБЫЧНЫМ банком (0x50) — то, что нарисовано
+ * при активном бите 2 (0x54/0x5C), в ОЗУ-копию не попадает и heal
+ * вернёт то, что лежало под ним. */
+
+/* Вывести спрайт в (x,y): банк на время вызова — GFX_BANK_SPRITE,
+ * затем прежний.  Клиппится по экрану. */
+void putsprite(int x, int y, const void *img);
+
+/* Переместить спрайт: восстановить фон под (oldx,oldy) (gfx_heal по
+ * размерам img) и вывести спрайт в (x,y).  Перекрытие старой и новой
+ * позиций безопасно (heal читает фон из ОЗУ-копии). */
+void movesprite(int oldx, int oldy, int x, int y, const void *img);
+
 /* ---- Текст ------------------------------------------------------- *
  * Шрифт 8×8 (системный).  Рисуется текущим цветом на фоновом. */