snark13
2349481b86
Часть II плана music_runtime_index_plan.md (SI0..SI4). gen/pop_sound_tbl.h БОЛЬШЕ НЕ ГЕНЕРИРУЕТСЯ: раскладка набора читается из SND/snd.idx (формат PSI1, писатель и разборщик — tools/pop_idx.py, 22 теста в make test-tools). Один и тот же sprpop.exe работает с набором SDLPoP (9 страниц) и MSDOS (10) — sha256 бинарника при смене набора не меняется. Заодно умолчание источника эффектов переведено на SDLPoP (SND_SRC=sdlpop): сборка обязана работать без оригинального дистрибутива DOS. У кого он есть, включает лучший набор явно — make SND_SRC=msdos (там полнее оцифровка: в SDLPoP звук 48 spiked пустой). Устройство: pop_snd_tbl/pop_snd_page/pop_snd_pages — резидентные данные (pop_snd_data.c), тип и инварианты — рукописный pop_snd_tbl.h. Записи читаются ОДНИМ read прямо в таблицу, поэтому sizeof(pop_snd_ent_t) == 5 стало частью дискового контракта: проверяется статически и полем размера записи в заголовке. POP_SND_PAGES как compile-time размер набора исчез — вместо него POP_SND_MAX_PAGES (вместимость, 16) и runtime pop_snd_pages. Цена: таблица переехала из _CODE в _DATA, суммарный резидент почти не изменился (куча 239 -> 229 Б); банк 8 +601 Б на чтение и валидацию. Валидация не доверяет файлу: заголовок целиком плюс каждая запись (страница, смещение, кратность блоку, непересечение с блоком тишины, выход за последнюю страницу). Последнее считается В БЛОКАХ — байтовый адрес конца не влезает в uint16, а 32-битная арифметика на Z80 дорога. НЕТ ИНДЕКСА — ЭФФЕКТОВ НЕТ, НО МУЗЫКА ИГРАЕТ. Первая версия просто возвращала ошибку, и игра становилась непроходимой: тишину льёт первый блок набора, без набора CBL не открывался, а с ним вставала музыка (её блоки считает тот же насос) — заставка ждала конца трека вечно. Теперь поднимается пустой набор с блоком тишины. Заливается ровно 128 байт и под DI: gfx_w0_page_prepare ставит в страницу IRQ-стабы, и заливка всей страницы затирала их — первое же прерывание давало чёрный экран. Грабли сборки: смена SND_SRC тихо давала неверный результат (sdlpop -> msdos -> sdlpop оставлял чужой набор в assets/packed). Причина не в логике, а в секундной гранулярности mtime. Лечение убирает время из решения: смена варианта сносит stamp'ы своего семейства, а упаковка, сборка архива и копия индекса делаются одним рецептом. То же получила и музыка (MUSIC_FMT). Проверено в MAME: таблица в памяти совпадает с файлом из образа побайтово; один EXE поднимает оба набора; отладочный --order reverse (30 из 31 записей отличаются от штатных) звучит правильно; битый индекс выключает эффекты, не роняя игру; без индекса PV-сцена проходит с музыкой; Ctrl+S работает в обоих режимах. Разбор — docs/sound_plan.md §10. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011MsUsEFAQfsjjQpJ7RtKVY
82 lines
5.7 KiB
Markdown
82 lines
5.7 KiB
Markdown
# 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
|
|
```
|
|
|
|
Чужих данных в репозитории нет — есть адреса, откуда их взять. Чтобы
|
|
перегенерировать ресурсы (или получить эталон механики), сначала:
|
|
|
|
```sh
|
|
make fetch # SDLPoP + записи саундтрека DOS-версии в assets/orig/
|
|
```
|
|
|
|
## Что где
|
|
|
|
```
|
|
src/ рукописный C: главный цикл sprpop.c + движок pop_*.c
|
|
gen/ генерируемые заголовки — руками не править
|
|
assets/orig/ оригинальные данные игры (вне репозитория, качает `make fetch`)
|
|
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 fetch` | скачать внешние исходные данные в `assets/orig/`: `fetch-sdlpop`, `fetch-music`, `fetch-check`, `fetch-list` |
|
|
| `make resources` | перегенерировать ресурсы из `assets/orig/` |
|
|
| `make music-mp3` | музыка из другого набора записей: `music-flac` (умолчание), `music-mp3`, `music-ogg`, `music-mt32` |
|
|
| `make SND_SRC=msdos` | оцифровка эффектов из дистрибутива DOS вместо SDLPoP (нужен свой `assets/orig/MSDOS/`) |
|
|
| `make -C tests/host` | модульные тесты движка (секунды, без эмулятора) |
|
|
| `make test-tools` | тесты упаковщиков на хосте: форматы файлов, которые читает Z80 |
|
|
| `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`. Заполняется он одной
|
|
командой `make fetch` — качается SDLPoP (ресурсы + исходники-эталон) и записи
|
|
саундтрека; адрес архива музыки скрипт берёт из самого SDLPoP.
|
|
|
|
Оригинальный дистрибутив DOS (`assets/orig/MSDOS/`) **не нужен**: и уровни, и
|
|
оцифровка звука берутся из SDLPoP. Он даёт ровно одно — более полный набор
|
|
эффектов (в SDLPoP пуст звук `spiked`, 48); у кого дистрибутив есть, включает
|
|
его явно: `make SND_SRC=msdos`. Подробности — `assets/orig/README.md`.
|
|
|
|
## Происхождение
|
|
|
|
Выделен из `applications/PoP/roomtest` 2026-08-26; та папка заморожена и
|
|
служит архивом закрытых задач, багов и исполненных планов. Референсные
|
|
реализации (Apple II 6502, Princed Resources, mininim) остались в
|
|
`applications/PoP/`.
|