C3D File Importer for Blender

Blender addon for importing motion capture data found in .c3d files.

How to Install

1. Download the latest version of io_anim_c3d from source code (intended for latest LTS release, see release section for stable/specific versions).
2. Open Blender
3. Open the Edit->Preferences window.
4. Go to the ‘Add-ons’ tab.
5. Click the ‘Install…’ button.
6. Navigate to the folder containing the downloaded .zip file and double-click the file.
7. Enable the addon ‘Import-Export: C3D format’ in the addon window.
8. Not there? Use the refresh button, restart blender, google how to install add-ons, or visit docs.blender.org.

How to Use

1. Make sure the add-on is installed and enabled (see the ‘How to Install’ section).
2. Go to File->Import->C3D (.c3d) to open the import window.
3. Change the import settings (if needed).
4. Navigate to the folder containing the .c3d file, and…
   1. Double-click to import a single file or
   2. Select file(s) to import and click the ‘Import C3D’ button.

Development

General guidelines and information how to configure the repository for development.

Development Tools

• Visual Studio Code
• Blender Development Extension

Tests

Unittests are available under the ‘tests/‘ folder. To run call:

tests/run.sh <path or alias to Blender executable>

Running tests require the addon to be installed to the Blender executable, simplest way to do so is to use the Blender development extension with the same executable as it will configure a symlink to the project, ensuring the test will run with the latest changes to the code. For running tests on Windows the console need to be able to handle bash scripts!

Unittests are minimal and should focus on testing the addon functionality. For functionality testing the importer go to the underlying .c3d parser project.

Code Style

• Classes should be in PascalCase
• Variables and functions should be in snake_case
• Code needs to be pep8 compliant (__init__.py has exemptions due to Blender dependencies).

Addon Tooltip Style

• Addon property names should written with the first letter in each word capatilized.
• Don’t forget to exclude the dot (.) at the end of the description as it will be added automatically…

Further Questions?

If there are any questions or suggestions please visit the issue board and make a ticket, hopefully I will be able to answer questions within some reasonable time frame 😄.