electronicarts/dem-bones is a design-focused project on GitHub with 1.0k stars, written primarily in C++. An automated algorithm to extract the linear blend skinning (LBS) from a set of example poses
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This repository contains an implementation of Smooth Skinning Decomposition with Rigid Bones,
an automated algorithm to extract the Linear Blend Skinning (LBS) with bone transformations from a set of example meshes.
Skinning Decomposition can be used in various tasks:
converting any animated mesh sequence, e.g. geometry cache, to LBS, which can be replayed in popular game engines,
solving skinning weights from shapes and skeleton poses, e.g. converting blendshapes to LBS,
solving bone transformations for a mesh animation given skinning weights.
This project is named after "The Skeleton Dance" by Super Simple Songs.
Contents
include/DemBones: C++ header-only core library using Eigen and OpenMP. Check out the documentations in docs/index.html.
bin: pre-compiled command line tools for Windows, Linux, and MacOS that read and write FBX and Alembic files. Check out the usage by running DemBones --help.
src/command: source code for the command line tool. Check out AbcReader.cpp, FbxReader.cpp, and FbxWriter.cpp for the usage of the core library.
data: input/output test data for the command line tool. Run and check out the scripts run.bat (Windows) or ./run.sh (Linux/MacOS).
Compiling
Tested platforms:
Visual Studio 2019 on Windows 10 x64
g++ 9.3.0 on Ubuntu Linux 20.14
LLVM 10.0.0 (Homebrew) on MacOS 10.13.6
Compiling steps:
Install cmake
Copy the following libraries to their respective folders in ExtLibs so that cmake can find these paths:
Eigen 3.3.9 with path ExtLibs/Eigen/Eigen/Dense,
Alembic (from Maya 2020 Update 4 DevKit) with path ExtLibs/Alembic/include/Alembic/Abc/All.h,
FBXSDK 2020.0.1 with path ExtLibs/FBXSDK/include/fbxsdk.h,
tclap 1.2.4 with path ExtLibs/tclap/include/tclap/CmdLine.h,
Run cmake:
mkdir build
cd build
cmake ..
Build:
cmake --build . --config Release --target install
Notes for Linux
You may need to install some libriries: libxml2-dev (run $ sudo apt-get install libxml2-dev) and zlib-dev (run $ sudo apt-get install zlib1g-dev).
bin/Linux/DemBones was compiled with flag -D_GLIBCXX_USE_CXX11_ABI=0
for compatibility with the pre-complied Alembic (from Maya 2020 Update 2 DevKit).
Notes for MacOS
Apple Clang (default compiler) does not support OpenMP and Eigen. We recommend using LLVM.
Assuming LLVM is installed in the default path: /usr/local/opt/llvm/bin, instead of cmake .., you can run:
The pre-compiled tool bin/DemBones requires dynamic libomp for LLVM. If you have an error messeage related to OpenMP,
please install libomp, e.g. with Homebrew using $ brew install libomp.
bin/MacOS/DemBones was compiled with the optimization flag -O3. It looks like LLVM uses fast math
so the results are slightly different with those generated by Windows version.
Removing optimization flags (in CMakeLists.txt) helps to reproduce the same results with Windows version but the tool will run 10x slower.
References
If you use the library or the command line tool, please cite the paper:
Binh Huy Le and Zhigang Deng. Smooth Skinning Decomposition with Rigid Bones. ACM Transactions on Graphics 31(6), Proceedings of ACM SIGGRAPH Asia 2012.
BibTeX:
@article{LeDeng2012,
author = {Le, Binh Huy and Deng, Zhigang},
title = {Smooth Skinning Decomposition with Rigid Bones},
journal = {ACM Trans. Graph.},
volume = {31},
number = {6},
year = {2012}
}
The skinning weights smoothing regularization was published in the paper:
Binh Huy Le and Zhigang Deng. Robust and Accurate Skeletal Rigging from Mesh Sequences. ACM Transactions on Graphics 33(4), Proceedings of ACM SIGGRAPH 2014.
Authors
Search for Extraordinary Experiences Division (SEED) - Electronic Arts http://seed.ea.com
We are a cross-disciplinary team within EA Worldwide Studios.
Our mission is to explore, build and help define the future of interactive entertainment.
Dem Bones was created by Binh Le (binh.graphics). The logo was designed by Phuong Le (phuongle.com).
Contributing
Before you can contribute, EA must have a Contributor License Agreement (CLA) on file that has been signed by each contributor.
You can sign here: http://bit.ly/electronic-arts-cla
Licenses
The source code, including include/DemBones and src/command, uses BSD 3-Clause License as detailed in LICENSE.md
The pre-compiled command line tool bin/DemBones(.exe) uses third party libraries: Eigen, tclap, Alembic, FBXSDK, and zlib with licenses in 3RDPARTYLICENSES.md
How active is development on electronicarts/dem-bones?
The most recent commit recorded on electronicarts/dem-bones was 1.8 years ago, based on the GitHub push timestamp. The repository has 173 forks — one of the better signals of community interest.
Is electronicarts/dem-bones open source?
TopGit's metadata for electronicarts/dem-bones does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What topics is electronicarts/dem-bones associated with?
GitHub's repository topics for electronicarts/dem-bones: "animation", "skinning". TopGit's editorial category is UI / UX.
Where can I see electronicarts/dem-bones in action?
The project maintains a homepage at https://seed.ea.com. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about electronicarts/dem-bones?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/electronicarts/dem-bones is the definitive source.
Read full README in the tab above.
Is dem-bones worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of dem-bones.