228 lines
7.9 KiB
C
228 lines
7.9 KiB
C
#pragma once
|
||
|
||
#include "wm_desc.h"
|
||
|
||
/*
|
||
* wm_event_t 表示“runtime 真正关心的输入事实”：
|
||
* - 它不是平台原始事件的逐字段照抄
|
||
* - 它允许 backend 对平台事件做最小必要的归一化 / 过滤 / 聚合
|
||
* - 它不承载 runtime 控制语义；stop / restart / error 由 backend.next_event()
|
||
* 的返回结果表达，而不是伪装成一个事件类型
|
||
*/
|
||
typedef enum wm_event_type_t {
|
||
// 最小核心里的快捷键只由 key press 触发，不单独暴露 key release 事件
|
||
WM_EVENT_KEY_PRESS,
|
||
// 鼠标绑定只匹配 button press；button release 主要供交互态结束拖拽使用
|
||
WM_EVENT_POINTER_BUTTON_PRESS,
|
||
WM_EVENT_POINTER_BUTTON_RELEASE,
|
||
WM_EVENT_POINTER_MOTION,
|
||
// 指针焦点进入某个窗口；对应 X11 EnterNotify / Wayland wl_pointer.enter
|
||
WM_EVENT_POINTER_ENTER,
|
||
WM_EVENT_WINDOW_MAP_REQUEST,
|
||
WM_EVENT_WINDOW_REMOVE,
|
||
WM_EVENT_WINDOW_METADATA_CHANGED,
|
||
WM_EVENT_WINDOW_HINTS_CHANGED,
|
||
WM_EVENT_WINDOW_ACTIVATE_REQUEST,
|
||
WM_EVENT_WINDOW_STATE_REQUEST,
|
||
WM_EVENT_CONFIGURE_REQUEST,
|
||
} 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_pointer_enter_event_t {
|
||
// 全局桌面坐标
|
||
wm_point_t root;
|
||
// 相对 window 的坐标；若 window == WM_WINDOW_ID_INVALID，则该值未定义
|
||
wm_point_t local;
|
||
// 当前进入并获得 pointer focus 的窗口；若未命中窗口，则为 WM_WINDOW_ID_INVALID
|
||
wm_window_id_t window;
|
||
} wm_pointer_enter_event_t;
|
||
|
||
typedef struct wm_window_map_request_event_t {
|
||
wm_window_info_t info;
|
||
// 仅用于 manage 路由判断，不进入持久 state
|
||
wm_window_id_t transient_for;
|
||
// 仅用于 manage 路由判断，不进入持久 state
|
||
bool is_dialog;
|
||
} wm_window_map_request_event_t;
|
||
|
||
/*
|
||
* 归一化后的窗口移除事件。
|
||
* backend 把 withdraw / destroy 这类平台差异折叠成单一 remove 事件，
|
||
* core 只按 reason 区分“为何离开 managed 集合”。
|
||
*/
|
||
typedef enum wm_window_remove_reason_t {
|
||
WM_WINDOW_REMOVE_WITHDRAWN,
|
||
WM_WINDOW_REMOVE_DESTROY,
|
||
} wm_window_remove_reason_t;
|
||
|
||
typedef struct wm_window_remove_event_t {
|
||
wm_window_id_t window;
|
||
wm_window_remove_reason_t reason;
|
||
} wm_window_remove_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 enum wm_window_hint_changed_flags_t {
|
||
WM_WINDOW_HINT_CHANGED_NONE = 0,
|
||
WM_WINDOW_HINT_CHANGED_URGENT = 1u << 0,
|
||
WM_WINDOW_HINT_CHANGED_FIXED_SIZE = 1u << 1,
|
||
WM_WINDOW_HINT_CHANGED_SKIP_TASKBAR = 1u << 2,
|
||
} wm_window_hint_changed_flags_t;
|
||
|
||
/*
|
||
* 客户端属性 / hint 变化的归一化结果。
|
||
* 这类事件不是控制请求，不经过 command 路由；
|
||
* runtime 直接把结果同步到 wm_window_t 中的 hint/capability 字段。
|
||
*/
|
||
typedef struct wm_window_hints_changed_event_t {
|
||
wm_window_id_t window;
|
||
uint32_t changed_fields;
|
||
bool urgent;
|
||
bool fixed_size;
|
||
bool skip_taskbar;
|
||
} wm_window_hints_changed_event_t;
|
||
|
||
/*
|
||
* 归一化后的窗口激活请求来源。
|
||
* 取值对齐 EWMH _NET_ACTIVE_WINDOW 的 source indication：
|
||
* - 0: 旧客户端 / 未指明来源
|
||
* - 1: 应用自身发起
|
||
* - 2: pager / taskbar / window switcher 发起
|
||
*/
|
||
typedef enum wm_window_activation_source_t {
|
||
WM_WINDOW_ACTIVATION_SOURCE_LEGACY = 0,
|
||
WM_WINDOW_ACTIVATION_SOURCE_APPLICATION = 1,
|
||
WM_WINDOW_ACTIVATION_SOURCE_PAGER = 2,
|
||
} wm_window_activation_source_t;
|
||
|
||
typedef struct wm_window_activate_request_event_t {
|
||
wm_window_id_t window;
|
||
wm_window_activation_source_t source;
|
||
} wm_window_activate_request_event_t;
|
||
|
||
/*
|
||
* 归一化后的窗口模式切换请求。
|
||
* backend 保留 add/remove/toggle 这类原始协议语义；
|
||
* route_event() 再结合当前 wm_state_t 翻译成最终的 SET_* 命令。
|
||
*/
|
||
typedef enum wm_window_state_request_kind_t {
|
||
WM_WINDOW_STATE_REQUEST_FULLSCREEN,
|
||
WM_WINDOW_STATE_REQUEST_MAXIMIZED,
|
||
WM_WINDOW_STATE_REQUEST_MINIMIZED,
|
||
} wm_window_state_request_kind_t;
|
||
|
||
typedef enum wm_window_state_request_action_t {
|
||
WM_WINDOW_STATE_REQUEST_ACTION_ADD,
|
||
WM_WINDOW_STATE_REQUEST_ACTION_REMOVE,
|
||
WM_WINDOW_STATE_REQUEST_ACTION_TOGGLE,
|
||
} wm_window_state_request_action_t;
|
||
|
||
typedef struct wm_window_state_request_event_t {
|
||
wm_window_id_t window;
|
||
wm_window_state_request_kind_t kind;
|
||
wm_window_state_request_action_t action;
|
||
} wm_window_state_request_event_t;
|
||
|
||
typedef enum wm_configure_request_field_t {
|
||
WM_CONFIGURE_REQUEST_FIELD_NONE = 0,
|
||
WM_CONFIGURE_REQUEST_FIELD_X = 1u << 0,
|
||
WM_CONFIGURE_REQUEST_FIELD_Y = 1u << 1,
|
||
WM_CONFIGURE_REQUEST_FIELD_WIDTH = 1u << 2,
|
||
WM_CONFIGURE_REQUEST_FIELD_HEIGHT = 1u << 3,
|
||
} wm_configure_request_field_t;
|
||
|
||
/*
|
||
* 归一化后的窗口配置请求。
|
||
* 这类事件只表达稀疏几何请求，不承载 fullscreen/maximize/minimize
|
||
* 之类窗口模式切换；后者应进入独立的 state request event。
|
||
*
|
||
* x / y / width / height 中只有 changed_fields 指示的成员才有意义。
|
||
*/
|
||
typedef struct wm_configure_request_event_t {
|
||
wm_window_id_t window;
|
||
uint32_t changed_fields;
|
||
int32_t x;
|
||
int32_t y;
|
||
int32_t width;
|
||
int32_t height;
|
||
} wm_configure_request_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_pointer_enter_event_t pointer_enter;
|
||
wm_window_map_request_event_t window_map_request;
|
||
wm_window_remove_event_t window_remove;
|
||
wm_window_metadata_changed_event_t window_metadata_changed;
|
||
wm_window_hints_changed_event_t window_hints_changed;
|
||
wm_window_activate_request_event_t window_activate_request;
|
||
wm_window_state_request_event_t window_state_request;
|
||
wm_configure_request_event_t configure_request;
|
||
} data;
|
||
} wm_event_t;
|