FACSHuman
FACSHuman plugin for MakeHuman project
Install / Use
/learn @montybot/FACSHumanREADME
FACSHuman v0.0.1 Alpha
FACSHuman plugin for MakeHuman project
Create pictures and videos of facial expressions for your experiments.
This work is based on the Facial Action coding System :
Ekman, P., Friesen, W. V., & Hager, J. C. (2002). Facial action coding system. A Human Face.
This plugin allow you to create facial expressions by moving the corresponding Action Units (AU) described in the FACS Manual. Additional plugins are available to create scene (lights placement and lights colors) and animations.
Paper
Please cite the following paper if you use this plugin for your research :
Gilbert, M., Demarchi, S., & Urdapilleta, I. (2021). FACSHuman, a software program for creating experimental material by modeling 3D facial expressions. Behavior Research Methods. https://doi.org/10.3758/s13428-021-01559-9 Pdf is available here : https://link.springer.com/content/pdf/10.3758/s13428-021-01559-9.pdf
The conference
Gilbert, M., Demarchi, S., & Urdapilleta, I. (2018). FACSHuman a Software to Create Experimental Material by Modeling 3D Facial Expression. Proceedings of the 18th International Conference on Intelligent Virtual Agents - IVA ’18, 333‑334. https://doi.org/10.1145/3267851.3267865 - ISBN: 978-1-4503-6013-5
- https://iva2018.westernsydney.edu.au/
- https://dl.acm.org/citation.cfm?id=3267865#
Link to my profile
https://www.researchgate.net/profile/Michael_Gilbert10
Documentation
Get started
Download and install MakeHuman from here http://www.makehumancommunity.org/content/downloads.html and follow the instructions for your Operating System.
Then start MakeHuman once to create the MH directory in your home/YOURUSER/Document/
For MH
If you have any questions about the installation and the use of this software :
http://www.makehumancommunity.org/wiki/Main_Page
http://www.makehumancommunity.org/forum/
FACSHuman Installation
Main files (the core)
Put this files inside the plugin directory of your MH installation (not in the plugin directory of MH in USER/Document/makehuman)
| File | Usage | |:-----------------------| ----------------------------:| | 7_FACSHuman.py | (main program) | | 8_FACSAnim.py | (to create facial animation) | | 9_FACS_scene_editor.py | (to edit/create scene) |
Target files of the AUs
All the FACSHuman target files were created with Blender and the MH tools for Blender.
Place targets files directory into :
For lastest version of MH :
/home/YOUR_USER/Documents/makehuman/YOUR_NUMBER/data/FACSHuman/
For earlier versions :
/home/YOUR_USER/Documents/makehuman/data/FACSHuman/
This directory contains :
- 00 Emotions
- 01 Upper Face AUs
- 02 Lower Face AUs
- 03 Lip Parting and Jaw Opening
- 04 Eye Positions
- 05 Head Positions
- 06 Miscellaneous AUs
- au.json
- black.jpg
Whithout these files plugins do not work
Additional ressources
Teeth, eyes, eylashes and tongue are modified versions of materials assets from the http://www.makehumancommunity.org/
Place directories in :
for lastest version of MH :
/home/YOUR_USER/Documents/makehuman/YOUR_NUMBER/data/...
for earlier versions :
/home/YOUR_USER/Documents/makehuman/data/...
Teeth
In order to avoid teeth distortion (original models) when you use mouth opening AUs, you need to use the modified facs models.
Place it in /teeth
This directory contains :
- FACSTeeth01
- FACSTeeth01a
- FACSTeeth01b
- FACSTeeth02
- FACSTeeth02a
- FACSTeeth02b
- FACSteeth03
- FACSteeth03_bw
- FACSteeth04
Eyes
Place it in /eyes
This directory contains :
- black_map.png
- /eyes_no_cornea
- /facs-poly
- makehuman_eye_specular.png
- makehuman_eye_specular2.png
- /materials
- /real_pupil_no-cornea
- specular_map.png
- specular_map_invert.png
- specular_map_white_b.png
Eyelashes
Place it in /eyelashes
This directory contains :
- FACSEyeLashes01
Tongue
Place it in /tongue
This directory contains :
- FACSTongue
- FACSTongue_bw (black and white model)
Custom
Place it in /custom
This directory contains :
- close_lips.target
This target is useful to close the small gap between lips of the MH model.
Additional installations
FACSvatar
An Open Source Modular Framework From Face to FACS Based Avatar Animation (Unity3D / Blender) More on FACSvatar: https://github.com/NumesSanguis/FACSvatar
FFmpeg
If you want to use the video production inside FACSHuman you need to install FFmpeg tools :
https://ffmpeg.org/about.html
and put this software into the path of your computer.
You will find the procedure on the net depending of your operating system.
Information
https://www.michaelgilbert.fr/facshuman/
FACSHuman is a plugin for Makehuman.
If you have any questions please contact me not the MH Team
Demo videos
More tutorials videos will be available soon.
All AUs demonstration
<a href="http://www.youtube.com/watch?feature=player_embedded&v=RJlP5M_Tmk8" target="_blank"><img src="http://img.youtube.com/vi/RJlP5M_Tmk8/0.jpg" alt="IMAGE ALT TEXT HERE" width="480" height="360" border="10" /></a>
Full demo
<a href="http://www.youtube.com/watch?feature=player_embedded&v=qqUxmFsK_Po" target="_blank"><img src="http://img.youtube.com/vi/qqUxmFsK_Po/0.jpg" alt="IMAGE ALT TEXT HERE" width="480" height="360" border="10" /></a>
FACSvatar Datas
<a href="http://www.youtube.com/watch?feature=player_embedded&v=jQwcDjFpq5g " target="_blank"><img src="http://img.youtube.com/vi/jQwcDjFpq5g/0.jpg" alt="IMAGE ALT TEXT HERE" width="480" height="360" border="10" /></a>
https://www.youtube.com/channel/UCEAepvD886XqB6wikmXW8Qg
