MotionBuilder Python脚本实战：从BVH到FBX的自动化转换
1. 为什么需要BVH到FBX的自动化转换
在动作捕捉和三维动画制作领域，BVH和FBX是两种最常见的文件格式。BVH（Biovision Hierarchy）是专门用于存储动作捕捉数据的格式，它记录了骨骼层次结构和旋转数据。而FBX（Filmbox）则是更通用的三维数据交换格式，支持动画、网格、材质等多种信息。
我见过太多团队在处理动捕数据时陷入重复劳动的困境。每次拿到新的BVH文件，都要手动导入MotionBuilder，调整参数，再导出为FBX。这个过程不仅耗时，而且容易出错。特别是在需要处理几十甚至上百个动作文件时，手动操作简直就是噩梦。
Python脚本自动化转换的优势很明显：
- 批量处理：可以一次性转换整个文件夹下的所有BVH文件
- 参数一致：确保每个文件的处理流程完全相同
- 节省时间：原本需要数小时的工作现在几分钟就能完成
- 减少错误：避免了人工操作可能带来的遗漏或失误
2. 环境准备与基础配置
2.1 安装必要的Python库
MotionBuilder内置了Python解释器，但默认环境比较精简。我们需要先安装一些必要的库：
# 通过MotionBuilder自带的mobupy.exe安装第三方库 mobupy.exe -m pip install numpy实测中发现，MotionBuilder对Python版本和库版本有一定要求。建议使用与MotionBuilder版本匹配的Python 2.7或3.x，避免兼容性问题。
2.2 配置Python编辑器
MotionBuilder内置了Python编辑器，可以通过菜单栏访问：
- 点击"Window" → "Python Editor"
- 建议将编辑器停靠在界面底部，方便随时调试脚本
- 设置合适的字体大小和配色方案，提高编码舒适度
我习惯在脚本开头添加以下配置，方便调试和日志记录：
import logging logging.basicConfig( filename="conversion.log", level=logging.DEBUG, format="%(asctime)s - %(levelname)s - %(message)s" )3. 核心转换脚本解析
3.1 BVH导入与数据处理
BVH文件包含骨骼层次和动画数据，我们需要先将其导入MotionBuilder场景：
def import_bvh(file_path): if not pyfbsdk.FBApplication().FileImport(file_path, True): raise IOError(f"Failed to import BVH file: {file_path}") logging.info(f"Successfully imported {file_path}")导入后通常需要对数据进行规范化处理。这是我常用的一个处理函数：
def normalize_mocap_data(trans, rots, ref_id=0): """正规化动捕数据""" # 将欧拉角转换为旋转矩阵 r = sciR.from_euler("xyz", rots, degrees=True).as_matrix() r1 = r[ref_id] # 计算参考坐标系 b1 = r1[0] b2 = np.array([0,1,0]) b1 = b1 - (b1*b2).sum(-1) * b2 b1 = b1 / np.linalg.norm(b1) b3 = np.cross(b1, b2) rref = np.vstack((b1, b2, b3)).T # 应用变换 r = np.einsum('cd,bda->bca', rref, r) trans = np.einsum('cd,bd->bc', rref, trans) rots = sciR.from_matrix(r).as_euler("xyz", degrees=True) # 调整位置 base_trans = trans[ref_id:ref_id+1].copy() base_trans[:, 1] = 0 trans = trans - base_trans return trans, rots3.2 FBX导出设置
FBX导出需要考虑多个参数设置，以下是一个完整的导出函数：
def export_fbx(output_path): # 设置FBX导出选项 options = pyfbsdk.FBExportOptions() options.UseASCIIFormat = False # 使用二进制格式 options.EmbedMedia = True # 嵌入媒体 options.Animation = True # 包含动画 # 执行导出 if not pyfbsdk.FBApplication().FileSave(output_path, options): raise IOError(f"Failed to export FBX file: {output_path}") logging.info(f"Successfully exported {output_path}")4. 完整自动化流程实现
4.1 单文件转换脚本
以下是完整的单文件转换脚本，集成了BVH导入、数据处理和FBX导出：
def convert_bvh_to_fbx(input_path, output_path=None): try: # 初始化场景 pyfbsdk.FBApplication().FileNew() # 设置默认输出路径 if not output_path: output_path = input_path.replace(".bvh", ".fbx") # 导入BVH import_bvh(input_path) # 数据处理（可选） # trans, rots = get_animation_data() # trans, rots = normalize_mocap_data(trans, rots) # apply_animation_data(trans, rots) # 导出FBX export_fbx(output_path) # 清理场景 pyfbsdk.FBApplication().FileExit() except Exception as e: logging.error(f"Conversion failed: {str(e)}") raise4.2 批量处理实现
实际项目中，我们通常需要处理整个文件夹的BVH文件。以下是批量处理的实现：
def batch_convert(input_dir, output_dir): # 确保输出目录存在 if not os.path.exists(output_dir): os.makedirs(output_dir) # 遍历输入目录下的所有BVH文件 for bvh_file in glob.glob(os.path.join(input_dir, "*.bvh")): try: # 构造输出路径 base_name = os.path.basename(bvh_file) fbx_file = os.path.join(output_dir, base_name.replace(".bvh", ".fbx")) # 执行转换 logging.info(f"Converting {bvh_file} to {fbx_file}") convert_bvh_to_fbx(bvh_file, fbx_file) except Exception as e: logging.error(f"Failed to convert {bvh_file}: {str(e)}") continue5. 实用技巧与常见问题解决
5.1 提高转换效率的技巧
经过多次项目实践，我总结出几个提升效率的技巧：
- 批处理模式运行：使用MotionBuilder的命令行模式可以跳过界面加载，显著提高速度：
"D:\MotionBuilder\bin\x64\motionbuilder.exe" -batch -console -verbosePython convert_script.py内存管理：长时间批量处理时，定期重启MotionBuilder可以避免内存泄漏问题。
并行处理：将文件分成多组，用多个MotionBuilder实例同时处理。
5.2 常见错误排查
问题1：骨骼映射错误
- 症状：导入后角色姿势异常
- 解决：检查BVH文件的骨骼命名是否与目标角色匹配
问题2：动画长度不一致
- 症状：FBX动画比原始BVH短或长
- 解决：在导入前设置正确的帧率和时间范围
# 设置动画长度为100帧 pyfbsdk.FBSystem().CurrentTake.LocalTimeSpan = pyfbsdk.FBTimeSpan( pyfbsdk.FBTime(0), pyfbsdk.FBTime(0,0,0,100) )问题3：缩放问题
- 症状：角色尺寸不正确
- 解决：在导入选项中设置正确的缩放单位
options = pyfbsdk.FBImportOptions() options.ForceScale = 0.01 # 例如从厘米转换为米6. 进阶应用：与模板角色结合
在实际制作中，我们通常需要将动捕数据应用到特定的角色模板上。以下是改进后的转换函数：
def convert_with_template(bvh_path, fbx_path, template_path): # 新建场景 pyfbsdk.FBApplication().FileNew() # 加载模板角色 if not pyfbsdk.FBApplication().FileOpen(template_path): raise IOError(f"无法打开模板文件: {template_path}") # 导入BVH动画 if not pyfbsdk.FBApplication().FileImport(bvh_path, True): raise IOError(f"无法导入BVH文件: {bvh_path}") # 这里可以添加动画重定向逻辑 # ... # 导出FBX pyfbsdk.FBApplication().FileSave(fbx_path) pyfbsdk.FBApplication().FileExit()这个进阶版本需要考虑骨骼映射、动画重定向等复杂问题，建议先在小规模数据上测试通过后再批量应用。