walkoncross / blender_bvh_addon_enhanced

Enhanced version of blender's bvh add-on with more settings supported. The bvh's rest pose should have the same handedness as the armature while could use a different up/forward definiton.

Enhanced bvh add-on (importer/exporter) for blender

• Enhanced bvh add-on (importer/exporter) for blender
  • Enhanced bvh importer
  • Enhanced bvh exporter
  • How to
    • Install
    • Load .bvh data onto an existing armature

Author: [email protected]

github repo: https://github.com/walkoncross/blender_bvh_addon_enhanced

Refer to for more information: https://docs.blender.org/manual/en/2.92/addons/import_export/anim_bvh.html

Enhanced version of blender's bvh add-on with more settings supported.

The bvh's rest pose should have the same handedness as the armature while could use a different up/forward definiton

Enhanced bvh importer

New features:

• Target: support to load .bvh data onto an existing armature
• Translation: choose to load translation (a.k.a position) for all bones/only root bone/none from the MOTION part of .bvh file
• Global Axis Conversion: whether to convert from bvh axis orientions into Blender's default axis orientions(Z-up/Y forward)
• Skip frames: skip first #N frames inthe the MOTION part of .bvh file
• Add rest pose: whether to add rest pose as the first frame in the animation curves.

Enhanced bvh exporter

• Forward and Up: customerize the output axis orientations
• Add rest pose: whether to add rest pose as the first frame in the animation curves.

How to

Install

1. download a release version .zip from: https://github.com/walkoncross/blender_bvh_addon_enhanced/raw/main/io_anim_bvh_enhanced.zip; (OR: git clone this repo and make a zip file (io_anim_bvh_enhanced.zip) from ./io_anim_bvh_enhanced);

2. Blender -> Edit -> Perferences -> Add-ons -> Install, get the path of io_anim_bvh_enhanced.zip, install and enable the add-on

3. After Installation:

Load .bvh data onto an existing armature

1. Select an existing armature object
2. File -> Import -> Motion Capture (.bvh), enhanced
3. Make settings
4. Import BVH

blender_bvh_addon_enhanced's Issues

Respect original bone name in BVH file

Here, spaces in the bone name are replaced with an underscore:

blender_bvh_addon_enhanced/io_anim_bvh_enhanced/import_bvh_enhanced.py

Line 152 in 0cabc06

file_lines[lineIdx][1] = '_'.join(file_lines[lineIdx][1:])

However, this causes import errors on models with bone names that contain spaces (such as headphone 1) as this would build the bone map with headphone_1 as key thus throwing a KeyNotFound error next.

Is there a reason to use a underscore as the concatenator instead of a space?