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.
This commit is contained in:
Robert Allan James
2026-08-07 10:27:46 -04:00
parent 7ba7a126c9
commit 8bf9480db5
+24
View File
@@ -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.