cryTools: AnimTools

Installation
Quadmenu Functions
Main Dialogue
   Selection Rollout
   
Operation Rollout
   Pivot Rollout
   Misc Rollout
   Load/Save/Export Rollout
   Perforce Rollout
   Tools Rollout
Model Set-Up
Batch Export Rollout

Installation

After initialization of the script in Max, it will also generate entries in the customization dialog: (Under the MainUI group and in the CryAnim category)

cryAnimInstallation.jpg

There are all functions available to make a key shortcut or tool bar button.
(most of the functionality is in the quad menu too)

Quadmenu Functions

quadmenu.jpg


go_forward bip to [0,0]
Takes the Bip01 node to [0,0].


go_forward bip to [0,0,0]
Takes the Bip01 node to [0,0,0].


go_forward show trajectory
Enables the trajectory of the selected node.
(
is hidden if no Biped object is selected)

go_forward hide trajectories

Hides all visible trajectories.
(is available if a trajectory is visible)


go_forward move to snapshot
Moves the selected Biped object to the nearest snapshot (generated out of the same object)
if a pivot point is selected, it keeps the offset of it is disabled if no correct snapshot is in the scene is visible if a Biped object is selected

go_forward move/rotate to snapshot
The same as "move to snapshot"
plus Rotation

go_forward lock rotation
Rotates the object every time it will be moved to the set rotation back
(is visible if a Biped object is in scene)


go_forward reset rotation
Rotates the selected Biped object with the same rotation as the parent object
(is visible if a Biped object is selected)


go_forward move to floor
If the foot is selected, it will be rotated and moved to plant on the ground
(is available if a Biped foot is selected)


go_forward create snapshot

single
Creates a snapshot of the selected object
(is visible if an Object is selected)

children
Creates snapshots of all children of the selected object
(is visible if an Object is selected)


go_forward copy
Copies the position and rotation of the selected objects and stores them into a temporary file in cry_temp folder
(is visible if an Object is selected)


go_forward paste

transform
Pastes the position and rotation from the temporary file to the selected objects
(is visible if the temporary file exists and an Object is selected)
(works for non-Biped nodes too)

position
Pastes only the position

rotation
Pastes only the rotation


go_forward select pivot
Starts the pivotSelect tool to select an internal pivot to align with snapshots or pivot points
(is available if hand or foot is selected)

Main Dialog: Selection Rollout

dialogSelection.jpg

led-yellow Drop down List :
In the drop down list you specify the object you want to appy the operation to.
When choosing Update List, the list will be updated with the available nodes in the scene.

If the selection is not "--Current Selection--" but an object in the scene is selected, the axis and offset is available and the Operation rollout will be updated.

dialogSelection2.jpg

 led-yellow Used Axis :
If enabled, you can select which coordinate axis will be used for the operation.

led-yellow Offset Set Button :
If enabled, sets the offset from the current selected object and the object selected in the drop down list. After the offset is generated, the Offset checkboxes are available.

led-yellow Offset Axis :
If position is checked, the selected object will be in addition to the offset aligned to the object set in the list. With this, the locator can be easily aligned in cycles or other animations, where the locator has a different position as the object selected in the list.

If rotation is checked, the selected object will be in addition to the offset rotated to the object set in the list. This helps when animating the locator in animations where the character runs in circles and the locator needs to follow up.

Main Dialog: Operation Rollout

dialogOperation.jpg

led-yellow Start / Stop :
This button sets the range of operation.
The red square box indicates which value will be changed when hitting again.

led-yellow Steps :
Specify how many steps the operation will use.
(Default is 1)


led-orange Operation :

If 'Current Selection' is selected in the Selection rollout:

Name Operation
Planted Key generates a planted key
Sliding Key generates a sliding key
Free Key generates a free key
-------------------- ------------------------------------------------------------------------------------------------
Move moves the selected Biped object to the nearest snapshot / pivot point
Move / Rotate moves and rotates the selected Biped object
-------------------- ------------------------------------------------------------------------------------------------
Move to Floor if the foot is selected it puts the foot on the floor
Reset Rotation adapts the rotation of the selected objects parent rotation
-------------------- ------------------------------------------------------------------------------------------------
Copy copies the rotation and position of the current selected object
Paste pastes the rotation / position / transform to the current selected object
-------------------- ------------------------------------------------------------------------------------------------
Bip to [0,0] puts Bip01 node to [0,0]
Bip to [0,0,0] puts Bip01 node to [0,0,0]


If some Object in the list is selected:
Name Operation
Move moves the selected Biped object to the object selected in the list
Line moves the selected Biped object with reference of the selected object in the list along a line

led-yellow Apply
Applies once the selected operation to the selected object.

led-yellow Begin / End
Applies the selected operation in the specified range (Start / Stop) and with the given Steps

led-yellow Range
Applies the selected operation for the Full animation range with the given Steps

Main Dialog: Pivot Rollout

dialogPivot.jpgled-yellow Select Pivot
If a foot is selected, you can select which pivot you want to operate with for Move operation.

led-yellow Create
Creates a new Pivot Point with the selected pivot.
led-yellow Delete
Deletes the Pivot Point of the selected Biped Object.
led-yellow Single
Creates a single snapshot from the selected Object.
led-yellow + Children
Creates snapshot from the children of the selected Object and integrates them into a group. 

Main Dialog: Misc Rollout

dialogMisc.jpg

led-yellow Load Model
If a model list is created before, the model selected will be opened (without message box asking to save changes!).
How to maintain models

led-yellow Reset Locator
Rotates and translates the locator to Y+ and [0,0,0] (origin of scene).

led-yellow Weapons Drop Down List
If a weapon list is created before, the weapon selected will be unhidden, every weapon before will be hidden (needs reference in weapons_ref.max in tools folder).
How to maintain weapons

led-orangeMuscles 

led-yellow AutoMuscles
If checked and nanoMuscles are in the scene, automatically repositions the look-at targets without animating.

If unchecked and Use Keys is unchecked too, keys will be generated automatically when changing the timeline.
When exporting using the cryAnim tools, the nanoMuscles will be baked automatically by export.

led-yellow Use Key
Is available when Auto-Muscles is unchecked.
If nanoMuscles are baked and Use Keys is checked, it will not generate keys when changing the timeline. Needed when tweaking the bones.

led-yellow Create
If there is no nanoMuscles rig available on the character, it will be generated.

led-yellow Bake
Bakes the nanoMuscles Keys.

Main Dialog: Load / Save / Export Rollout

dialogLoadSave.jpg

led-yellow Load Biped File
Prompts a open file dialog where you can choose the biped you want to load (must have correct file naming: works not without file extension).

led-yellow Start / End
Sets the range to save the biped to.

led-yellow Range
Sets the current animation range to save the biped to.

led-yellow All
Uses the biped range for saving.

led-yellow Add
If a bone is currently selected, the bone will be added to the bone export list.

led-yellow Delete
If a bone is selected in the list, it will be deleted.

led-yellow Save
Prompts a saving file dialog to choose a file where to save the biped to.

led-yellow Export
Prompts a saving file dialog to choose a file where to export to.

led-yellow Save / Export
Prompts a saving file dialog to choose a file where to save to.
(It will generate automatically the correct path for the CAF file and export the biped.)

led-yellow Batch Export
Runs the batch exporter to export .bip or .fbx files.
How to use the batch export

Main Dialog: Perforce Rollout

dialogPerforce.jpg

led-yellow AutoUpdate
If checked, tries to get latest revision every minute from perforce.

led-yellow Notify
If checked, shows a message box if there is a new updated installed.


Name Y(es) N(o) A(sk)
Open For Edit always open never open prompt message to ask
Add to Source Control always add never add prompt message to ask



Main Dialog: Tools Rollout

dialogTools.jpgled-yellow Reload Script
Destroys the dialog and runs the loading script to load all necessary files again.

led-yellow Prompt for File
When saving or exporting, a open file dialog pops up to get the file location the animation should be saved to (works only with extension).

led-yellow Biped Working Directory
Has the path of the directory to use when Save / Exporting animations and will be the default folder when Loading Biped Files.
led-yellow Pick
Opens a dialog to get the directory for the biped files.
led-yellow Set
Assigns the folder path to the variable used internally.

led-yellow Use Rollout States
If checked, remembers the last state (rolled up/down) of the rollouts and when loading the dialog again, these states will be set.
led-yellow Notify File Attribute
If checked, pops up a message box if the file to save or export to is read-only.