User Tools

Site Tools

This page exists within the Old ArtZone Wiki section of this site. Read the information presented on the linked page to better understand the significance of this fact.

Import BVH Files

The BVH Importer Options dialog comes up when you select File > Import, choose the BioVision (.bvh) export option, and select/open a .bvh file.


To import a BVH file:

  1. Load and select the figure to apply the animation file to.
  2. Choose File > Import from the menu, select the BioVision (.bvh) export option, locate and select the file to be imported, then click on Open.

    The BVH Importer Options dialog comes up with the following options available:
  • Selected File: Shows the name of the BVH file being loaded.
  • Selected Figure: Shows the currently selected figure that the animation file will be applied to.
  • Scene Animation Setup Options
    • Adjust scene to match the file: When selected will adjust frames in current scene to match the file being imported.
    • Use the current scene values: When selected will use the current scene frames and drop any frames from the animation that go over the scene max frames.
    • In Place Mode (no X or Z hip translation): When enabled will leave the figure in current location in the scene. When disabled, figure will move based on where the imported animation places the figure.
    • Limit Joint Rotation: When enabled, limits joint rotation even if the animation file has settings outside the limits. When disabled, does not limit joint rotation and the animation settings are used.
  • Show Details: Click on button to expand the dialog and view the name mapping lists. The name mapping shows which nodes in the animation are mapped to the nodes in the selected figure. Changes to Hide Details when list is expanded.
  1. If you are not sure if the name mapping is correct, i.e., animation was made for a biped and is being applied to a quadruped, etc., or know that the mapping is not correct, click on the Show Details button to view the current mapping.
    • Load Map: Enables a saved name mapping to be loaded and applied to the import.
    • Save Map: Enables the current name mapping to be saved so it can be used for a future BVH import or export.
    • File Nodes: Lists the figure node hierarchy from the file being imported. Nodes with a checkmark next to them indicate that a matching node was found in the Figure Nodes list.
    • Figure Nodes: Lists the figure node hierarchy for the selected figure.

  1. Review the nodes listed in the File Nodes listing to ensure that they are correctly mapped to a node in the Figure Nodes listing.
  2. If needed, remap nodes that are not mapped as needed for the figure or for the requirements of the animation, or map nodes that had no matching nodes.
    • To change the mapping of a node:
      1. Click once on the name to be remapped in the File Nodes list to select it. The matching node in the Figure Nodes list will be highlighted as well.

      2. Click on a different node in the Figure Nodes list and the selected node in the File Nodes list will be remapped to the selected node.


        If you remap a node from the figure to a node in the file and that figure node had a matching file node, the file node will be deselected and will not be imported. For example, the image below shows a lFoot figure node that has been remapped to the lShin file node. This means that the original lFoot file node no longer has a matching node so is automatically deselected and will not be imported. The node can be remapped to the lFoot and then the lShin remapped as well.

      3. Confirm the change by clicking on a different node in the File Nodes list, then reselecting the previous node. When it is selected, the remapped node will be selected in the Figure Nodes list instead of the original node.
    • To map a node that did not have a matching name or was unmapped:
      1. Click on the node to be mapped in the File Nodes list to select it. The checkbox next to the node will be empty.

      2. Click on the matching node in the Figure Nodes list to map to the file node. The blank checkbox next to the file node will automatically be checked to show that it is now mapped to a figure node.

  3. If needed, remove nodes from the File Nodes listing that should not be imported by clicking on the checkbox to remove the checkmark for that node. If a parent node is deselected, all child nodes will be deselected as well.
  4. If the name mapping was changed, save the map by clicking on the Save Map button. The BVH Save Map dialog will come up.

  5. Click on the arrow next to the Stored Maps field to select a name from the drop-down list to overwrite or click on the New button to create a new file. The Stored Maps field will be cleared and made editable. Enter a new name and click on Save.

  6. To load a saved map that will override the current name mapping, click on the Load Map button. The BVH Load Maps dialog will come up.
  7. Select the map to load from the Stored Maps drop-down menu then click on the Load button. The selected map will be applied to the current figure and file nodes.

  8. To delete a saved map, click on the Load Map button. The BVH Load Maps dialog will come up.
  9. Select the map to delete from the Stored Maps drop-down menu then click on the Delete button. A confirmation dialog will come up. Click on Yes to delete the map or on No to keep it.

  10. Once all settings have been selected and names are mapped correctly, click on the Accept button. The animation will be imported and applied to the selected figure.
  11. Press Play on the Timeline tab to play the animation.