snark13
df5071a967
Часть I плана music_runtime_index_plan.md (MI0..MI5). gen/pop_music_tbl.h и gen/pop_music_ticks.h УДАЛЕНЫ: длины треков и длительности реплик читаются из MUS/mus.idx (формат PMI1, tools/pop_idx.py, тесты в make test-tools). Один и тот же sprpop.exe работает с любым из четырёх наборов записей — sha256 бинарника при смене MUSIC_FMT не меняется. ГДЕ ЖИВЁТ ИНДЕКС. 228 байт таблицы в W2 не положить (свободной кучи там порядка двух сотен), поэтому индекс лежит в одной странице EMM, а в резиденте от него два байта. Данные в странице — со смещения 0x100: gfx_w0_page_prepare пишет в неё стабы прерываний (0x38 и 0x66), и с нуля они попали бы прямо в записи id 10 и 21. Со смещением работает штатная защита, а не запрет прерываний (тот же приём, что CFG_BASE в pop_config.c). Число страниц в индексе не хранится — считается из blocks, чтобы не разъехалось. ПАУЗА КОНЦА УРОВНЯ — СОСТОЯНИЕМ, А НЕ СЧЁТЧИКОМ. pop_endmus_left и POP_MUS_TICKS_32/41 удалены; главный цикл ждёт pop_music_active() — «заявка лежит, идёт загрузка или трек звучит». Одного busy мало: между заявкой и первой нотой 190-230 мс (замер в sound_plan §9). Прежний счётчик закрывал эту щель ценой зависимости EXE от набора и жёсткого делителя /4, который врал в режимах FAST/FASTEST (там логический кадр 3 кадра луча, а не 4). Побочно исправилось расхождение с SDLPoP: при выключенном звуке заявка не кладётся, и уровень меняется сразу, как в оригинале (seg006:651 + seg003:387) — раньше игра держала пройденный уровень лишние 12 секунд в тишине. PV-СЦЕНА — на четырёх якорях (8 байт статики), которые считаются из индекса при входе в сцену; прежние выражения шкалы не изменились. План предлагал протащить структуру времён через пять функций — для сцены, которая идёт раз за запуск, это того не стоит. ПАМЯТЬ. За обе фазы резидент не вырос, а освободился: _CODE 23865 -> 23544, куча 239 -> 256 Б. Банк 9 похудел на 118 Б (ушла pop_mus_tbl из rodata), банк 11 — на длительности реплик. ПРОВЕРЕНО В MAME: exe побайтово одинаков для flac и mt32; все 22 трека в индексах различаются, и контрольные значения совпали с предсказанными планом (m41 732->685, m50 831->867, m53 985->1044, m56 9865->10462 блоков, 78->82 страницы); на mt32 PV-сцена проходит целиком по его длительностям; без mus.idx музыки нет, эффекты работают, игра проходима. НЕ ПРОВЕРЕНО: потоковый m56 на 82 страницах — до финала надо дойти в игре. Единственный оставшийся пункт приёмки, отмечен в sound_plan §11.5. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011MsUsEFAQfsjjQpJ7RtKVY
SprPoP/docs — индекс
Актуальность на 2026-08-26 (перенос из applications/PoP/roomtest).
Сюда взято только то, что ещё читают. Исполненные планы остались архивом
в ../../PoP/docs/, закрытые задачи и баги — в ../../PoP/roomtest/.
Входные точки
| Документ | О чём |
|---|---|
TASKS_OPEN.md |
Что берётся в работу сейчас — начинать отсюда |
BUGS_OPEN.md |
Открытые баги и незакрытые оптимизации |
impl_diff.md |
Осознанные расхождения с SDLPoP: где сделано не дословно и почему. Новое расхождение — записью сюда, а не только комментарием в коде |
keys.txt |
Целевая раскладка управления, к которой подгоняем SprPoP |
keys_plan.md |
План перевода на неё: что совпадает, что переназначить, каких функций нет вовсе |
../assets/orig/README.md |
Откуда берутся исходные данные: make fetch (SDLPoP + музыка), зачем нужен и почему необязателен MSDOS/, SND_SRC |
Производительность
| Документ | О чём |
|---|---|
perf_registry.md |
Реестр оптимизаций: всё отложенное одним списком |
perf_backlog.md |
Отложенная оптимизация отрисовки + как мерить (wait-state'ы, границы кадра) |
perf_green_phase.md |
ЗЕЛЁНАЯ фаза (слой фона): раскладка тактов, способы ускорения G1..G6, журнал правок |
perf_cyan_phase.md |
ЦИАН фаза (персонажи + передний слой): раскладка тактов, C1..C7, журнал правок |
perf_l11_room15.md |
Сцена и замер: факел + чомпер + страж (ур.11 к.15) |
perf_l13_room23.md |
Сцена и метод замера кадра: каскад плит (ур.13 к.23), зонды, канал clog |
resident_budget.md |
Бюджет резидента W1/W2: как мерить и как освобождать |
layout_plan_v2.md |
Раскладка кода по окнам/банкам/страницам + замеры скорости отрисовки |
Движок и содержание игры
| Документ | О чём |
|---|---|
full_game_plan.md |
Полноценная игра: автомат состояний, title/intro, demo, таймер, cutscenes, ending, Hall of Fame |
levels_plan.md |
Уровни: загрузка, переходы, тайлсеты, читы |
levels_12_15_plan.md |
Уровни 12/13 (тень, Джафар, падающие плиты) + что такое 14/15 и 0 |
midtable_analysis.md |
Слои отрисовки: back/mid/fore и objtable в оригинале, чего стоит порт |
room_model_plan.md |
kid_room ≠ drawn_room (straddle): сделан S1, остальное впереди |
quicksave_plan.md |
QuickSave/QuickLoad (реализовано): формат снимка POPQ v3 — справочник |
menu_settings_plan.md |
Pause menu и Settings, POP.CFG, VANILLA и задел под ENHANCED |
palette_plan.md |
Карта всех 256 слотов палитры + механика fade |
status_line_text.md |
Строка HP как статус-строка: инвентаризация ВСЕХ текстов SDLPoP |
sound_plan.md |
Звук через CBL: разбор и архитектура |
music_runtime_index_plan.md |
Будущее улучшение: runtime-индексы музыки и PCM-эффектов, смена аудионаборов без перелинковки EXE |
shadow_render.md |
Вид Тени (OR+XOR) — отложено: почему XOR несовместим с прозрачностью #FF |
roomnav_skip.md |
Комнаты для отладочного телепорта +/−: какие пропускать и почему |
host_tests_plan.md |
Модульные тесты движка под ucsim_z80: два шва, регрессии, дифф против SDLPoP |
Справочники по оригиналу
| Документ | О чём |
|---|---|
PORT_PLAN.md |
Общая карта фаз со статусами; §6 модель движения, §10 режим памяти |
KID_PLAN.md |
Модель персонажа: char_type, actions_*, устройство play_seq |
gates_spikes_plan.md |
Раскладка объектов по комнатам, декод LINKLOC/LINKMAP, ссылки на seg-код |
PoP/POP-DAT-FormatSpecifications.pdf |
Каноническая спецификация форматов .DAT (грепаемая копия — .txt) |
PoP/MSDOS_RESOURCE_FORMAT.md |
Наш разбор ресурсов MS-DOS-версии |
PoP/APPLEII_RESOURCE_FORMAT.md |
Наш разбор ресурсов Apple II |
Заделы
| Документ | О чём |
|---|---|
ideas_backlog.md |
Осознанно отложенные гипотезы (мышь, PRNG) |
prng_alternatives.md |
Запасные генераторы, если упрёмся в бюджет кадра |
Не переносилось
Исполнено целиком, лежит в ../../PoP/docs/: frame_pacing_plan.md
(фиксированный логический кадр), l9_invert_plan.md (зелье переворота),
shadow_atlas_plan.md (запечка атласа Тени).