SprPoP: раскладка управления — фазы A и B плана keys_plan.md

Приводим клавиши к keys.txt (раскладка SDLPoP).  Работа делится надвое, и
здесь только то, что не трогает игровую логику: переназначения (A) и три
мелкие функции поверх готовых механизмов (B).  Читы, требующие правки
логики, и осмотр соседних комнат — фазы C и D, отложены.

ПЕРЕНАЗНАЧЕНИЯ (A)

  U            -> Shift+I   переворот экрана; U отдан «комнате сверху»
  Esc          -> Backspace меню; Esc остаётся дублёром, как у SDLPoP
  F7 / F8      -> - / +     ±минута, основной ряд и цифровой блок
  - / +        -> Ctrl+- / Ctrl++  обход комнат (наш отладочный телепорт)
  I            -> Ctrl+I    бессмертие
  P            -> Ctrl+P    режим скорости
  1 и 2        -> Ctrl+F    стоп-кадр, теперь одной клавишей
  F10 в игре   -> Ctrl+Q    вторая клавиша выхода; F10 ловится глобально

Плюс новое на готовых путях: Ctrl+A — рестарт уровня, Ctrl+V — версия
сборки (функция была, её показывал только старт), Ctrl+D — отладочная
строка (тот же тумблер, что в Settings; POP.CFG не пишем), Home / Page Up —
дублёры диагональных прыжков (у SDLPoP это не отдельное действие, а те же
Up+Left / Up+Right, поэтому просто добавляются к стрелкам).

Все наши сверхштатные клавиши ушли под Ctrl, чтобы не занимать голые буквы
из раскладки, и вписаны в keys.txt отдельным разделом.  Ctrl+B намеренно
не занята: keys.txt держит её под «вернуться в комнату Кида» (фаза D).

ФУНКЦИИ (B)

  Space  «сколько осталось» (seg000:612).  Не печатает сама: поднимает тот
         же pop_show_time, которым пользуется автоматическое объявление
         минут, и строку собирает time_msg() — «59 MINUTES LEFT» и «11
         SECONDS LEFT» остаются в одном месте.
  T      постоянный показ таймера.  Переиспользует поле DBG_F_TIME
         отладочной строки, своего рендера нет.  У верхней полосы теперь
         три состояния, и отслеживается РЕЖИМ (0 нет / 1 таймер / 2 всё),
         а не флаг: переход «таймер -> полоса» тоже перерисовывает всё.
  Ctrl+R возврат в заставку — тот же переход, что «Restart Game» в меню.

ДВЕ ЛОВУШКИ, найденные по дороге

  Модификатор обязан входить в САМО значение, а не в условие блока: с
  `if (ctrl) { nav = ...; nav_prev = nav; }` при отпускании Ctrl кромка
  застревала ненулевой и следующее нажатие глохло.

  Один скан-код на два чита: Shift+I и Ctrl+I — это 0x43 в обоих случаях.
  По той же причине ±минута требует ОТПУЩЕННОГО Ctrl (иначе сработает и
  время, и обход комнат), а T — отпущенных Shift и Ctrl (Shift+T отдан
  «добавить HP» в фазе C).

Обработчики положены в pop_frame_ui (банк 8), а не в резидент: там куча
всего 308 байт.  Проверено в MAME: Ctrl+D поднимает строку
«Level 1, Room 1, Speed: NORMAL...», T — один таймер 59:30 без подписей,
Space — watchpoint на pop_show_time ловит запись значения 2 (именно
обработчик клавиши, автообъявление пишет 1).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-27 15:22:21 +03:00
parent c71981fdf9
commit 76f02e76db
10 changed files with 376 additions and 39 deletions
+46 -10
View File
@@ -250,6 +250,8 @@ int main(void)
uint16_t dead_frames = 0;
#ifdef ROOMNAV
uint8_t nav_prev = 0;
uint8_t freeze_prev = 0;
uint8_t dbgbar_prev = 0;
#endif
uint8_t cheat_prev = 0, immo_prev = 0, sword_prev = 0, nlvl_prev = 0;
uint8_t xdec_prev = 0, xinc_prev = 0, upsd_prev = 0;
@@ -396,7 +398,9 @@ int main(void)
* NORMAL). Edge, чтоб одно нажатие = один шаг. Дефолт FASTEST
* (crt0 зануляет _DATA). Что означают режимы — pop_pace.h. */
if (!is_demo) {
uint8_t pk = kbd_raw_down(KBD_SPEED_MODE);
uint8_t pk = (uint8_t)(kbd_raw_down(KBD_SPEED_MODE) &&
(kbd_raw_down(KBD_LCTRL) ||
kbd_raw_down(KBD_RCTRL)));
if (pk && !pace_prev) {
uint8_t m = (uint8_t)(pop_speed_mode + 1);
pop_speed_mode = (uint8_t)(m >= POP_SPEED_MODES ? 0 : m);
@@ -405,12 +409,34 @@ int main(void)
pace_prev = pk;
}
/* Отладочный стоп-кадр: '1' (PS/2 0x16) — заморозить, '2' (0x1E) —
* продолжить. В заморозке пропускаем весь tick/draw/flip: картинка
* стоит, можно спокойно разбирать позу Kid и окклюзию. */
/* Отладочный стоп-кадр: Ctrl+F — вкл/выкл ОДНОЙ клавишей. Раньше
* занимал две голые цифры ('1' заморозить, '2' продолжить); голые
* клавиши освобождены под раскладку keys.txt. В заморозке
* пропускаем весь tick/draw/flip: картинка стоит, можно спокойно
* разбирать позу Kid и окклюзию. */
if (!is_demo) {
if (kbd_raw_down(0x16)) frozen = 1;
if (kbd_raw_down(0x1E)) frozen = 0;
uint8_t fk = (uint8_t)(kbd_raw_down(KBD_KEY_F) &&
(kbd_raw_down(KBD_LCTRL) ||
kbd_raw_down(KBD_RCTRL)));
if (fk && !freeze_prev) frozen = (uint8_t)!frozen;
freeze_prev = fk;
}
/* Ctrl+D — отладочная строка (level/room/...) в верхнем борте. Тот
* же переключатель, что пунктом Settings: пишем прямо в модель
* настроек, а строку по ней перерисовывает pop_status сам. В
* POP.CFG не сохраняем — это шорткат «посмотреть», сохранение
* остаётся за экраном Settings.
*
* На Ctrl+B вешать нельзя: keys.txt держит эту комбинацию под
* «вернуться в комнату Кида» (фаза D плана keys_plan.md). */
if (!is_demo) {
uint8_t dk = (uint8_t)(kbd_raw_down(KBD_KEY_D) &&
(kbd_raw_down(KBD_LCTRL) ||
kbd_raw_down(KBD_RCTRL)));
if (dk && !dbgbar_prev) pop_settings.show_debug_bar ^= 1;
dbgbar_prev = dk;
}
/* Читы — В БАНКЕ (sprpop_cold.c): они дёргаются раз в кадр, а места
* в резиденте W1/W2 нет (см. TASKS_OPEN, MEM). */
@@ -446,13 +472,23 @@ int main(void)
}
#ifdef ROOMNAV
/* Обход комнат по номеру: '+' (0x79 numpad / 0x55 '=') — вперёд,
* '-' (0x7B / 0x4E) — назад. Edge по nav_prev: одно нажатие = одна
/* Обход комнат по номеру: Ctrl++ — вперёд, Ctrl+− — назад. Голые
* +/- отданы времени, как в оригинале (keys.txt); обход — наш
* отладочный чит, поэтому уехал под Ctrl на ТЕ ЖЕ клавиши: мышечная
* память сохраняется. Edge по nav_prev: одно нажатие = одна
* комната. Сама навигация — в банке (sprpop_cold.c): она нужна
* только по клавише, а место в резиденте дефицитно. */
if (!is_demo) {
uint8_t nav = (uint8_t)((kbd_raw_down(0x79) || kbd_raw_down(0x55)) |
((kbd_raw_down(0x7B) || kbd_raw_down(0x4E)) << 1));
/* Ctrl входит в САМО значение nav, а не в условие блока: иначе
* при отпускании Ctrl блок не выполнялся бы, nav_prev застревал
* ненулевым и следующее нажатие глохло на кромке. */
uint8_t ctrl = (uint8_t)(kbd_raw_down(KBD_LCTRL) ||
kbd_raw_down(KBD_RCTRL));
uint8_t nav = !ctrl ? 0 :
(uint8_t)((kbd_raw_down(KBD_TIME_ADD_NUM) ||
kbd_raw_down(KBD_TIME_ADD_MAIN)) |
((kbd_raw_down(KBD_TIME_SUB_NUM) ||
kbd_raw_down(KBD_TIME_SUB_MAIN)) << 1));
if (nav && !nav_prev && pop_dbg_roomnav((uint8_t)(nav & 1 ? 1 : 2)))
dead_frames = 0;
nav_prev = nav;