Files
Sprinter-SDCC/applications/SprPoP/src/pop_settings.h
T
snark13 31b82661eb 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>
2026-08-27 12:12:28 +03:00

41 lines
2.2 KiB
C

/*
* pop_settings.h — рантайм-настройки игры (план docs/menu_settings_plan.md
* §5, этап MS0). Единственный контракт между UI/файлом настроек и игрой:
* gameplay-код читает значения, но не знает про UI-структуры и POP.CFG.
*
* Экран Settings и загрузчик POP.CFG уже используют эти поля; начальные
* значения ставит pop_settings_defaults() из pop_boot() (crt0 зануляет
* _DATA, поэтому ненулевые дефолты литералами в данных запрещены).
*/
#ifndef POP_SETTINGS_H
#define POP_SETTINGS_H
#include <stdint.h>
typedef enum {
POP_PROFILE_VANILLA = 0, /* текущее поведение SprPoP (план §1) */
POP_PROFILE_ENHANCED = 1 /* будущий набор fixes (план §12) */
} pop_gameplay_profile_t;
typedef struct {
uint8_t sound_enabled; /* 0/1 — зеркало звука (Ctrl+S / pop_sfx) */
uint8_t music_enabled; /* 0/1 — зеркало музыки (Ctrl+M / pop_mus_want) */
uint8_t speed_mode; /* POP_SPEED_* (pop_pace.h), 0..2 */
uint8_t gameplay_profile; /* pop_gameplay_profile_t */
uint8_t cheats_enabled; /* 0/1 — активны ли чит-клавиши */
uint8_t show_build_info; /* 0/1 — build info на title (этап MS8) */
uint16_t enhancement_flags; /* маска будущего ENHANCED (план §12) */
uint8_t time_limit_enabled;/* 0/1 — 60-минутный лимит / unlimited */
uint8_t show_debug_bar; /* 0/1 — отладочная полоса в верхнем борте */
} pop_settings_t;
extern pop_settings_t pop_settings;
void pop_settings_defaults(void) __banked;
/* Применить модель к runtime-владельцам (темп, читы, звук). До окончания
* pop_sfx_init() sound_ready=0: звук применится отдельным вызовом после
* инициализации набора. */
void pop_settings_apply(uint8_t sound_ready) __banked;
#endif