timer_t

概述

定时器系统。

本定时器精度较低，最高精度为1000/FPS，如果需要高精度的定时器，请用OS提供的定时器。

示例：

static ret_t my_on_timer(const timer_info_t* info) {
widget_t* widget = WIDGET(info->ctx);
...
return RET_REPEAT;
}

...

timer_add(my_on_timer, widget, 1000);

在非GUI线程请用timer_queue。

函数

timer_add 函数

• 函数功能：

增加一个timer。

• 函数原型：

uint32_t timer_add (timer_func_t on_timer, void* ctx, uint32_t duration);

• 参数说明：

timer_count 函数

• 函数功能：

返回timer的个数。

• 函数原型：

uint32_t timer_count ();

• 参数说明：

timer_modify 函数

• 函数功能：

修改指定的timer的duration，修改之后定时器重新开始计时。

• 函数原型：

ret_t timer_modify (uint32_t timer_id, uint32_t duration);

• 参数说明：

timer_next_time 函数

• 函数功能：

返回最近的timer到期时间。

• 函数原型：

uint32_t timer_next_time ();

• 参数说明：

timer_queue 函数

• 函数功能：

用于非GUI线程增加一个timer，本函数向主循环的事件队列中发送一个增加timer的请求。

timer回调函数，回调函数返回RET_REPEAT，则下次继续执行，否则自动移出。

• 函数原型：

ret_t timer_queue (timer_func_t , void* ctx, uint32_t duration);

• 参数说明：

timer_remove 函数

• 函数功能：

删除指定的timer。

• 函数原型：

ret_t timer_remove (uint32_t timer_id);

• 参数说明：

timer_reset 函数

• 函数功能：

重置指定的timer，重置之后定时器重新开始计时。

• 函数原型：

ret_t timer_reset (uint32_t timer_id);

• 参数说明：

timer_set_on_destroy 函数

• 函数功能：

设置一个回调函数，在timer被销毁时调用(方便脚本语言去释放回调函数)。

• 函数原型：

ret_t timer_set_on_destroy (uint32_t timer_id, tk_destroy_t on_destroy, void* on_destroy_ctx);

• 参数说明：