Ресурсы — в архивы 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>
This commit is contained in:
2026-08-25 21:29:14 +03:00
parent d86adc54c4
commit 65797af44c
40 changed files with 997 additions and 244 deletions
+57
View File
@@ -0,0 +1,57 @@
/*
* atlas_attach — принять .atl, УЖЕ прочитанный в EMM-страницу.
*
* Вторая половина atlas_load, отделённая ради архивов ресурсов: кто читает
* атлас не из отдельного файла, а куском общего архива (PoP: pop_arc.c,
* формат PBA1), делает своё чтение сам, а проверку магии, gfx_w0_page_prepare
* и разбор заголовка отдаёт сюда — иначе эти двадцать строк пришлось бы
* повторять в каждом приложении.
*
* n — сколько байт реально прочитано (или -1, если чтение не удалось).
* При любой ошибке блок ОСВОБОЖДАЕТСЯ: вызывающему остаётся только
* вернуть -1, и «полузагруженных» атласов не бывает.
*
* Ошибки: EREAD — короткое чтение, EINVAL — не .atl.
*/
#include <errno.h>
#include <sprinter_mem.h>
#include <sprite.h>
#include "../_bgi.h"
int atlas_attach(atlas_t *a, uint8_t blk, uint8_t page, int n)
{
uint8_t ok, count, h[5];
a->blk = blk;
a->page = page;
if (n < (int)sizeof(h)) {
mem_free_block(blk);
a->page = 0;
if (n >= 0) errno = EREAD;
return -1;
}
bank_read(page, 0, h, sizeof(h));
ok = (n >= (int)_ATL_DATA_OFF &&
h[0] == 'S' && h[1] == 'P' && h[2] == 'A' && h[3] == '1');
count = 0;
if (ok) {
count = h[4];
gfx_w0_page_prepare(page);
}
/* Восстановить W3 ДО записи в *a: если atlas_t лежит в банковской
* памяти (её адрес тоже резолвится через W3), запись при ещё
* замапленной странице атласа ушла бы не в тот физический банк
* (найдено 2026-07-15 — PoP room.c держит tile_atlas[] в --bank 1,
* a->count оставался мусором, room_draw читал пиксели не с того
* оффсета). a->blk/a->page выше пишутся ДО ремапа — их это не
* касалось, только a->count. */
if (!ok) {
mem_free_block(blk);
a->page = 0;
errno = EINVAL;
return -1;
}
a->count = count;
return 0;
}
+12 -42
View File
@@ -2,62 +2,32 @@
* atlas_load — загрузить .atl-файл в свежую EMM-страницу (§3.1/§9в
* дизайна, вариант II: файл-офсет == офсет страницы == W0-адрес).
*
* Порядок: выделить страницу → bank_load_file() → проверить магию 'SPA1'
* gfx_w0_page_prepare(). Никакого пересчёта офсетов: каталог и ленты
* уже лежат по своим W0-адресам.
* Порядок: выделить страницу → bank_load_file() → atlas_attach (магия
* 'SPA1' + gfx_w0_page_prepare). Никакого пересчёта офсетов: каталог и
* ленты уже лежат по своим W0-адресам.
*
* Кто держит атласы в АРХИВЕ, а не отдельными файлами, повторяет ту же
* пару вызовов со своим чтением: mem_alloc_pages + своё чтение в страницу
* + atlas_attach.
*
* Вызывать ВНЕ рендера (W3 на время загрузки занята страницей атласа).
* Ошибки: -1 + errno (open/read/alloc; EINVAL — не .atl).
*/
#include <errno.h>
#include <sprinter_mem.h>
#include <sprite.h>
#include "../_bgi.h"
int atlas_load(atlas_t *a, const char *path)
{
uint8_t blk, ok, count, h[5];
uint8_t blk, page;
int n;
blk = mem_alloc_pages(1);
if (!blk) return -1;
page = mem_get_page(blk, 0);
a->blk = blk;
a->page = mem_get_page(blk, 0);
n = bank_load_file(a->page, 0, path, 16384);
/* Не затирать errno от open/read: вызывающему важно отличить отсутствие
* файла или короткое чтение от файла, который действительно не .atl.
* Раньше оба случая проваливались в EINVAL ниже, что маскировало
* фактическую причину сбоя загрузки экранных полос. */
if (n < (int)sizeof(h)) {
mem_free_block(blk);
a->page = 0;
if (n >= 0) errno = EREAD;
return -1;
}
bank_read(a->page, 0, h, sizeof(h));
ok = (n >= (int)_ATL_DATA_OFF &&
h[0] == 'S' && h[1] == 'P' && h[2] == 'A' && h[3] == '1');
count = 0;
if (ok) {
count = h[4];
gfx_w0_page_prepare(a->page);
}
/* Восстановить W3 ДО записи в *a: если atlas_t лежит в банковской
* памяти (её адрес тоже резолвится через W3), запись при ещё
* замапленной странице атласа ушла бы не в тот физический банк
* (найдено 2026-07-15 — PoP room.c держит tile_atlas[] в --bank 1,
* a->count оставался мусором, room_draw читал пиксели не с того
* оффсета). a->blk/a->page выше пишутся ДО ремапа — их это не
* касалось, только a->count. */
if (!ok) {
mem_free_block(blk);
a->page = 0;
errno = EINVAL;
return -1;
}
a->count = count;
return 0;
* файла или короткое чтение от файла, который действительно не .atl. */
n = bank_load_file(page, 0, path, 16384);
return atlas_attach(a, blk, page, n);
}
+6
View File
@@ -290,6 +290,12 @@ typedef struct {
* 0 — OK; -1 + errno (файл/память/формат). */
int atlas_load(atlas_t *a, const char *path);
/* Принять .atl, уже прочитанный в страницу СВОИМИ силами — например, куском
* общего архива ресурсов. n — сколько байт прочитано (-1, если не вышло).
* Проверяет магию, готовит страницу к маппингу в W0 и заполняет *a; при
* любой ошибке освобождает блок сам. 0 — OK; -1 + errno. */
int atlas_attach(atlas_t *a, uint8_t blk, uint8_t page, int n);
/* Подготовить уже выделенную EMM-страницу для безопасного маппинга в W0:
* установить IRQ/NMI-стабы и запомнить штатную страницу DSS. */
void gfx_w0_page_prepare(uint8_t page);