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>

docs/libc-headers.md

@@ -32,9 +32,15 @@ SDCC-версию) и дальше только добавляет Sprinter-ра
 
 ## 3. Свои заголовки (SDCC-аналога нет — затенения нет)
 
-conio.h, dir.h, dos.h, errno.h, fcntl.h, gfx.h, mouse.h, palette.h,
+conio.h, dir.h, dos.h, errno.h, fcntl.h, mouse.h, palette.h,
 sprinter*.h, unistd.h, bios/*.
 
+Графика вынесена из libc в отдельную библиотеку libbgi/: её публичные
+заголовки gfx.h (mode-agnostic BGI_GFX) и graphics.h (BGI API) живут в
+libbgi/include/ и пробрасываются через -I libbgi/include (sprinter-cc
+добавляет его автоматически).  Внутренний заголовок графики —
+libbgi/_bgi.h (слияние старых libc/gfx/_gfx.h и libc/bgi/_bgi.h).
+
 ## Правила
 
 - новый стандартный заголовок — сначала пробовать паттерн 1
@@ -42,5 +48,7 @@ sprinter*.h, unistd.h, bios/*.
   реализацию (как puts/putchar на ESTEX);
 - в заголовках паттерна 2 — комментарий, какие декларации обслуживают
   z80.lib;
-- internal-заголовки libc (`_conio.h`, `_file.h`, `_gfx.h`, …) живут
-  РЯДОМ с исходниками в libc/<area>/, не в libc/include.
+- internal-заголовки libc (`_conio.h`, `_file.h`, …) живут
+  РЯДОМ с исходниками в libc/<area>/, не в libc/include.  Internal
+  графики — в libbgi/_bgi.h (корень libbgi/, подключается из common/ и
+  bgi256/bgi16/ как `#include "../_bgi.h"`).

docs/libc-reference.md

@@ -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.
 

docs/libc-roadmap.md

@@ -75,7 +75,7 @@ fgetpos/fsetpos (хвост П2).  bdos/brk/ioctl — отказ решение
       (stdio.h, time.h — обязаны дублировать сигнатуры z80.lib);
       из sprinter_compat.h убраны макросы min/max (конфликтовали с
       функциями из stdlib.h; в Solid-C это тоже функции)
-- [x] lib/Makefile: stale .rel чистятся сверкой списка перед упаковкой;
+- [x] libc/Makefile: stale .rel чистятся сверкой списка перед упаковкой;
       штамп .modules триггерит перелинковку при смене состава (и сносит
       архив — mtime на exFAT грубый)
 - [x] Все extra-тесты в top-level TESTS (43 программы: + hello2, simple,

docs/size_baseline.tsv

@@ -6,6 +6,7 @@ banked	1056
 bankedbg	1067
 banklocl	4832
 banktest	3767
+bgi_img	6218
 bgitest	4196
 bios_text	4470
 cat	915