This information is for Vicon Shogun 1.7. For up-to-date help, see the latest Shogun documentation.

Vicon Shogun banner

Description

Creates one or more new modules of a specified type.

Use create to define one or more new objects in your scene. You may use this command to create any of the six object types: Markers, RigidBodies, Characters, BoneNodes, and Solvers. Various attributes of the object can be set at creation, including pre translation and pre rotation values, parent module, and the name of the module(s) to create.

Functional area

Data editing

Command syntax

Syntax

create moduleType "name1" ["name2"] ...[-addSelect] [-parent string] [-positionOffset vector] [-rotationOffset vector] [-preTranslation vector] [-preRotation vector] [-allClips] [-multiple integer] 

Arguments

NameTypeRequiredComments
moduleNamestringnoString name of the new module
moduleTypestringyesType of module to be created. Valid types are: Marker, RigidBody, Character, BoneNode, and Solver.

Flags

NameFlag argumentsArgument typeExclusive toComments
copy0Create copies of all selected objects of the named type. Copies will have same name but no other data in common.
addSelect0Do not reset the selection. Simply adds this new object to the current selection.
parent1stringParent the newly created object to the object named here.
preTranslation1vectorOffset the newly created object by posOffsetVector from its parent.
preRotation1vectorOffset the newly created object by rotOffsetVector from its parent.
allClips0Add the new module to all clips (default is active clip only)
positionOffset1vectorSets the pre translation value - deprecated: use -preTranslation instead
rotationOffset1vectorSets the pre rotation value - deprecated: use -preRotation instead
multiple
integerCreates multiple instances of the object being created. The integer specifies the total number of objects to create.

Return value

void

Examples

// Create a new object of type Marker having the name "rightThumb"
// parent the new Marker to the CharacterNode called Actor_1.
create Marker rightThumb -parent Actor_1;
// Create 4 new characters
create Character Actor_2 Actor_3 Actor_4 Actor_5;

Additional information

Related commands