Меню, статус-строка и оболочка игры: 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>

libbgi/_bgi.h

@@ -33,6 +33,7 @@
  * Байт _gfx_bank (0x50..0x5F): какой видеобанк мапится при записи —
  * 0x50 normal, 0x54 temp, 0x58 transparent, 0x5C оба. */
 extern uint8_t _bgi_prevmode;   /* видеорежим до initgraph */
+extern uint8_t _bgi_init_black; /* initgraph_black: не открывать EGA-палитру */
 
 /* CPU-адрес колонки 0 текущей draw-страницы: 0xC000 (page 0) или
  * 0xC140 (page 1); каждый примитив использует его вместо константы. */

libbgi/bgi256/_bgi_mode_set.c

@@ -36,7 +36,8 @@ uint8_t _bgi_mode_set(void)
     _gfx_bank = 0x50;
     gfx_set_visible_page(0);
     gfx_set_draw_page(0);
-    gfx_pal_load(0, 0, 16, _bgi_ega_pal);
+    if (!_bgi_init_black)
+        gfx_pal_load(0, 0, 16, _bgi_ega_pal);
     _bgi_maxx     = GFX_WIDTH - 1;
     _bgi_maxy     = GFX_HEIGHT - 1;
     _bgi_maxcolor = 255;

libbgi/common/_bgi_state.c

@@ -16,4 +16,5 @@ int     _bgi_maxx;
 int     _bgi_maxy;
 int     _bgi_maxcolor;
 uint8_t _bgi_prevmode;
+uint8_t _bgi_init_black;
 int     _bgi_result;

libbgi/common/atlas_load.c

@@ -26,7 +26,17 @@ int atlas_load(atlas_t *a, const char *path)
     a->page = mem_get_page(blk, 0);
 
     n = bank_load_file(a->page, 0, path, 16384);
-    if (n >= 5) bank_read(a->page, 0, h, sizeof(h));
+    /* Не затирать errno от open/read: вызывающему важно отличить отсутствие
+     * файла или короткое чтение от файла, который действительно не .atl.
+     * Раньше оба случая проваливались в EINVAL ниже, что маскировало
+     * фактическую причину сбоя загрузки экранных полос. */
+    if (n < (int)sizeof(h)) {
+        mem_free_block(blk);
+        a->page = 0;
+        if (n >= 0) errno = EREAD;
+        return -1;
+    }
+    bank_read(a->page, 0, h, sizeof(h));
     ok = (n >= (int)_ATL_DATA_OFF &&
           h[0] == 'S' && h[1] == 'P' && h[2] == 'A' && h[3] == '1');
     count = 0;

libbgi/common/initgraph.c

@@ -10,6 +10,9 @@
 void initgraph(void)
 {
     _bgi_prevmode = _bgi_mode_set();
+    /* Флаг одноразовый: обычный следующий initgraph обязан снова получить
+     * стандартную EGA-палитру, даже если этот вход был «чёрным». */
+    _bgi_init_black = 0;
     _bgi_fg     = WHITE;
     _bgi_bg     = BLACK;
     _bgi_cx     = 0;

libbgi/common/initgraph_black.c

@@ -0,0 +1,27 @@
+/*
+ * initgraph_black — войти в графику, не открывая стандартную палитру.
+ *
+ * Нужен программам с собственным fade-in: палитру можно заранее погасить
+ * ещё в текстовом режиме, а SETVMOD тогда не осветит сохранённую VRAM
+ * промежуточной EGA-палитрой. ABI совпадает с initgraph: аргументов нет.
+ */
+
+#include "../_bgi.h"
+
+void initgraph_black(void)
+{
+    /* Очистить обе графические VRAM-страницы ЕЩЁ В ТЕКСТОВОМ РЕЖИМЕ.
+     * SETVMOD переключает video descriptors раньше, чем вызывающий успеет
+     * выполнить следующую C-инструкцию; одна только чёрная palette не
+     * спасает, если прошивка при переключении кратко выбирает старую.
+     * Окна 0x50/0xC000 доступны независимо от текущего режима экрана. */
+    gfx_set_bank(GFX_BANK_NORMAL);
+    setfillstyle(SOLID_FILL, BLACK);
+    gfx_set_draw_page(0);
+    bar(0, 0, GFX_WIDTH - 1, GFX_HEIGHT - 1);
+    gfx_set_draw_page(1);
+    bar(0, 0, GFX_WIDTH - 1, GFX_HEIGHT - 1);
+
+    _bgi_init_black = 1;
+    initgraph();
+}

libbgi/include/graphics.h

@@ -63,6 +63,10 @@ extern uint8_t _bgi_fill_pattern, _bgi_fill_color;
  * позиция = (0,0).  Предыдущий видеорежим запоминается для closegraph. */
 void initgraph(void);
 
+/* То же состояние BGI, но без загрузки EGA-палитры; перед SETVMOD очищает
+ * обе графические VRAM-страницы для чистого собственного fade-in. */
+void initgraph_black(void);
+
 /* Вернуться в текстовый режим, действовавший до initgraph(). */
 void closegraph(void);