Giter VIP home page Giter VIP logo

flame-blender-add-on's Introduction

FLAME Blender Add-on

FLAME is a lightweight and expressive generic head model learned from over 33,000 of accurately aligned 3D scans. This add-on allows you to add gender specific FLAME skinned meshes to your current Blender scene. The imported FLAME meshes consist of shape keys (blend shapes) for shape, expression and pose correctives as well as joints for manipulation of neck, jaw and eyes.

Add-on features:

  • Add gender specific FLAME mesh to current scene
  • Randomize/reset shape
  • Randomize/reset expression
  • Update joint locations
  • Enable/disable corrective poseshapes
  • Pose neck and jaw joints
  • 3D printing support: Make mesh watertight and export at proper scale

Requirements: Blender 2.80+

Additional Dependencies: None

Data

Download the FLAME Blender Add-on from MPI-IS/FLAME. You need to sign up and agree to the model license (CC BY 4.0) for access to the model.

Installation

  1. Blender>Edit>Preferences>Add-ons>Install

  1. Select flame_tool add-on ZIP file and install

  2. Enable FLAME add-on

  1. Enable sidebar in 3D Viewport>View>Sidebar

  2. FLAME tool will show up in sidebar

Usage

Add gender specific FLAME mesh

  • Select gender and press "Add to scene" button to add model to origin
    • Note: If you cannot see the mesh then make sure that you have removed the default Blender cube at the origin since it will cover the FLAME model

Modify shape

You can modify the shape by selecting the FLAME mesh and then either clicking on the "Random head shape" button or by modifying the shape keys of the selected mesh.

Modify expression

You can modify the expression by selecting the FLAME mesh and then either clicking on the "Random facial expression" button or by modifying the corresponding shape keys of the selected mesh.

Update joint locations

If you modified the shape keys for shape and/or expression you should click on the "Update joint locations" button to recalculate the joint locations.

Corrective pose blendshapes

If you modified the pose in the Blender Pose mode and you want to use corrective poseshapes then you should click on the "Set poseshapes for current pose" button to apply these pose-dependent deformations for the current pose.

Change pose

The add-on pose sliders allow you to quickly pose neck and jaw of the model. More detailed posing is possible in Blender Pose Mode. You have to select the FLAME2020 root object before being able to enter pose mode.

Prepare and export for 3D printing

Select mesh and the click on the "Close mesh" button to close all holes in the mesh and make it watertight for proper slicing. Click on the "Export OBJ" button to export the model in [mm] scale for you slicing software.

License

FLAME is available under Creative Commons Attribution license (CC BY 4.0). By using the model or the code code, you acknowledge that you have read the license terms (http://flame.is.tue.mpg.de/model_license), understand them, and agree to be bound by them. If you do not agree with these terms and conditions, you must not use the code.

Citing

When using this code in a scientific publication, please cite

@article{FLAME:SiggraphAsia2017,
  title = {Learning a model of facial shape and expression from {4D} scans},
  author = {Li, Tianye and Bolkart, Timo and Black, Michael. J. and Li, Hao and Romero, Javier},
  journal = {ACM Transactions on Graphics, (Proc. SIGGRAPH Asia)},
  volume = {36},
  number = {6},
  year = {2017},
  pages = {194:1--194:17},
  url = {https://doi.org/10.1145/3130800.3130813}
}

Acknowledgement

This FLAME Blender Add-on has been implemented by Joachim Tesch. We thank Joachim for implementing and distributing the Add-on.

flame-blender-add-on's People

Contributors

timobolkart avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

flame-blender-add-on's Issues

Change shape and expression parameters with python

Thanks a lot for the add-on, it's awesome !

But I wonder if it is possible to set the shape and expression parameters of the flame model in Blender with python, using the parameters that I get from TF_FLAME let's say.

I tried to set the exact same FLAME parameters both in TF_FLAME and the in Blender but the resulting models differ a lot.

Is there a way to interpolate the parameters to match the logic of the FLAME model in Blender ?
I hope so cause the number of parameters for both shape and expression match.
Thanks !

bug in more recent numpy version

numpy #bug

C:\Users\USER\AppData\Roaming\Blender Foundation\Blender\3.2\scripts\addons\flame_tools\__init__.py:350: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray.
  mat = np.asarray([[0, -r[2], r[1]],

What is the meaning of each shape key?

Thank you for this wonderful add-on.

The faces that can be generated using this add-on come with 418 shape keys (blendshapes), but what do the 300 Shape parameters, 100 Expression parameters and 18 Pose parameters mean?

I would like to know if there is any site or video that explains this, as it would be inconvenient to try to tweak all the parameters to see the changes.

Keyframe jaw values

Hi,

Regarding the jaw value (Set jaw), I have assigned it for many frames (I am working with a video) based on a preprocessing step, as following: bpy.data.window_managers["WinMan"].flame_tool.flame_jaw = <value>. However, I can't keyframe the value for the jaw since it is not a shape key (I need to keyframe since I want to export an fbx for a video, not a single frame). Any ideas?

Thanks in advance

Texture for FLAME

I just wonder, if I can have my own texture for FLAME ?
So that I can render it in blender.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.