libc: graphics.h — Turbo-C BGI-слой, Фаза 1 (режим 256)

Функционально-совместимый с Turbo-C <graphics.h> поверх gfx.h.
Архитектура: mode-agnostic математика (libc/bgi/*.c → sprinter.lib) +
driver-leaf'ы per-режим (libc/bgi/drv256/*.c → sprinter_gfx256.lib).
Режим выбирается линковкой: sprinter-cc --gfx 256 (16 — позже, тем же
leaf-split'ом). Один код работает в любом режиме без правок.

API: initgraph/closegraph/graphresult/cleardevice, set/get color+bkcolor,
getmaxx/y/color, put/getpixel, moveto/moverel/getx/gety, line/lineto/
linerel, rectangle, bar, circle, outtext/outtextxy. initgraph грузит
EGA-палитру 0..15. Пакетные примитивы (circle) — одна W3-скобка на
примитив (иначе на порядок медленнее). Проверено в MAME (tests/bgitest).

Попутно: gfx_getpixel256 в libc/gfx. size-check без регресса, baseline
обновлён. Детали: memory/bgi_two_lib_design, docs/TODO.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/TODO.md

@@ -24,14 +24,27 @@ first-fit-decreasing, уважение `#pragma codeseg BANKn`, перелинк
 
 ## ОБЯЗАТЕЛЬНОЕ ДЛЯ V2
 
-### Turbo-C-style graphics API (BGI-like)
+### Turbo-C-style graphics API (BGI-like) — Фаза 1 ГОТОВА (256, 2026-07-08)
 
-Расширить `gfx_*` до уровня Turbo-C `<graphics.h>`: initgraph/
-closegraph/cleardevice-алиасы, current point (moveto/lineto/linerel),
-setcolor/setbkcolor, getpixel, circle/arc/ellipse/pieslice, drawpoly/
-fillpoly, floodfill, bar/bar3d, outtext[xy]/settextstyle/textwidth,
-imagesize/getimage/putimage (COPY/XOR/AND/OR/NOT_PUT), setviewport/
-клиппинг, setactivepage/setvisualpage (2 страницы есть), setlinestyle.
+Архитектура: `graphics.h` — mode-agnostic слой (libc/bgi/*.c в
+sprinter.lib), режим задаёт driver-архив; выбор линковкой через
+`sprinter-cc --gfx 256` (16 — позже, тем же leaf-split'ом; см.
+memory/bgi_two_lib_design).
+
+**Фаза 1 (256, реализовано и проверено в MAME — tests/bgitest):**
+initgraph/closegraph/graphresult/cleardevice, setcolor/getcolor/
+setbkcolor/getbkcolor, getmaxx/getmaxy/getmaxcolor, putpixel/getpixel,
+moveto/moverel/getx/gety, line/lineto/linerel, rectangle, bar, circle,
+outtext/outtextxy.  initgraph грузит EGA-палитру 0..15.  Пакетные
+примитивы (circle) — одна W3-скобка на весь примитив (raw-плот), иначе
+на порядок медленнее.
+
+**Фаза 2 (осталось):** ellipse/arc/pieslice, drawpoly/fillpoly,
+floodfill, setfillstyle/паттерны, bar3d, settextstyle/textwidth/
+textheight (размеры/направление), imagesize/getimage/putimage
+(COPY/XOR/AND/OR/NOT_PUT), setviewport/клиппинг, setactivepage/
+setvisualpage (2 страницы есть), setlinestyle, setaspectratio
+(пиксели 320×256 неквадратные — окружности визуально эллиптичны).
 Acceptance: типичная BGI-программа переносится без существенных
 правок.  Референс: Turbo C 2.x BGIDEMO.
 

docs/libc-reference.md

@@ -206,6 +206,27 @@ rect fill_rect` — через акселератор (hline/vline burst до 25
 чётный), `gfx_load_default_font`, `gfx_set_font(ptr)` (interleaved
 font[row*256+char]).
 Палитра: `gfx_pal_load/set/get/get_color/reset` (страницы 0..3).
+`gfx_getpixel256(x,y)→color` — чтение пикселя (0x81).
+
+## <graphics.h> — Turbo-C BGI (функц. совместимость), Фаза 1, режим 256
+
+Слой поверх `<gfx.h>` со «текущим» цветом/позицией.  Режим задаётся
+driver-либой на линковке: `sprinter-cc --gfx 256` (→ 320×256×256; 16 —
+позже).  API mode-agnostic: код не меняется при смене режима.
+Setup: `initgraph()` (без аргументов — режим фиксирован либой; грузит
+EGA-палитру 0..15, цвет=WHITE, фон=BLACK, CP=(0,0)),
+`closegraph()`, `graphresult()`, `cleardevice()`.
+Границы/цвет: `getmaxx/getmaxy` (319/255), `getmaxcolor` (255),
+`setcolor/getcolor`, `setbkcolor/getbkcolor`.  Константы BLACK..WHITE.
+Точки: `putpixel(x,y,c)`, `getpixel(x,y)`.
+Позиция/линии: `moveto/moverel/getx/gety`, `lineto/linerel` (двигают
+CP), `line(x1,y1,x2,y2)` (не двигает).
+Фигуры: `rectangle` (контур), `bar` (заливка тек. цветом — паттерны в
+Ф2), `circle`.  Текст 8×8: `outtextxy(x,y,s)`, `outtext(s)` (двигает CP).
+Реализация: libc/bgi/*.c (math) + libc/bgi/drv256/*.c (leaf →
+sprinter_gfx256.lib).  Пакетные примитивы — одна W3-скобка на примитив.
+Ф2: ellipse/arc/fillpoly/floodfill/setfillstyle/getimage/putimage/
+viewport/settextstyle — см. docs/TODO.md.
 
 ## <irq.h> — user-ISR кадрового прерывания (IM 2)
 

docs/size_baseline.tsv

@@ -6,6 +6,7 @@ banked	1056
 bankedbg	1067
 banklocl	4832
 banktest	3767
+bgitest	4158
 bios_text	4470
 cat	915
 cblstream	6277