System Requirements & Installation
 


 

Supported Software

Currently, Faceware Retargeter supports the Windows versions of Autodesk Maya® 2019, 2020, 2022, and 2023, the Windows versions of Autodesk Motionbuilder® 2018, 2019, 2020, and 2022 and the Windows version of Autodesk 3DS Max® 2019, 2020, 2021, 2022

 


 

System Requirements

 

 

Faceware Retargeter is a plug-in into a 3D application, therefore it maintains the same system requirements as the host application.  Only the Windows versions of each application are supported.

For system requirements for supported applications, please use the links below.

 


 

Installation

Step 1: Installing Required Windows components

 

Retargeter requires several different runtimes and components to run properly. As of the release of Retargeter 5.0, the dependencies other than Matlab are included in the installation package. Please make sure you have the following installed before installing and running Analyzer. Download links are provided.

 

Matlab Runtime Compiler (not required for Retargeter 5.9+): 

Microsoft Visual Studio 2017

 

Step 2: Installing Retargeter

To install Retargeter, simply run the installer you downloaded from our website and complete the installation.

If this is your first time installing Analyzer or Retargeter, during the installation you will be required to also install the Codemeter Runtime.  Codemeter is a requirement of our licensing software and will run in the background of your machine.

 


 

Silent Install

Retargeter 5.4.9 and later allows for silent installation via a command line or script. This allows for easy mass installation of the software.

 

To silently install/uninstall, run the Retargeter installation file in a command prompt or script with the following flags:

 

/S: the flag to install/uninstall silently
/Year=[InputYearHere]: the flag to indicate what year to install (Only needed for installer)

 

*Potential Installer Error Codes:*

6 = Year not provided
7 = Invalid year passed
8 = Host app [Year] not installed
9 = Please uninstall previous version first
10 = Matlab not installed

 

*Potential Uninstaller Error Codes:*

6 = Can't determine what year to uninstall (Can happen if user moves uninstaller out of parent folder)

 


 

Loading the Plug-in

 

Maya

In Maya, Retargeter is loaded through the Plug-in Manager. Once the software is installed you will see the plug-in titled "ImRetargetMaya.mll" in Maya's plug-in list. To load the plug-in, find it in the list and click on the check box to the right of it's name marked, "Load". If you wish to have the plug-in load automatically when Maya starts, optionally you can click the second box marked, "Auto Load".

 

3DS Max

The Retargeter is loaded in 3DS Max through the Utility Panel. By clicking the "More..." button, you can select 'FACEWARE' from the list of plug-ins.

 

MotionBuilder

Loading Retargeter in MoBu is slightly different than the other apps as it's loaded as a "Device" and needs to be opened externally.

To launch Retargeter from MotionBuilder:

  1. Open the 'Devices' menu in the 'Asset Browser'
  2. Click and drag 'Faceware Retargeter' ('IM Retargeting' in older versions) into your viewport
  3. In your Retargeter installation directory for MotionBuilder, you'll find "FacewareRetargeter_GUI.exe" - Run this file and it will be connected to MotionBuilder
Create your own Knowledge Base