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.
|string||no||One 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.|
|Name||Flag arguments||Argument type||Exclusive to||Comments|
|0||—||r||Specifies that selection operation add to the current scene selection. The default is to replace the scene selection.|
|0||—||a||Specifies that selection operation be removed from the current scene selection. The default is to replace the scene selection.|
|1||string||—||Narrows the search to specific module types (e.g. Bone, Marker, etc.). The default is all module types.|
|1||string||—||Only selects modules that are children of this module name.|
// 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
// Add to the selection all front waist markers
selectByName "?FWT" -a;