Analyzerbatch is a feature available in the Studio Plus version of Faceware Analyzer. Analyzerbatch gives the user access to command-line functionality for most Analyzer features, allowing for scripting and batch processing of Analyzer jobs.
Command:
Analyzerbatch: The main command to run AnalyzerBatch. Requires another command related to specific desired functionality (see below). If run without an accompanying command, running analyzerbatch will open a list of the other commands that can be used.
Command:
NewJob: Creates a new Analyzer Job from a source video file.
Syntax:
Required Arguments:
-VideoFile: This is the path to the video file that you want to import.
-FwtFile: This is the path to the FWT file that you want to create. This file is the input to the Track, Export Landmark Positions, and Parameterize command.
Optional Arguments:
-autoValidFrames: Automatically determine valid video regions by looking
for a colored square in one of the corners of the video. The first argument
is the corner to look in, the second is the color of the square, and the
third indicates whether the existence of the square means that the frame is
valid.
-manualValidFrames: Manually specify Valid video regions. Expects a comma
separated list of frame ranges (e.g. 0-100,200-300).
-manualSize: Manually specify size and quality of JPEG images used in
Retargeter. The first argument is the size as a percentage of the source
video size. The second argument is the quality as a percentage value from 1-100.
-imageRotate: Rotate video images. Valid values are 0, 90, 180, and 270.
-frameBurnin: Burn frame numbers into video.
-analysisDefinition: File path to alternative Analysis Definition file.
-trim: Trims your Job to a defined length. (t for time, tc for timecode, f for frames)
-framerate: You must specify the desired Frame Rate when creating a new Job from an image sequence.
Command:
Track: Use the track command to track a previously created job with Autotrack or user-created tracking models.
Syntax:
Required Arguments:
-FwtFile: This is the path to the fwt file that you want to track.
-autotrack: Track the entire newly created job with Autotrack.
Optional Arguments:
-model: Uses custom tracking models created with the “Export Tracking Model...” function in Analyzer. Requires a separate argument for each different model. For example:
*Note: When creating tracking models for use with Analyzerbatch, it is highly recommended to only train the three nose landmarks in the Eyes group. For the other groups, lock the nose landmarks before training. Otherwise, the nose in every group will likely have an adverse effect on your tracking quality.
Command:
Parameterize: The parameterize command is used to take an already tracked Analyzer job and parameterize it to convert the data into a form that Retargeter can use to apply animation.
Syntax:
Required Arguments:
-FwtFile: This is the path to the fwt file which will contain the parameter data for retargeting.
-Username: This is your username for the Parameterization service.
-Password: This is your password for the Parameterization service.
Optional Arguments:
-actormodel: The file name following this argument specifies a neutral frame (.fwlf) to parameterize for jobs that are being AutoSolved in Retargeter.
-url: Alternate Parameterization service URL
-ranges: Specifies which frame range is to be parameterized. Defaults to all frames if this argument does not specify otherwise.
-includetrackingresults: Include this optional flag if you'd like to create a secondary image sequence with burned-in tracking results. The images will show the landmarks positions on the face for each frame.
-region: Include this if you wish to change the parameterization region. 1 = US East, 2 = Asia/Pacific. The default is US East
-dc 0: Include this if you wish to opt out of data collection during parameterization. The value will always be "0".
Command:
ExportLandmarkPositions: Exports the positions of all facial landmarks from each frame to an XML file.
Syntax:
Required Arguments:
FwtFile: This is the path to the Analyzer job file (.fwt) that you want to export landmark positions from.
XmlFile: This is the path to the XML file that you want to save the data to. A new file will be created if it does not exist already.
Command:
Help: Lists the arguments and syntax for each command
Syntax:
Required Arguments:
Command: This is the command that the user desires help for. Can be: