4737ec323c
Три правки едут вместе намеренно: n_banks и --bank обязаны меняться атомарно, иначе промежуточный коммит — зависание (см. ниже). MEM-BANK5. CODE и DATA делят одно 32-КБ пространство W1+W2, поэтому килобайт кода, уехавший в банк, — это килобайт, доступный данным. Кандидат выбран не по размеру, а по частоте вызова: диспетчер управления дёргается раз в кадр на персонажа и горячих банк→банк переходов не создаёт (в отличие от pop_level, чей pop_level_tile зовётся из банка 2 на КАЖДЫЙ тайл). _CODE 26 780 -> 24 662 Б (−2 118) куча 180 -> 2 298 Б банк 5 2 211 / 16 384 (13.5 %) Шина control_* (8 глобалов) переехала в pop_state.c. Сегодня она уцелела бы и в pop_ctrl.c — банки собираются без --bank-data, их писучие данные остаются в общем _DATA, — но это флаг сборки, а не свойство кода, а шину трогают уже три банка: 5 пишет с клавиатуры, 1 подаёт синтетический ввод ИИ (autocontrol_*, seg002), 3 читает через pop_ctrl_shift_held. Заодно pop_ctrl.c наконец включает собственный заголовок — раньше объявления жили прямо в нём. ГРАБЛИ, на которые наступили (стоили дольше самой задачи): n_banks в roomtest.c захардкожен, и его надо править вместе с числом --bank. С n_banks=4 и пятым банком crt0 выделил четыре страницы, _bank_pages[5] остался нулём, и первый же вызов pop_ctrl_init() через трамплин отобразил в W3 страницу 0 и прыгнул на 0xC874 в мусор — исполнение забрело в дисковый код DSS и осталось крутить чтение секторов. Симптом: загрузка ресурсов проходит целиком (open=45 — все атласы), комната и Кид успевают нарисоваться из enter_room, а HP и номер комнаты уже нет, и kid_tick не вызывается ни разу. Ровно предупреждение из шапки runtime/bank.s. Сверку n_banks с реальным максимальным индексом банка записал в docs/TODO.md (Auto-banking) — это должно быть ошибкой сборки. DBG-CHEATS: [ (0x54) и ] (0x5B) двигают Кида на пиксель (seg000:1828), по фронту нажатия, под pop_cheats. Нужны потому, что мост MAME теряет нажатия при быстрой отправке и подогнать Кида в позу скриптом нельзя — на это упёрлись BUG-LOOSE-2 и BUG-GATE-PASS-1. ROOMNAV больше не зовёт pop_trob_reset: reset обнуляет room_seen, то есть чит ОТМАТЫВАЛ МИР (открытые/закрытые ворота, нажатые кнопки). Навигация обязана только телепортировать. Проверено в MAME: старт уровня 1 рисуется полностью (комната, Кид, HP, номер), бег вправо и падение на второй ряд отрабатывают, ] даёт x+1 и [ даёт x−1 по одному нажатию, Shift+→ — осторожный шаг (x 131 -> 142, колонка 4 -> 5) и при удержании 90 кадров не срывается в бег (x 142 -> 151), то есть pop_ctrl_shift_held работает через границу банк 3 -> банк 5. Наборы под ucsim: geom 39, grab 53, phys 1723 — все зелёные. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
69 lines
4.3 KiB
C
69 lines
4.3 KiB
C
/*
|
||
* pop_ctrl.h — управление Kid (Фаза K2b): порт диспетчера control()
|
||
* (SDLPoP seg005.c) + модель ввода read_user_control/user_control
|
||
* (seg006.c) поверх held-state клавиатуры <kbd_raw.h>.
|
||
*
|
||
* Kid-only подмножество: без меча и стражи. Map-запросы (стена/край/
|
||
* захват) ЗАСТАБЛЕНЫ «открытый пол» — реальная коллизия (стоп у стены,
|
||
* падение в ямы, повисание) приходит в K3/K4. Даёт отклик на клавиши:
|
||
* бег влево/вправо, разворот, стоп, присед, прыжок с места, прыжок в
|
||
* беге, присед-прыжок.
|
||
*
|
||
* Раскладка (kbd_raw, PS/2 Set 2): ←/→ = движение, ↓ = присед, ↑ =
|
||
* прыжок вверх (с →), Shift = осторожный шаг (K3). ESC — выход (проверяет
|
||
* приложение сам, канал raw забирает весь ввод у DSS).
|
||
*/
|
||
#ifndef POP_CTRL_H
|
||
#define POP_CTRL_H
|
||
|
||
#include <stdint.h>
|
||
|
||
/* МОДУЛЬ ЖИВЁТ В БАНКЕ 5 (--bank 5=pop_ctrl.c), поэтому всё, что зовут
|
||
* снаружи, помечено __banked. Зовут с трёх сторон: главный цикл
|
||
* (резидент), guards.c (банк 1) и pop_map.c (банк 3) — банк→банк
|
||
* работает, трамплин сохраняет страницу окна на стеке. Диспетчер
|
||
* дёргается один раз за кадр на персонажа, так что цена перехода
|
||
* незаметна. Сама шина control_* лежит в pop_state.c (см. ниже). */
|
||
|
||
/* Открыть raw-канал клавиатуры и обнулить память авто-повтора.
|
||
* 0 — OK, -1 — ошибка (EBUSY и пр., см. kbd_raw_open). */
|
||
int pop_ctrl_init(void) __banked;
|
||
void pop_ctrl_close(void) __banked;
|
||
|
||
/* Один кадр ввода: прочитать клавиши -> обновить control_* -> прогнать
|
||
* диспетчер control() (может сменить Kid.curr_seq). Звать ПЕРЕД
|
||
* kid_tick() (play_seq продолжит с новой последовательности). */
|
||
void pop_ctrl_tick(void) __banked;
|
||
|
||
/* control_shift зажат ПРЯМО СЕЙЧАС? — для check_grab в физике (pop_map):
|
||
* зацеп за уступ в падении по Shift. Валидно после pop_ctrl_tick. */
|
||
int8_t pop_ctrl_shift_held(void) __banked;
|
||
|
||
/* ---- Шина синтетического ввода (порт глобалов control_* из seg005) ----
|
||
* В оригинале ИИ соперника (autocontrol_*, seg002) не имеет своего
|
||
* диспетчера: он ВЫСТАВЛЯЕТ эти переменные, а дальше исполняется тот же
|
||
* control(), что и для игрока. Значения — CONTROL_RELEASED/IGNORE/HELD. */
|
||
#define POP_CONTROL_RELEASED 0
|
||
#define POP_CONTROL_IGNORE 1
|
||
#define POP_CONTROL_HELD (-1)
|
||
/* Оси ЭТОГО кадра (абсолютные): X = -1 влево / +1 вправо, Y = -1 вверх /
|
||
* +1 вниз. Для ИИ «вперёд/назад» уже в системе персонажа, поэтому оси он
|
||
* заполняет как есть, без flip_control_x. */
|
||
/* Определены в pop_state.c (резидент W1/W2), а не в pop_ctrl.c: шину
|
||
* трогают три банка сразу, а данные банкового модуля живут в _DATA лишь
|
||
* пока сборка идёт без --bank-data. */
|
||
extern int8_t control_x, control_y, control_shift;
|
||
#define POP_CONTROL_HELD_FORWARD (-1)
|
||
#define POP_CONTROL_HELD_BACKWARD 1
|
||
#define POP_CONTROL_HELD_UP (-1)
|
||
#define POP_CONTROL_HELD_DOWN 1
|
||
extern int8_t control_forward, control_backward, control_up, control_down,
|
||
control_shift2;
|
||
|
||
/* Диспетчер (seg005:252) для АКТИВНОГО персонажа Char. Игрок идёт через
|
||
* pop_ctrl_tick (тот делает user_control с зеркалом «вперёд»), страж — из
|
||
* своего тика напрямую. */
|
||
void pop_control(void) __banked;
|
||
|
||
#endif
|