Files
mirai/docs/api-reference.md
2025-12-29 22:04:39 +08:00

8.1 KiB

version, last_updated, status
version last_updated status
0.1.0 2024-01-20 draft

API 参考索引

本文档提供 MILAI 框架所有公共 API 的快速索引,帮助开发者快速查找所需接口。

核心类索引

基础层 (Core)

类名 命名空间 说明 文档位置
object milai 所有可共享对象的基类 02-phase0-infrastructure.md
widget_base milai UI 控件的抽象基类 02-phase0-infrastructure.md
spinlock milai::threading 自旋锁同步原语 02-phase0-infrastructure.md
thread_pool milai::threading 线程池管理器 02-phase0-infrastructure.md
task_graph milai::threading 任务依赖图 02-phase0-infrastructure.md

响应式系统 (Reactive)

类名 命名空间 说明 文档位置
signal<T> milai::reactive 可观察值 05-phase2-reactive-system.md
computed<T> milai::reactive 自动计算值 05-phase2-reactive-system.md
effect milai::reactive 副作用函数 05-phase2-reactive-system.md
dirty_tracker milai::reactive 脏标记追踪器 05-phase2-reactive-system.md

渲染系统 (Render)

类名 命名空间 说明 文档位置
render_context milai::render 渲染上下文 03-phase1a-rendering-core.md
pipeline milai::render 渲染管线 03-phase1a-rendering-core.md
batch milai::render 批处理器 03-phase1a-rendering-core.md
shader milai::shader 着色器封装 03-phase1a-rendering-core.md

窗口系统 (Window)

类名 命名空间 说明 文档位置
window milai::window 窗口抽象接口 02-phase0-infrastructure.md
window_manager milai::window 窗口管理器 02-phase0-infrastructure.md
dpi_scale milai::window DPI 缩放因子 02-phase0-infrastructure.md

文本系统 (Text)

类名 命名空间 说明 文档位置
font milai::text 字体资源 04-phase1b-text-input.md
text_shaper milai::text 文本整形器 04-phase1b-text-input.md
glyph_cache milai::text 字形缓存 04-phase1b-text-input.md
text_layout milai::text 文本布局 04-phase1b-text-input.md

输入系统 (Input)

类名 命名空间 说明 文档位置
input_manager milai::input 输入管理器 04-phase1b-text-input.md
gesture_manager milai::input 手势识别器 04-phase1b-text-input.md
focus_manager milai::input 焦点管理器 04-phase1b-text-input.md
ime_manager milai::input IME 管理器 04-phase1b-text-input.md

UI 控件系统 (UI)

类名 命名空间 说明 文档位置
widget milai::ui 控件基类 06-phase3-widget-system.md
container milai::ui 容器控件 06-phase3-widget-system.md
label milai::ui 文本标签 06-phase3-widget-system.md
button milai::ui 按钮 06-phase3-widget-system.md
text_input milai::ui 文本输入 06-phase3-widget-system.md

布局控件 (Layout)

类名 命名空间 说明 文档位置
h_stack milai::ui 水平布局 06-phase3-widget-system.md
v_stack milai::ui 垂直布局 06-phase3-widget-system.md
z_stack milai::ui 层叠布局 06-phase3-widget-system.md
spacer milai::ui 弹性空间 06-phase3-widget-system.md
overlay milai::ui 覆盖层 06-phase3-widget-system.md

调试系统 (Debug)

类名 命名空间 说明 文档位置
perf_monitor milai::debug 性能监控器 07-phase4-debugger.md
widget_tree_view milai::debug 控件树视图 07-phase4-debugger.md
inspector milai::debug 属性检查器 07-phase4-debugger.md
debug_overlay milai::debug 调试覆盖层 07-phase4-debugger.md

函数索引

工厂函数

函数 命名空间 说明
make_object<T>(args...) milai 创建对象并调用 on_created
make_weak<T>(args...) milai 创建弱引用
global_thread_pool() milai::threading 获取全局线程池实例
window::create(config) milai::window 创建窗口
label(text) milai::ui 创建标签
button(text) milai::ui 创建按钮
h_stack() milai::ui 创建水平布局
v_stack() milai::ui 创建垂直布局
z_stack() milai::ui 创建层叠布局

全局函数

函数 命名空间 说明
batch(fn) milai::reactive 批量更新
application::create() milai 创建应用实例

宏定义

说明
MILAI_NONCOPYABLE(class) 禁用拷贝构造和赋值
MILAI_NONMOVABLE(class) 禁用移动构造和赋值
MILAI_DEFAULT_MOVABLE(class) 启用默认移动操作

枚举索引

任务优先级

枚举值 说明
task_priority::low 低优先级
task_priority::normal 正常优先级
task_priority::high 高优先级
task_priority::critical 关键优先级

文本对齐

枚举值 说明
text_align::left 左对齐
text_align::center 居中
text_align::right 右对齐
text_align::justify 两端对齐

堆叠对齐

枚举值 说明
stack_alignment::start 起点对齐
stack_alignment::center 居中对齐
stack_alignment::end 终点对齐
stack_alignment::stretch 拉伸对齐

结构体索引

配置结构

结构体 命名空间 说明
window_config milai::window 窗口创建配置
text_style milai::text 文本样式
text_layout_config milai::text 文本布局配置
sdf_config milai::text SDF 生成配置
layout_style milai::ui 布局样式
shader_parameter milai::ui 着色器参数

类型别名

别名 原始类型 说明
widget::ptr std::shared_ptr<widget> 控件共享指针
widget::weak_ptr std::weak_ptr<widget> 控件弱指针
signal<T>::ptr std::shared_ptr<signal<T>> 信号共享指针

本文档随 API 演进持续更新