СИМПТОМ: затемнение (fade) хрипело — одинаково с играющей музыкой и в тишине. Ключевое наблюдение пользователя: повтор тишины обязан звучать тишиной, значит дело не в недоливе буфера. ПОИСК: отладочные клавиши, каждая делала ровно один кусок fade. Ожидание кадров — чисто; чтение палитры, запись палитры и 512 вызовов bios_get_place() (видео вообще не трогает) — скрежет во всех трёх. Последнее и решило: виновата не палитра, а ЛЮБОЙ вызов BIOS. ПРИЧИНА: `rst 8` раскрывается в `out ($7C),a`, который включает системное ПЗУ и перестраивает окно 0 (MAME sprinter.cpp, update_memory: m_pages[0] + m_bank_view0.select). ПЗУ ложится ПОВЕРХ страничного регистра, поэтому запись в порт 0x82 из прерывания бесполезна — OTIR вычитывает ПЗУ и отдаёт его в звук. Отсюда же старое правило «глушить CBL на время загрузки файлов»: причина была не в том, что ESTEX долго занимает CPU. РЕШЕНИЕ (идея пользователя): качать через W3. Он управляется только портом 0xE2, подмену из прерывания никто не перекрывает, а BIOS во время нашего ISR не исполняется — окно возвращается до выхода, и для него подмена невидима. После этого BIOS безопасен везде. * pop_sfx.c — насос берёт взаймы W3 вместо W0, чтение по 0xC000 + смещение. * pop_ui.c — буфер палитры по фиксированному 0x4000 (эти 256 байт DSS занимает только при загрузке программы): 256 байт со стека долой. * libbgi/common/gfx_pal_write.c — запись палитры прямо в видеопамять, минуя BIOS. Писалась как обход скрежета, после переноса насоса не нужна; оставлена как более быстрый примитив (2,5 тыс. тактов на 64 цвета против 10,8 тыс. у BIOS) с честной шапкой. Адресация разобрана по исходникам BIOS (FUNC_SCREEN.ASM): Port_Y = индекс цвета, адрес 0xC3E0 + pal*4, порядок R/G/B/Y. * libc/video/pal_get.c, pal_load.c — в шапках зафиксировано, что BIOS выбирает окно ПО АДРЕСУ БУФЕРА (`BIT 7,H`). * pop_intro.c — при пропуске интро клавишей не глушился CBL, и следующая загрузка уровня шла с открытым буфером; добавлен pop_sfx_pause. * pop_ctrl.c — убраны отладочные «осторожные шаги» на J/L (эмуляция Shift+стрелка для MAME), у них и стоял TODO. Разбор целиком — docs/sound_plan.md §5. Бюджет: _CODE 23966, куча 245 Б. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
roomtest
Живой прототип порта Prince of Persia: комната 1 уровня 1 отрисовывается реальной композицией слоёв-тайлов, по ней бегает и прыгает Kid под управлением с клавиатуры. Служит стендом для переноса механик движка (анимация, коллизия, падение, зацеп, окклюзия, проваливающиеся полы) до их выделения в переиспользуемый код.
Правила разработки и порядок слоёв рендера — CLAUDE.md.
Быстрый старт
make # собрать roomtest.exe (ассеты упакуются автоматически)
make run # собрать, упаковать на дискету и запустить в MAME
Клавиши в запущенном тесте: ←/→ бег, ↓ присед, ↑+→ прыжок, Shift шаг, ESC выход.
Отладка рисования:
- SPACE — тумблер дабл-буфера (в однобуфере баги рисования видны без мерцания-через-кадр).
- 1 — заморозить кадр (
frozen: tick/draw/flip пропускаются, картинка стоит), 2 — снять заморозку и продолжить. Приём для разбора транзиентных артефактов (тряска/падение loose, поза Kid): поймать проблемный кадр на1, спокойно рассмотреть/снять пиксели — в т.ч. удалённо из MAME MCP-моста, пока анимация стоит.
Читы (pop_cheat.h; в релизной сборке выключаются через pop_cheats):
- I — бессмертие Кида (toggle). Работает ТОЛЬКО в бою, то есть с
мечом в руке. Удар по безоружному Киду остаётся смертельным — ровно как
в оригинале (seg002
hurt_by_sword: «Being hurt when not in fighting pose means death»,take_hp(100)). Ограничение не косметическое: анимация «получил удар» (seq_74) состоит из кадров 150..179, которые ВСЕ с мечом, и подмена смерти на неё оставляла Кида в боевой стойке приsword == 0— состоянии, для которого у диспетчераcontrol()нет ни одной ветки, то есть с намертво зависшим управлением (BUG-CHEAT-IMM-1). На физику (падения, пики, чомперы) бессмертие действует всегда, независимо от меча. - K — убить стража, S — выдать меч, Shift+L — следующий уровень, +/− — обход комнат.
Эталон вида комнаты — ../toolchain/1.1-2.png.
Модули
roomtest.c— главный цикл (дабл-буфер, порядок tick/draw).pop_bg.c— фон комнаты композицией тайлов + fore-окклюзия + loose-полы.pop_kid.c— анимация/движение Kid (интерпретатор seqtbl).pop_ctrl.c— управление с клавиатуры (диспетчер control).pop_map.c— коллизия с картой, физика падения, loose-полы.room1_data.h— карта комнаты 1;kid_data.h— данные анимации Kid (оба генерируются скриптами../toolchain/).
Статус (2026-08-18)
Уровни 1-3 приняты, 4-12 прошли предварительный тест. Работает: комнаты и переходы, Kid (анимация, управление, коллизия/падение, зацеп/подтягивание/ спуск, окклюзия), кнопки и ворота, пики, чомперы, проваливающиеся полы, дверь уровня и переход на следующий, меч и бой, стражи с ИИ (включая скелета и визиря), тень уровней 4/5/6, зеркало, HP и зелья, чекпойнты, дворцовый тайлсет.
«Принят» = пользователь обошёл ВСЕ комнаты уровня; «предварительно пройден» =
прогон по сценарию. Разбивка по уровням с найденными багами —
TASKS_OPEN.md. Не сделано вовсе: звук, таймер/HUD времени,
меню и сохранения (QuickSave запланирован).
Что берём в работу сейчас — TASKS_OPEN.md (сделанное с
протоколами замеров — TASKS_CLOSED.md); открытые баги —
BUGS_OPEN.md, закрытые с разбором корней —
BUGS_CLOSED.md; план следующих уровней —
../docs/levels_plan.md.