On this page |
Overview ¶
Selection sets are used to organize controls into groups, or sets, in the animate state. These sets can then be used to select, hide, pin, and isolate groups of controls. Selection sets are only displayed when you are in the animate state.
Selection sets are stored with the geometry when you exit the animate state. When you re-enter the animate state, you will see the selection sets you defined earlier.
Selection sets can be managed either in its own pane, or in a HUD window that is embedded in the animate state.
Selection sets pane
The selection sets pane offers the full functionality of working with and managing selection sets, including options for importing, mirroring, and editing sets, as well as the ability to customize the display of the pane.
To create a selection sets pane tab:
-
Click the New Tab icon at the top of a pane.
-
Choose New Pane Tab Type ▸ Animation ▸ APEX Selection Sets.
Selection sets HUD
A selection sets HUD window is automatically created and displayed in the viewport when you enter the animate state. The HUD offers a more streamlined selection of options for working with and managing selection sets within the viewport. There are also slight differences in the placement of icons between the HUD and the selection sets pane.
Selection sets structure ¶
There are three top-level categories of selection sets:
User-defined selection sets
Users can create sets from a selected group of controls.
Current Selection
A special set that contains the currently selected controls in the animate state. Users cannot make changes to this set.
All Controls
A special set that contains all the controls in the current scene. Users cannot make changes to this set.
Selection sets are organized in a tree structure with a hierarchy of controls for each character in the set:
-
At the top level is the selection set
-
Under the selection set is the character
-
Under the character is the rig
-
Under the rig are the controls in the rig
To the right of each item in the tree structure is a number that indicates the number of controls in the item’s subtree. If the name of the item contains a pattern, this number represents the number of controls matched by the pattern, and an additional descriptor, PATTERN
, is appended after the number. For example, a pattern that matches 10 controls in a rig could be displayed in the tree structure as: * 10, PATTERN
.
Selection set icons ¶
In the following table, an item is a character, rig, or control in the selection set tree structure.
Icon |
Functionality |
---|---|
|
User-defined sets |
|
Currently selected controls |
|
Character |
|
Character is visible, or all characters in the set are visible |
|
Some of the characters in the set are visible |
|
Character is hidden, or all characters in the set are hidden |
|
Rig |
|
Control |
|
Control is visible, or all controls in the group are visible |
|
Some of the controls in the group are visible |
|
Control is hidden, or all controls in the group are hidden |
Icon |
Functionality |
---|---|
|
Primary control - the control on which the transform handle is placed |
|
Item is isolated |
|
Some of the items in the group are isolated |
|
The isolating functionality is currently disabled, but when isolating is enabled, this item is isolated. |
|
Control is selected, or all controls in the group are selected |
|
Some of the controls in the group are selected |
|
Control is not selected, or none of the controls in the group are selected |
|
Item is pinned |
|
Some of the items in the group are pinned |
|
Item is un-pinned, or all items in the group are un-pinned |
Creating and modifying sets ¶
To... | Do this |
---|---|
Create a set from a selection of controls |
|
Create an empty set |
RMB click anywhere in the selection sets tree structure, and choose Create Empty Set. or In the selection sets pane, choose Edit ▸ Create Empty Set. |
Create a nested selection set |
Drag and drop a set into another set. or
|
Reorganize the tree structure |
Drag and drop sets within the tree structure. |
Add or remove controls from a set |
|
Remove a set |
RMB click the set, and choose Delete Set. or
|
Remove all sets |
In the selection sets pane, choose Edit ▸ Clear Sets. |
Duplicate a set |
RMB click the set, and choose Duplicate Set. or
The duplicate set is named |
Rename a set |
|
Rename sets using a pattern |
For example, if the current set names are |
Color a set |
or
or
|
Clear the color on a set |
or
|
Working with sets ¶
With selection sets, you can select, display, pin, and isolate groups of controls. You also have the option to show or hide full character geometries.
In the following table, an item is a character, rig, or control in the selection set tree structure.
To... | Do this |
---|---|
Select or deselect items |
Select the item in the tree structure. or In the selection sets pane, click the or icon. or RMB click on an item, and choose Select Controls or De-Select Controls. or In the selection sets pane, select the item, and choose Manage ▸ Select Selected Sets or De-Select Selected Sets. |
Show or hide controls |
Click the or icon. or RMB click on an item, and choose Show Controls or Hide Controls. or In the selection sets pane, select the item, and choose Manage ▸ Show Selected Sets or Hide Selected Sets. Note When the isolating functionality is enabled, the showing/hiding of controls is disabled (the show/hide icons in the selection sets pane are greyed out). |
Change the control that has its handle displayed when the set is selected |
In the selection sets pane, RMB click the control, and choose Make Primary Control. The icon beside the control name will change to . |
Isolate or de-isolate items |
Isolating controls hides all other controls except for the selected controls. In the HUD, Ctrl+Shift click on the or icon to isolate the item. A icon will appear beside the item name. To de-isolate the item, click on the icon. or In the selection sets pane, click in the Isolate Controls column next to the set. or RMB click on an item, and choose Isolate Controls or De-Isolate Controls. or In the selection sets pane, select the item, and choose Manage ▸ Isolate Selected Sets or De-Isolate Selected Sets. |
Enable/Disable the isolating functionality |
In the HUD, RMB click the tree structure, and choose Enable Isolating or Disable Isolating. When isolating is enabled, the isolating icons (/) appear beside the item name. When isolating is disabled or no items are isolated, the show/hide icons (/) appear beside the item name. or In the selection sets pane, click or on the top toolbar. indicates that isolating is enabled. indicates that isolating is disabled or no items are isolated. When isolating is enabled, the showing/hiding of controls is disabled (the show/hide icons in the selection sets pane are greyed out). |
Clear the isolate state of all sets |
RMB click the tree structure, and choose Clear Isolated Controls. or In the selection sets pane, ⌃ Ctrl click the icon at the top of the Isolate Controls column. or In the selection sets pane, choose Manage ▸ Clear all isolated. |
Pin or unpin items |
Pinned items remain in the channel list. When you set a keyframe, you are keying all the items that are pinned. Click the or icon. or RMB click on an item, and choose Pin Controls or Un-Pin Controls. or In the selection sets pane, select an item, and choose Manage ▸ Pin Selected Sets or Un-Pin Selected Sets. |
Clear all pinned sets |
In the selection sets pane, ⌃ Ctrl click the icon at the top of the Pin/Unpin Controls column. or In the selection sets pane, choose Manage ▸ Un-Pin all. |
Show or hide characters |
Click the or icon. or RMB click anywhere in the selection sets tree structure, and choose Show All Characters. or In the selection sets pane, choose Manage ▸ Show all characters. |
Fully expand or collapse a subtree |
Hold ⇧ Shift and click on the or icon before the item name. or RMB click on an item, and choose Expand Sub Tree or Collapse Sub Tree. or In the selection sets pane, select an item, and choose Manage ▸ Recursively Expand Selected Sets or Recursively Collapse Selected Sets. |
Show only selection set items with a particular name |
At the bottom of the selection sets pane, turn on Filter, and enter a pattern for filtering the item names. Only sets with item names that match the pattern are displayed in the selection sets tree structure. |
Mirroring sets ¶
Selection sets support specifying a pattern to map set names and controls between the left and right sides of the character.
By default:
-
Set names match the patterns
L_*
andR_*
. -
Controls match the patterns
*_l
and*_r
.
When mirroring a set:
-
The set names that match the left or right set pattern are pattern-renamed to the opposite side.
-
Inside the pattern-renamed set, all controls that match the left or right control pattern are pattern-renamed to the opposite side.
To... | Do this |
---|---|
Mirror a set |
RMB click a set, and choose Create Mirror Set. or
or
If the original set name matches the set pattern in Manage ▸ Edit Set Name Remap Patterns, the mirrored set will be pattern-renamed to the opposite side. If the original set name does not match the set pattern in Manage ▸ Edit Set Name Remap Patterns, the mirrored set will be named |
Change the control remap patterns |
|
Change the set name remap patterns |
|
Working with patterns ¶
Selection sets support the use of patterns in character, rig, and control names. Patterns can allow you to apply a group of controls to any number of characters in the scene, which is useful when creating or importing generic sets made for multiple characters. You can also use patterns to specify that a set includes all the controls in a character.
Patterns can be expanded back to the actual names of the character, rig, or control. Expanding a pattern is essentially the reverse operation of defining a pattern.
In the following table, an item is a character, rig, or control in the selection set tree structure.
To... | Do this |
---|---|
Change a pattern for an item |
For example:
The number beside the item name is the number of controls matched by the set, and an additional descriptor, PATTERN, is appended after the number. |
Expand all patterns in a set |
Replaces all the patterns with the character/control names. RMB click a set, and turn on Expand All Patterns. or In the selection sets pane, select a set, and choose Edit ▸ Expand Patterns in Selected Sets. |
Expand only character patterns in a set |
Replaces the character pattern with character names, and creates a hierarchy for each character. Patterns within the character are not expanded. RMB click a set, and turn on Expand Characters Patterns. or In the selection sets pane, select a set, and choose Edit ▸ Separate Character Patterns in Selected Sets. |
Apply a set to all characters |
RMB click a set, and choose Apply to All Characters. or In the selection sets pane, select a set, and choose Edit ▸ Apply to All Characters. If Edit ▸ Expand Patterns when Applying to Characters is turned on, a hierarchy for each character will appear under the set. If Edit ▸ Expand Patterns when Applying to Characters is turned off, the character names will be renamed to If Edit ▸ Separate Sets for Each Character when Applying is turned on, a separate set will be created for each character. |
Apply a set to selected characters |
If Edit ▸ Expand Patterns when Applying to Characters is turned on, a hierarchy for each character will appear under the set. If Edit ▸ Expand Patterns when Applying to Characters is turned off, and more than one character is chosen, the character name under the set will be replaced with a list of the selected character names separated by spaces, for example, If Edit ▸ Separate Sets for Each Character when Applying is turned on, a separate set will be created for each character. |
Create a separate set for each character when expanding a pattern |
RMB click a set, and choose Make Separate Sets for Each Character. A separate set is created for each character. or In the selection sets pane, turn on Edit ▸ Separate Sets for Each Character when Applying. When applying a set to all or selected characters (using Apply to All Characters or Select Characters to Apply to), a separate set is created for each character. |
Remove the original set when creating separating sets for characters |
This option is used in conjuction with making separate sets for each character when expanding a pattern. Turn on Edit ▸ Remove Original Set when Separating Sets for Characters. The original set will be deleted after creating the new sets for each character. |
Turn an item name into a wildcard pattern |
RMB click the item, and choose Generalize Item. For characters, the character name changes to For controls, the control name changes to |
Importing and exporting sets ¶
Selection sets are generally stored in an attribute on the scene’s geometry for the animate state. There is also the option to import sets to and from files on disk, as well as from another node in the scene that contains geometry with the correct selection set attribute.
To... | Do this |
---|---|
Export all sets to a file |
|
Export selected sets to a file |
|
Import sets from a file |
|
Import sets from a node |
|