The Mannequin Editor is set of high level tools to help you manage the complexities of interactive animation.
For a detailed introduction of the Mannequin Editor, please see this page.
Option | Description |
---|---|
Load Preview Setup | Load an existing preview setup. |
Preview Editor | The Preview Editor can be used bind characters and animation databases to Scope Contexts for visualization purposes within the Mannequin Editor. Multiple context configurations can be defined and later switched between through the Context dropdown available in the Fragments and Transitions panes. |
Animation DB Editor | The Animation Database Editor is used to edit the rules which determine in which ADB file fragments end up. It can also be used to create new ADB files. |
Tag Definition Editor | The Tag Definition Editor is used to create & edit Tag Definition Files. More information can be found in the (technical) tutorial Entity Setup From Scratch. |
Save Changes | Opens up a window with a list of modified files and provides a way to save or revert the changes on a file-by-file basis. |
Re-export All | Commit all changes, so that they're visible in the level editor. |
Option | Description |
---|---|
New Sequence | Create a new sequence. |
Load Sequence | Load an existing sequence. |
Save Sequence | Save the current sequence. |
Option | Description |
---|---|
List Used Animations | Exports a list of all animation (CAF) files used by all existing preview setups, in a CSV format. |
List Used Animations (Current Preview) | Exports a list of all animation (CAF) files used by the currently loaded preview setup, in a CSV format. |
This pane has three tabs at the bottom, with which you can switch between three panes, the Fragments pane, the Sequences pane and the Transitions pane.
The Fragments pane consists of two parts: the Fragment List and the TagState list.
This pane lists all fragments in an animation database (and its sub-databases). It is used to find & create fragments, change fragment tags, as well as creating and editing fragmentIDs.
It is typically used in combination with either the Fragment Editor (to edit fragments) or the previewer (to preview sequences).
It can be accessed by clicking on the "Fragments" tab at the left side of the editor.
For tutorials that go through some of this functionality, check out Mannequin Editor Tutorial 1 - Preview Setup, Fragments and Saving and Mannequin Editor Tutorial 2 - Tags & Previewing.
The next sections will go through the parts of this panel from top to bottom:
Option | Description | |
---|---|---|
Context | Use the context dropdown to select which context configuration you would like to use. This list is based on the current Preview Setup, which can be edited in the Preview Editor. Fragments displayed in the browser below belong to the database of the currently active context configuration. | |
Current ADB | Shows the ADB in which fragments for the currently selected fragmentID end up in.
| |
FragmentID Filter | Show only fragments for fragmentIDs containing this word. | |
Tag Filter | Show only fragments with tags containing this word. The word "<default>" counts too, so if you look for "default" it includes all fragments without tags. | |
Anim Filter | Show only fragments with animations containing this word. | |
Sub Folders | When checked: The fragment list will create folders for all tags. Higher priority tags will be higher up the tree than lower priority ones. | |
Show Empty | Show also FragmentIDs that have no fragments in it. (useful for example when creating the first fragment with a certain fragmentID) |
Fragment Tree
Shows the list of fragments, sorted by fragmentID.
Some things to note about this tree view:
The currently 'edited' fragment is shown in bold. This is the fragment whose tagstate is displayed below, and it is the same fragment which is the main fragment currently displayed in the Mannequin Fragment Editor.
Note that this is a different fragment than the currently selected one! (see screenshot above).
Function Buttons
Button | Description |
---|---|
New | Create new Fragment within the currently selected fragmentID. |
Delete | Delete the currently selected fragment. |
Edit | Edit the currently selected fragment: open it in the Mannequin Fragment Editor and show its tagstate below. |
New ID | Create new FragmentID. First it will ask you for a name, after which it opens the Mannequin FragmentID Editor. |
Delete ID | Delete currently selected FragmentID. |
Edit ID | Open the Mannequin FragmentID Editor for the currently selected FragmentID. |
Tag Definition Editor | Open the Mannequin Tag Definition Editor. |
This shows the tagstate (both global tags and fragtags) of the currently edited fragment, which is the boldface fragment in the fragment list.
Here you can edit this fragment's tagstate. An empty or unchecked tag means the tag is not set on the fragment.
The Sequences browser is used to select the sequence you would like to open in the Mannequin Previewer.
It simply lists the files in the default sequence folder, described in the article on sequence files.
To access the panel, click on the tab Sequences at the bottom of the mannequin editor.
Use double click or the Open button to open the selected sequence.
The Transition Browser is used to list all the transitions in a certain animation database (and its sub-ADBs).
It is used in combination with the Mannequin Transition Editor.
It can be accessed by clicking the Transitions tab at the bottom of the mannequin editor.
See Mannequin Editor Tutorial 3 - Transitions.
Option | Description |
---|---|
Context | Use the context dropdown to select which context configuration you would like to use. This list is based on the current Preview Setup, which can be edited in the Preview Editor. Transitions displayed in the browser below belong to the database of the currently active context configuration. |
Transition From/To | Provides a way to filter the transition list below based on Fragment IDs and tagstate. |
Button | Description |
---|---|
New | Create a new transition. |
Open | Open the currently selected transition in the Transition Editor and shows it in the Transition Preview below. |
Edit | Edit the currently selected transition: opens it in the Transition Editor and shows it in the Transition Preview below. |
Copy | Copy the selected transition. |
Delete | Deletes the selected transition. |
In the pane on the right you can open four different tools within the Mannequin Editor: the Fragment Editor, the Transition Editor, the Previewer and the Mannequin Error Report.
The Fragment Editor is used to edit fragments (multiple at a time).
It can be brought up by:
For details on the tracks, see Mannequin Track Properties.
For specific details on editing clips, see Mannequin Animation Clip Properties.
For more, see Mannequin Editor Tutorial 1 - Preview Setup, Fragments and Saving.
The Transition Editor is where you edit specific mannequin transitions.
It is typically used together with the Transition Browser.
Is is accessed by clicking the Transitions tab at the bottom of the mannequin editor.
See Mannequin Editor Tutorial 3 - Transitions.
The Previewer is used to edit and view Sequence Files, or simply to test a sequence of fragments without even saving it to a file.
It can be accessed by clicking the "Previewer" tab at the bottom of the mannequin editor.
See Mannequin Editor Tutorial 2: Tags & Previewing.
This panel displays the result of validation on the currently opened setup.
It is one of the panels at the right of the mannequin editor. To access it simply press the "Error Report" tab at the bottom.
Every time you open a preview setup validation is done on that setup. If any errors are found, the error report will pop up to the front automatically.
This area shows the list of errors/warnings the validation found.
Double click a line to select that fragment in the Fragment Browser/Editor.
Select one or more lines to operate on those fragments using the menu or right click menu.
Button | Description |
---|---|
Select All | Check all listed errors/warnings. |
Clear Selection | Uncheck all. |
Check | Run the validation again. |
Delete Fragments | Delete the fragments corresponding to the checked errors/warnings. |
Option | Description |
---|---|
Copy Warning(s) To Clipboard | Copy all lines to the clipboard. |
E-mail Error Report | Create a mail with all lines. |
Open in Excel | Open the lines in Excel. |