FaceFX Support

FaceFX Documentation and support

DOS Prompt Use

The facefx-studio.exe executable file is a powerful commandline tool.  Pass it a .facefx file and it will launch the GUI with the specified file opened.  Pass it a .fxl or .py file, and it will execute the scripts in command-line mode.  (You will probably need to call the loadactor command and possibly the saveactor command in your .fxl or .py file to do anything meaningful.)

C:\> "c:\Program Files\FaceFx\FaceFX Studio Professional\facefx-studio" "C:\my-python-file.py"
C:\> "c:\Program Files\FaceFx\FaceFX Studio Professional\facefx-studio" "C:\my-fxl-file.fxl"
C:\>"c:\Program Files\FaceFx\FaceFX Studio Professional\facefx-studio" "C:\my-facefx-file.facefx"

Options

Here are some other flags that can be set from the commandline.  

–ogre_rendersystem

Use the–ogre_rendersystem option to specify the render system to use when FaceFX is run from the commandline.  You can also launch the application using “opengl” instead of the default “direct3d” to troubleshoot graphics driver issues.  Check the install folder for the openGL shortcut as well.  

"c:\Program Files\FaceFx\FaceFX Studio Professional\facefx-studio" -ogre_rendersystem="opengl"

Note that when running a script with the -exec flag or by passing a .FXL or .PY file, by default FaceFX is started without initializing the renderer.  This allows FaceFX to be run from machines without a graphics card, but it prevents the render command from working, and the fbx commands can not export FBX files with body animations.  The previewanim and exportframe commands also require the rendersystem, and these commands are used by the FBX Import process.  Use the -ogre_rendersystem flag if you need to call these functions from your script.  Note that the machine must have an acceptable graphics card for the render system to initialize properly.

  "c:\Program Files\FaceFx\FaceFX Studio Professional\facefx-studio" -ogre_rendersystem="direct3d" "C:\renderscript.py" 

Return Values

When specifying the -exec option from the command line or being passed a .FXL or .PY file, the executable returns a value by setting the %ERRORLEVEL%

-2 Indicates a crash occurred.  No crash dialog is displayed in command-line mode, so check the “Crash Reports” folder in the FaceFX Studio directory in the current  users documents folder.  Please send crash reports to OC3 Entertainment.
-1  The specified script contained an error and did not execute completely.
0 Execution completed successfully.