Vicon Shogun banner

Description

Selects all modules with matching name(s).

Names can contain DOS-style wild card characters to select modules matching name patterns. The wild card character ? matches any single character, while * matches zero or more characters.

Thus, the following command selects all markers whose name began with L (usually indicating they are on the left of the body):

selectByName "L*" -type "Marker"; 

Unlike the select command which selects only the first module with the given name if multiple modules of the same name exist, the selectByName command selects all modules of the given name.

Functional area

Selection

Command syntax

Syntax

selectByName "name1" "name2" ...[-a] [-r] [-type string] [-childOf string]

Arguments

NameTypeRequiredComments
name1stringnoOne or more module names to select. The name can contain DOS-style wild card characters to match name patterns. If no names are specified, all modules are de-selected.

Flags

NameFlag argumentsArgument typeExclusive toComments
a0rSpecifies that selection operation add to the current scene selection. The default is to replace the scene selection.
r0aSpecifies that selection operation be removed from the current scene selection. The default is to replace the scene selection.
type1stringNarrows the search to specific module types (e.g. Bone, Marker, etc.). The default is all module types.
childOf1stringOnly selects modules that are children of this module name.

Return value

void

Examples

// Select all head markers in the scene, not just the
// one under the priority search module
selectByName "LFHD" "RFHD" "LBHD" "RBHD";

// Could have also done this
selectByName "*HD";

// Add to the selection all front waist markers
selectByName "?FWT" -a;

Additional information

Related commands