libbgi: спрайты — кэш адреса кадра, DDA+asm тик, Y-сортировка со слоями

Оптимизации A+B (профиль rpgwalk-15: активная часть кадра 410К → 307К
тактов из 430080; лимит спрайтов 16×16 на стабильные 48.8 fps: 14 → ~21):

- (B) sprite_t.src/stride — готовый адрес кадра: считают только
  sprite_frame (теперь функция, одно умножение на СМЕНУ кадра) и тикер
  (±an_step БАЙТ инкрементально); блит-ядра принимают src+stride,
  img/sx/sy из сигнатуры ушли.  Блит 177К → 146К на кадр.
- (A) тик 100К → 37.7К: tween переформулирован Брезенхэм → беззнаковый
  DDA (mv_rem/mv_acc, «приехали» = rem==0 — без знаковых 16-бит
  сравнений), tick_move и tick_anim — ручной asm (SDCC спиллит такие
  функции в IX-фрейм ~100 обращений; C-реструктуризации не помогали —
  проверено кодогеном).  Биты an_flags переименованы по категориям
  (_SPR_STRIP_HORZ, _SPR_PP_BACK).

Y-сортировка (gfx_sprite_ysort, идеи пользователя — 8-бит ключ,
персистентность):

- painter's algorithm по ключу {layer:8, clamp_y:8}; поле
  sprite_t.layer (в КОНЦЕ структуры — asm-офсеты не сдвигает): слои
  сцены в одном массиве/одном sprite_update;
- ПЕРСИСТЕНТНАЯ asm-таблица {key16, ptr16}: resort порядка прошлого
  кадра (почти линейно), rebuild при смене arr/count; массив
  приложения не трогается; ~28К/15 спрайтов (с нуля было 44К);
- компоненты YSORT_Y/YSORT_LAYER отключаемы независимо масками ключа
  (без ветвлений в сортировщике); ВНИМАНИЕ: mode=1 значит Y-only,
  полный порядок = YSORT_Y|YSORT_LAYER;
- funcptr-DCE: выключено = код и таблица не линкуются (rpgwalk −190 Б);
- ПРАВИЛО в sprite.h: два sprite_update на страницу запрещены (heal
  второй группы стирает спрайты первой — ОЗУ-копия чистая).

Попутные фиксы:

- libbgi/Makefile: .rel зависят от заголовков (HDRS) — stale .rel со
  старой раскладкой sprite_t молча ломал рантайм;
- rpgprof: --memory small (перерос tiny: BSS вылезал за W2 → мгновенный
  «Unexpected application termination»; mkexe это пока не ловит);
- tests/spranim: проверки переведены на кэш src, добавлены T6 (reframe
  после тикера) и T7 (Y-сортировка: порядок, слои, персистентный
  resort, LAYER-only) — 7/7 PASS в MAME.

Доки: §9д — новый бюджет (19.5К/спрайт), §9е — ПЛАН FPS-делителя
(frame pacing, gfx_set_fps_div); TODO — дизайн цепочки irq-обработчиков.

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

libbgi/common/_gfx_blit_sprite.c

@@ -6,66 +6,34 @@
  * и смены банка — вызывающий (sprite_update/putsprite) держит скобку и
  * банк 0x5C.  Проверок размера НЕТ (контракт ≤64 — в доке, не в коде).
  *
+ * src — ГОТОВЫЙ адрес первого пикселя кадра, stride — шаг строки
+ * источника (полная ширина img/ленты); считает вызывающий один раз
+ * (кэш sprite_t.src/stride; putsprite — из заголовка).  Заголовок
+ * getimage и (sx,sy) ядру больше не передаются (2026-07-14) — весь
+ * пересчёт адреса кадра ушёл в редкие точки его смены (sprite_frame,
+ * тикер анимации инкрементально).
+ *
  * Клип по ЭКРАНУ остаётся (это функциональность — спрайты штатно уходят
- * за края): fast-path «целиком на экране» = 4 сравнения.
- *
- * ФОРМАТ getimage и параметры атласа
- * ----------------------------------
- * img указывает на getimage-буфер: 4-байтовый заголовок + пиксели.
- * Заголовок = uint16 width, uint16 height (little-endian):
- *   p[0]=width lo, p[1]=width hi, p[2]=height lo, p[3]=height hi.
- * Дальше (p+4) — пиксели ПОСТРОЧНО, по width байт на строку.
- *
- *   int img_w = p[0] | (p[1] << 8);
- * — это ПОЛНАЯ ширина картинки/ленты-атласа (склейка двух байтов
- * заголовка в 16-бит).  Используется как ШАГ между строками источника
- * (sstride): чтобы спуститься на строку ниже в буфере, надо прибавить к
- * адресу целую ширину картинки.  Для одиночного спрайта img_w == ширине
- * кадра; для ЛЕНТЫ-АТЛАСА (много кадров в ряд) img_w — ширина всей ленты
- * (> ширины кадра w), поэтому img_w остаётся int (лента может быть шире
- * 64, хотя КАДР ≤ 64).
- *
- *   (sx, sy) — смещение КАДРА (под-прямоугольника) ВНУТРИ картинки:
- * левый-верхний угол вырезаемого кадра в пикселях.  Для целого спрайта
- * sx = sy = 0.  Для кадра N горизонтальной ленты: sx = N*FRAME_W, sy = 0
- * (вертикальные атласы — sy).  Отсюда адрес первого пикселя кадра:
- *   src = p + 4  (пропустить заголовок)
- *       + sx     (сместиться на sx пикселей вправо в первой строке)
- *       + sy*img_w  (спуститься на sy строк — цикл сложений ниже, без
- *                    умножения: обычно sy == 0).
+ * за края): fast-path «целиком на экране» = 4 сравнения; при выходе
+ * корректируются края И src (левый — src += -x; верхний — src +=
+ * (-y)*stride, одно 16-бит умножение ТОЛЬКО на реально клипнутом
+ * кадре — редкость рядом с кадровым циклом).
  */
 #include "../_bgi.h"
 
-void _gfx_blit_sprite(int x, int y, const void *img,
-                      int sx, int sy, uint8_t w, uint8_t h)
+void _gfx_blit_sprite(int x, int y, const uint8_t *src,
+                      uint16_t stride, uint8_t w, uint8_t h)
 {
-    const uint8_t *p = (const uint8_t *)img;
-    const uint8_t *src;
-    uint16_t dst;
-    int img_w = p[0] | (p[1] << 8);   /* ширина картинки/ленты = sstride */
     int cw = w, ch = h;               /* рабочие w,h кадра (для клипа) */
 
     if (x < 0 || y < 0 || x + cw > _bgi_maxx + 1 || y + ch > _bgi_maxy + 1) {
-        if (x < 0) { sx -= x; cw += x; x = 0; }
-        if (y < 0) { sy -= y; ch += y; y = 0; }
+        if (x < 0) { src += -x; cw += x; x = 0; }
+        if (y < 0) { src += (uint16_t)(-y) * stride; ch += y; y = 0; }
         if (x + cw > _bgi_maxx + 1) cw = _bgi_maxx + 1 - x;
         if (y + ch > _bgi_maxy + 1) ch = _bgi_maxy + 1 - y;
         if (cw <= 0 || ch <= 0) return;
     }
 
-
-    /* Адрес первого пикселя кадра: заголовок(4) + sx вправо + sy строк
-     * вниз.  sy*img_w умножением (__mulint, O(1) ~300Т): вертикальные
-     * ленты атласов сделали sy != 0 нормой — цикл сложений был O(sy),
-     * до ~64К тактов на блит кадра 11 (профиль rpgwalk 2026-07-13).
-     * if (sy): горизонтальные ленты/одиночные спрайты не платят и за
-     * умножение. */
-    src = p + 4 + sx;
-    if (sy)
-        src += (uint16_t)sy * (uint16_t)img_w;
-
-    dst = _gfx_addr_base + x;
-
-    _bgi_blit_rows_raw(src, (uint8_t *)dst, (uint8_t)cw, (uint8_t)ch,
-                       img_w, (uint8_t)y);
+    _bgi_blit_rows_raw(src, (uint8_t *)(_gfx_addr_base + x),
+                       (uint8_t)cw, (uint8_t)ch, (int)stride, (uint8_t)y);
 }