# T-Deck Cyberspace Demo A first-person wireframe fly-through of Cyberspace, inspired by [System Shock's Cyberspace](https://shodan.fandom.com/wiki/Cyberspace) from the Shodan Fandom wiki. The camera is dragged along a "river of data" through immense rooms of glowing wireframe, populated with the classic Cyberspace objects — a vibe study for the NetDeck game's jack-in view. ## Overview Everything renders as glowing wireframe on a 320x240 framebuffer, exactly like the wiki describes: *"important programs manifest as floating geometric shapes in immense rooms of glowing wireframe. Hallways between rooms represent rivers of data between nodes, which drag the user along in digital currents."* - **Data current** — the camera follows a gently curving spline path, banking into curves and bobbing weightlessly; the tunnel of octagonal rings swells between narrow hallways and vast rooms (zones) with smoothstep radius blends. - **Cyberspace objects** (per the wiki's Objects list), recycled around a 256-unit loop so the flight never ends: | Object | Wiki appearance | In the demo | |---|---|---| | Data Object | spinning purple cube | two nested counter-rotating wireframe cubes | | Data Fragment | yellow square + 4 orange diamonds | spinning square with octahedra on the diagonals | | Infonode | geometric signpost | green pylon + octahedron head + orbiting spark | | Security Mine | blue sphere | pulsing billboard circles + orange prime blink | | Integrity Restorative | red cross | three-axis red wireframe cross | | I.C.E. Barrier | geometric growths | cluster of magenta pyramids, shimmering | | SHODAN's core | vertical diamond ending in four curved tentacles | Bézier tentacles + rotating shield ring, once per loop | - **Void stars** — distant fixed points for orientation (rotation-only parallax, translation-free, infinity-depth). - **NetDeck-style HUD chrome** — crosshair, LNK/TRACE meters, zone banner (MILITARY SPUR / RESEARCH GROTTO / DATA CISTERN / SECURITY GRID), DIST / VEL / NODE readouts in a 3x5 bitmap font. ## Controls - **SPACE** — freeze / resume the current (NetDeck `Space` freeze convention) - **f / s** — faster / slower current - **h** — toggle HUD - **ESC** — quit ## Building & Running ```bash # Build and run the cyberflythrough demo make run APP=Cyberflythrough # Headless smoke test (240 frames, dump BMP) make smoke APP=Cyberflythrough # Clean built binary make clean ``` ## File Structure ``` cyberspace-demo/ ├── README.md # This file ├── Makefile # Build configuration ├── shim.h # Arduino API shim (millis, random, etc.) ├── src/ │ └── main.cpp # SDL3 host loop — window, framebuffer, setup()/loop() └── examples/ └── Cyberflythrough/ └── Cyberflythrough.cpp # Cyberspace fly-through sketch ``` ## How It Works The sketch implements the standard emulator contract: - `setup()` — called once at launch, seeds the object/streak/star fields - `loop()` — called once per frame (~60 fps) - consumes keys from `emu::keyboard` (freeze, speed, HUD) - advances the camera along the data-current spline (`pathX/pathY`), banks the roll into curves, simulates streaks and object recycling - transforms world → view space with one 3x3 matrix per frame (yaw/pitch from the path tangent, blended toward straight-ahead) and perspective-projects - draws octagonal tunnel rings + longitudinal ribs with depth fade, near-plane segment clipping, and the object wireframes - draws HUD chrome and sets `emuGfx::dirty = true` Geometry notes: - All lines are Bresenham's algorithm against the direct framebuffer. - Depth fade multiplies each color by a per-segment brightness using `dimc()`, giving the glowing-wireframe-into-the-distance look without a z-buffer. - Segments are clipped against the near plane in view space so objects sweeping past the camera don't smear across the screen. Potential next steps toward NetDeck integration: replace the scripted camera with trackball-steered flight, pin the tunnel zones to actual network nodes (AIRLK/JUNC/HIVE), and let data-object pickups arm the daemon keys (`1` FRENZY.EXE / `2` BLIND).