From 8bf9480db5009abf2140a6fee5191ecb948071bb Mon Sep 17 00:00:00 2001 From: Robert Allan James Date: Fri, 7 Aug 2026 10:27:46 -0400 Subject: [PATCH] FABRIC.md: item 4.3 -- console discussion held, scope 4.3.1 (framebuffer + coordinate fabric) CONSOLE.md superseded as a rough prior draft, not edited further. Console design now lives in FABRIC.md going forward. 4.3.1 is the first slice: framebuffer sanity check, QEMU screenshot capability, Cartesian/Z coordinate machinery, and a cube as the first real exercise of the projection math. --- FABRIC.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/FABRIC.md b/FABRIC.md index d2567ba..96c0216 100644 --- a/FABRIC.md +++ b/FABRIC.md @@ -3643,6 +3643,30 @@ document and committing that amendment as its own item.* > **Note, 2026-08-05: Captain Bob wants a discussion before any work starts on this item.** > Do not begin 4.3 on an unblock-and-go basis the way 4.1 was — raise it and wait. + > + > **Discussion held 2026-08-07.** `.claude/CONSOLE.md` is a rough prior working draft, + > superseded — not edited further, not treated as authoritative. Console's design lives + > in this document from here on. First slice scoped below as 4.3.1. + +- [ ] **4.3.1 — Framebuffer sanity and the coordinate fabric.** First real work on Console: + prove the raw hardware boundary before anything Stadium- or VM-shaped touches it. Scope: + 1. Confirm `framebuffer.c` is wired to the real UEFI GOP `BootInfo` and draw a simple + orientation-revealing test pattern (raw pixel primitives only — no coordinate/Z + machinery yet). + 2. Add QEMU monitor/QMP screenshot capability (`screendump`) so the result can actually + be inspected — none exists today; all three `qemu` targets currently run with + `-display none` and no monitor attached. + 3. Stand up Cartesian coordinate machinery: origin bottom-left `(0,0)`, Y-up, plus a new + Z axis — depth-into-screen, not height. Fixed orthographic projection for now (angle + TBD — true 45° cavalier vs. 2:1 isometric, still open); explicitly a placeholder, not + the final projection — this is heading toward real 3D animation later, not a static + scene. + 4. Draw a cube using the new machinery. Stop here for review — first real exercise of the + coordinate/projection math, not expected to be fast. + + **Explicitly out of scope for 4.3.1:** raster image (PNG/JPEG) rendering as fabric + backgrounds — real direction, deliberately deferred past this slice. + - [ ] **4.4 — Artemis last.** It works today; it is the thing that cannot be broken. *Refs:* §10.