SprPoP: автономное приложение, выделенное из roomtest

Порт PoP переехал в applications/SprPoP — приложение, которое собирается
само: код, оригинальные данные, конверторы ресурсов и сборка внутри одной
папки.  Наружу знает единственный путь — корень тулчейна (SPRINTER_ROOT,
по умолчанию ../..).  applications/PoP/roomtest ЗАМОРОЖЕНА и остаётся
архивом закрытых задач, багов и исполненных планов.

Скопировано из applications/PoP/roomtest@4b74478.  Перенос проверен
побайтово: собранный sprpop.exe совпал с roomtest.exe того же коммита,
все 39 дисковых ресурсов и все 16 генерируемых заголовков — тоже, host-
тесты зелёные (15/15).

Раскладка:
  src/           рукописный C (roomtest.c -> sprpop.c)
  gen/           генерируемые заголовки, в репозитории
  assets/orig/   оригинальные данные игры, вне репозитория (копирайт)
  assets/packed/ то, что ложится на диск, в раскладке диска
  tools/         конверторы; все пути — в одном tools/paths.py
  build/         выход: exe, каталоги ресурсов, hdd/, промежуточные atl/

Сборка ресурсов: assets/packed и gen — версионируемые ВХОДЫ, а не то, что
пересчитывается каждым make.  Автоматика построена на ОТСУТСТВИИ файла, а
не на таймстемпах: git не хранит времена, и в свежем клоне сравнение по
времени превращалось бы в лотерею.  Недостающий ресурс или заголовок
чинится сам, рекурсивным вызовом в ветку генерации.

Музыка собирается из любого из четырёх наборов записей (make music-mp3,
music-mt32, ...); набор входит в имя stamp'а, поэтому смена набора сама
делает музыку устаревшей.  Длины реплик больше не захардкожены: упаковщик
печатает их в gen/pop_music_ticks.h, и шкала сцены выражена через них —
иначе mt32 (реплики на 6% длиннее) молча ломал катсцену.

Тулчейн: в app.mk два обратносовместимых крючка (SRC_DIR/BUILD_DIR),
HDD_IMG стал ?=; команда сборки roomtest не изменилась.  Корневой
make host-tests переключён на SprPoP.

Подгонка тайминга катсцены с принцессой (PV_MAGIC_LEAD): сцена
render-bound и идёт ~49 тиков/с вместо 60, из-за чего кода реплики
приходила раньше молнии.  Это обход, а не лечение; разбор с замерами —
docs/BUGS_OPEN.md, записи SND-PACE-DEAD, PV-RENDER-BOUND, MUS-LEFT-TEAR.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-27 12:12:28 +03:00
parent 4b74478d19
commit 31b82661eb
235 changed files with 51293 additions and 10 deletions
+78
View File
@@ -0,0 +1,78 @@
/*
* pop_timer.c — единый владелец глобального таймера (FG4, банк 9).
*
* SDLPoP хранит rem_min/rem_tick и уменьшает rem_tick на каждом логическом
* игровом кадре. Здесь та же схема: после нуля tick возвращается к 719,
* поэтому 720 тиков образуют минуту. Настройки, экранные сообщения и
* переход TIME_EXPIRED остаются снаружи: это делает ядро таймера чистым и
* не привязывает его к ещё не реализованным title/cutscene режимам.
*/
#include <stdint.h>
#include "pop_timer.h"
uint8_t pop_timer_minutes;
uint16_t pop_timer_ticks;
uint8_t pop_show_time;
void pop_timer_new_game(void) __banked
{
pop_timer_minutes = POP_TIMER_START_MINUTES;
pop_timer_ticks = POP_TIMER_START_TICKS;
pop_show_time = 0;
}
uint8_t pop_timer_tick(uint8_t enabled, uint8_t may_run) __banked
{
if (!enabled || !may_run || pop_timer_minutes == 0) return 0;
--pop_timer_ticks;
if (pop_timer_ticks != 0) {
/* Последняя минута: оригинал напоминает о времени КАЖДУЮ секунду
* (rem_tick % 12 == 0) и специально гасит текущую строку, чтобы
* новая встала немедленно, не дожидаясь её 24 тиков. */
if (pop_timer_minutes == 1 && pop_timer_ticks % 12 == 0)
pop_show_time = 2; /* 2 = «показать, перебив текущую» */
return 0;
}
pop_timer_ticks = POP_TIMER_START_TICKS;
--pop_timer_minutes;
/* Круглые пятёрки и весь финальный отсчёт: seg008:1795. */
if (pop_timer_minutes != 0 &&
(pop_timer_minutes <= 5 || pop_timer_minutes % 5 == 0))
pop_show_time = 1;
return (uint8_t)(pop_timer_minutes == 0);
}
void pop_timer_cheat_subtract(void) __banked
{
/* Это буквально правило SDLK_KP_MINUS: последнюю минуту читом не
* отнимаем, иначе не получится отличить чит от настоящего expiry. */
if (pop_timer_minutes > 1) --pop_timer_minutes;
pop_show_time = 2; /* оригинал показывает результат сразу */
}
void pop_timer_cheat_add(void) __banked
{
/* SDLPoP хранит signed short, у нас достаточно byte: 255 минут —
* практический максимум и насыщение не даёт тихо свернуться в нуль. */
if (pop_timer_minutes != 0xFF) ++pop_timer_minutes;
pop_show_time = 2;
}
void pop_timer_qsave(pop_qs_io_t *io) __banked
{
uint8_t minutes = pop_timer_minutes;
uint16_t ticks = pop_timer_ticks;
pop_qs_u8(io, &minutes);
pop_qs_u16(io, &ticks);
if (io->reading && io->apply) {
if (ticks == 0 || ticks > POP_TIMER_START_TICKS) {
io->failed = 1;
return;
}
pop_timer_minutes = minutes;
pop_timer_ticks = ticks;
}
}