emulator-template: Pace host at ~60 fps, convert sample demo to delta-time
The host busy-spun loop() with no frame limiting, so every frame-based animation ran at desktop fps (hundreds+). Add SDL_Delay-based pacing to the 60 Hz contract, and switch the bundled Demo to delta-time updates (velocities in px/s scaled by measured dt) so speed is correct at any frame rate.
This commit is contained in:
@@ -3,11 +3,16 @@
|
||||
*
|
||||
* Contract with the emulator host (src/main.cpp):
|
||||
* - implement setup() — called once at launch
|
||||
* - implement loop() — called once per frame (~60 fps)
|
||||
* - implement loop() — called once per frame (host paces at ~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)
|
||||
*
|
||||
* Update state with DELTA TIME, not per-frame constants: measure the real
|
||||
* seconds since the previous loop() call (see loop() below) and scale all
|
||||
* speeds in "units per second" by it. Then the sketch runs at the same
|
||||
* speed no matter what fps the host (or the real hardware) manages.
|
||||
*
|
||||
* This sample just bounces a colored box around — enough to prove the
|
||||
* pipeline works. Delete everything and start from the structure below.
|
||||
*/
|
||||
@@ -24,23 +29,30 @@ static constexpr int H = 240;
|
||||
|
||||
// --- Demo state -----------------------------------------------------------
|
||||
static float boxX = 40, boxY = 30;
|
||||
static float velX = 1.7f, velY = 1.1f;
|
||||
static float velX = 100.0f, velY = 70.0f; // pixels per second
|
||||
static unsigned long lastMs = 0;
|
||||
static constexpr float BOX = 24.0f;
|
||||
|
||||
void setup()
|
||||
{
|
||||
randomSeed(millis());
|
||||
velX = 1.0f + random(100) / 50.0f;
|
||||
velY = 1.0f + random(100) / 50.0f;
|
||||
velX = 60.0f + random(100) * 1.2f; // 60..180 px/s
|
||||
velY = 60.0f + random(100) * 1.2f;
|
||||
}
|
||||
|
||||
void loop()
|
||||
{
|
||||
// Delta time: seconds since the previous frame.
|
||||
unsigned long now = millis();
|
||||
float dt = lastMs ? (now - lastMs) / 1000.0f : 1.0f / 60.0f;
|
||||
lastMs = now;
|
||||
if (dt > 0.1f) dt = 0.1f; // clamp after stalls (drag, breakpoint)
|
||||
|
||||
// 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; }
|
||||
boxX += velX * dt;
|
||||
boxY += velY * dt;
|
||||
if (boxX < 0 || boxX + BOX > W) { velX = -velX; boxX += velX * dt; }
|
||||
if (boxY < 0 || boxY + BOX > H) { velY = -velY; boxY += velY * dt; }
|
||||
|
||||
// Clear the framebuffer (opaque black, alpha = 0xFF)
|
||||
for (int i = 0; i < W * H; i++) emuGfx::fb[i] = 0xFF000000;
|
||||
|
||||
Reference in New Issue
Block a user