Files
Sprinter-SDCC/applications/PoP/roomtest/pop_timer.h
T
snark13 47a4b084c4 Меню, статус-строка и оболочка игры: title/intro/cutscene/HoF, POP.CFG, палитры
Эта сессия (меню + текст в служебных полосах):

* Меню: рамка выделения считается от силуэта текста (SEL_PAD сверху и
  снизу), а не «на глаз»; все экраны центрируются в игровых 200 строках
  (UI_CENTER_TOP/UI_CENTER_FIELD) и в них помещаются; Enter и Space —
  равноправные клавиши действия (ui_action_down).
* Settings: убраны SHOW SPRINTER SCREEN и BACK, добавлены DEBUG BAR и
  ABOUT.  About показывает тот же текст, что стартовый Sprinter screen,
  минус строка про клавиши — общий about_text(), чтобы экраны не
  разъехались.  CONTROLS собирается таблицей и центрируется по
  фактическому числу строк.
* GAME PAUSED переехала в нижнюю статус-строку, как в оригинале
  (SDLPoP rect_bottom_text = {193,70,202,250}): это состояние программы,
  а не пункт меню.  POP_HP_Y вынесен в pop_cdraw.h — полосу делят два
  модуля.
* pop_status.c (банк 9) — текст в обеих служебных полосах.  Нижняя:
  порт display_text_bottom + таймера (QUICKSAVE/QUICKLOAD/SOUND ON/OFF,
  24 тика).  Верхняя отладочная переведена с палочек на текст
  «Level ##, Room ##, Speed: …, Sound: …, Immortal #» малым шрифтом, с
  своим форматированием чисел (без printf и без деления).
  Заявка сообщения — запись одного байта pop_status_msg: резидент W1/W2
  не растёт, весь рендер в банке.  Бюджет после правок не изменился
  (_CODE 23981, куча 267 Б).
* Цена вывода: блит глифа ~4,6 тыс. тактов независимо от размера, поэтому
  всё change-driven, отладочная строка перерисовывается ПО ПОЛЯМ, пробелы
  не блитятся вовсе, а вход в комнату заливает только игровое поле
  (pop_screen_fill_field) — борта от комнаты к комнате не меняются.
* Интро: в PV-сцене зазвучали пропавшие эффекты оригинала — закрытие
  ворот (4) и открытие двери покоев (51), из которой входит Джафар.
* docs/status_line_text.md — полная инвентаризация ВСЕХ текстов SDLPoP в
  статус-строке: геометрия, семантика text_time_total как идентификатора
  сообщения, мигание, рестарт по истечении 36/288.

Вместе с этим выкладывается накопленная работа по оболочке полной игры:
автомат состояний (pop_app), title, intro/PV и cutscene, attract-demo,
Hall of Fame, глобальный таймер, настройки и POP.CFG, модуль палитр и
fade, звуковой набор, host-тесты на новые швы.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-25 13:58:36 +03:00

45 lines
2.6 KiB
C

/*
* pop_timer.h — глобальный игровой таймер (FG4, банк 9).
*
* Время измеряется логическими кадрами SDLPoP: 720 тиков = одна минута.
* Модуль намеренно не знает ни о клавиатуре, ни о графике, ни о состоянии
* Settings: вызывающий передаёт, разрешён ли лимит и можно ли времени идти.
* Благодаря этому тот же код проверяется host-тестом без DSS/MAME.
*/
#ifndef POP_TIMER_H
#define POP_TIMER_H
#include <stdint.h>
#include "pop_qsave.h"
#define POP_TIMER_START_MINUTES 60
#define POP_TIMER_TICKS_PER_MINUTE 720
#define POP_TIMER_START_TICKS (POP_TIMER_TICKS_PER_MINUTE - 1)
/* Оставшееся время. ticks всегда 1..719 вне короткого участка timer_tick.
* Нуль minutes означает естественное истечение; выключенный в Settings
* лимит состояние не меняет, а просто останавливает отсчёт. */
extern uint8_t pop_timer_minutes;
extern uint16_t pop_timer_ticks;
/* Начать новую игру: ровно исходные 60:00 SDLPoP (60 минут, tick 719). */
void pop_timer_new_game(void) __banked;
/* Один логический игровой кадр. enabled — переключатель Settings,
* may_run — правила текущей сцены/уровня. Возвращает 1 ОДИН раз, когда
* отсчёт дошёл до нуля; на паузе, HDD/QuickSave и при выключенном лимите
* вызывать можно — состояние останется неизменным. */
uint8_t pop_timer_tick(uint8_t enabled, uint8_t may_run) __banked;
/* Читы, повторяющие +/- SDLPoP: минус не даёт искусственно поставить 0,
* плюс добавляет минуту. Они меняют счётчик и при выключенном лимите —
* после включения пользователь продолжит именно это подготовленное время. */
void pop_timer_cheat_subtract(void) __banked;
void pop_timer_cheat_add(void) __banked;
/* Состояние входит в payload QuickSave. Неверный tick помечает поток
* ошибочным, не подменяя живой таймер частично. */
void pop_timer_qsave(pop_qs_io_t *io) __banked;
#endif /* POP_TIMER_H */