core: 定义核心事件数据模型并更新其文档

This commit is contained in:
2026-03-21 02:51:43 +08:00
parent 4c96f2a1db
commit 931dc3d8d5
22 changed files with 1204 additions and 220 deletions

View File

@@ -3,7 +3,7 @@
#include <stddef.h>
#include "core/types.h"
#include "wm_desc.h"
#include "core/wm_desc.h"
/* 核心实体定义 */
typedef struct wm_window_t {
@@ -75,7 +75,8 @@ typedef struct wm_state_t {
* - wm_state_init() / wm_state_cleanup() 必须成对调用
* - 同一个 state 生命周期内wm_state_init() 不允许重复调用
* - 除 wm_state_init() 外,其余 state 相关接口都要求 state 已初始化
* - workspaces[i] 必须满足 wm_workspace_desc_valid(&workspaces[i], output_count)
* - workspaces[i] 必须满足 wm_workspace_desc_valid(&workspaces[i],
* output_count)
* - 传入空指针、未初始化对象或违反前置条件属于调用方错误
*
* 初始化时根据描述表构建 outputs[] 与 workspaces[]。
@@ -84,8 +85,7 @@ typedef struct wm_state_t {
* workspace若某个 output 没有任何归属 workspacewm_state_init() 会失败。
*/
void wm_state_init(wm_state_t *state, const wm_output_info_t *outputs,
size_t output_count,
const wm_workspace_desc_t *workspaces,
size_t output_count, const wm_workspace_desc_t *workspaces,
size_t workspace_count);
void wm_state_cleanup(wm_state_t *state);