收消息

触摸 / 按键 / 定时器消息怎么收。

完整清单见「UI 开发」。下面每个接口都带一句用法和一个例子；签名取自 Lib/c/vml_ui.h（权威来源）。

ui_msg_get_a(void)

当前消息的第一个参数（触摸的 x、按键的键码、定时器的 id…）。

int x = ui_msg_get_a();

ui_msg_get_b(void)

当前消息的第二个参数（触摸的 y…）。

int y = ui_msg_get_b();

ui_msg_clear(void)

清空消息队列（切场景 / 重开一局时用，免得把上一局的按键吃进来）。

ui_msg_clear();

ui_msg_get_count(void)

队列里还积着几条（想丢掉积压时可以看一眼）。

if (ui_msg_get_count() > 8) ui_msg_clear();

ui_msg_get_type(void)

当前消息的类型（省得把 msg[0] 记在脑子里）。

if (ui_msg_get_type() == VML_MSG_TOUCHDOWN) { /* 处理 */ }

ui_msg_read(int* msg)

不等：没有消息就返回 VML_MSG_NONE。连续动画用这个（配自己的节拍）；事件驱动的用 ui_msg_wait（常态省电）。 ⚠ 只有 int* msg 一个参数 —— 没有 timeout，别照 ui_msg_wait 写。

int m[4];
while (ui_win_is_closed() == 0) {
    if (ui_msg_read(m) == VML_MSG_TOUCHDOWN) { /* 处理 */ }
    /* 画一帧 */
    ui_2d_present();
}

ui_msg_read_ex(int* msg, int keep)

ui_msg_read 的带「读完后留不留」版本。

int m[4];
ui_msg_read_ex(m, VML_MSG_CONSUME);

ui_msg_fetch(void)

不碰指针的取消息版本（拿不到数组指针的语言用）：没有就返回 VML_MSG_NONE，参数用 ui_msg_get_a() / ui_msg_get_b() 读。

if (ui_msg_fetch() == VML_MSG_TOUCHDOWN) { int x = ui_msg_get_a(); int y = ui_msg_get_b(); }

ui_msg_wait(int* msg, int timeout_ms)

等一条消息，参数是 int msg[4]。返回消息类型（见下表）；timeout=0 表示一直等。

int m[4];
int t = ui_msg_wait(m, 0);   /* 一直等 */

ui_msg_wait_ex(int* msg, int timeout_ms, int keep)

同上，第三个参数决定读完之后留不留这条消息（VML_MSG_KEEP / VML_MSG_CONSUME）。

int m[4];
ui_msg_wait_ex(m, 0, VML_MSG_KEEP);   /* 读完不弹掉 */

ui_msg_fetch_wait(int timeout_ms)

不碰指针的等消息版本：等到就返回类型、超时返回 VML_MSG_NONE。

if (ui_msg_fetch_wait(500) == VML_MSG_TIMER) { /* 一拍到了 */ }