Files
Sprinter-SDCC/applications/PoP/roomtest/pop_sfx.h
T
snark13 a630568a8b Звук PoP: приоритеты и перебиваемость вместо «всегда перебивать»
Пользователь услышал расхождение с SDLPoP: у нас решётка обрывалась
приземлением Кида, в оригинале доигрывает до конца, а приземления не
слышно.  Оказалось, упущен целый механизм.

play_sound (seg000:12C5) НЕ играет, а только номинирует кандидата на
кадр — из нескольких выживает важнейший (меньше prio = важнее, при
равенстве последний).  play_next_sound (seg000:1304) раз в кадр решает,
запускать ли: можно, только если ничего не играет ЛИБО текущий помечен
перебиваемым и новый не менее важен.  Иначе номинант выбрасывается —
очереди в оригинале нет.

Отсюда всё, что слышно: gate_closing_fast неперебиваем и доигрывает
целиком; челюсти (prio 0x10) всегда важнее решётки (0x32), поэтому
решётка звучит только в паузах между укусами.

Таблицы из SDLPoP с учётом fix_sound_priorities (в его config.h он
определён безусловно).  Створка двери уровня — единственная запись,
правимая на ходу, вынесена в отдельный байт.  Добавлен пропущенный
stop_sounds на завершении открытия двери (seg007:455).

Проверено записью MAME: старт уровня 1 был 135+210 мс (решётка, обрезанная
на 80 мс), стал один всплеск 455 мс с корреляцией огибающей +0,889 со
звуком 6.

Заведён BUG-SND-FIRSTRUN: искажение первого эффекта при первом запуске
после загрузки системы — вероятно, лечится _cbl_prime, но проверить можно
только на железе.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-20 16:46:04 +03:00

77 lines
4.9 KiB
C

/*
* pop_sfx.h — звуковые ЭФФЕКТЫ PoP через COVOX-Blaster.
*
* Данные — оригинальная оцифровка игры (`digisnd1..3.dat`), приведённая
* упаковщиком к 10 937,5 Гц. Конвертировать в рантайме нечего: у PoP
* сэмплы 8 бит БЕЗЗНАКОВЫЕ МОНО, и это ровно формат CBL (см. <cbl.h> и
* ../docs/sound_plan.md).
*
* ОДИН ГОЛОС. Оригинал тоже одноголосый: `play_sound` глушит
* предыдущий звук (`stop_sounds`, seg009.c), поэтому новый эффект просто
* перебивает играющий, и никакого микшера не нужно.
*
* ПОЧЕМУ ЭТО НЕ ЛОМАЕТ КАДР. Насос живёт в прерывании CBL и отдаёт 128
* байт раз в ~11,7 мс. Кадровые прерывания при этом теряются (ветка CBL
* в трамплине делает приватный RETI), но нам всё равно: темп кадра
* считается ПО ЛУЧУ (pop_pace.h), а не по прерываниям. Если бы пейсинг
* остался на них — звук сломал бы игру.
*/
#ifndef POP_SFX_H
#define POP_SFX_H
#include <stdint.h>
/* Поднять набор: занять 8 EMM-страниц и вычитать в них данные. ВЫВОД НЕ
* ВКЛЮЧАЕТ — см. pop_sfx_start. 0 — OK, -1 — не получилось (тогда всё
* дальнейшее молча ничего не делает, игра идёт без звука). */
int pop_sfx_init(void) __banked;
/* Включить вывод (открыть CBL). Звать ПОСЛЕ всей загрузки: пока идёт
* чтение файлов, ESTEX уходит в диск надолго, насос не успевает долить
* блок, и железо крутит хвост своего буфера — на слух сплошной скрежет.
* Идемпотентно. */
int pop_sfx_start(void) __banked;
/* Заглушить вывод на время загрузки (закрывает CBL). Парная к start. */
void pop_sfx_pause(void) __banked;
/* Закрыть CBL и отпустить страницы; звать на выходе. */
void pop_sfx_close(void) __banked;
/* Вкл/выкл звук по воле пользователя (Ctrl+S, порт SDLPoP seg000:657).
* Правит pop_snd_want и приводит вывод в соответствие. */
void pop_sfx_toggle(void) __banked;
/* ХОЧЕТ ЛИ ЗВУКА ПОЛЬЗОВАТЕЛЬ. Не то же самое, что «CBL открыт»: вывод
* ещё гасит служебная пауза на время загрузки уровня. Читать для
* индикации; писать — только через pop_sfx_toggle. 0 и в случае, когда
* набор вообще не поднялся (нет файлов, нет страниц) — то есть флаг
* честно means «звука не будет». */
extern uint8_t pop_snd_want;
/* Заявить эффект с номером id (0..56 — нумерация оригинала, см.
* sound_plan.md). НЕ запускает его немедленно и НЕ перебивает играющий:
* это порт play_sound (seg000:12C5), который лишь НОМИНИРУЕТ кандидата на
* текущий кадр. Из нескольких заявок за кадр выживает важнейшая, а решение
* «запускать или нет» принимает pop_sfx_tick. Звуки без оцифровки (музыка)
* игнорируются.
*
* НЕ банковая и НЕ __banked: зовётся из горячих мест (play_seq в
* pop_kid.c, физика, боёвка), и трамплин на каждый шаг Кида не нужен. */
void pop_sfx_play(uint8_t id);
/* Раз в кадр: запустить номинанта, если можно (порт play_next_sound,
* seg000:1304). Оригинал зовёт его в конце отрисовки кадра — зовём там же.
* Не запустили — номинант ВЫБРАСЫВАЕТСЯ, очереди у оригинала нет. */
void pop_sfx_tick(void);
/* Перебиваемость съезжающей створки двери уровня (звук 15) — единственная
* запись таблицы, которую оригинал правит на ходу (seg007:442/464):
* 1 при закрытии двери, 0 при открытии. */
extern uint8_t pop_sfx_slide_intr;
/* Оборвать текущий эффект (порт stop_sounds). */
void pop_sfx_stop(void);
#endif