protologic_core 11.0.0

Rust bindings for Protologic
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

use std::time::Duration;

use crate::constants;

#[cfg(not(mock_protologic))]
#[link(wasm_import_module = "wasi_snapshot_preview1")]
extern
{
    /// Yield execution for one frame
    pub fn sched_yield() -> i32;
}

/// Yield execution for one frame
#[cfg(mock_protologic)]
pub unsafe fn sched_yield() -> i32 { panic!("extern called in test mode!") }

/// Skip one single tick
pub fn wait_tick()
{
    wait_ticks(1);
}

/// Wait for the given number of ticks to pass
pub fn wait_ticks(ticks: u32)
{
    // No need to invalidate the cache if we're not actually waiting
    if ticks == 0 {
        return;
    }

    // Wait for as many ticks as necessary 
    for _ in 0..ticks {
        unsafe { sched_yield(); }
    }

    // Invalidate the cache now that execution is returning to caller code
    unsafe { crate::lowlevel::quickstate::quickstate_invalidate_cache(); }
}

/// Wait for the given amount of time to pass
pub fn wait_time(timespan: Duration)
{
    // We can only wait an exact number of ticks. Round down.
    let tick_count = f32::floor(timespan.as_secs_f32() / constants::tick_duration()) as u32;
    wait_ticks(tick_count);
}