2021-08-10 15:18:59 -06:00
|
|
|
# hypoloop
|
2021-08-10 15:12:36 -06:00
|
|
|
## A flexible game-like loop for real-time simulation and rendering
|
2021-08-10 15:17:51 -06:00
|
|
|
### Features:
|
|
|
|
- Constant update rate
|
|
|
|
- Variable display rate
|
|
|
|
- Arbitrary simulation timescale
|
2021-08-12 14:13:58 -06:00
|
|
|
- Compatible with other libraries' built-in event loops
|
2021-08-11 12:57:13 -06:00
|
|
|
- Real-time can be disabled for high-speed simulations
|
2021-08-12 12:00:13 -06:00
|
|
|
|
|
|
|
## Example
|
|
|
|
```rust
|
|
|
|
use hypoloop::core::{State, Loop};
|
|
|
|
|
|
|
|
fn main() {
|
|
|
|
// create sim with default configuration
|
|
|
|
let mut sim = Loop::new();
|
|
|
|
|
|
|
|
// test variable
|
|
|
|
let mut x: f32 = 0.0;
|
|
|
|
|
|
|
|
// create a closure containing your update logic
|
2021-08-12 14:11:46 -06:00
|
|
|
let mut update_logic = move |state: &mut State| {
|
2021-08-12 12:00:13 -06:00
|
|
|
// access loop metadata via the State object
|
|
|
|
x += state.get_timescale();
|
|
|
|
print!("x: {} | ", x);
|
|
|
|
|
|
|
|
// print information about the current tick's timings
|
2021-08-12 14:11:46 -06:00
|
|
|
state.debug_time();
|
2021-08-12 12:00:13 -06:00
|
|
|
};
|
2021-08-12 14:11:46 -06:00
|
|
|
|
2021-08-12 12:00:13 -06:00
|
|
|
// create a closure containing your display logic
|
2021-08-12 14:11:46 -06:00
|
|
|
let display_logic = move |state: &State| {
|
2021-08-12 12:00:13 -06:00
|
|
|
//
|
|
|
|
};
|
|
|
|
|
|
|
|
// run the simulation with your user-defined update and display logic
|
2021-08-12 14:11:46 -06:00
|
|
|
// initialize the sim (cleans internal clocks, etc.)
|
|
|
|
sim.init();
|
|
|
|
loop {
|
|
|
|
// "step" the sim forward
|
|
|
|
sim.step(&mut update_logic, &display_logic);
|
|
|
|
}
|
2021-08-12 12:00:13 -06:00
|
|
|
}
|
|
|
|
```
|