DOS Prompt Use



-exec option

FaceFX is a powerful commandline tool for automating your facial animation pipeline.  Simply use the -exec option, and pass the path to a python or FXL file to execute:

C:\> c:\perforce\FaceFx\Studio\FxStudio -exec "C:\my-python-file.py"
C:\> c:\perforce\FaceFx\Studio\FxStudio -exec "C:\my-fxl-file.fxl"


  • Notice that you do not include the “.exe” file extension when calling fxstudio.
  • The analyze command is not available in FaceFX Studio Professional, and analyzing audio from the commandline is not possible without it.
  • You will probably need to call the loadActor command and possibly the saveActor command in your batch file to do anything meaningful.

Other options

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

  • --help - displays a list of available options
  • -verbose - generate verbose log messages for troubleshooting
  • -ogre_rendersystem - set to "direct3d" to launch FaceFX Studio in DirectX mode to troubleshoot graphics issues.  "opengl" is the default.  Note that when running a script with the -exec flag, 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 because it relies on the render system being initialized.  Use the -ogre_rendersystem flag with the -exec option if you need to call this function from your script.  Note that the machine must have an acceptable graphics card for the render system to initialize properly.

            c:\perforce\FaceFx\Studio\FxStudio -ogre_rendersystem="opengl"

            c:\perforce\FaceFx\Studio\FxStudio -exec "C:\renderscript.py" -ogre_rendersystem="direct3d"

  • -safe - starts up FaceFX Studio at a small resolution in the center of the screen to resolve issues where FaceFX is "lost" on a monitor that is no longer available.
  • -nosplash - starts up FaceFX Studio without a splash screen.
Version Number: 
2010