import 'dart:html' as html; import 'package:rules_of_living/src/Grid.dart'; class Engine { // Elapsed Time Counter - useful for Safety Timeout Stopwatch _elapsed = new Stopwatch(); /// Game Tick Rate /// /// *does* impact game speed; dictates how long each logic step takes. Only /// interesting for engine internal calculations, to set simulation speed /// from the outside use stepsPerSecond instead. int _MS_PER_STEP = 1000 ~/ 3; /// Set Logic Updates per Second /// /// Dictates simulation speed. Sets the amount of (logic) updates per second. /// Translations between number of updates and their timings is not exact so /// comparing this variable to fixed ints might not yield the expected results. /// Does not affect render frequency, which is handled by framesPerSecond. int get stepsPerSecond => 1000 ~/ _MS_PER_STEP; set stepsPerSecond(int val) => _MS_PER_STEP = 1000 ~/ val; // Max Frame (i.e. Rendering) rate - does *not* impact game speed final int _MS_PER_FRAME = 1000 ~/ 30; // ms stuck in updateloop after which game will declare itself unresponsive final int SAFETY_TIMEOUT = 2000; // Grid Size TODO add as configurable option static final GRID_X = 100; static final GRID_Y = 100; num _updateLag = 0.0; num _drawLag = 0.0; /// The Canvas to Paint on /// /// Manually define or change the canvas the engine should render to. Should /// be used if no canvas was defined at engine creation and it should be /// rendered later. html.CanvasElement canvas; Grid _grid = new Grid(GRID_X, GRID_Y); bool running = false; Engine([this.canvas]) { _elapsed.start(); _grid.addPattern(amount: 15, dispersal: 5); html.window.animationFrame.then(animFrame); } void animFrame(num now) { process(now); html.window.animationFrame.then(animFrame); } void reset() { _grid.reset(); running = false; } void clear() { _grid = new Grid(GRID_X, GRID_Y); running = false; } void process(num now) { _drawLag += _elapsed.elapsedMilliseconds; _updateLag += _elapsed.elapsedMilliseconds; _elapsed.reset(); while (_updateLag >= _MS_PER_STEP) { if (_elapsed.elapsedMilliseconds > SAFETY_TIMEOUT) { // TODO stub - give warning etc when this occurs print("ERROR STUCK IN UPDATE LOOP"); break; } if (running == true) update(); _updateLag -= _MS_PER_STEP; } if (_drawLag >= _MS_PER_FRAME) { render(_updateLag / _MS_PER_STEP); _drawLag = 0; } } /// Update Engine Logic /// /// Updates the logic of the engine by one tick. Should usually not be called /// directly, since it is automatically taken care of by the processing function. /// If simulation should be advanced manually one time, prefer using step(). void update() { if (!_grid.update()) running = false; } /// Advances Logic One Update /// /// Moves logic of the engine one step forward and pauses the /// simulation. Does not automatically re-render the new state /// (though this should usually not pose a problem). void step() { running = false; _grid.update(); } /// Renders the Current Simulation State /// /// Renders the simulation once. Will usually automatically be called by /// the internal engine processing. Does not do anything if no canvas is /// defined. void render([num interp]) { if(canvas != null) _grid.render(canvas, interp); } void addPattern( {CellPattern pattern, int x, int y, int amount, int dispersal, int seed}) { _grid.addPattern( pattern: pattern, x: x, y: y, amount: amount, dispersal: dispersal, seed: seed); } void toggleEdgeRendering() { _grid.renderEdges = !_grid.renderEdges; } }