UuuNyaa / blender_motion_generate_tools

motion_generate_tools is a Blender addon for generate motion using MDM: Human Motion Diffusion Model.
GNU General Public License v3.0
104 stars 9 forks source link
blender-addon diffusion-models motion-generation

motion_generate_tools

motion_generate_tools is a Blender addon for generate motion using the following Model.

motion_generate_toolsは以下のモデルを使ってモーションを生成するためのBlenderアドオンです。

Download

Download motion_generate_tools from the github release page

Installation

The easiest way to install the motion_generate_tools is to do so through directly through Blender:

  1. Open the Blender User Preferences menu and select the Add-ons tab (Edit > Preferences... > Add-ons)
  2. Click the Install... button at the top of the Add-ons menu. This will open a file menu where you can select the motion_generate_tools-v0.0.0.zip file.
  3. After installing the addon .zip file, Blender will filter the addons list to only show the motion_generate_tools addon. Click the checkbox next to the title to enable the addon.
  4. Click Required Python Modules: Update Python Modules button at the addon Preferences.
    • If you have a NVIDIA GPU that supports CUDA, you can choose with CUDA button.
  5. Click CLIP Model: Download CLIP Model button at the addon Preferences.
  6. Restart Blender. A Blender restart is maybe required to complete the installation.

https://user-images.githubusercontent.com/70152495/210015009-0b190692-291d-422f-ac95-dcebbecd97b8.mp4

Requirements

Usage

  1. Open the smpl_model_20210421-bones.blend file
  2. Select the SMPLX-neutral armature
  3. Goto 3D Viewport > Sidebar > Animation > Motion Generator Panel
  4. Enter a Text Condition
    a person jumps.
    a person throws.
    a man is locking his hans behind his back and sweeping his legs right and left, in a dance like motion.
    a person is walking in a counterclockwise circle.
  5. Press Generate Motion button

Motion Generator Tools under development

Limitation

Acknowledgments

Source code

This addon is based on code from the following repository:

Datasets

This addon depends on the following datasets:

Contribution

We need people to test the installation and give us feedback!

License

This code is distributed under the GPLv3.

Note that our code depends on other libraries, including MDM, CLIP, SMPL, SMPL-X, PyTorch3D, and uses datasets that each have their own respective licenses that must also be followed.