LiftSim软件界面测试引擎使用说明

LiftSim是一款专注于吊装/起重机作业场景的专业仿真软件，其Test模块是保障仿真流程可靠性、验证各功能模块正确性的核心工具。

该模块通过系统化的测试用例设计、实时日志反馈与可视化配置，帮助用户快速完成从基础模型导入到完整动画工作流的全流程验证，为实际吊装作业的仿真分析提供坚实支撑。

2.1 界面布局

LiftSim主界面分为五大功能区域，为测试功能提供直观入口：

• 顶部菜单栏：包含`Home` / `View` / `Libraries` / `Test` / `Settings` 五大核心菜单，其中`Test`菜单是测试功能的核心入口。

• Test快捷操作区：提供`Run All`（全量运行）、`Stop`（停止）、`Basic`（基础测试）、`Advanced`（高级测试）、`Engine UI`（测试引擎界面）等快捷按钮，支持快速触发不同层级的测试操作。

• 左侧项目树：展示当前项目结构，包括`Blocks`（块模型）、`Cranes`（起重机）、`Eye Plates`（眼板）、`Links`（连接件）等核心仿真对象，是测试数据的载体。

• 中间设计区：提示“Import a block model to start designing”，明确告知用户：需先导入块模型，才能启动后续设计与测试流程。

• 右侧动画数据区：初始状态显示“No Animation Data”，测试完成后将在此展示仿真动画结果与数据。

2.2 测试入口操作

点击顶部菜单栏`Test` → 点击`Engine UI`按钮，即可打开Dear ImGui Test Engine测试引擎窗口，进入核心测试交互界面。

3.1 测试用例列表

测试引擎窗口的`Tests`标签页下，预设了覆盖全流程的核心测试用例：

3.2 运行控制与状态反馈

• 单例运行：点击每个用例前的`Run`按钮，可单独执行对应测试。

• 全量运行：点击顶部`Run All`按钮，一键触发所有测试用例的顺序执行。

• 实时状态：测试用例执行状态会实时更新，失败用例会以红色标记，便于快速识别问题。

3.3 日志反馈与问题排查

下方`LOG`标签页会实时打印测试过程与结果，例如典型错误提示：

日志清晰告知用户测试失败的根因（如缺少前置依赖、参数配置错误等），帮助快速定位并解决问题。

切换至测试引擎窗口的`Tools`标签页，可对测试过程进行深度配置：

4.1 屏幕/视频录制配置

• 录制触发方式：

￮ `Capture when requested by API`：API触发录制（默认勾选，适配自动化测试场景）

￮ `Capture screen on error`：错误发生时自动截屏，便于问题复现

• 编码器配置：

￮ `Video Encoder Path`：指定视频编码器路径

￮ `Video Encoder params`：配置视频编码参数（分辨率、码率等）

￮ `Gif Encoder params`：配置GIF编码参数（帧率、压缩率等）

• 输出格式：

支持选择`.mp4`等视频格式，用于测试过程可视化留存。

4.2 性能优化选项

• 全局延迟控制：`Slow down whole app`可设置毫秒级延迟，便于观察测试细节（适合教学演示）

• 性能模式切换：`Unthrolled`/`Pick ref dt`用于平衡仿真流畅度与系统资源占用

• 实时性能监控：展示单帧耗时、FPS（帧率）、近500帧性能波动曲线，帮助分析性能瓶颈

4.3 UI重置

点击`Reboot UI context`按钮，可快速重置测试引擎界面上下文，解决界面卡顿或异常显示问题。

推荐的标准测试流程如下：

1. 前置准备：在主界面导入块模型，或直接执行`import_block_model_with_progress`测试用例，完成基础数据准备

2. 分步验证：依次执行`import_crane` / `import_eyeplate`等组件导入用例，确保各仿真对象正常加载

3. 流程联动：执行`auto_connect`测试，验证组件间自动连接逻辑的正确性

4. 成果输出：执行`animation_recording_workflow`，启动动画录制并导出视频/GIF文件

5. 问题排查：通过`LOG`标签页反馈，定位测试失败原因，迭代优化模型与配置

6.1 功能总结

LiftSim的Test模块通过结构化用例、可视化日志、灵活配置三大核心能力，为吊装仿真场景提供了高效、可靠的测试验证方案，大幅提升了仿真工作的效率与成果质量。

6.2 常见问题