Retargeter 3DS MAX: Maxscript Batch Commands

Brian Genna -

Faceware Retargeter 3DS MAX: Maxscript Batch Commands

 

ImAddPose - Adds a Pose to a Face Group.

 Usage:

 

  • Arguments: Face Group (String), Scene Frame Number (Integer), Description (String)
  • Example: ImAddPose "Brows" 10 "My Pose Description" ;

 

ImUpdatePose - Updates an existing Pose.

 Usage:

 

  • Arguments: Face Group (String), Scene Frame Number (Integer)
  • Example: ImUpdatePose "Mouth" 10 ;



ImUpdatePoseSelected - Turns a Pose on or off.

 Usage:

 

  • Arguments: Face Group (String), Frame Range Name (String), Scene Frame Number (Integer),  On or Off (Boolean)
  • Example: ImUpdatePoseSelected "Mouth" "All Frames" 10 false ;



ImUpdateSharedPoseSelected - Turns a Shared Pose on or off.

 Usage:

 

  • Arguments: Face Group (String), Frame Range Name (String), Video Name (String), Scene Frame Number (Integer), On or Off (Boolean)
  • Example: ImUpdateSharedPoseSelected "Mouth" "All Frames" "Video1" 10 false ;




ImCreateNetworkDatabase - Creates a Shared Pose Database.

 Usage:

 

  • Arguments: Shared Pose Database File Path (String)
  • Example: ImCreateNetworkDatabase "C:\Directory\SharedPoseDatabse.fwsp" ;



ftiLoadSharedPoseDatabase - Loads a Shared Pose Database.

 Usage:

 

  • Arguments: Shared Pose Database File Path (String)
  • Example: ftiLoadSharedPoseDatabase "C:\Directory\SharedPoseDatabse.fwsp" ;

 

ImEditRetargetingRange - Edits an existing Frame Range.

 Usage:

 

  • Arguments: Face Group (String), Current Frame Range Name (String), New Frame Range Name (String), Pruning (Integer), Prune Spacing (Integer), Smoothing (Integer), Master Control (String), Frame Range (String), Autosolve (Boolean), Pose Weight (Integer)
  • Example: ImEditRetargetingRange "Brows" "All Frames" "Edited Range" 9 3 5 "None" "1-100" false 2 ;



ImAddRetargetRange - Adds a new Frame Range.

 Usage:

 

  • Arguments: Face Group (String), Frame Range Name (String), Frame Range (String)
  • Example: ImAddRetargetRange "Mouth" "All Frames" "101-200" ;



ImDeleteRetargetingRange - Deletes a Frame Range.

 Usage:

 

  • Arguments: Face Group (String), Frame Range Name (String)
  • Example: ImDeleteRetargetingRange "Mouth" "All Frames" ;



ImAddSharedPose - Adds the pose to the Shared Pose Database.

 Usage:

 

  • Arguments:  Face Group (String), Scene Frame Number (Integer)
  • Example: ImAddSharedPose "Mouth" 10 ;



ImDeleteSharedPose - Deletes a Shared Pose from the Database

 Usage:

 

  • Arguments: Face Group (String), Video Name (String), Scene Frame Number (Integer)
  • Example: ImDeleteSharedPose "Mouth" "vid-AD3" 17 ;



ImRevertToPoses - Reverts to poses only. Removes in-between animation.

 Usage:

 

  • Arguments: Face Group (String), Frame Range Name (String)
  • Example: ImRevertToPoses "Brows" "All Frames" ;




ImReloadRetargetingResults - Reloads Retargeting Results.

 Usage:

 

  • Arguments: Face Group (String), Frame Range Name (String)
  • Example: ImReloadRetargetingResults "Brows" "All Frames" ;



ImClearAllKeys - Clears all keyframes within the specified Face Group and Frame Range.

 Usage:

 

  • Arguments: Face Group (String), Frame Range Name (String)
  • Example: ImClearAllKeys "Brows" "All Frames" ;



ImSetPlaybackRange - Sets the scene timeline to match the video’s range.

 Usage:

 

  • Arguments: none
  • Example: ImSetPlaybackRange ;



ImSetSceneFrameOffset - Sets the scene’s frame offset for current job.

 Usage:

 

  • Arguments: Offset (Integer)
  • Example: ImSetSceneFrameOffset 3 ;



ImUpdateSharedPoses - Updates the user’s shared poses if the database has been updated.

 Usage:

 

  • Arguments: Face Group (String)
  • Example: ImUpdateSharedPoses "Brows" ;



ImDefaultCurrentFrame - Sets all controllers in specified Pose Group to their default value on the current frame.

 Usage:

 

  • Arguments: Face Group (String)
  • Example: ImDefaultCurrentFrame "Brows" ;

 

ImDeletePose - Deletes the pose on the specified frame.

 Usage:

 

  • Arguments:  Face Group (String), Scene Frame Number (Integer), Delete Key (Boolean)
  • Example: ImDeletePose "Mouth" 0 true ;





ImGetAutoPoses - Gets a number of AutoPoses on the Face Group and Frame Range specified.

 Usage:

  • Arguments: Face Group (String), Frame Range Name (String), Number Of Poses (Integer)
  • Example: ImGetAutoPoses "Brows" "All Frames" 3 ;



ImCopyPose - Makes a copy of a pose.

 Usage:

 

  • Arguments: Face Group (String), Origin Scene Frame Number (Integer), Destination Scene Frame Number (Integer), Description (String)
  • Example: ImCopyPose "Mouth" 10 300 "Copied Pose" ;




ImMovePose - Moves a pose from one frame to another.

 Usage:

 

  • Arguments: Face Group (String), Origin Scene Frame Number (Integer), Destination Scene Frame Number (Integer), Description (String)
  • Example: ImMovePose "Brows" 10 300 "Move Pose" ;



ImSetPoseName - Sets the description of the specified pose.

 Usage:

 

  • Arguments: Face Group (String), Scene Frame Number (Integer), Description (String)
  • Example: ImSetPoseName "Brows" 300 "Changed Name" ;




ImBackup - Creates a backup.

 Usage:

 

  • Arguments: Backup Name (String)
  • Example: ImBackup "New Backup" ;



ImRestore - Restores scene from a Backup.

 Usage:

 

  • Arguments: Backup Name (String)
  • Example: ImRestore "New Backup" ;



ImApplySharedPoseToScene - Applies Shared Pose to scene.

 Usage:

 

  • Arguments: Face Group (String), Video Name (String), Video Frame Number (Integer)
  • Example: ImApplySharedPoseToScene "Mouth" "vid-AD3" 10 ;



ftiRetarget - Retargets a Pose Group and Frame Range

 Usage:

 

  • Arguments: Face Group (String), Frame Range Name (String)  

Optional Arguments: Use AutoSolve (String)

  • Example: ftiRetarget "Eyes" "All Frames" "generateautosolve" ;




ftiOpenPerformance - Loads a performance in Retargeter.

 Usage:

 

  • Arguments: .FWR File Path (String), Character Setup File Path (String)
  • Optional Arguments (String):

fr = Set Frame Rate in scene to match Video

pr = Set Playback Range to match Video

a = Import Audio

v = Import Video

as = Use AutoSolve

  • Example: ftiOpenPerformance "C:/Directory/Job.fwr" "C:/Directory/CharacterSetupFile.xml" "a" "v" "fr" "pr" "as" ;










Have more questions? Submit a request

Comments

this.location="http://support.facewaretech.com"
Powered by Zendesk