131 lines
4.2 KiB
C
131 lines
4.2 KiB
C
#pragma once
|
||
|
||
#include "wm_types.h"
|
||
|
||
/*
|
||
* wm_event_t 表示“runtime 真正关心的输入事实”：
|
||
* - 它不是平台原始事件的逐字段照抄
|
||
* - 它允许 backend 对平台事件做最小必要的归一化 / 过滤 / 聚合
|
||
* - 它不承载 runtime 控制语义；stop / restart / error 由 backend.next_event()
|
||
* 的返回结果表达，而不是伪装成一个事件类型
|
||
*/
|
||
typedef enum wm_event_type_t {
|
||
WM_EVENT_KEY_PRESS,
|
||
WM_EVENT_POINTER_BUTTON_PRESS,
|
||
WM_EVENT_POINTER_BUTTON_RELEASE,
|
||
WM_EVENT_POINTER_MOTION,
|
||
WM_EVENT_WINDOW_MAP_REQUEST,
|
||
WM_EVENT_WINDOW_UNMAP,
|
||
WM_EVENT_WINDOW_DESTROY,
|
||
WM_EVENT_WINDOW_METADATA_CHANGED,
|
||
WM_EVENT_CONFIGURE_REQUEST,
|
||
WM_EVENT_TIMER_TICK,
|
||
WM_EVENT_STATUS_TICK,
|
||
} wm_event_type_t;
|
||
|
||
typedef struct wm_key_press_event_t {
|
||
/*
|
||
* 规范化后的逻辑主键编码（xkb keysym）。
|
||
* backend 应先结合 keymap / xkb state 把原始按键解析成逻辑键，再写入这里。
|
||
* 它适合与 "SUPER+m" 这类配置字符串解析结果做匹配。
|
||
*/
|
||
wm_keysym_t keysym;
|
||
// backend 归一化后的修饰键掩码
|
||
wm_modifier_mask_t modifiers;
|
||
/*
|
||
* backend 原始物理键编码。
|
||
* 它保留平台侧按键信息，便于调试、日志或未来按物理键位绑定；
|
||
* 常规快捷键匹配不应直接使用它。
|
||
*/
|
||
uint32_t keycode;
|
||
} wm_key_press_event_t;
|
||
|
||
typedef struct wm_pointer_button_event_t {
|
||
wm_button_t button;
|
||
wm_modifier_mask_t modifiers;
|
||
// backend 原始按钮码，仅供调试或未来平台特化逻辑使用
|
||
uint32_t raw_button;
|
||
// 全局桌面坐标
|
||
wm_point_t root;
|
||
// 相对 window 的坐标；若 window == WM_WINDOW_ID_INVALID，则该值未定义
|
||
wm_point_t local;
|
||
// 当前命中的窗口；若未命中窗口，则为 WM_WINDOW_ID_INVALID
|
||
wm_window_id_t window;
|
||
} wm_pointer_button_event_t;
|
||
|
||
typedef struct wm_pointer_motion_event_t {
|
||
// 全局桌面坐标
|
||
wm_point_t root;
|
||
// 相对 window 的坐标；若 window == WM_WINDOW_ID_INVALID，则该值未定义
|
||
wm_point_t local;
|
||
// 当前命中的窗口；若未命中窗口，则为 WM_WINDOW_ID_INVALID
|
||
wm_window_id_t window;
|
||
} wm_pointer_motion_event_t;
|
||
|
||
typedef struct wm_window_map_request_event_t {
|
||
wm_window_id_t window;
|
||
} wm_window_map_request_event_t;
|
||
|
||
typedef struct wm_window_unmap_event_t {
|
||
wm_window_id_t window;
|
||
} wm_window_unmap_event_t;
|
||
|
||
typedef struct wm_window_destroy_event_t {
|
||
wm_window_id_t window;
|
||
} wm_window_destroy_event_t;
|
||
|
||
typedef enum wm_window_meta_changed_flags_t {
|
||
WM_WINDOW_META_CHANGED_NONE = 0,
|
||
WM_WINDOW_META_CHANGED_TITLE = 1u << 0,
|
||
WM_WINDOW_META_CHANGED_APP_ID = 1u << 1,
|
||
WM_WINDOW_META_CHANGED_CLASS = 1u << 2,
|
||
WM_WINDOW_META_CHANGED_INSTANCE = 1u << 3,
|
||
} wm_window_meta_changed_flags_t;
|
||
|
||
typedef struct wm_window_metadata_changed_event_t {
|
||
wm_window_id_t window;
|
||
uint32_t changed_fields;
|
||
/*
|
||
* These strings are borrowed from the backend adapter and are valid until
|
||
* wm_runtime_process_event() returns. changed_fields decides which ones are
|
||
* meaningful for the current event.
|
||
* runtime 会复制这些字符串到 wm_window_t 中的对应字段。
|
||
*/
|
||
const char *title;
|
||
const char *app_id;
|
||
const char *class_name;
|
||
const char *instance_name;
|
||
} wm_window_metadata_changed_event_t;
|
||
|
||
typedef struct wm_configure_request_event_t {
|
||
wm_window_id_t window;
|
||
wm_rect_t requested_rect;
|
||
} wm_configure_request_event_t;
|
||
|
||
typedef struct wm_timer_tick_event_t {
|
||
wm_time_ms_t now_ms;
|
||
} wm_timer_tick_event_t;
|
||
|
||
typedef struct wm_status_tick_event_t {
|
||
wm_time_ms_t now_ms;
|
||
} wm_status_tick_event_t;
|
||
|
||
typedef struct wm_event_t {
|
||
wm_event_type_t type;
|
||
// backend 归一化后的事件时间值（毫秒），不是 wall-clock 时间戳
|
||
wm_time_ms_t time_ms;
|
||
union {
|
||
wm_key_press_event_t key_press;
|
||
wm_pointer_button_event_t pointer_button_press;
|
||
wm_pointer_button_event_t pointer_button_release;
|
||
wm_pointer_motion_event_t pointer_motion;
|
||
wm_window_map_request_event_t window_map_request;
|
||
wm_window_unmap_event_t window_unmap;
|
||
wm_window_destroy_event_t window_destroy;
|
||
wm_window_metadata_changed_event_t window_metadata_changed;
|
||
wm_configure_request_event_t configure_request;
|
||
wm_timer_tick_event_t timer_tick;
|
||
wm_status_tick_event_t status_tick;
|
||
} data;
|
||
} wm_event_t;
|