MIRAFACE software is the Facial Animation software capable of 
interpreting Facial Animation Parameters (FAPs). In this
release it is integrated with FAP decoding software from
Rockwell  (rockwell_v05.tar.gz) and FAP file reading module 
from Lucent for the purpose of FAP input. Facial Animation module, 
as well as the supplied simple facial model, are developed at 
MIRALab, University of Geneva and LIG, EPFL.

The software renders in real time the FAP animation. If the host is too
slow it skips frames to keep the timing.

The software works on Silicon Graphics workstations. Only the rendering,
concentrated in face_draw.c, uses GL functions. The rest of the code
is platform-independent.

The Makefile in the main directory compiles all and places the executables 
in the main directory. There are following executables:

1. decodeface <FAP bitstream file>

Decodes a FAP bitstream and plays the animation.

2. miraface <FAP file>

Reads a FAP file and plays the animation.


The main directory contains:

Makefile	performs make in all subdirectories and places the executable
		in the main directory.

mirastdconv.txt
mirastdface.sm
mirastdface.rg	These files contain necessary data for the executable and
		must be present in the derectory where decodeface is executed

DATA		Subdirectory containing data files (.stream = fap bitstream,
		.fap = fap file)

DECODE		Subdirectory containing the FAP bitstream decoding software (Rockwell).

READFAP		Subdirectory containing FAP file reading software (Lucent).

FACE		Subdirectory containing facial animation software (MIRALab/LIG).


The FACE subdirectory contains the source code of the FAP facial animation
software. It compiles into a library libface.a in which two functions
are important: 
init_face - initializes the facial model
run_faps - based on given faps and fap mask, animates the facial model.

MIRAFACE Facial Animation software is developed at MIRALab, University of Geneva 
and LIG, Swiss Federal Institute of Technology.

For more information contact:

Igor Pandzic
MIRALab, University of Geneva
Igor.Pandzic@cui.unige.ch
http://miralabwww.unige.ch