Encumbered Flight (addSetEncumbranceSim)

Table of Contents

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

The Add Set Encumbrance example creates a new "Set" command that allows a user to set an encumbrance value to DtManualRotaryWingEncumberedFlightActuator.

This is the sim engine plugin which receives the request and changes the weight of the aircraft. The message is sent by the addSetEncumbranceGui example. This is very similar to the addSetSim example. See this example for a detailed explanation of adding a set message to the sim.

How to Run the Example

Usage

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

To view the behavior:

1. Start VR-Forces GUI and SIM.
2. Create a new scenario - e.g. EntityLevel SMS on Ground_DB II terrain.
3. Create two CH-47 Chinook rotary wing aircraft nearby each other.
4. Right click on the first Chinook and select Set → Position → Encumbrance...
5. Set the Encumberance in the pop-up box to 10000 kg and click the OK button.
6. Create plans for both Chinooks and task them to fly to altitude of 5000 m.
7. Switch the observer view to Out-the-Window
8. Orient the view so that it is a perspective with both helicopters visible.
9. Run the scenario
10. Observe that the encumbered helicopter rises in altitude more slowly than the unencumbered helicopter.

Classes

DtManualRotaryWingEncumberedFlightActuator	Actuator that accepts the set message and changes the weight of the aircraft.
DtSetEncumbranceRequest	The subclass of DtSetDataRequest that is used to communicate the new set request between the front-end and the back-end.

Plugin Entry Points

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

#include <vrfcgf/vrfPluginExtension.h>
#include "setEncumbranceRequest.h"
#include "manualRotaryWingEncumberedFlightActuator.h"

#include <vrfcgf/cgf.h>
#include <vrfcgf/factoryManager.h>
#include <vrfobjcore/simComponentTypes.h>

using namespace vrfAddSetEncumbranceExample;

extern "C" {

   DT_VRF_DLL_PLUGIN void DtPluginInformation(DtVrfPluginInformation& info)
   {
      info.pluginName = "Add Set Encumbrance";
      info.pluginDescription = "Back-end plugin to process new Set Encumbrance command";
      info.pluginVersion = "1.00";
      info.pluginCreator = "VT MAK";
      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()->componentFactory()->addCreatorFcn(
         DtRotaryWingEncumberedFlightActuatorType, DtManualRotaryWingEncumberedFlightActuator::creator);  

      cgf->factoryManager()->setDataRequestFactory()->addCreatorFcn(
         DtSetEncumbranceType,
         DtSetEncumbranceRequest::creator);
      
      return true;
   }
}