libbgi: FPS-делитель gfx_set_fps_div(n) поверх цепочки кадровых IRQ

Логический кадр = ровно n кадровых интервалов (1=50/2=25/3=~16.7 fps);
при переполнении слота — выравнивание на ближайший фронт (без дрейфа
фазы, в отличие от наивного «жди n фронтов»).

Механика: фоновый счётчик _gfx_frame_tick инкрементит _gfx_frame_isr,
поставленный в СВОЙ слот цепи (irq_chain_add); gfx_set_fps_div(1) снимает
только этот слот (irq_chain_remove), не трогая хендлер приложения.
gfx_wait_vsync: ветка n>=2 (счётчик + halt) перед лучевым поллингом;
поллинг вынесен в static gfx_wait_vsync_beam (функция с хвостовым __asm
не должна иметь переходов через asm — SDCC не эмитит эпилог-метку;
ранний return делителя в чистом-C gfx_wait_vsync).

Файлы: common/_gfx_fps_state.c (данные), _gfx_frame_isr.c (ISR),
gfx_set_fps_div.c (сеттер, единственная ссылка на irq-механику → DCE).
Работает tiny/big/huge (цепочка all-modes); small для мелких программ
= EINVAL.

Проверено MAME (tests/fpsdiv): n=1/2/3 → 20/40/60 кадров на 20 wait'ов
(drift=0); n=2 с рендер-заглушкой ~1 кадр → период держится 2
(поглощение перерасхода, наивный путь дал бы ~60); huge идентично;
small = EINVAL graceful.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-15 10:36:37 +03:00
parent 2c6f4e33c3
commit 1b4fbeaa6b
11 changed files with 290 additions and 8 deletions
+14
View File
@@ -0,0 +1,14 @@
/*
* _gfx_frame_isr — кадровый обработчик FPS-делителя (ставится в цепочку
* через irq_chain_add из gfx_set_fps_div). Правила irq.h: вызывается
* ~50 раз/с, никаких ESTEX/BIOS/gfx/банков — только инкремент счётчика.
*
* Разностная семантика ожидания в gfx_wait_vsync терпит wrap uint8,
* поэтому счётчик 8-битный (одна INC (nn) — минимальный хвост в ISR).
*/
#include "../_bgi.h"
void _gfx_frame_isr(void)
{
_gfx_frame_tick++;
}