Deformation Learning Solver for Autodesk Maya

This project has been DEPRECATED and is no longer being supported. This is just my personal experiment project that I never expected people taking it seriously, companies use this tool will end up implementing their own version, and I'm not allowed to share or sell the source code in any way, sorry about that.

Please find the alternative solution from EA's Dem Bones, it's reliable in terms of performance and accuracy, I highly recommend everyone adapt this implementaion to your own project.

Any query regarding to DLS won't get replied, thanks for your understanding.

Deformation Learning Solver is based on Smooth Skinning Decomposition with Rigid Bones which was an automated algorithm to extract the linear blend skinning (LBS) from a set of example poses, and made to convert any deformation approximation to joints and it's skinning-based. This allows there to be a savings in computing resources and a smaller data footprint.

This tool haven't be verified in real production yet, since this's just a personal research project to learn SSDR and skinning technique in deep, please feel free to test it at your own risk.

License: BSD 3-Clause

Contact:

• Author: Webber Huang
• Project: https://github.com/WebberHuang/DeformationLearningSolver

Demo:

• Deformation Learning Solver
• Deformation Learning Solver v1.5

Requires:

Maya 2014 x64 and above, Windows, Linux and OS X

The solver has been compiled success on these platforms:

• Windows 7 64bit, Visual Studio 2013
• CentOS 7, GCC 4.8.3 with -std=c++11
• OS X 10.10, Xcode 6.1 with -std=c++11

Install:

• This tool is module based, you can place "DeformationLearningSolver" folder to any where.

• Launch maya, drag install.mel into scene, a new icon will be created in current shelf, launch Deformation Learning Solver by clicking the icon.

Manual Install:

• What 'install.mel' does is to create 'DeformationLearningSolver.mod' in /YOUR/HOME/DIRECTORY/maya/modules (ie. C:/Users/YourName/Documents/maya/modules), and setup the installation path, then maya will find this tool automatically. In the same way, you can put 'DeformationLearningSolver.mod' into any directory existing in 'MAYA_MODULE_PATH', then change the paths in it and make them point to the right position, maya will find it without difficulty.

• There's a backup of 'DeformationLearningSolver.mod' in 'modules' folder, you can copy and paste it to anywhere rather than modify it, otherwise, 'install.mel' will fail to install.

• Launch it with these python commands:

import DLS DLS.launch()

Features:

• Convert deformation animation such as blend shapes, to skinned, weighted and bone joint animation.
• Approximate deformation animation by solving the skinning weights with existing joints and joint animations.
• Reverse skeleton animations from animated sequences with existing joints and skinning weights.

Limitations:

• Work with single mesh each time.

Plug-ins:

These plug-ins are included in this tool

• SSDSolverCmd: the core functions of SSDR.
• wbDeltaMushDeformer: a deformer based on Delta Mush: Smoothing Deformations While Preserving Detail, it's also a component in AdvanceSkeleton since 5.0.

Usage:

• There's no document for this tool, the only instruction you can find are those two Demos mentioned above.

• This tool can either solve the best weight map with pre-define joints by user or extract specify number of joints, animations and weight map from a mesh sequences, the first case is extremely fast since it only need to solve the weight map with one iteration.

• To solve weight map from existing joints, please bind mesh with skin cluster first, this tool will find joints involve, then put them into solver. Otherwise, it will solve mesh sequences with specify number of joints within max iterations.

Parameters:

Here are key parameters you should understand:

• Num of Bones: specifies the number of joints will be created.
• Max Infs: specifies the maximum number of weighted influences for a given point.
• Epsilon: the computation will finish before it reaches the max iteration if the subtraction between Current Total Error and Previous Total Error is less than epsilon.
• Max Iters: in general, more iterations can result in more accurate approximation, but I found 10 is sufficient in most cases.
• Target Mesh: input animated mesh here will enable reverse enginnering feature as showed in Demo v1.5.

History:

2017-11-13: v1.5.5 by Webber Huang

• FIXED: unable to support arbitrary FPS

2017-07-31: v1.5.4 by Webber Huang

• UPDATE: wbDeltaMush v1.8.1, fixed crash issue when mesh contains wrong UV
• Compile against Maya 2017

2015-11-21: v1.5.3 by Webber Huang

• UPDATE: wbDeltaMush v1.8.0, better performance and minor bugs fixed

2015-09-02: v1.5.0 by Webber Huang

• NEW: wbDeltaMush is included
• NEW: reverse bone animation from animated sequence
• NEW: alternative update with existing bones and weights
• NEW: a editor for sampling any attribute
• UPDATE: parallelize bone transformation updating function, 30~40% faster than before
• minor bugs fixed

2015-06-18: v1.0.0 by Webber Huang

• Initial release

References:

1. B. H. Le and Z. Deng, “Smooth Skinning Decomposition with Rigid Bones,” ACM Trans. Graph., vol. 31, no. 6, pp. 199:1–199:10, Nov. 2012.