Object Manager Extension (objectManager)

Table of Contents

• Object Manager Subclassing
• How to Run the Example
  • Usage
• Classes
• Plugin Entry Points

The Object Manager Extension example demonstrates the following:

• How to install a new object manager

Object Manager Subclassing

This example shows how to subclass and install your own version of the DtVrfObjectManager to extend its functionality.

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 install your own derived object manager.

Usage

In the Launcher, click the Plug-ins button to bring up the Plug-ins Selection dialog. Enable the plugin.

To view the new behavior:

1. Start VR-Forces GUI and SIM.
2. There is no need to create a new or load an existing scenario.
3. The vrfSim console will immediately begin repeatedly displaying 'MyObjectManager::tick()'. This confirms that the derived object manager is in use.

Classes

MyObjectManager

This subclass of DtVrfObjectManager prints out a message every time it is ticked.

Plugin Entry Points

/*******************************************************************************
** Copyright (c) 2003 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/

#include "vrfcgf/vrfPluginExtension.h"
#include "vrfcgf/defaultVrfCreator.h"
#include "myObjectManager.h"
#include "vrfcgf/vrfCreator.h"

#include "vrfcgf/cgf.h"

extern "C" {

   DT_VRF_DLL_PLUGIN void DtPluginInformation(DtVrfPluginInformation& info)
   {
      info.pluginName = "objectManager";
      info.pluginVersion = "1.00";
      info.pluginCreator = "MAK Technologies";
      info.pluginCreatorEmail = "sales@mak.com";
      info.pluginContactWebPage = "www.mak.com";
      info.pluginContactMailingAddress = "10 Fawcett Street, Suite 204, Cambridge, MA 02138 USA";
      info.pluginContactPhone = "(617) 876 8085";
   }

   DT_VRF_DLL_PLUGIN bool DtInitializeVrfPlugin(DtCgf* cgf)
   {
      cgf->vrfCreator()->setLocalObjectManagerCreatorFcn(MyObjectManager::creator);
      
      return true;
   }
}

/*******************************************************************************
** Copyright (c) 2021 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/

#include "myObjectManager.h"
#include <vrfutil/profiler.h>

//It is important to pass the DtSimulationServices to the constructor of the base class
MyObjectManager::MyObjectManager(DtSimulationServices* simManager) :
   DtLocalObjectManager(simManager)
{
}

MyObjectManager::~MyObjectManager()
{
}

void MyObjectManager::tick()
{
   DtPROFILE("MyObjectManager::tick");
   //This is a good place to add your own functionality. For instance, if you
   //were making an after action review tool, this might be a good place to
   //connect to a database to store simulation information.

   DtInfo("MyObjectManager::tick()\n");


   //In order for VR-Forces to function, it is vital to call down to the base
   //class !
   DtLocalObjectManager::tick();
}


//The creator simply calls new. It is important to pass on the DtSimulationServices.
DtLocalObjectManager* MyObjectManager::creator(DtSimulationServices* simManager)
{
   return new MyObjectManager(simManager);
}