Settings Manager Extension (settingsManagerSim)

Table of Contents

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

The Settings Manager Extension example demonstrates the following:

• How to install a new settings manager to maintain a new file
• How to add settings to the existing file (vrfSim.xml)

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 settings manager.

Usage

To view the new behavior:

1. Open a command prompt window, navigate to the VR-Forces /bin64/ directory and start just the VR-Forces vrfSIM (backend) through the Launcher - using "vrfLauncher -B".
2. In the Launcher, set the settingsManager plugin to load and start VR Forces using the preconfigured DIS (7) connection (rather than "DIS (7) localhost").
3. Open a separate command prompt window, navigate to the VR-Forces /bin64/ directory and start settingsManagerRemoteDIS.exe from the command prompt.
4. After starting, the settingsManagerRemote executable will connect to the sim engine and demonstrate remotely changing and querying some test settings added by the plugin.

5. The vrfSim console window should display text similar to the following:

   Double value set to 17184
   Bool value set to 1

6. The settingsManagerRemote console window should display text similar to the following:

   Calling modifyBackEndSetting setting with double = 17184 bool = 1
   Response received from back-end 1:3001 : double = 17184 bool = 1
   Settings received;

Plugin Entry Points

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

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

#include "vrfcgf/cgf.h"
#include "vrfcore/vrfSimSettingsManager.h"
#include "vrfcgf/factoryManager.h"

extern "C" {

   DT_VRF_DLL_PLUGIN void DtPluginInformation(DtVrfPluginInformation& info)
   {
      info.pluginName = "settingsManagerSim";
      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->factoryManager()->settingsObjectFactory()->addCreatorFcn(
         "test-settings", DtTestSettings::create);
      cgf->vrfCreator()->setLocalObjectManagerCreatorFcn(
         MyObjectManager::creator);
      
      return true;
   }
}