
RmlUi 示例
在原生 SFML 窗口中运行 RmlUi 文档。从计数器开始,再体验主题变量、拖动窗口、模板和视觉测试页面。
运行准备
以下命令均在 monorepo 根目录执行。首次运行 bootstrap 安装依赖并构建各包。需要显示环境和 OpenGL;macOS 原生构建另需 Xcode Command Line Tools 和 CMake。详见快速开始。
node tools/bootstrap.cjs修改 RmlUi TypeScript 源码后,执行 npm run build:ts --prefix packages/sfml.js-rmlui。示例使用本地构建的包。
启动器读取包内 third_party/rmlui 下 RmlUi 6.3 的内置资源。列出全部入口:
node packages/sfml.js-rmlui/examples/official.cjs --list示例






JavaScript FontEffectInstancer 与原生字形纹理回调
node packages/sfml.js-rmlui/examples/font-effect.cjs
操作:Space 切换发光效果,Escape 退出。
有限烟测:--frames N;--screenshot path.png 捕获最后一帧。

文件文档加载、原生内存快照与同步回调 RCSS 输入
node packages/sfml.js-rmlui/examples/streams.cjs
操作:Escape 退出。使用 --frames N --screenshot path.png 进行有限帧截图。

四角定位、文本测量、投影边界与自有裁剪几何
node packages/sfml.js-rmlui/examples/element-utilities.cjs
操作:Space 切换角点,Escape 退出。
--frames 6 --exercise --screenshot path.png 验证四个角点并截图。

平衡的原生图层、预乘透明度、自合成滤镜与保存的蒙版快照
node packages/sfml.js-rmlui/examples/render-layers.cjs
操作:空格移动图形,Escape 退出。
--frames 6 --exercise --screenshot path.png 验证两个位置并截取最后一帧。

延迟预乘字节生成、自有句柄转移与裁剪区域图层快照
node packages/sfml.js-rmlui/examples/callback-textures.cjs
操作:空格重新生成颜色;Esc 退出。
--frames 6 --exercise --screenshot path.png 验证缓存和重新生成,并截图最后一帧。

自定义原生上下文和输入控件的分配与释放、自有文档流、独立标签及 Factory 缓存
node packages/sfml.js-rmlui/examples/factory-elements.cjs
操作:输入框编辑,空格更新文本,Escape 退出。
--frames 6 --exercise --screenshot path.png 验证编辑并截图最后一帧。

原生标量、递归 data-for、共享数组、稀疏补丁、getter 与变换求值、自定义 Factory 视图及默认双向控制器委派
node packages/sfml.js-rmlui/examples/data-models.cjs
操作:Increment 更新计数,编辑标题,切换详情,Escape 退出。
--frames 6 --exercise --screenshot path.png 验证真实绑定并截图最后一帧。


六个原始标签页、装饰器与颜色补间、表单控件、四秒提交动画,以及实时 RML/RCSS 编辑器
node packages/sfml.js-rmlui/examples/official.cjs basic-demo
操作:切换标签页,调整补间,提交表单,编辑沙盒。Escape 先取消已打开的主题选择框,否则退出。F8 切换 Debugger。
--panel sandbox --frames 8 --exercise --screenshot path.png 验证两侧编辑器并截图沙盒。面板:welcome、decorators、font-effects、animations、controls、sandbox。



每次更新重新生成原始 50 行,保留独立渲染和 200 项 FPS 环形缓冲
node packages/sfml.js-rmlui/examples/official.cjs benchmark
操作:Space 暂停渲染,Down 单步渲染,Return 暂停行更新,Right 单步更新,F8 切换 Debugger,Escape 退出。
--frames 3 --screenshot path.png 限定运行帧数并截图。







使用原始字体塑形英文、阿拉伯文与印地文段落。
node packages/sfml.js-rmlui/examples/official.cjs harfbuzz
点击语言按钮切换段落。Escape 退出。



运行原始 C++ 游戏、菜单、装饰器和高分榜数据模型。
node packages/sfml.js-rmlui/examples/official.cjs invaders
左右键移动,空格开火,Escape 打开暂停菜单,F8 切换 Debugger。通过原始菜单重开或退出。
先构建包;游戏模块在同一个构建目录中生成,加载时无需编译器。macOS 已验证;Linux 和 Windows 实际执行仍待验证。
高分保存到应用数据目录。--scores-file /absolute/path/scores.txt 指定已有父目录中的文件。--frames 8 --exercise 启动限帧游戏。

原始 Lua 文档和 Game 表驱动原始原生游戏。
node packages/sfml.js-rmlui/examples/official.cjs lua-invaders
左右键移动,空格开火,Escape 打开暂停菜单,F8 切换 Debugger。设置保存到所选高分文件的同目录。
先构建包;游戏模块在同一个构建目录中生成,加载时无需编译器。macOS 已验证;Linux 和 Windows 实际执行仍待验证。
--scores-file /absolute/path/scores.txt 指定已有父目录中的文件。--frames 8 --exercise 启动限帧游戏。

浏览 113 个上游视觉测试页面
node packages/sfml.js-rmlui/examples/official.cjs visual/clip_mask
操作:F6/F7 切换页面,Escape 退出。
在命令后追加 --frames 60 可在 60 帧后关闭窗口。 --frames N 接受正整数,便于限定时长的冒烟检查。 这里提供预览,未接入上游断言框架。
113 页 VisualTests 断言、真实 IME 检查、游戏的剩余平台工作及全项目独立验收仍待完成。渲染器与模块检查分别保留在对应指南的证据中。截图均来自实际运行的原生应用。
全部示例 · RmlUi 快速开始 · 上游示例