2. 操作符模块(AddonOperators)¶
模块标识符:AddonOperators.py
编制员:开发团队
修改完成日期:2025年12月31日
2.1 模块功能¶
定义MoMask系统所有Blender操作符,实现UI与业务逻辑桥接。包含:模型预览、热加载、BVH导入、动作重定向、完整管道操作。
对应需求:软件需求说明书第3章第3节"用户交互功能"
2.2 输入输出信息¶
- 输入:外部模型目录、模型枚举、目标骨架、BVH目录、操作符参数、烘焙后清除标志
- 输出:加载的集合/骨架、导入的骨架、操作结果、用户提示
2.3 处理描述¶
- 模型预览:验证选择→加载模型→移至中心→设为目标骨架
- 模型热加载:构建路径→验证文件→加载骨架→自动指定目标
- BVH重导入:确定目录→扫描文件→导入BVH
- 动作重定向:验证参数→导入BVH→执行重定向→烘焙动画→清理约束
- 完整管道:请求下载→获取路径→重定向预览→自动烘焙
2.4 测试说明¶
- TEST_OP_001:模型预览测试
- TEST_OP_002:热加载测试
- TEST_OP_003:BVH重导入测试
- TEST_OP_004:重定向完整测试
- TEST_OP_005:完整管道测试
- TEST_OP_006:错误处理测试
- TEST_OP_007:清理测试