emulator-template: Neutralize demo slot, add 10s auto-exit safety hatch
Make the template foolproof to copy-and-fill for a new demo: - examples/Conway/ replaced by a neutral examples/Demo/Demo.cpp sample (bouncing box) documenting the full sketch contract (setup/loop, emuGfx::fb, emuGfx::dirty, emu::keyboard) - Makefile passes the sketch path as -DAPP_SRC; main.cpp now includes APP_SRC instead of hardcoding Conway.cpp, window title uses APP_NAME - Safety hatch: emulator auto-exits after 10 seconds by default so a runaway demo can't hang and eat resources; --user-run disables the cap, --timeout MS adjusts it (default 10000) - README rewritten as a step-by-step recipe: replace the Demo sketch, run 'make run'; documents all CLI flags, drops the unimplemented --dump-interval flag Verified: fresh copy + sketch swap builds and renders; hatch fires at 10s (and at --timeout 2000); --user-run runs until --frames cap.
This commit is contained in:
@@ -0,0 +1,61 @@
|
||||
/**
|
||||
* Demo sketch — replace this file with your own experiment.
|
||||
*
|
||||
* Contract with the emulator host (src/main.cpp):
|
||||
* - implement setup() — called once at launch
|
||||
* - implement loop() — called once per frame (~60 fps)
|
||||
* - write pixels into emuGfx::fb[] (320x240, ABGR8888 uint32)
|
||||
* - set emuGfx::dirty = true each frame you want presented
|
||||
* - read keys from emu::keyboard (ASCII queue, filled from SDL events)
|
||||
*
|
||||
* This sample just bounces a colored box around — enough to prove the
|
||||
* pipeline works. Delete everything and start from the structure below.
|
||||
*/
|
||||
|
||||
#include "shim.h"
|
||||
|
||||
// Emulator state provided by the host (src/main.cpp)
|
||||
extern uint32_t emuGfx::fb[320 * 240];
|
||||
extern bool emuGfx::dirty;
|
||||
extern std::deque<uint8_t> emu::keyboard;
|
||||
|
||||
static constexpr int W = 320;
|
||||
static constexpr int H = 240;
|
||||
|
||||
// --- Demo state -----------------------------------------------------------
|
||||
static float boxX = 40, boxY = 30;
|
||||
static float velX = 1.7f, velY = 1.1f;
|
||||
static constexpr float BOX = 24.0f;
|
||||
|
||||
void setup()
|
||||
{
|
||||
randomSeed(millis());
|
||||
velX = 1.0f + random(100) / 50.0f;
|
||||
velY = 1.0f + random(100) / 50.0f;
|
||||
}
|
||||
|
||||
void loop()
|
||||
{
|
||||
// Move and bounce
|
||||
boxX += velX;
|
||||
boxY += velY;
|
||||
if (boxX < 0 || boxX + BOX > W) { velX = -velX; boxX += velX; }
|
||||
if (boxY < 0 || boxY + BOX > H) { velY = -velY; boxY += velY; }
|
||||
|
||||
// Clear the framebuffer (opaque black, alpha = 0xFF)
|
||||
for (int i = 0; i < W * H; i++) emuGfx::fb[i] = 0xFF000000;
|
||||
|
||||
// Draw a filled box with a color that drifts over time
|
||||
uint8_t r = (uint8_t)(128 + 127 * sinf(millis() / 900.0f));
|
||||
uint32_t color = 0xFF000000u | ((uint32_t)r << 16) | 0x0000CC66u;
|
||||
for (int y = (int)boxY; y < (int)(boxY + BOX); y++) {
|
||||
if (y < 0 || y >= H) continue;
|
||||
for (int x = (int)boxX; x < (int)(boxX + BOX); x++) {
|
||||
if (x < 0 || x >= W) continue;
|
||||
emuGfx::fb[y * W + x] = color;
|
||||
}
|
||||
}
|
||||
|
||||
// Present the frame
|
||||
emuGfx::dirty = true;
|
||||
}
|
||||
Reference in New Issue
Block a user