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
+22 -2
View File
@@ -83,6 +83,11 @@ static const char * const status_text[POP_MSG_N] = {
};
uint8_t pop_status_msg; /* заявка (пишут откуда угодно) */
/* Постоянный показ таймера (клавиша T, keys.txt). Отдельно от
* pop_settings.show_debug_bar: полоса — это отладка, а таймер игрок может
* захотеть держать перед глазами. В POP.CFG не пишется намеренно — это
* переключатель «на посмотреть», а не настройка. */
uint8_t pop_show_timer;
uint8_t pop_status_ticks; /* сколько кадров ещё висит; читает HP */
static uint8_t st_shown; /* что реально нарисовано */
static uint8_t st_dirty; /* бит на страницу дабл-буфера */
@@ -152,7 +157,7 @@ static uint8_t dbg_lvl, dbg_room, dbg_spd, dbg_snd, dbg_mus, dbg_imm;
static uint8_t dbg_tmin, dbg_tsec; /* показанное время ##:## */
static uint8_t dbg_phase; /* кадры до пересчёта секунд */
static uint8_t dbg_dirty[2]; /* маска по странице; DBG_F_ALL => и подписи */
static uint8_t dbg_on; /* показанное состояние тумблера Settings */
static uint8_t dbg_on; /* показанный РЕЖИМ полосы: 0 нет / 1 таймер / 2 всё */
/* ---- общее ------------------------------------------------------------- */
@@ -530,7 +535,11 @@ void pop_status_invalidate(void) __banked
void pop_status_frame(uint8_t room) __banked
{
uint8_t page, bit, saved;
uint8_t want = pop_settings.show_debug_bar;
/* Три состояния верхней полосы: 0 — нет, 1 — только таймер (T), 2 —
* вся отладочная строка (Ctrl+D). Отслеживаем именно РЕЖИМ, а не
* булево: переход «таймер -> полоса» тоже обязан перерисовать всё. */
uint8_t want = (uint8_t)(pop_settings.show_debug_bar ? 2 :
(pop_show_timer ? 1 : 0));
if (!pop_ui_ready()) return;
page = (uint8_t)(gfx_get_draw_page() & 1);
@@ -573,6 +582,17 @@ void pop_status_frame(uint8_t room) __banked
wipe(DBG_LEFT, DBG_TOP, DBG_RIGHT, DBG_BOTTOM);
dbg_dirty[page] = 0;
}
} else if (want == 1) {
/* Только таймер: подписей нет, поле рисуется на своём месте у
* правого края — dbg_value стирает свою зону сам. Полную маску
* сюда пропускать нельзя, иначе dbg_draw позовёт dbg_labels. */
dbg_scan(room);
if (dbg_dirty[page] & DBG_F_TIME) {
if (dbg_dirty[page] == DBG_F_ALL)
wipe(DBG_LEFT, DBG_TOP, DBG_RIGHT, DBG_BOTTOM);
dbg_draw(DBG_F_TIME);
}
dbg_dirty[page] = 0;
} else {
dbg_scan(room);
if (dbg_dirty[page]) {