libbgi: выделить графику BGI в отдельную библиотеку + тест спрайтов

Графика вынесена из libc/ в новую библиотеку libbgi/:
  - common/  — mode-agnostic математика и состояние (один исходник,
    .rel попадает в оба driver-архива);
  - bgi256/ + bgi16/ — mode-specific leaf'ы (raw-плот/чтение/спаны);
  - include/ — graphics.h + gfx.h; _bgi.h — внутренний заголовок.
Собираются lib/bgi256.lib (и bgi16.lib в Фазе 2); выбор режима
линковкой через sprinter-cc --gfx 256|16.  libc/ теперь без графики.

tests/bgi_img — тест спрайтов getimage/putimage/imagesize (5 операций
COPY/XOR/OR/AND/NOT + XOR-round-trip + self-check imagesize).
Проверен автотестом в MAME.

Примечание: make size-check пока красный (gfx_dbuf/gfx_demo выросли
после реорга) — закрыть по завершении миграции libbgi.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-09 14:18:33 +03:00
parent 3bf50f7ff7
commit 52636a5d6e
164 changed files with 1072 additions and 1440 deletions
+22 -11
View File
@@ -180,7 +180,13 @@ wrchar rdchar`; режимы `gettextmode/settextmode` (0x02=40×32,
`bios_fillchar/fillattr/fillcharattr`, `bios_clearwin[_ch]`,
`bios_scrollwin`. Строка s — в #4000#BFFF; place продвигается.
## <gfx.h> — графика (0x81: 320×256×256; 0x82: 640×256×16)
## <gfx.h> — графика, mode-agnostic API (BGI_GFX); живёт в libbgi/include
Рисование (putpixel/line/bar/circle/…) вынесено в BGI — см. `<graphics.h>`
и driver-библиотеки lib/bgi256.lib / lib/bgi16.lib (выбор режима линковкой:
`sprinter-cc --gfx 256` / `--gfx 16`). В gfx.h остались только функции
БЕЗ BGI-аналога (mode-agnostic, живут в libbgi/common/, .rel в обеих
driver-библиотеках):
Setup: `gfx_init(mode,page)→prev`, `gfx_done(prev)`.
Страницы/банк: `gfx_set/get_visible_page`, `gfx_set/get_draw_page`
@@ -199,14 +205,13 @@ Setup: `gfx_init(mode,page)→prev`, `gfx_done(prev)`.
использования с реальным CBL-звуком. Фолбэк на одно кадровое
прерывание (`halt`), если бит не ведёт себя как ожидается за разумное
число попыток.
Примитивы (суффикс _256 / _16): `clear putpixel hline vline line
rect fill_rect` — через акселератор (hline/vline burst до 256 байт;
в 0x82 vline через RMW). Координаты int, клиппинг по краям.
Текст: `gfx_putchar256/16, gfx_text256/16` (8×8, fg/bg; в 0x82 x —
чётный), `gfx_load_default_font`, `gfx_set_font(ptr)` (interleaved
font[row*256+char]).
Шрифт: `gfx_load_default_font`, `gfx_set_font(ptr)` (interleaved
font[row*256+char]) — грузится лениво при первом использовании BGI-текста.
Палитра: `gfx_pal_load/set/get/get_color/reset` (страницы 0..3).
`gfx_getpixel256(x,y)→color` — чтение пикселя (0x81).
Константы режимов: `GFX_MODE_320x256x256` (0x81), `GFX_MODE_640x256x16`
(0x82); размеры `GFX_WIDTH/HEIGHT` (320/256), `GFX_WIDTH_16/HEIGHT_16`
(640/256). Рисование через `<graphics.h>` (BGI).
## <graphics.h> — Turbo-C BGI (функц. совместимость), Фаза 1, режим 256
@@ -237,9 +242,15 @@ drawpoly.
Стиль текста (Ф2d): `settextstyle(font,dir,size)`/`gettextsettings`,
`textwidth`/`textheight` — масштаб 1..10, HORIZ/VERT, прозрачный фон
(только DEFAULT_FONT 8×8).
Реализация: libc/bgi/*.c (math) + libc/bgi/drv256/*.c (leaf →
sprinter_gfx256.lib). Пакетные примитивы — одна W3-скобка на примитив;
тригонометрия/эллипсы целочисленные (Q7/isqrt, БЕЗ 32-бит).
Реализация: libbgi/common/*.c (mode-agnostic math + BGI public API +
BGI_GFX) + libbgi/bgi256/*.c (256-цветные leaf'ы) → lib/bgi256.lib
(Фаза 2 добавит libbgi/bgi16/*.c → lib/bgi16.lib; common .rel одни и
те же в обоих архивах). Leaf'ы — реальные реализации (БЕЗ обёрток:
putpixel/getpixel полностью inline, _bgi_plot_raw/_bgi_hspan_raw/...
поглощают акселераторный asm). Пакетные примитивы — одна W3-скобка
на примитив; тригонометрия/эллипсы целочисленные (Q7/isqrt, БЕЗ 32-бит).
Cross-lib: libbgi всегда линкуется с libc; _cbl_port_ref/unref
объявлены extern в libbgi/_bgi.h (сверять с libc/cbl/_cbl.h).
Ф2d (осталось): setviewport/клиппинг, settextjustify, setaspectratio —
см. docs/TODO.md.