SleelaTerminal™ — Phraign™ Frame-Based Terminal Pixel Control System
SleelaTerminal™ is SLeeLa's terminal product. It is built on GNU Bash (GPL, © Free Software Foundation). SleelaTerminal™ branding applies only to SLeeLa's own additions — the Phraign™ pixel-terminal work and the
model-3D/application — and never to the vendored GNU Bash sources, whose GPL headers, copyright, and third-party GNU project names are left intact.
Phraign™ is the SleelaTerminal™ frame-based, pixel-accurate terminal control system. It lets a program treat the terminal output surface as an addressable planar map of pixels rather than only a character grid, and to specify control of that surface at pixel granularity.
Phraign™ is the umbrella name for the SleelaTerminal™ pixel-terminal work living
in bash/:
| Component | File | Role |
|---|---|---|
| Overview | PHRAIGN.md | This document — the Phraign™ system summary. |
| Interface spec | PIXEL_TERMINAL.md | Coordinate model, frame semantics, sizing, resize events. |
| Handshake spec | SLEELA_BASH_HANDSHAKE.md | Versioned capability negotiation between SLeeLa and Bash. |
| Shell interface | pixel-terminal.sh | Bash text-protocol functions (pixel_terminal_*). |
| Native layer | pixel_terminal.hpp / pixel_terminal.cpp | C++ sleela::terminal::PixelTerminal owning frame + geometry. |
| Smoke test | pixel_terminal_smoke.cpp | Native layer assertions. |
| Application | model-3D/ | Phraign™ City 3D — a ~4000-block city rendered onto the Phraign frame per pixel (see model-3D/README.md). |
Why "SleelaTerminal™" and "Phraign™"
SleelaTerminal™ is the SLeeLa-facing product/distribution name for the whole
terminal effort. Phraign™ is the frame-based control system inside it, and
pixel_terminal remains the concrete module/API name. Naming the product and
the system separately lets SLeeLa refer to the whole frame-based terminal
capability — spec, handshake, shell interface, and native layer — as one thing,
while the code-level identifiers stay descriptive and the underlying execution
engine (GNU Bash) keeps its own name.
What Phraign™ gives the user
- Pixel accuracy. The terminal surface is modeled as a frame of pixels with
an origin at the upper-left corner. A program addresses any pixel by integer
(x, y)coordinates, where0 <= x < widthand0 <= y < height. - A pixel map / planar surface. The frame is a raster plane the program fills, clears, or sets pixel-by-pixel, then submits for presentation.
- Terminal-following geometry. Phraign™ prefers the terminal's physical pixel size and falls back to character-cell size, and it derives the frame center from the current dimensions.
- Resize awareness.
SIGWINCHand the nativepollResize()path let a program observe terminal size changes without discarding frame content. - Capability negotiation. A versioned handshake
(
SLEELA-BASH/1 PHRAIGN/1 VARIANT=NATIVE) lets SLeeLa confirm the Bash environment understands Phraign™ before sending frame commands.
System shape
SLeeLa program
|
v
Bash --- Phraign™ handshake (HELLO / READY / CAPS)
|
v
pixel_terminal_* shell interface (pixel-terminal.sh)
|
v
Native Phraign™ layer (sleela::terminal::PixelTerminal)
|
frame + geometry + resize
|
v
SLeeLa terminal/frame bridge
|
v
pixel-addressable terminal frame
Bash stays responsible for command execution; Phraign™ owns the frame and geometry abstraction; the SLeeLa bridge owns actual raster presentation.
Compatibility
SleelaTerminal™ (via Phraign™) is additive. Ordinary Bash commands, standard
I/O, POSIX shell behavior, and normal terminal operation are unchanged. A
terminal without the Phraign™ bridge may ignore the pixel commands without
affecting ordinary Bash operation. See PIXEL_TERMINAL.md and
SLEELA_BASH_HANDSHAKE.md for details.
Attribution
SleelaTerminal™ is built on GNU Bash, which is free software licensed under
the GNU General Public License and copyright the Free Software
Foundation. The vendored Bash sources in bash/ retain their original GPL
license text, copyright notices, and references to GNU projects unchanged;
SleelaTerminal™ / Phraign™ branding covers only SLeeLa's own additive files.