README: Original FACS Models

Facial Action Coding System (FACS) original X3D models

Dr. Myeong Won Lee and team created these original models. She provided the following documentation 8 July 2024.

The HAnim FACS animations are generated as follows:

  1. A simple motion of facial expression is represented by a single action unit of FACS, such as inner brow raise or wink. More complex facial animation that is made up of a combination of motions, such as a smile made up of both eye and mouth motions, is defined by combining several action units.
  2. To represent an action unit in FACS, a minimum of three sets of an LOE1 HAnim facial model (three X3D files) can be used. An LOE1 HAnim facial model is defined by 43 facial regions. Currently, up to five sets of HAnim faces can be used to generate a FACS action unit for a facial expression.
  3. The sets of HAnim facial models for an action unit of FACS are animated using X3D keyframe interpolators. This animation can be generated by the HAnim facial converter.

Example X3D animation files for FACS action units for facial animation are located at the first shared drive link.

The HAnim Facial Motion Converter used for the HAnim FACS animation can be downloaded at the second shared drive link.

All the files submitted or notified to Web3D can be used freely without any restriction. It would be good if the facial examples can be uploaded to the Web3D resource pages. In addition, it is ok if all the submitted files that we developed are assigned Web3D software licenses.

X3D Model Changes

Continuing changes have been applied to content in this originals subdirectory to produced modified models in the parent FacialAnimation directory. List of changes follows.

  1. File names adjusted to meet X3D Scene Authoring Hints: Naming Conventions
  2. Added DOCTYPE DTD statements for improved XML validation
  3. X3D canonicalization (c14n) for consistent whitespace and attribute ordering
  4. Model metadata of various kinds, following best practices described in X3D Scene Authoring Hints: meta Statements
  5. Added Web3D Consortium open-source license
  6. Fixed DEF/USE of ImageTexture files to avoid repetitive, time-consuming reloading of the renamed file from Jin.jpg to JinImageAtlas.jpg
  7. Fixed DEF of Coordinate nodes to end in _COORD vice -COORD for best portability and to match naming conventions
  8. Fixed DEF/USE of Material files to avoid repetitive reloading and then Appearance files
  9. Renamed all files to put "Jin" first, which will help alphabetization when we add more FACS examples in the future
  10. Applied correct name to meta title, meta identifier, and WorldInfo title attributes
  11. Added meta reference links to original version of each file
  12. Combined duplicative clocks and ScalarInterpolator adapters, omit unnecessary Adapter ROUTEs
  13. Added directory package descriptions
  14. Under evaluation: changing animation loop period from cycleInteval="4" to cycleInteval="0.99" in order to make model-animation visualizations more obvious.
  15. TODO adjust select models to restore prior more-complex ScalarInterpolator clock reversals
  16. TODO rescale units to meters

Many model refinements have been applied. For example, see the subversion diff log at revision 36730. These changes all preserve and enhance the orginal features of this model set.

Next steps: the Future Work: FACS for X3D HAnim page describes plans for continuing progress.

Online at https://www.web3d.org/x3d/content/examples/HumanoidAnimation/FacialAnimation/originals/README.html

Revised 27 October 2024