libbgi: funcptr-диспетч clip/noclip спрайтовых ядер + снятие src[0]-фикса

Диспетчеризация clip/noclip через указатели _gfx_blit_fn/_gfx_heal_fn
(common/_gfx_sprite_fns.c, дефолт clip): gfx_sprite_clip() — теперь
модуль, переключает указатели один раз; sprite_update/putsprite/
movesprite зовут через указатель — ветка if(clip) из горячего цикла
убрана (съедала половину выигрыша noclip). Программа без вызова
gfx_sprite_clip() noclip-ядра не линкует.

Замер dev-MAME (16 шаров, uncapped): clip 50 → noclip 60-61 fps
(+20-22%). Регресс tests/sprites (A/B PASS), size-check OK
(balls −237 Б, sprites −3177 Б — отвязались лишние ядра).

Фикс CPU-байта write-триггера (preread + EX AF,AF') снят: точная
dev-MAME эмулирует ПЛМ, подавляющую CPU-байт при активном burst'е —
подтверждено по байтам VRAM (tests/blitw col0 = GREEN через
read_vram MCP-моста). Для heal фикс был избыточен всегда (банк 0x50
перезаписывает dst[0]). Строки фикса оставлены закомментированными
в трёх leaf'ах на случай отличий реального железа; шапки и §9а/§9б
дизайна обновлены. НА ЖЕЛЕЗЕ ПЕРЕПРОВЕРИТЬ.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/sprite-api-design.md

@@ -562,13 +562,44 @@ for (;;) {
 невидима (burst перезаписывает dst[0] правильным src[0]), но при
 0x58/0x5C, если src[0] == 0xFF, перезапись скипается — на экране
 вертикальная полоса цвета последних байтов строк (симптом: клипнутые
-спрайты в tests/sprites).  Нейтрализовано в `_bgi_copy_rows_raw`:
-src[0] предчитывается до армирования и подставляется в A через
-EX AF,AF' перед триггером — CPU-байт становится src[0], корректным при
-любом банке и любой семантике первого цикла.  Регресс: tests/blitw
-(визуальная секция «trig leak»).  Подтверждено в MAME 0.283; на железе
-проверить вместе с остальным (полоса цвета — маркер, что железо делает
-так же; чистый col0 — что CPU-цикл триггера подавляется ПЛМ).
+спрайты в tests/sprites).  Было нейтрализовано в `_bgi_copy_rows_raw`:
+src[0] предчитывался до армирования и подставлялся в A через EX AF,AF'
+перед триггером.
+
+**ФИКС СНЯТ 2026-07-13.** Точная dev-MAME (сборка разработчиков
+Sprinter, `mame/sources/MAME`) эмулирует ПЛМ, подавляющую CPU-байт
+триггера при активном burst'е — квирк был артефактом стоковой MAME
+0.283.  Проверено pixel-точно: tests/blitw, col0 @(200,150) = 0x02
+GREEN по байтам VRAM (read_vram через MCP-мост).  Для heal фикс был
+избыточен всегда (банк 0x50 перезаписывает dst[0]).  Строки фикса
+оставлены закомментированными в трёх leaf'ах (_bgi_copy_rows_raw,
+_bgi_blit_rows_raw, _bgi_heal_rows_raw) — восстановить, если реальное
+железо поведёт себя как MAME 0.283 (маркер: вертикальная полоса цвета
+последних байтов строк на клипнутых/прозрачных спрайтах).  Регресс:
+tests/blitw (визуальная секция «trig leak»).  НА ЖЕЛЕЗЕ ПЕРЕПРОВЕРИТЬ.
+
+## 9б. Клип спрайтов: noclip-ядра + funcptr-диспетч (2026-07-12/13)
+
+Клип в спрайтовых ядрах стоит не только сравнений (~0.85 мс/кадр на 16
+шаров), но и codegen-эффекта: клип-код раздувает регистровое давление
+всей функции (спиллы) — поэтому рантайм-скип внутри общего ядра
+возвращает лишь малую часть.  Полный выигрыш даёт ФИЗИЧЕСКИ отдельная
+функция без клип-кода: `_gfx_blit_sprite_noclip` / `_gfx_heal_sprite_noclip`.
+
+Выбор ядра — НЕ веткой в горячем цикле (ветка `if (clip)` в
+sprite_update съедала половину выигрыша: 52 вместо 57 fps на старой
+MAME), а перенаправлением указателей `_gfx_blit_fn`/`_gfx_heal_fn`
+(common/_gfx_sprite_fns.c, дефолт — clip-ядра) один раз в
+`gfx_sprite_clip()`; sprite_update/putsprite/movesprite зовут через
+указатель.  Программа без вызова `gfx_sprite_clip()` не линкует
+noclip-ядра (на них ссылается только модуль gfx_sprite_clip.c).
+
+Замер на точной dev-MAME (16 шаров, uncapped, A/B 2026-07-13):
+clip 50 fps → noclip-funcptr 60-61 fps (**+20-22%**) — полный выигрыш
+noclip доехал до приложения.  С vsync-капом оба варианта упираются в
+~48-50 (кадр < 20 мс) — выигрыш конвертируется в запас кадра.
+ВНИМАНИЕ: noclip требует гарантии приложения, что спрайты целиком на
+экране — выход за край портит соседнюю память (tests/spriteclip).
 
 ## 10. Риски / что проверить артефактом (Фаза 0)