How saintbridgethefirst/imageraster works
ImageRaster is a 3Pi+ robot scanning system with a live browser dashboard and a Processing Digital Twin. The main workflow is to prepare a printed sheet, start a raster scan from the dashboard or robot button, collect pose and surface readings, and view or download the reconstructed image and scan data. The graph also preserves documented analysis and simulation capabilities. Firmware call details are limited to the supplied excerpts and source index; Digital Twin internals are represented at the directory level where source was not sampled.
Main entry points: Controller.cpp Raster controller · WebDashboard.cpp Dashboard server · DigitalTwin Scan simulator · ImageRaster.ino Firmware entry
Components 17
Sheet preparation
- Sheet generator
tools/make_sheet.py - Sheet assets
DigitalTwin/sheets
Robot firmware
- Firmware entry
ImageRaster.ino - Raster controller
Controller.cpp - Robot I/O
Robot.cpp - Odometry model
OdometryModel.cpp - Scan ring buffer
ScanLog.cpp - Polling timer
TaskTimer.cpp - WiFi access point
RobotWifiAP.cpp - TCP telemetry
Controller.cpp
Live dashboard
- Dashboard server
WebDashboard.cpp - Browser dashboard
dashboard/dashboard.html
Digital Twin
- Scan simulator
DigitalTwin - Twin views
DigitalTwin - Twin models
DigitalTwin
Other components
- Operator
- 3Pi+ robot
Connections 20
- Operator → Sheet generator: prepares artwork
tools/make_sheet.py - Sheet generator → Sheet assets: creates sheets
tools/make_sheet.py - Operator → 3Pi+ robot: starts scan
README.md - 3Pi+ robot → Firmware entry: runs firmware
README.md - Firmware entry → Raster controller: updates
- Raster controller → Robot I/O: reads sensors
Controller.cpp - Raster controller → Odometry model: updates pose
Controller.cpp - Raster controller → Scan ring buffer: appends samples
Controller.cpp - Raster controller → Polling timer: schedules work
- Firmware entry → WiFi access point: starts access point
- Dashboard server → Robot I/O: reads robot state
- Dashboard server → Raster controller: controls scans
- Dashboard server → WiFi access point: serves over WiFi
- Browser dashboard → Dashboard server: requests status and data
- Scan ring buffer → Dashboard server: provides samples
- Raster controller → TCP telemetry: emits scan telemetry
README.md - TCP telemetry → Scan simulator: feeds twin
README.md - Scan simulator → Twin models: uses models
- Scan simulator → Twin views: renders views
- Sheet assets → Scan simulator: supplies scan surface