Add Simulation Command

Table of Contents

• How to Run the Example
  • Usage
  • Classes
  • Plugin Entry Points

The Add Simulation Command example demonstrates the following:

• How to create and register a new simulation command
• How to create a simulation command executor to execute simulation commands

The Add Simulation Command example adds a new simuation command which will receive and implement the new MySimCommand. Since this example is loaded as a plugin, it can be used in conjunction with the released VR-Forces application

How to Run the Example

This example demonstrates how to add a new kind of sim command.

Usage

Select Settings, Plugins... and on the Plugins Editor page, use the combo box at the top of the page to select the plug-in. Then enable the Load Plugin checkbox and re-start VR-Forces.

To view the new behavior:

1. Create a new scenario.
2. Create a M1A2 entity.
3. Right-click on entity and select 'Plan...'.
4. In the 'Plan' dialog, select Commands>My Sim Command Message... to bring up dialog for new command.
5. In 'Simulation Command Message Example' window, type in an arbitrary message. It will get displayed in the entity's console window when the command is executed.
6. Click OK in the 'My Sim Command' window.
7. Click OK in the 'Plan' dialog for the entity.
8. Right-click>Information on the entity to display its information window.
9. Click on the 'play' button.

Note that the text you typed in to the 'My Sim Command' window appears in the back-end console, prefaced by the name of the entity.\

Classes

MySimCommand	The subclass of DtSimCommand that is used to communicate the new simulation command.
MySimCommandExecutor	The subclass of DtSimCommandExecutor implements the MySimCommand command.

---

Plugin Entry Points

/*******************************************************************************
** Copyright (c) 2006 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
/*******************************************************************************
** $RCSfile: plugin.cxx,v $ $Revision: 1.1 $ $State: Exp $
*******************************************************************************/

#include "vrfcgf/vrfPluginExtension.h"
#include "mySimCommand.h"
#include "mySimCommandExecutor.h"
#include "vrfobjcore/simCommandExecutorFactory.h"

#include "vrfcgf/cgf.h"
#include "vrfcgf/factoryMgr.h"
#include "vrfobjcore/compTypes.h"

extern "C" {

   DT_VRF_DLL_PLUGIN void DtPluginInformation(DtVrfPluginInformation& info)
   {
      info.pluginName = "Add Sim Command Sim";
      info.pluginVersion = "1.00";
      info.pluginCreator = "MAK Technologies";
      info.pluginCreatorEmail = "sales@mak.com";
      info.pluginContactWebPage = "www.mak.com";
      info.pluginContactMailingAddress = "150 Cambridge Park Drive 3rd Floor - Cambridge, MA 02140 USA";
      info.pluginContactPhone = "(617) 876 8085";
   }

   DT_VRF_DLL_PLUGIN bool DtInitializeVrfPlugin(DtCgf* cgf)
   {
      //For simulation commands, the executor and the message both need to be registered

      cgf->factoryManager()->simCommandFactory()->addCreatorFcn(
         MySimCommandType, MySimCommand::creator);

      cgf->factoryManager()->simCommandExecutorFactory()->addCreatorFcn(
         MySimCommandType, MySimCommandExecutor::create);
      
      return true;
   }
}