documentation

Multi Model Tracker Command Reference

The MultiModelTracker contains multiple ModelTrackers - one for each anchor. The ModelTracker can be adressed by the name of their corresponding anchor. This way, one can send a command to a specific ModelTracker (see anchorCommand). Therefore it is useful to also have a look at the Model Tracker Command Reference. Some commands are implemented in the MultiModelTracker and propagate the command to all anchors. For additional details to MultiModelTracking have a look at vlUnitySDK_multiModelTutorial.

The following commands can be executed, if a tracking configuration with a MultiModelTracker pipeline is loaded:

CommandName Parameter

Result

addAnchor
{
"name": string
?"models": array
?"workSpaceDefinitionURI": string
?"workSpaceDefinition": object
?"parameters": {}
}
None

The addAnchor command adds a new tracking anchor to the current MultiModelTracker. The AnchorDefinition may contain all elements, which is also given in the tracking configuration for an anchor. The name of the anchor is mandatory. All parameters, which are not specified are derived from the MultiModelTracker.

enableAnchor
{
"anchorName": string
}
None

The enableAnchor command activates the tracking for the anchor with the specified name.

disableAnchor
{
"anchorName": string
}
None

The disableAnchor command deactivates the tracking for the anchor with the specified name.

anchorCommand
{
"anchorName": string,
"content": ModelTrackerCommand
}
CommandResult

The anchorCommand command propagates the given ModelTrackerCommand the anchor with the specified name. The result of this command is the result of the ModelTrackerCommand. For details on possible commands see Model Tracker Command Reference.

setAttributeSeparately
{
"name": string,
"values": AnchorValuePair[]
}
None

The setAttributeSeparately command sets the attribute given by the name parameter to the values given for specific anchors. An AnchorValuePair is of the form

{
"anchor": string,
"value": string
}

getAttributeSeparately
{
"att": string
}
AnchorValuePair[]

The getAttributeSeparately command returns a list of the attribute value for each anchor.

resetHard None None

The resetHard command performs the resetHard command on all anchors. For details see Model Tracker Command Reference.

resetSoft None None

The resetSoft command performs the resetSoft command on all anchors. For details see Model Tracker Command Reference.

setInitPose
ExtrinsicData
None
The setInitPose command sets the init pose in all anchors. For details see Model Tracker Command Reference.

All JsonAndBinary commands of the ModelTracker can also be executed for a specific node. This is done via the anchorCommand:

CommandName Parameter BinaryData

Result

anchorCommand
{
"anchorName": string,
"content": ModelTrackerCommand
}
CommandBinaryData CommandResult
The addModelData command propagates a ModelTracker jsonAndBinary command to the node specified by the anchorName. The binary data has to be the same as required by the jsonAndBinary command. It also returns the same result. See also Model Tracker Command Reference