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:
@@ -0,0 +1,64 @@
|
||||
# SprPoP — Prince of Persia на Sprinter Sp2000
|
||||
|
||||
Порт оригинального Prince of Persia (1989) на компьютер Sprinter Sp2000:
|
||||
режим 320×256×256, дабл-буфер, звук через CBL, код разложен по одиннадцати
|
||||
16-килобайтным банкам.
|
||||
|
||||
Приложение **автономно** — код, оригинальные данные, конверторы ресурсов и
|
||||
сборка лежат внутри этой папки. Наружу нужен только компилятор:
|
||||
|
||||
```sh
|
||||
export SPRINTER_ROOT=/путь/к/C-Compiler # не нужен, если папка лежит внутри его дерева
|
||||
make # build/sprpop.exe + ресурсы в build/
|
||||
make hdd # + образ build/hdd/sprpop.chd
|
||||
```
|
||||
|
||||
## Что где
|
||||
|
||||
```
|
||||
src/ рукописный C: главный цикл sprpop.c + движок pop_*.c
|
||||
gen/ генерируемые заголовки — руками не править
|
||||
assets/orig/ оригинальные данные игры (вне репозитория, см. там README)
|
||||
assets/packed/ то, что ложится на диск игры, в раскладке диска
|
||||
tools/ конверторы ресурсов; все пути — в tools/paths.py
|
||||
docs/ планы, доски задач и багов, справочники (начинать с docs/README.md)
|
||||
tests/host/ модульные тесты движка под ucsim_z80
|
||||
build/ выход: sprpop.exe, каталоги ресурсов, hdd/, промежуточные atl/
|
||||
```
|
||||
|
||||
## Цели сборки
|
||||
|
||||
| Команда | Что делает |
|
||||
|---|---|
|
||||
| `make` | собрать `build/sprpop.exe` и разложить ресурсы в `build/` |
|
||||
| `make hdd` | + образ жёсткого диска `build/hdd/sprpop.chd` |
|
||||
| `make mame-link` | однократно подставить образ в MAME (символьная ссылка на `IMG/test_hdd.chd`) |
|
||||
| `make resources` | перегенерировать ресурсы из `assets/orig/` |
|
||||
| `make music-mp3` | музыка из другого набора записей: `music-flac` (умолчание), `music-mp3`, `music-ogg`, `music-mt32` |
|
||||
| `make -C tests/host` | модульные тесты движка (секунды, без эмулятора) |
|
||||
| `make clean` | снести `build/` (ассеты не трогает) |
|
||||
| `make distclean` | `clean` + снести упакованные ассеты `assets/packed/` |
|
||||
|
||||
Отладочные ключи: `make LEVEL=9` — стартовый уровень, `make ROOM=15 POS=2` —
|
||||
стартовая комната и тайл (`row*10+col`), `make PROF=1` — профиль фаз кадра
|
||||
полосами бордюра, `make ALLOCS=100000` — плотная упаковка регистров для
|
||||
замеров размера.
|
||||
|
||||
## Сборка из чистого клона
|
||||
|
||||
Работает без `assets/orig/`: упакованные ресурсы (`assets/packed/`) и
|
||||
генерируемые заголовки (`gen/`) лежат в репозитории. Исключение —
|
||||
`assets/packed/LEVELS/`: файлы уровней ложатся на диск прямо из оригинала,
|
||||
без конвертации, поэтому они, как и `assets/orig/`, вне репозитория. Что и
|
||||
откуда положить — `assets/orig/README.md`.
|
||||
|
||||
`assets/orig/` нужен только чтобы ресурсы **перегенерировать** (`make
|
||||
resources`) и как **эталон механики**: любая правка поведения сверяется с
|
||||
`assets/orig/SDLPoP/src/` до кодинга, см. `CLAUDE.md`.
|
||||
|
||||
## Происхождение
|
||||
|
||||
Выделен из `applications/PoP/roomtest` 2026-08-26; та папка заморожена и
|
||||
служит архивом закрытых задач, багов и исполненных планов. Референсные
|
||||
реализации (Apple II 6502, Princed Resources, mininim) остались в
|
||||
`applications/PoP/`.
|
||||
Reference in New Issue
Block a user