Description

This command selects objects in the scene via their membership in any selection sets previously defined.

Selection commands are a staple of CG software. Shogun Post provides a flexible array of select functions, including this selectSet command, to meet just about any selection requirement.

The selectSet command coupled with pre-defined selection sets enables you to set up your scenes without regard to specific marker names. For example, a selection set can be defined called setWaist that includes all the names you might encounter for waist markers, allowing the waist markers to be selected via the selection set rather then explicit marker names.

Functional area

Selection

Command syntax

Syntax

selectSet "set1" "set2" ...[-all] [-a] [-r] [-priorityOnly]

Arguments

Name	Type	Required	Comments
`set1`	string	no	String names of pre-defined Selection Sets. More than one can be used.

Flags

Name	Argument type	Exclusive to	Comments
`all`	—	—	Selects all members of all defined Selection Sets. Using this option removes the need to supply an argument.
`a`	—	r	Add to the current selection
`r`	—	a	Remove from the current selection
`priorityOnly`	—	—	Selects only modules3 that are children of the priority module.

Return value

void

Examples

// First add several Selection Sets to the current selection. 
// Then remove one.
// Then select all Selection Set members.
selectSet -a head LeftLeg RightFoot;
selectSet -r LeftLeg;
selectSet -all;