Files
Sprinter-SDCC/libbgi/common/atlas_load.c
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

64 lines
2.7 KiB
C

/*
* atlas_load — загрузить .atl-файл в свежую EMM-страницу (§3.1/§9в
* дизайна, вариант II: файл-офсет == офсет страницы == W0-адрес).
*
* Порядок: выделить страницу → bank_load_file() → проверить магию 'SPA1'
* → gfx_w0_page_prepare(). Никакого пересчёта офсетов: каталог и ленты
* уже лежат по своим W0-адресам.
*
* Вызывать ВНЕ рендера (W3 на время загрузки занята страницей атласа).
* Ошибки: -1 + errno (open/read/alloc; EINVAL — не .atl).
*/
#include <errno.h>
#include <sprinter_mem.h>
#include <sprite.h>
#include "../_bgi.h"
int atlas_load(atlas_t *a, const char *path)
{
uint8_t blk, ok, count, h[5];
int n;
blk = mem_alloc_pages(1);
if (!blk) return -1;
a->blk = blk;
a->page = mem_get_page(blk, 0);
n = bank_load_file(a->page, 0, path, 16384);
/* Не затирать 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;
if (ok) {
count = h[4];
gfx_w0_page_prepare(a->page);
}
/* Восстановить W3 ДО записи в *a: если atlas_t лежит в банковской
* памяти (её адрес тоже резолвится через W3), запись при ещё
* замапленной странице атласа ушла бы не в тот физический банк
* (найдено 2026-07-15 — PoP room.c держит tile_atlas[] в --bank 1,
* a->count оставался мусором, room_draw читал пиксели не с того
* оффсета). a->blk/a->page выше пишутся ДО ремапа — их это не
* касалось, только a->count. */
if (!ok) {
mem_free_block(blk);
a->page = 0;
errno = EINVAL;
return -1;
}
a->count = count;
return 0;
}