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/common/getimage.c

@@ -1,27 +1,51 @@
 /*
  * getimage — сохранить прямоугольник экрана в буфер bitmap.
  * Формат: uint16 width, uint16 height, затем w*h байт (по строкам).
- * Чтение raw в одной W3-скобке.
+ *
+ * Через accel-ядро: _bgi_copy_rows_raw строками экран→буфер (Фаза A
+ * спрайтового дизайна).  Чтение экрана возвращает ОЗУ-копию (видео-ОЗУ
+ * write-only) — после рисования в temp-банке (0x54/0x5C) getimage
+ * вернёт ФОН, а не то, что на экране (это и есть механизм heal).
+ *
+ * Клиппинга нет (контракт BGI: rect валиден); safe-версия отсекает
+ * выход за экран целиком.  Буфер bitmap обязан лежать вне W3
+ * (< 0xC000) — на время операции W3 замаплен на видеобанк.
  */
 #include "../_bgi.h"
 
 void getimage(int left, int top, int right, int bottom, void *bitmap)
 {
     uint8_t *p = (uint8_t *)bitmap;
+    const uint8_t *src;
     int w = right - left + 1;
     int h = bottom - top + 1;
-    int x, y;
+    int rem;
 
     if (w <= 0 || h <= 0) return;
+#ifndef GFX_NOCHECK
+    if (left < 0 || top < 0 || right > _bgi_maxx || bottom > _bgi_maxy)
+        return;
+#endif
 
     *p++ = (uint8_t)w;
     *p++ = (uint8_t)(w >> 8);
     *p++ = (uint8_t)h;
     *p++ = (uint8_t)(h >> 8);
 
+    /* Полосы <= 256 байт (лимит блока акселератора); шаг строки
+     * буфера — полная ширина w у ОБЕИХ полос (полосы одной строки
+     * лежат в буфере подряд). */
+    src = (const uint8_t *)(_gfx_addr_base + left);
+    rem = w;
     _bgi_begin();
-    for (y = 0; y < h; y++)
-        for (x = 0; x < w; x++)
-            *p++ = (uint8_t)_bgi_read_raw(left + x, top + y);
+    while (rem > 256) {
+        _bgi_copy_rows_raw(src, p, 0 /* =256 */, (uint8_t)h,
+                           w, 0, (uint8_t)top);
+        src += 256;
+        p   += 256;
+        rem -= 256;
+    }
+    _bgi_copy_rows_raw(src, p, (uint8_t)rem, (uint8_t)h,
+                       w, 0, (uint8_t)top);
     _bgi_end();
 }