Repository navigation
Strata 0.6.0
What a playtesting harness needs to play a Strata game without a person at
the window: injected events, a shared frame clock and the drive channel
(STRATA_DRIVE, with STRATA_DRIVE_SURFACE, STRATA_DRIVE_CLOCK and
STRATA_DRIVE_STEP). The ABI addition is compatible: STRATA_ABI_VERSION
stays 1 and STRATA_ABI_MINOR is 12. The Python binding also knows the
v0.5.0 libraries' SHA-256s.
- ABI 1.12, for playtesting harnesses (Preponderous RFC 0027): a Strata game
can be played by something other than a person at a window. All compatible
additions; every ABI 1.x host keeps working. Seedocs/DRIVE.md.strata_push_event/Engine::pushEvent: queue an event that
strata_poll_eventreturns after the platform's own, on any surface
(bounded at 4096).strata_frame_seconds/Engine::frameSeconds: the seconds to advance
this frame, from a monotonic clock, or the step a stepped driver granted.strata_is_driven/Engine::driven: whether a harness drove this
engine, so a game can keep a driven run away from the player's saves.- The drive channel: with
STRATA_DRIVEnaming a Unix socket, the engine
connects (it never listens) and takes JSON lines that inject events, step
a stepped clock (STRATA_DRIVE_CLOCK,STRATA_DRIVE_STEP) and take
screenshots.STRATA_DRIVE_SURFACE=headlessturns a driven game's window
into a headless surface. A failed or dropped connection runs undriven. strata_set_relative_mouse_modereturnsSTRATA_OKon a headless or
host-context surface when the engine is driven; injected motion is then
relative. Undriven, nothing changes.- Tests:
test_drive.cpp(the protocol over a socket pair, no GL) and
strata-drive-e2e(a real headless engine, two stepped runs drawing
identical frames; skipped where there is no EGL). C# P/Invokes and Python
declarations (Engine.push_event,frame_seconds,driven), with tests.
- Python binding:
KNOWN_RELEASESgains v0.5.0 (linux-x64andwin-x64),
sostrata.load_release("0.5.0")needs no hash.