MotionBuilder 2022 Python脚本实战：BVH转FBX自动化处理（附完整代码）

MotionBuilder 2022 Python脚本实战BVH转FBX自动化处理附完整代码在动画制作流程中BVHBiovision Hierarchy和FBXFilmbox是两种常见的文件格式。BVH通常用于动作捕捉数据的存储而FBX则是行业标准的3D动画交换格式。对于需要处理大量动捕数据的动画师和技术美术来说如何高效地将BVH转换为FBX是一个常见的痛点问题。MotionBuilder作为专业的3D角色动画软件内置了Python脚本环境这为我们提供了自动化处理的可能性。本文将带你从零开始构建一个完整的BVH转FBX自动化解决方案涵盖项目结构设计、日志记录、异常处理等工程化实践特别针对Windows平台下的路径处理等实际问题提供解决方案。1. 环境准备与项目结构在开始编写脚本之前合理的项目结构能够大大提高后续开发和维护的效率。我们建议采用以下目录结构bvh2fbx_project/ ├── config/ # 配置文件目录 ├── input/ # 输入BVH文件 ├── output/ # 输出FBX文件 ├── logs/ # 日志文件 ├── templates/ # FBX模板文件 ├── scripts/ # Python脚本 │ ├── bvh2fbx.py # 主脚本 │ └── utils.py # 工具函数 └── README.md # 项目说明1.1 MotionBuilder Python环境配置MotionBuilder使用的是内置的Python环境通常为Python 2.7或3.x版本。要检查当前版本可以在MotionBuilder的Python编辑器中运行import sys print(sys.version)如果需要安装额外的Python库可以使用MotionBuilder自带的pipmobupy.exe -m pip install 包名注意MotionBuilder的Python环境是独立的与系统Python环境不冲突但也不共享已安装的包。2. 核心转换脚本开发2.1 基础转换功能实现首先我们创建一个基本的BVH转FBX函数处理单个文件的转换import pyfbsdk import logging def convert_bvh_to_fbx(input_path, output_path, template_pathNone): 将BVH文件转换为FBX格式 参数: input_path: 输入的BVH文件路径 output_path: 输出的FBX文件路径 template_path: 可选的FBX模板文件路径 try: # 初始化新场景 pyfbsdk.FBApplication().FileNew() # 加载模板文件如果提供 if template_path and not pyfbsdk.FBApplication().FileOpen(template_path): raise IOError(f无法打开模板文件: {template_path}) # 导入BVH文件 if not pyfbsdk.FBApplication().FileImport(input_path, True): raise IOError(f无法导入BVH文件: {input_path}) # 保存为FBX if not pyfbsdk.FBApplication().FileSave(output_path): raise IOError(f无法保存FBX文件: {output_path}) return True except Exception as e: logging.error(f转换失败: {str(e)}) return False2.2 增强的批量处理功能对于实际生产环境我们需要处理的是批量转换任务。以下是一个增强版的批量处理函数import os import glob from datetime import datetime def batch_convert_bvh_to_fbx(input_dir, output_dir, template_pathNone): 批量转换目录中的所有BVH文件为FBX 参数: input_dir: 包含BVH文件的输入目录 output_dir: 输出FBX文件的目录 template_path: 可选的FBX模板文件路径 # 确保输出目录存在 os.makedirs(output_dir, exist_okTrue) # 获取所有BVH文件 bvh_files glob.glob(os.path.join(input_dir, *.bvh)) if not bvh_files: logging.warning(f在目录 {input_dir} 中未找到BVH文件) return total_files len(bvh_files) success_count 0 logging.info(f开始批量转换共 {total_files} 个文件需要处理) start_time datetime.now() for i, bvh_file in enumerate(bvh_files, 1): try: # 构造输出路径 base_name os.path.splitext(os.path.basename(bvh_file))[0] fbx_file os.path.join(output_dir, f{base_name}.fbx) logging.info(f正在处理文件 {i}/{total_files}: {bvh_file}) # 执行转换 if convert_bvh_to_fbx(bvh_file, fbx_file, template_path): success_count 1 logging.info(f成功转换: {fbx_file}) else: logging.error(f转换失败: {bvh_file}) except Exception as e: logging.error(f处理文件 {bvh_file} 时发生错误: {str(e)}) end_time datetime.now() elapsed end_time - start_time logging.info( f批量转换完成共处理 {total_files} 个文件 f成功 {success_count} 个失败 {total_files - success_count} 个 f耗时: {elapsed.total_seconds():.2f} 秒 ) return success_count total_files3. 工程化实践3.1 完善的日志系统良好的日志系统对于自动化脚本至关重要它能帮助我们追踪问题、分析性能。我们使用Python内置的logging模块配置如下import logging from logging.handlers import RotatingFileHandler def setup_logging(log_filebvh2fbx.log, log_levellogging.INFO): 配置日志系统 logger logging.getLogger() logger.setLevel(log_level) # 文件处理器 - 自动轮转最大5个文件每个10MB file_handler RotatingFileHandler( log_file, maxBytes10*1024*1024, backupCount5, encodingutf-8 ) file_handler.setFormatter(logging.Formatter( %(asctime)s - %(name)s - %(levelname)s - %(message)s )) # 控制台处理器 console_handler logging.StreamHandler() console_handler.setFormatter(logging.Formatter( %(asctime)s - %(levelname)s - %(message)s )) # 添加处理器 logger.addHandler(file_handler) logger.addHandler(console_handler) return logger3.2 异常处理与重试机制在实际运行中可能会遇到各种异常情况。我们实现一个带有重试机制的包装函数import time def with_retry(func, max_attempts3, delay1, *args, **kwargs): 带重试机制的函数包装器 参数: func: 要执行的函数 max_attempts: 最大尝试次数 delay: 重试间隔(秒) args, kwargs: 传递给func的参数 last_exception None for attempt in range(1, max_attempts 1): try: return func(*args, **kwargs) except Exception as e: last_exception e if attempt max_attempts: logging.warning( f尝试 {attempt}/{max_attempts} 失败{delay}秒后重试。错误: {str(e)} ) time.sleep(delay) logging.error(f所有 {max_attempts} 次尝试均失败) raise last_exception3.3 Windows路径处理Windows平台下的路径处理常常会遇到各种问题特别是当路径包含空格或特殊字符时。我们提供一些实用函数来处理这些情况def sanitize_path(path): 清理路径处理空格和特殊字符 path os.path.normpath(path) path path.replace([, \[).replace(], \]) if in path and not path.startswith(): path f{path} return path def ensure_absolute_path(path, base_dirNone): 确保返回绝对路径 if not os.path.isabs(path): base base_dir or os.getcwd() path os.path.join(base, path) return os.path.normpath(path)4. 完整脚本集成现在我们将所有组件集成到一个完整的脚本中可以通过命令行参数来控制转换过程#!/usr/bin/env python # -*- coding: utf-8 -*- import os import sys import argparse import logging from datetime import datetime import pyfbsdk # 初始化日志 logger logging.getLogger(bvh2fbx) def main(): # 解析命令行参数 parser argparse.ArgumentParser(descriptionBVH到FBX批量转换工具) parser.add_argument(input, help输入BVH文件或目录) parser.add_argument(output, help输出FBX文件或目录) parser.add_argument(-t, --template, helpFBX模板文件路径) parser.add_argument(-l, --log, defaultbvh2fbx.log, help日志文件路径) parser.add_argument(-v, --verbose, actionstore_true, help详细输出) args parser.parse_args() # 设置日志级别 log_level logging.DEBUG if args.verbose else logging.INFO setup_logging(args.log, log_level) logger.info( * 50) logger.info(fBVH转FBX转换开始于 {datetime.now()}) logger.info( * 50) try: # 处理输入输出路径 input_path ensure_absolute_path(args.input) output_path ensure_absolute_path(args.output) # 判断是单个文件还是目录 if os.path.isfile(input_path) and input_path.lower().endswith(.bvh): # 单个文件转换 if os.path.isdir(output_path): output_file os.path.join( output_path, os.path.splitext(os.path.basename(input_path))[0] .fbx ) else: output_file output_path if output_path.lower().endswith(.fbx) else output_path .fbx logger.info(f开始转换单个文件: {input_path} - {output_file}) success with_retry( convert_bvh_to_fbx, input_pathinput_path, output_pathoutput_file, template_pathargs.template ) if success: logger.info(f成功转换: {output_file}) else: logger.error(f转换失败: {input_path}) elif os.path.isdir(input_path): # 批量转换 logger.info(f开始批量转换目录: {input_path} - {output_path}) success with_retry( batch_convert_bvh_to_fbx, input_dirinput_path, output_diroutput_path, template_pathargs.template ) if success: logger.info(所有文件转换成功) else: logger.warning(部分文件转换失败请检查日志) else: logger.error(f无效的输入路径: {input_path}) return 1 except Exception as e: logger.exception(发生未处理的异常:) return 1 finally: logger.info( * 50) logger.info(fBVH转FBX转换结束于 {datetime.now()}) logger.info( * 50) return 0 if __name__ __main__: sys.exit(main())5. 实际应用与优化建议5.1 性能优化技巧在处理大量BVH文件时性能可能成为瓶颈。以下是一些优化建议内存管理MotionBuilder在处理大场景时可能消耗大量内存。定期重启可以防止内存泄漏。def safe_exit(): 安全退出MotionBuilder try: pyfbsdk.FBApplication().FileExit() except Exception as e: logger.warning(f退出时发生错误: {str(e)})并行处理虽然MotionBuilder本身不支持多线程但可以通过外部脚本并行启动多个MotionBuilder实例。# 示例批处理脚本 echo off set MB_PATHC:\Program Files\Autodesk\MotionBuilder 2022\bin\x64\motionbuilder.exe start %MB_PATH% -batch -console -verbosePython scripts/bvh2fbx.py input1 output1 start %MB_PATH% -batch -console -verbosePython scripts/bvh2fbx.py input2 output25.2 常见问题解决在实际使用中可能会遇到以下问题及解决方案字符编码问题确保Python脚本文件使用UTF-8编码在脚本开头添加编码声明# -*- coding: utf-8 -*-路径包含空格使用sanitize_path函数处理路径在Windows批处理脚本中用引号包裹路径MotionBuilder未响应添加超时机制使用Windows任务计划程序定期检查并重启挂起的进程5.3 扩展功能根据实际需求可以考虑扩展以下功能进度报告将转换进度写入数据库或发送邮件通知质量控制转换后自动检查FBX文件的有效性元数据保留将BVH中的自定义属性保留到FBX文件中def preserve_metadata(bvh_path, fbx_path): 保留BVH文件中的元数据到FBX # 这里可以添加自定义的元数据处理逻辑 pass在实际项目中这个脚本已经帮助团队将BVH到FBX的转换时间从数小时缩短到几分钟同时减少了人为错误。关键在于根据具体需求不断调整和优化脚本功能使其更好地融入现有的制作流程。