12.9 - Simulation Commands

Table of Contents

• 12.9.1 Simulation Command Execution
• 12.9.2 Adding a New Simulation Command

Simulation commands represent an operation for the simulation to perform, such as creating a new simulation object, or printing a console message.

You can use simulation commands in plans. Simulation commands can also be sent directly to a simulation engine using the DtIfExecuteSimCommand interface content message. All simulation commands are subclassed from DtSimCommand (simCommand.h) and are registered with the DtSimCommandFactory.

Similar to tasks and set data requests, each simulation command includes a type identifier and a set of arguments that are used when executing the command. Some of the simulation commands are executed differently depending on whether they are executed by a global plan or by an individual plan. When simulation commands are sent directly to a simulation engine, they are executed as if they are part of a global plan.

Some of the simulation commands that are part of VR-Forces include:

• DtCreateObjectCommand creates a new simulation object.
• DtConsoleMessageCommand prints a message to the console. If executed by a specific simulation object, it prints to that simulation object's object console.
• DtDeleteObjectCommand deletes a simulation object.
• DtAbandonPlanCommand causes a simulation object to abandon the execution of its plan.
• DtChangeHostilityCommand changes an entry in the hostility matrix.

12.9.1 Simulation Command Execution

Each DtSimCommand subclass has a corresponding subclass of DtSimCommandExecutor that carries out the execution of that specific command type. This separates the representation of the command and the logic that executes the command. The command executor is responsible for processing the command and the arguments provided and making the appropriate calls into the VR-Forces API to execute the command. Command executes are registered with the DtSimCommandExecutorFactory and must be registered using the same type identifier that was used for the corresponding DtSimCommand subclass.

12.9.2 Adding a New Simulation Command

You can add new simulation commands through the VR-Forces API. The addSimCommand (GUI) and addSimCommand (Sim) examples shows how to add a new simulation command to the front-end and back-end.

[<< Creating a New DtSetDataRequest] [Home] [Top of Page] [Reports >>]