Struct Timer 

pub struct Timer { /* private fields */ }

灵活的计时器工具

Timer 提供了丰富的计时功能，支持一次性和重复计时、暂停恢复等操作。 它是实现时间相关游戏逻辑的核心工具。

设计特点

• 零分配: 所有操作都不涉及内存分配
• 高精度: 使用 Duration 提供微秒级精度
• 状态管理: 清晰的状态转换和查询接口
• 灵活配置: 支持多种创建和配置方式

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
// 创建 3 秒一次性计时器
let mut timer = Timer::from_seconds(3.0);
 
// 创建 1 秒重复计时器
let mut repeat_timer = Timer::repeating_from_seconds(1.0);
 
// 在游戏循环中更新
let delta = Duration::from_millis(16); // ~60 FPS
 
timer.tick(delta);
repeat_timer.tick(delta);
 
if timer.just_finished() {
    println!("Timer finished!");
}
 
if repeat_timer.just_finished() {
    println!("Repeat timer triggered!");
}

Implementations

impl Timer

pub fn new(duration: Duration) -> Timer

创建新的一次性计时器

参数

• duration: 计时时长

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let timer = Timer::new(Duration::from_secs(5));
assert_eq!(timer.duration(), Duration::from_secs(5));
assert!(!timer.is_repeating());

pub fn repeating(duration: Duration) -> Timer

创建新的重复计时器

参数

• duration: 每次计时的时长

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let timer = Timer::repeating(Duration::from_secs(2));
assert!(timer.is_repeating());

pub fn from_seconds(seconds: f32) -> Timer

从秒数创建一次性计时器

示例

use anvilkit_core::time::Timer;
 
let timer = Timer::from_seconds(3.5);
assert_eq!(timer.duration_seconds(), 3.5);

pub fn repeating_from_seconds(seconds: f32) -> Timer

从秒数创建重复计时器

示例

use anvilkit_core::time::Timer;
 
let timer = Timer::repeating_from_seconds(1.0);
assert!(timer.is_repeating());
assert_eq!(timer.duration_seconds(), 1.0);

pub fn from_millis(millis: u64) -> Timer

从毫秒数创建一次性计时器

pub fn repeating_from_millis(millis: u64) -> Timer

从毫秒数创建重复计时器

pub fn tick(&mut self, delta: Duration)

更新计时器

应该在每帧调用此方法来推进计时器。

参数

• delta: 自上次更新以来的时间间隔

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(1.0);
 
// 模拟 0.5 秒
timer.tick(Duration::from_millis(500));
assert_eq!(timer.percent(), 0.5);
assert!(!timer.finished());
 
// 再模拟 0.5 秒
timer.tick(Duration::from_millis(500));
assert!(timer.finished());
assert!(timer.just_finished());

pub fn finished(&self) -> bool

检查计时器是否已完成

对于一次性计时器，完成后会一直返回 true。 对于重复计时器，只有在刚完成的那一帧返回 true。

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(1.0);
assert!(!timer.finished());
 
timer.tick(Duration::from_secs(1));
assert!(timer.finished());

pub fn just_finished(&self) -> bool

检查计时器是否在本帧刚完成

这对于触发一次性事件非常有用，避免重复触发。

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(1.0);
 
timer.tick(Duration::from_millis(999));
assert!(!timer.just_finished());
 
timer.tick(Duration::from_millis(1));
assert!(timer.just_finished());
 
timer.tick(Duration::from_millis(1));
assert!(!timer.just_finished()); // 下一帧不再是 "刚完成"

pub fn elapsed(&self) -> Duration

获取已经过的时间

pub fn elapsed_seconds(&self) -> f32

获取已经过的时间（秒）

pub fn duration(&self) -> Duration

获取计时器总时长

pub fn duration_seconds(&self) -> f32

获取计时器总时长（秒）

pub fn percent(&self) -> f32

获取完成百分比 (0.0 到 1.0)

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(2.0);
timer.tick(Duration::from_secs(1));
 
assert_eq!(timer.percent(), 0.5);

pub fn remaining(&self) -> Duration

获取剩余时间

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(3.0);
timer.tick(Duration::from_secs(1));
 
assert_eq!(timer.remaining(), Duration::from_secs(2));

pub fn remaining_seconds(&self) -> f32

获取剩余时间（秒）

pub fn reset(&mut self)

重置计时器到初始状态

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(1.0);
timer.tick(Duration::from_millis(500));
 
assert_eq!(timer.percent(), 0.5);
 
timer.reset();
assert_eq!(timer.percent(), 0.0);
assert!(!timer.finished());

pub fn pause(&mut self)

暂停计时器

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(1.0);
timer.pause();
 
assert!(timer.is_paused());
 
// 暂停状态下 tick 不会推进时间
timer.tick(Duration::from_secs(1));
assert_eq!(timer.elapsed_seconds(), 0.0);

pub fn resume(&mut self)

恢复计时器

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(1.0);
timer.pause();
timer.resume();
 
assert!(timer.is_running());

pub fn set_duration(&mut self, duration: Duration)

设置计时器时长

注意

如果新时长小于已经过的时间，计时器会立即完成。

示例

use anvilkit_core::time::Timer;
use std::time::Duration;
 
let mut timer = Timer::from_seconds(1.0);
timer.set_duration(Duration::from_secs(2));
 
assert_eq!(timer.duration_seconds(), 2.0);

pub fn set_repeating(&mut self, repeating: bool)

设置是否为重复计时器

示例

use anvilkit_core::time::Timer;
 
let mut timer = Timer::from_seconds(1.0);
assert!(!timer.is_repeating());
 
timer.set_repeating(true);
assert!(timer.is_repeating());

pub fn is_repeating(&self) -> bool

检查是否为重复计时器

pub fn is_running(&self) -> bool

检查计时器是否正在运行

pub fn is_paused(&self) -> bool

检查计时器是否已暂停

pub fn state(&self) -> TimerState

获取计时器状态

pub fn finish(&mut self)

强制完成计时器

将已经过时间设置为总时长，并触发完成状态。

示例

use anvilkit_core::time::Timer;
 
let mut timer = Timer::from_seconds(10.0);
timer.finish();
 
assert!(timer.finished());
assert!(timer.just_finished());

Trait Implementations

impl Clone for Timer

fn clone(&self) -> Timer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Timer

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.