Ресурсы — в архивы PBA1; тайминги сцены PV — по часам насоса CBL

ТАЙМИНГИ.  Пользователь заметил, что заклинание Джафара не совпадает с
музыкой. Замер в MAME (breakpoint на вспышке + курсор трека): реплика m53
успевала ДОИГРАТЬ до молнии, хотя по шкале оригинала между входом Джафара
и заклинанием ровно 822 тика = 13,7 с.

Причина: пейсинг считал НАШИ ожидания vsync, а не прошедшее время.
Полноэкранная копия страницы стоит больше кадра луча, и разница копилась.
Кадровые прерывания для счёта не годятся (теряются в di-окнах
акселератора), поэтому часами стал насос CBL: он идёт от расхода буфера
железом, 85,4 Гц, и ему безразлично, чем занят главный цикл. Один тик
оригинала = 57/40 тика насоса (0,07 % ошибки, без деления в кадре).
Когда звук выключен, работает прежний путь по кадрам луча.

После фикса замер даёт 229 блоков остатка m53 против расчётных 233 —
расхождение 47 мс.

АРХИВЫ.  Группы ресурсов сложены в PBA1: kid (58 атласов), pv (78),
shadow (32), bg (25), title (20), guard (10), vizier (5), skel (4). Было
232 файла на образе, стало 8 архивов плюс шесть палитр и таблицы уровней.
При цене `open` 51,4 мс против 32,6 мс за чтение 16 КБ это возвращает
секунды на каждой загрузке.

- pop_pack_arc.py печатает индексы элементов константами (ARC_<GRP>_<FILE>),
  порядок задаёт Makefile, а серии код проверяет статически;
- atlas_load разделён: atlas_attach принимает уже прочитанную страницу,
  поэтому чтение из архива не дублирует проверку магии и подготовку W0;
- имена архивов живут в pop_arc.c и адресуются номером. Строковый литерал
  лежит в rodata своего банка, и указатель на него из другого банка после
  переключения W3 показывает на чужие данные — ровно так падала загрузка
  фона (поймано брейкпоинтом на puts).

Проверено в MAME: заставка, интро и уровень 1 собираются из архивов,
Тень грузит все 32 страницы. Host-тесты: 15 наборов.

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

applications/PoP/roomtest/pop_arc.h

@@ -26,17 +26,43 @@
 #define POP_ARC_H
 
 #include <stdint.h>
+#include <sprite.h>   /* atlas_t */
 
 #define POP_ARC_HEADER   512
 #define POP_ARC_SECTOR   512
 #define POP_ARC_MAX      126     /* (512-8)/4 */
 #define POP_ARC_REC      4       /* байт на запись таблицы */
 
-typedef struct {
+/* Имя у структуры есть намеренно: так на неё можно сослаться из заголовков,
+ * которым незачем тянуть весь pop_arc.h (pop_ui.h). */
+typedef struct pop_arc_s {
     int     fd;
     uint8_t count;
 } pop_arc_t;
 
+/* ИМЕНА АРХИВОВ ЗНАЕТ САМ МОДУЛЬ, и это не вкусовщина: строковый литерал
+ * лежит в rodata СВОЕГО банка, а pop_arc.c живёт в банке 8.  Указатель на
+ * литерал из другого банка после переключения W3 показывает на чужие
+ * данные — ровно так «BG\bg.arc» превращался в мусор и загрузка фона
+ * падала (поймано 2026-08-26).  Поэтому наружу отдаём НОМЕР архива. */
+typedef enum {
+    POP_ARC_BG = 0,
+    POP_ARC_KID,
+    POP_ARC_GUARD,
+    POP_ARC_SKEL,
+    POP_ARC_VIZIER,
+    POP_ARC_SHADOW,
+    POP_ARC_TITLE,
+    POP_ARC_PV,
+    POP_ARC_SND,
+    POP_ARC_IDS
+} pop_arc_id_t;
+
+/* Открыть архив по номеру: то же, что pop_arc_open, но имя берётся из
+ * таблицы внутри модуля. */
+int8_t pop_arc_open_id(pop_arc_t *a, uint8_t id,
+                       uint8_t *tbl, uint8_t tbl_max) __banked;
+
 /* Открыть архив и вычитать таблицу в буфер вызывающего (count*4 байт).
  * tbl_max — сколько записей помещается в буфер.
  * Возврат: число записей; -1 — не открылся, не PBA1 либо таблица не влезла. */
@@ -54,4 +80,11 @@ int pop_arc_read(pop_arc_t *a, const uint8_t *tbl, uint8_t idx, uint16_t skip,
 
 void pop_arc_close(pop_arc_t *a) __banked;
 
+/* Атлас ПРЯМО ИЗ АРХИВА: выделить страницу, вычитать в неё элемент idx и
+ * отдать libbgi (atlas_attach — проверка магии + подготовка страницы к
+ * маппингу в W0).  Полный эквивалент atlas_load, только источник другой.
+ * 0 — OK, -1 — ошибка (страница освобождена). */
+int8_t pop_arc_atlas(pop_arc_t *a, const uint8_t *tbl, uint8_t idx,
+                     atlas_t *at) __banked;
+
 #endif /* POP_ARC_H */