ci-platforms / darwin amd64 smoke (push) Skipped
GitHub / linux amd64 native GitHub-hosted native CI: success
ci-platforms / windows amd64 smoke (push) Skipped
GitHub / windows amd64 native GitHub-hosted native CI: success
GitHub / darwin arm64 native GitHub-hosted native CI: success
GitHub / darwin amd64 native GitHub-hosted native CI: success
ci / checks (push) Failing after 1h21m34s
ci / native-authoring (push) Skipped
ci-platforms / darwin arm64 smoke (push) Skipped
github-native / gitea-pending (push) Skipped
github-native / darwin amd64 native (push) Skipped
github-native / linux amd64 native (push) Skipped
github-native / windows amd64 native (push) Skipped
github-native / darwin arm64 native (push) Skipped
github-native / gitea-result (push) Skipped
ci / build (amd64, linux, ubuntu-24.04) (push) Successful in 12m4s
ci / release (push) Skipped
Add dockable Art tools, animation and previews, guarded asset workflows, and the Web Asset Studio built on the shared Art Core. Expand English and Russian documentation, interactive Try scenes, examples and editor icons. Add audio waveform navigation, source analysis, guarded previews and a browser Worker mixer. Preserve source changes and recovery with bounded checks, and strengthen native, browser and interoperability CI. Prepare version 0.12.5 and manually built native artifact candidates. Fix the production site image demo build dependency. Reuse immutable scene indices when capturing keyframes. Wait for real Persist save/load completion in component tests. Stabilize browser Game View captures outside pointer hover. Aseprite interchange and persistent Audio EDL recovery remain limited; the artifact workflow does not publish releases or change stable.
356 lines
8.2 KiB
Go
356 lines
8.2 KiB
Go
package engine
|
|
|
|
import (
|
|
"runtime"
|
|
"runtime/metrics"
|
|
"time"
|
|
|
|
"aego/core/clock"
|
|
"aego/core/errs"
|
|
"aego/core/rng"
|
|
"aego/platform"
|
|
)
|
|
|
|
const idleSleep = 16 * time.Millisecond
|
|
|
|
func (e *Engine) Step(app App) bool {
|
|
if e.closed || e.err != nil {
|
|
return false
|
|
}
|
|
if !e.appInit {
|
|
e.app = app
|
|
if err := app.Init(e); err != nil {
|
|
e.err = errs.Wrap(err, errs.EngineInit, "app initialization failed")
|
|
return false
|
|
}
|
|
// Type-assertion cache updates can allocate; resolve this once before
|
|
// the per-frame hot path, even for apps without a pacer.
|
|
e.framePacer, _ = app.(FramePacer)
|
|
e.finisher, _ = app.(FrameFinisher)
|
|
e.appInit = true
|
|
e.lastTime = e.plat.Now()
|
|
}
|
|
e.frame()
|
|
return !e.quit
|
|
}
|
|
|
|
const (
|
|
zoneGPU = phaseCount + iota
|
|
zonePoll
|
|
zoneFrame
|
|
allocZones
|
|
)
|
|
|
|
func AllocZone(i int) string {
|
|
switch i {
|
|
case zoneGPU:
|
|
return "gpu"
|
|
case zonePoll:
|
|
return "poll"
|
|
case zoneFrame:
|
|
return "frame"
|
|
}
|
|
return Phase(i).String()
|
|
}
|
|
|
|
func (e *Engine) AllocTotals(dst []uint64) []uint64 {
|
|
return append(dst, e.allocTotal[:]...)
|
|
}
|
|
|
|
func (e *Engine) FrameBytes() uint64 {
|
|
return e.frameBytes
|
|
}
|
|
|
|
func (e *Engine) allocMark() uint64 {
|
|
if !e.probe {
|
|
return 0
|
|
}
|
|
return e.objects()
|
|
}
|
|
|
|
func (e *Engine) allocSince(z int, mark uint64) {
|
|
if e.probe {
|
|
e.allocTotal[z] += e.objects() - mark
|
|
}
|
|
}
|
|
|
|
func gated(p Phase) bool {
|
|
return p >= PhaseFixedBegin && p <= PhaseAnimation
|
|
}
|
|
|
|
func (e *Engine) exec(ctx *Context, p Phase, mask SystemScope, paused bool) {
|
|
list := e.reg.systems.phases[p]
|
|
if len(list) == 0 {
|
|
return
|
|
}
|
|
var before uint64
|
|
if e.probe {
|
|
before = e.objects()
|
|
}
|
|
gate := gated(p)
|
|
ps := e.tracer.Begin(e.phaseZones[p])
|
|
for i := range list {
|
|
s := &list[i]
|
|
if s.scope&mask == 0 || (gate && !s.pause.runs(paused)) {
|
|
continue
|
|
}
|
|
z := e.tracer.Begin(s.zone)
|
|
s.sys.Run(ctx)
|
|
z.End()
|
|
}
|
|
ps.End()
|
|
if e.probe {
|
|
n := e.objects() - before
|
|
e.allocs[p] += n
|
|
e.allocTotal[p] += n
|
|
}
|
|
}
|
|
func (e *Engine) SetPhaseAllocs(on bool) {
|
|
if on && len(e.probeSample) == 0 {
|
|
e.probeSample = []metrics.Sample{{Name: "/gc/heap/allocs:objects"}, {Name: "/gc/heap/allocs:bytes"}}
|
|
}
|
|
e.probe = on
|
|
}
|
|
|
|
func (e *Engine) SetLockstep(on bool) {
|
|
e.lockstep = on
|
|
}
|
|
|
|
// exactFrameAllocs flushes allocator caches: runtime/metrics can publish cached-span allocations in a later frame, skewing per-frame byte comparisons.
|
|
// ReadMemStats stops the world, so use it only while the probe is enabled.
|
|
func exactFrameAllocs() (uint64, uint64) {
|
|
var stats runtime.MemStats
|
|
runtime.ReadMemStats(&stats)
|
|
return stats.Mallocs, stats.TotalAlloc
|
|
}
|
|
|
|
func (e *Engine) objects() uint64 {
|
|
o, _ := e.heapAllocs()
|
|
return o
|
|
}
|
|
|
|
func (e *Engine) heapAllocs() (objects, bytes uint64) {
|
|
metrics.Read(e.probeSample)
|
|
if v := e.probeSample[0].Value; v.Kind() == metrics.KindUint64 {
|
|
objects = v.Uint64()
|
|
}
|
|
if v := e.probeSample[1].Value; v.Kind() == metrics.KindUint64 {
|
|
bytes = v.Uint64()
|
|
}
|
|
return objects, bytes
|
|
}
|
|
func (e *Engine) PhaseAllocs(dst []uint64) []uint64 {
|
|
return append(dst, e.lastAllocs[:]...)
|
|
}
|
|
|
|
func (e *Engine) random(w *World) *rng.Source {
|
|
if w != nil && w.Random != nil {
|
|
return w.Random
|
|
}
|
|
return e.ctx.Random
|
|
}
|
|
|
|
func (e *Engine) begin(ctx *Context, w *World, real float64) clock.Plan {
|
|
t := w.Time
|
|
plan := t.Begin(real)
|
|
rnd := e.random(w)
|
|
*ctx = Context{
|
|
Engine: e,
|
|
World: w,
|
|
Time: t,
|
|
Dt: t.Span(clock.Game).Delta,
|
|
Unscaled: t.Span(clock.Real).Delta,
|
|
Alpha: t.Alpha(),
|
|
Frame: t.Frame(),
|
|
Tick: t.Tick(),
|
|
Paused: plan.Paused,
|
|
Random: rnd,
|
|
}
|
|
if w.Recorder != nil {
|
|
w.Recorder.Stamp(uint64(w.ID()), ctx.Frame, ctx.Tick)
|
|
}
|
|
return plan
|
|
}
|
|
|
|
func (e *Engine) mark(w *World, steps int) {
|
|
t := w.Time
|
|
var first, last uint64
|
|
if steps > 0 {
|
|
first, last = t.Tick()+1, t.Tick()+uint64(steps)
|
|
}
|
|
e.tracer.Mark(uint64(w.ID()), t.Frame(), first, last)
|
|
}
|
|
|
|
func (e *Engine) simulate(ctx *Context, mask SystemScope, plan clock.Plan) {
|
|
t, w := ctx.Time, ctx.World
|
|
fixed := t.FixedDelta()
|
|
paused := plan.Paused
|
|
for range plan.Steps {
|
|
ctx.Tick = t.BeginTick()
|
|
if w.Recorder != nil {
|
|
w.Recorder.Stamp(uint64(w.ID()), ctx.Frame, ctx.Tick)
|
|
}
|
|
ctx.Dt, ctx.Alpha = fixed, 0
|
|
for p := PhaseFixedBegin; p <= PhaseFixedEnd; p++ {
|
|
e.exec(ctx, p, mask, false)
|
|
}
|
|
if w.Break != nil && w.Break() {
|
|
t.SetPaused(true)
|
|
paused = true
|
|
break
|
|
}
|
|
}
|
|
ctx.Paused = paused
|
|
ctx.Dt, ctx.Alpha = t.Span(clock.Game).Delta, t.Alpha()
|
|
if paused {
|
|
ctx.Dt = 0
|
|
}
|
|
for p := PhasePreUpdate; p <= PhaseAnimation; p++ {
|
|
e.exec(ctx, p, mask, paused)
|
|
}
|
|
if !paused && w.Break != nil && w.Break() {
|
|
t.SetPaused(true)
|
|
}
|
|
}
|
|
|
|
func (e *Engine) TickWorld(w *World, scope SystemScope, real float64) clock.Plan {
|
|
if w == nil || w.Time == nil {
|
|
return clock.Plan{}
|
|
}
|
|
saved := e.wctx
|
|
plan := e.begin(&e.wctx, w, real)
|
|
e.mark(w, plan.Steps)
|
|
e.exec(&e.wctx, PhaseFrameBegin, scope, plan.Paused)
|
|
e.exec(&e.wctx, PhaseInput, scope, plan.Paused)
|
|
e.simulate(&e.wctx, scope, plan)
|
|
e.wctx = saved
|
|
return plan
|
|
}
|
|
|
|
func (e *Engine) RunPhase(w *World, p Phase, scope SystemScope, dt, alpha float64) {
|
|
if w == nil || int(p) >= phaseCount {
|
|
return
|
|
}
|
|
saved := e.wctx
|
|
e.wctx = Context{Engine: e, World: w, Dt: dt, Alpha: alpha, Frame: e.frameNo, Random: e.random(w)}
|
|
if t := w.Time; t != nil {
|
|
e.wctx.Time, e.wctx.Frame, e.wctx.Tick = t, t.Frame(), t.Tick()
|
|
e.wctx.Unscaled = t.Span(clock.Real).Delta
|
|
}
|
|
e.exec(&e.wctx, p, scope, false)
|
|
e.wctx = saved
|
|
}
|
|
|
|
func (e *Engine) RunFixed(w *World, scope SystemScope, dt float64) {
|
|
for p := PhaseFixedBegin; p <= PhaseFixedEnd; p++ {
|
|
e.RunPhase(w, p, scope, dt, 0)
|
|
}
|
|
}
|
|
|
|
func (e *Engine) RunVariable(w *World, scope SystemScope, dt, alpha float64) {
|
|
for p := PhasePreUpdate; p <= PhaseAnimation; p++ {
|
|
e.RunPhase(w, p, scope, dt, alpha)
|
|
}
|
|
}
|
|
|
|
func (e *Engine) frame() {
|
|
e.lastAllocs, e.allocs = e.allocs, [phaseCount]uint64{}
|
|
var o0, b0 uint64
|
|
if e.probe {
|
|
o0, b0 = exactFrameAllocs()
|
|
}
|
|
e.tracer.BeginFrame()
|
|
now := e.plat.Now()
|
|
delta := 0.0
|
|
if e.frameNo > 0 {
|
|
delta = now - e.lastTime
|
|
}
|
|
if e.clockReset != nil && e.clockReset.ConsumeFrameClockReset() {
|
|
delta = 0
|
|
}
|
|
if e.frameNo > 0 && e.cfg.FixedFrameTime > 0 {
|
|
delta = e.cfg.FixedFrameTime
|
|
}
|
|
if delta < 0 {
|
|
delta = 0
|
|
}
|
|
if e.lockstep {
|
|
delta = 1 / e.cfg.FixedHz
|
|
}
|
|
e.lastTime = now
|
|
e.frameNo++
|
|
mask := ScopeFrame | e.cfg.LoopScope
|
|
plan := e.begin(&e.ctx, e.main, delta)
|
|
e.mark(e.main, plan.Steps)
|
|
|
|
e.jobs.drain()
|
|
e.exec(&e.ctx, PhaseFrameBegin, mask, plan.Paused)
|
|
|
|
e.input.BeginFrame()
|
|
pz := e.tracer.Begin(e.zPoll)
|
|
am := e.allocMark()
|
|
e.plat.PollEvents(e.onEvent)
|
|
e.allocSince(zonePoll, am)
|
|
pz.End()
|
|
e.exec(&e.ctx, PhasePollEvents, mask, plan.Paused)
|
|
e.exec(&e.ctx, PhaseInput, mask, plan.Paused)
|
|
|
|
updateStart := e.plat.Now()
|
|
e.simulate(&e.ctx, mask, plan)
|
|
renderStart := e.plat.Now()
|
|
e.stats.UpdateTime = renderStart - updateStart
|
|
|
|
e.stats.ResetGPU()
|
|
rendered := !e.minimized && e.metrics.PixelW > 0 && e.metrics.PixelH > 0
|
|
paceTime := 0.0
|
|
if rendered {
|
|
e.exec(&e.ctx, PhaseRenderPrepare, mask, plan.Paused)
|
|
am = e.allocMark()
|
|
e.curFrame = e.dev.BeginFrame(e.metrics.PixelW, e.metrics.PixelH)
|
|
e.allocSince(zoneGPU, am)
|
|
e.exec(&e.ctx, PhaseRender, mask, plan.Paused)
|
|
if e.framePacer != nil {
|
|
start := e.plat.Now()
|
|
e.framePacer.PaceFrame()
|
|
paceTime = max(0, e.plat.Now()-start)
|
|
}
|
|
e.exec(&e.ctx, PhaseRenderUI, mask, plan.Paused)
|
|
gs := e.curFrame.Stats()
|
|
am = e.allocMark()
|
|
e.dev.EndFrame()
|
|
e.curFrame = nil
|
|
if e.finisher != nil {
|
|
e.finisher.FrameFinished()
|
|
}
|
|
if e.capture != nil {
|
|
e.grab()
|
|
}
|
|
sz := e.tracer.Begin(e.zSwap)
|
|
e.win.SwapBuffers()
|
|
sz.End()
|
|
e.allocSince(zoneGPU, am)
|
|
e.stats.DrawCalls = gs.DrawCalls
|
|
e.stats.Vertices = gs.Vertices
|
|
e.stats.Triangles = gs.Triangles
|
|
e.stats.TexSwitches = gs.TexSwitches
|
|
} else if e.minimized {
|
|
time.Sleep(idleSleep)
|
|
}
|
|
e.stats.RenderTime = max(0, e.plat.Now()-renderStart-paceTime)
|
|
|
|
if lim := e.frameLimit; lim > 0 && e.vsync == platform.VSyncOff && !e.cfg.Headless {
|
|
if wait := 1/lim - (e.plat.Now() - now); wait > 0 {
|
|
time.Sleep(time.Duration(wait * float64(time.Second)))
|
|
}
|
|
}
|
|
e.exec(&e.ctx, PhaseFrameEnd, mask, plan.Paused)
|
|
e.stats.FrameTime = delta
|
|
e.counter.Sample(&e.stats)
|
|
e.tracer.EndFrame()
|
|
if e.probe {
|
|
o, b := exactFrameAllocs()
|
|
e.allocTotal[zoneFrame] += o - o0
|
|
e.frameBytes += b - b0
|
|
}
|
|
}
|