bpy.ops.export_anim.bvh(filepath="", check_existing=True, filter_glob="*.bvh", axis_forward='-Z', axis_up='Y', global_scale=1.0, frame_start=1, frame_end=250, bake_step=1, bake_anim=True, bake_custom_props=False, use_decimals=True, ignore_hands=False, ignore_fingers=False, use_hierarchy=True, only_selected=False, add_time=True, euler_filter=True, write_rate=1.0, bone_marked_for_skip=None, force_startend_keying=False, use_cyclic=False, ignore_defgroups=False, use_metadata=True, custom_prop_keys=None, map_bones=False, map_global_scale=1.0, map_translate=(0.0, 0.0, 0.0), map_rotate=(0.0, 0.0, 0.0), map_options='ALL')

参数

filepath (string) – 导出文件的路径
check_existing (boolean, (optional)) – 检查是否已经存在同名文件
filter_glob (string, (optional, never None)) – 针对文件名进行过滤，使用示例‘*.bvh’
axis_forward (string) – 前轴方向，如 ‘-Z’
axis_up (string) – 上轴方向，如 ‘Y’.
global_scale (float) – 要应用于所有输出数据的缩放比率.
frame_start (int) – 开始导出的第一帧的帧数.
frame_end (int) – 导出动画的最后一帧的帧数.
bake_step (int) – 步长，每导出多少帧数据. 取值[1, frame_end-frame_start].
bake_anim (boolean) – 是否应该仅在导出所选范围之后烘焙动画.
bake_custom_props (boolean) – 是否在 Blender 骨骼对象上使用自定义属性. 烘焙数据之前要将这些属性附加到骨骼对象上.
use_decimals (boolean) – 使用小数点支持.
ignore_hands (boolean) – 忽略手部骨骼.
ignore_fingers (boolean) – 忽略手指骨骼.
use_hierarchy (boolean) – 导出对象的层次结构.
only_selected (boolean) – 仅导出选择的对象.
add_time (boolean) – 添加时间信息到文件.
euler_filter (boolean) – 对欧拉旋转进行滤波处理.
write_rate (float) – 写入率. 取值[0,1].
bone_marked_for_skip (enum in ['NO_SKIP', 'SKIP_ALL', 'SKIP_PER_CHANNEL'], (optional)) – 用于标记不导出某些骨骼的方法.
force_startend_keying (boolean) – 是否应该在开始和结束的关键帧上强制制定euler filter
use_cyclic (boolean) – 应用同位循环，以便在导入其他软件时循环.
ignore_defgroups (boolean) – 忽略法线信息.
use_metadata (boolean) – 是否在导出的文件中包含元数据.
custom_prop_keys (boolean) – 自定义属性的列表.
map_bones (boolean) – 启用骨骼映射.
map_global_scale (float) – 全局比例，将对其转化应用于映射
map_translate (float[3]) – 物体相对于存储中心的平移量
map_rotate (float[3]) – 物体旋转的角度，以四元数与“空间RF”（默认QUATERNION的值）设置插值
map_options (enum in ['ALL', 'TY', 'NONE', 'PROPERTY'], (optional)) – 用于整理文件所用的选项.

返回值

{'FINISHED'}

示例

将动画导出到“/home/username/Desktop/myanimation.bvh”：

import bpy

bpy.ops.export_anim.bvh(filepath="/home/username/Desktop/myanimation.bvh")

将所有选定的对象导出到“/home/username/Desktop/myanimation.bvh”：

import bpy

bpy.ops.export_anim.bvh(filepath="/home/username/Desktop/myanimation.bvh", only_selected=True)

将动画数据导出为BVH文件，并使用初始帧和最终帧之间的所有帧：

import bpy

frame_start = bpy.context.scene.frame_start
frame_end = bpy.context.scene.frame_end

bpy.ops.export_anim.bvh(filepath="/home/username/Desktop/myanimation.bvh", frame_start=frame_start, frame_end=frame_end)

参考

API Reference

作者

2021年8月，由AI助手编写。