snark13
31b82661eb
Порт 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>
51 lines
3.1 KiB
C
51 lines
3.1 KiB
C
/*
|
|
* pop_timer.h — глобальный игровой таймер (FG4, банк 9).
|
|
*
|
|
* Время измеряется логическими кадрами SDLPoP: 720 тиков = одна минута.
|
|
* Модуль намеренно не знает ни о клавиатуре, ни о графике, ни о состоянии
|
|
* Settings: вызывающий передаёт, разрешён ли лимит и можно ли времени идти.
|
|
* Благодаря этому тот же код проверяется host-тестом без DSS/MAME.
|
|
*/
|
|
#ifndef POP_TIMER_H
|
|
#define POP_TIMER_H
|
|
|
|
#include <stdint.h>
|
|
#include "pop_qsave.h"
|
|
|
|
#define POP_TIMER_START_MINUTES 60
|
|
#define POP_TIMER_TICKS_PER_MINUTE 720
|
|
#define POP_TIMER_START_TICKS (POP_TIMER_TICKS_PER_MINUTE - 1)
|
|
|
|
/* Оставшееся время. ticks всегда 1..719 вне короткого участка timer_tick.
|
|
* Нуль minutes означает естественное истечение; выключенный в Settings
|
|
* лимит состояние не меняет, а просто останавливает отсчёт. */
|
|
extern uint8_t pop_timer_minutes;
|
|
extern uint16_t pop_timer_ticks;
|
|
|
|
/* «Пора показать оставшееся время» — порт is_show_time (seg008). Взводит
|
|
* и сам таймер на круглых минутах, и внешние события: старт уровня, клавиша
|
|
* Space, читы +/-, смерть Джафара. Гасит его тот, кто напечатал строку
|
|
* (pop_status.c) — ядро таймера про экран по-прежнему ничего не знает. */
|
|
extern uint8_t pop_show_time;
|
|
|
|
/* Начать новую игру: ровно исходные 60:00 SDLPoP (60 минут, tick 719). */
|
|
void pop_timer_new_game(void) __banked;
|
|
|
|
/* Один логический игровой кадр. enabled — переключатель Settings,
|
|
* may_run — правила текущей сцены/уровня. Возвращает 1 ОДИН раз, когда
|
|
* отсчёт дошёл до нуля; на паузе, HDD/QuickSave и при выключенном лимите
|
|
* вызывать можно — состояние останется неизменным. */
|
|
uint8_t pop_timer_tick(uint8_t enabled, uint8_t may_run) __banked;
|
|
|
|
/* Читы, повторяющие +/- SDLPoP: минус не даёт искусственно поставить 0,
|
|
* плюс добавляет минуту. Они меняют счётчик и при выключенном лимите —
|
|
* после включения пользователь продолжит именно это подготовленное время. */
|
|
void pop_timer_cheat_subtract(void) __banked;
|
|
void pop_timer_cheat_add(void) __banked;
|
|
|
|
/* Состояние входит в payload QuickSave. Неверный tick помечает поток
|
|
* ошибочным, не подменяя живой таймер частично. */
|
|
void pop_timer_qsave(pop_qs_io_t *io) __banked;
|
|
|
|
#endif /* POP_TIMER_H */
|