Files

T

snark13 5348feb5f4 Доски приведены в соответствие с кодом; bug_list/bug_closed → BUGS_OPEN/BUGS_CLOSED

Доска отставала от кода на три задачи — планировать по ней было нельзя.
Сверка проведена грепом по исходникам, а не по записям:

- L4-MIRROR ЗАКРЫТА: шаги 1-5 сделаны и проверены пользователем в MAME
  (зеркало в атласе, постановка тайла, отражение, прыжок сквозь зеркало с
  рождением тени, левый клип тени).  Протокол с разбором решений — в архиве;
- L3-CHOMP и L3-SKEL закрыты ещё 2026-08-08/07 (коммиты dc0bd47, 4d4323f,
  db4106a, 1461ed5), на доске значились как предстоящие;
- тайлсет palace (шаг 2 levels_plan) в коде есть целиком — pop_bg_load(type),
  pal_*.atl, дворцовый wall_pattern, решётки 25-29 и в tile_table, и в
  коллизии (tile_is_floor совпадает с seg006:0628);
- в GUARD-PHYS остаток пересобран по факту: check_chomped_guard сделан,
  скелет в check_guard_fallout сделан, ветки ТЕНИ нет — она уехала в L5-SHADOW.

Приёмки: по решению пользователя уровни 1-4 приняты SMOKE-тестами, полные
обходы всех комнат делаются по готовности ВСЕХ уровней — L3-PASS/L4-PASS как
отдельные задачи отменены, вместо них политика приёмок в архиве.

Новая цель — уровень 5.  Инвентарь res2005.bin: НИ ОДНОГО нового тайла, всё
портировано на уровнях 1-4.  Единственная новая механика — спецсобытие «тень
крадёт зелье» (комната 24): заведена задача L5-SHADOW с портом по SDLPoP
(check_shadow / do_init_shad / do_auto_moves + shad_drink_move /
autocontrol_shadow_level5 + ветка тени в check_guard_fallout), включая
готовые константы и то, что у нас уже есть под это.

Заведён MIRROR-FG-STALE (низкий): place_mirror пишет тайл в данные уровня, но
не в снимок room_fg, по которому работает коллизия — если зеркало поставлено,
пока игрок В комнате 4, оно невидимо для коллизии (тень не родится).  В
обычном прохождении недостижимо: дверь выхода в другой комнате.  Записан
точный сценарий воспроизведения читом ROOMNAV и фикс на несколько строк.

Правило «в _OPEN только незакрытое» теперь выполняется буквально:
- bug_list.md → BUGS_OPEN.md, bug_closed.md → BUGS_CLOSED.md (ссылки
  обновлены во всех документах и в комментарии pop_trob.c);
- из TASKS_OPEN убраны блоки закрытых задач (L3-CHOMP, L3-SKEL, L3-PASS,
  L4-MIRROR, DRAW-CHAR), справка по связности комнат уехала в архив;
- из BUGS_OPEN убраны 8 строк таблицы закрытых багов, закрытый T-2 (уехал в
  BUGS_CLOSED) и раздел «уровень 3 — неначатые задачи» (обе записи закрыты);
  сводная таблица пересобрана по реально открытым записям.

Все внутренние ссылки проверены скриптом: битых якорей 0.  make size-check
OK (65 программ), tests-host 5/5.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-11 16:10:10 +03:00

9.3 KiB

Raw Blame History

roomtest — правила подпроекта

Живой прототип порта PoP: комната 1 уровня 1 (композиция тайлов в рантайме)

Kid (анимация seqtbl, управление, коллизия, падение, зацеп, fore-окклюзия, проваливающиеся полы). Действуют правила корневого CLAUDE.md и applications/PoP/CLAUDE.md.

Главное правило (из ../CLAUDE.md): ../SDLPoP/src/ — источник истины. Перед реализацией ЛЮБОЙ функции и по ЛЮБОМУ вопросу «как в оригинале» — СНАЧАЛА прочитай соответствующий код SDLPoP и портируй по нему; не пиши по памяти и не угадывай константы/порядок слоёв. Расхождение с SDLPoP = по умолчанию баг у нас; ОСОЗНАННЫЕ расхождения (платформа/бюджет требуют иначе) перечислены в ../docs/impl_diff.md — новое туда же записью, а не только комментарием в коде.

НАЧИНАТЬ С NEXT_SESSION.md — состояние окружения, задача на ближайший заход и грабли последней сессии одним файлом.

Что в работе сейчас — TASKS_OPEN.md (доска задач: приоритеты, критерии готовности); сделанное с протоколами замеров — TASKS_CLOSED.md. Баги — BUGS_OPEN.md (только ОТКРЫТЫЕ) и BUGS_CLOSED.md (закрытые + разбор корней: перед заведением нового бага грепни там по симптому); сырые формулировки пользователя с прогонов — bugs_level1.md / bugs_level2.md. План следующих уровней — ../docs/levels_plan.md.

Правило разнесения: как только задача/баг закрыт — запись целиком переезжает в TASKS_CLOSED.md / BUGS_CLOSED.md, а в открытом файле остаётся ссылка. Открытые файлы обязаны читаться целиком за раз.

Сборка и запуск

make            # собрать roomtest.exe (упаковав ассеты через toolchain/)
make run        # exe + EXTRA_DATA на дискету + запуск MAME (см. корневой док)
make -C tests-host   # модульные тесты движка под ucsim_z80 (секунды, без MAME)

Логику, которую можно проверить без железа, покрывать в tests-host/ (обвязка — testkit/, там же почему прогон именно под z80). MAME остаётся для отрисовки, банков, таймингов и клавиатуры.

MEMORY=small, --gfx 256. Ассеты (pop_env0..4.atl, pop_wall.atl, pop_fore.atl, kid0..27.atl, kid.pal) генерируются python-скриптами ../toolchain/ — Makefile дёргает их сам при изменении. Данные комнаты — room1_data.h (fg=foretable code, bg=backtable modifier); данные анимации Kid — kid_data.h (генерится pop_extract_kid_data.py).

Проверка в MAME

Только через toolchain/mame_interactive.py или MCP-мост mame-z80 (см. memory mame_autotest, mame_mcp_bridge, mame_hdd_test_disk). Эталон комнаты — ../toolchain/1.1-2.png. Пересобрал HDD-образ → MAME ОБЯЗАН полный рестарт (mame_hdd_rebuild_restart).

Отладочные тумблеры в живой сессии (roomtest.c): SPACE — вкл/выкл дабл-буфер (в однобуфере видно баги рисования без мерцания-через-кадр); 1 — заморозить кадр, 2 — продолжить (разбор позы/окклюзии); ESC — выход. Читы (pop_cheat.h): K — убить стража, I — бессмертие, S — выдать меч, Shift+L — следующий уровень, +/− — обход комнат (ROOMNAV). Уровень грузится по номеру (pop_level_load_num), на диске лежат все 15.

Модули

Файл	Роль (порт SDLPoP)
`roomtest.c`	Главный цикл: дабл-буфер (2 страницы + флип на vsync), tick→draw порядок слоёв.
`pop_tile.c/.h`	Общие ЛИСТЬЯ слоя фона — РЕЗИДЕНТ W1: блит куска атласа, чтение тайла комнаты, `tile_table`, метка «фон трогали вот здесь» (`pop_cd_touch`). Резидент потому, что их зовут обе половины слоя фона из разных банков, а `const`-таблицы банка из чужого банка не видны.
`pop_bg.c/.h`	ГОРЯЧАЯ половина слоя фона (банк 2, каждый кадр): fore-окклюзия поверх ЛЮБОГО персонажа (`seg003` redraw_at_char/char2 — один проход на всех Char), оверлеи кромки, кладка стены (`wall_pattern`), клип. `pop_bg.h` — публичный API ВСЕГО слоя (обеих половин).
`pop_room.c`	ХОЛОДНАЯ половина слоя фона (банк 7, раз на комнату/событие): полная отрисовка комнаты (`seg008` draw_tile), точечные перерисовки тайлов (пики, ворота, кнопки, дверь уровня, дрожащие плиты), падающие куски loose (`seg007` mob), загрузка атласов.
`_pop_bg.h`	Внутренний контракт между половинами: общее состояние + три тонкие `__banked`-обёртки. Там же расписано, почему рез прошёл именно здесь и сколько стоит.
`pop_kid.c/.h`	Анимация/движение: интерпретатор seqtbl `play_seq` + frame_table (`seg006`), окна `Char` (loadkid/loadshad), атласы Кида.
`pop_cdraw.c/.h`	ОТРИСОВКА персонажей — одна на всех Char (порт `add_kid_to_objtable`/`add_guard_to_objtable`, `seg008:22F0/2324`): спрайт, clip_char, брызги, клинок, heal; + полоса HP и палитры соперника. Там же ПРОПУСК неизменившегося кадра (`pop_char_skip_mask`): персонаж, у которого с прошлой отрисовки этой страницы ничего не изменилось и фон под ним не трогали, не перерисовывается вовсе.
`pop_ctrl.c/.h`	Управление: диспетчер `control()` (`seg005`) + ввод `read_user_control` (`seg006`) поверх `<kbd_raw.h>`.
`pop_map.c/.h`	Коллизия с картой + физика падения/приземления/стены + loose-полы (`seg005/006/007`).

Порядок слоёв в кадре (важно для окклюзии)

roomtest.c каждый тик рисует в СКРЫТУЮ страницу: pop_char_heal (стереть прошлый кадр — по слоту на персонажа) → kid_tick → pop_phys_tick → pop_loose_tick (loose СЛОЙ ФОНА — ДО персонажей, чтобы они были поверх плиты) → pop_char_draw/pop_char_fore для соперника и Кида (кто позже — тот поверх, порядок задаёт обход тайлов) → pop_room_clip_borders (чистка бортов, гейт по флагу — только в кадрах падения) → флип на vsync.

Отрисовка персонажа ОДНА на всех (pop_cdraw.c): слот выбирает окно Char, набор атласов и heal-прямоугольники, всё остальное общее — как два одинаковых входа add_*_to_objtable в оригинале.

Дабл-буфер: у каждой страницы своя видео-ОЗУ и теневая ОЗУ-копия; heal берёт чистый фон из копии ТОЙ страницы, в которую рисуем. Любой динамический элемент (Kid, loose-плита, падающий кусок) обязан чистить свой прошлый кадр на КАЖДОЙ из двух страниц — иначе остаток виден через кадр как мерцание. Это типовой источник багов «остаётся кусочек» (см. memory pop_fall_debug_baseline).

Ключевые memory

pop_kid_plan, pop_hang_state, pop_fore_layer, pop_fall_debug_baseline, accel_vertical_copy, kbd_raw_fifo_drain, pop_check_sdlpop_first.

9.3 KiB Raw Blame History Unescape Escape