Example Plugin for the DIS Broker

An example DIS Broker plugin that overrides some of the existing DIS object and interaction translators.

Plugins are loaded from their respective brokers' plugin directories. Default plugin directories for each broker are a subfolder in the 'plugins' directory that shares the name of the broker (For example, the DIS Broker's plugin directory is 'plugins/disBroker'. The plugin directory is a broker setting, and can be configured on a broker-by-broker basis.

When a broker is run, it checks the plugin directory for shared libraries and if they are valid plugins, loads them and calls their initialization method.

The example plugin library installs and builds into your install's runtime library folder (bin on windows, lib on linux), and must be manually copied into the plugins/disBroker directory if you want to test it with the DIS Broker.

---

/****************************************************************************
 * Copyright (c) 2013 VT MAK
 * All rights reserved.
 ****************************************************************************/


#pragma once

// Get proper local export symbol
#ifdef _WIN32
#  ifdef DT_DLL_BROKERPLUGIN
#    undef DT_DLL_BROKERPLUGIN
#    define DT_DLL_BROKERPLUGIN __declspec ( dllexport )
#  else
#    define DT_DLL_BROKERPLUGIN __declspec ( dllimport )
#  endif
#else
#  define DT_DLL_BROKERPLUGIN
#endif

---

/****************************************************************************
 * Copyright (c) 2013 VT MAK
 * All rights reserved.
 ****************************************************************************/


#include <dllExport.h>

// Set plugin export macro and declare and export the plugin init method.
#define DT_VRX_PLUGIN_EXPORT_MACRO DT_DLL_BROKERPLUGIN
#include <broker/exportBrokerPlugin.h>

#include <libDisBroker/disBroker.h>
#include <libDisBroker/resupplyOfferTrans.h>
#include <libDisBroker/resupplyCancelTrans.h>
#include <libDisBroker/resupplyReceivedTrans.h>
#include <libDisBroker/emitterSystemTrans.h>
#include <libDisBroker/dataInTrans.h>
#include <libDisBroker/iffTrans.h>

#include <modDataInterTrans.h>
#include <modEntityTrans.h>

using namespace MAKVrExchange::DtDisBroker;

bool pluginInitBroker( MAKVrExchange::DtBroker* broker )
{
   DtDisBroker* disBroker = dynamic_cast<DtDisBroker*>( broker );
   if ( ! disBroker )
   {
      DtWarn << "Broker is not a DtDisBroker! Aborting plugin init." << std::endl;
      return false;
   }

   // Get pointers to the broker's object and interaction translator factories.
   DtObjectTranslatorFactory* objTransFactory =
      disBroker->objectTranslatorFactory();
   DtInteractionTranslatorFactory* interTransFactory =
      disBroker->interactionTranslatorFactory();

   // Remove some translators we're not interested in.
   // New translators can also be added in this manner, by
   // calling addCreator instead of removeCreator (see below).
   objTransFactory->removeCreator<DtIffObjectTranslator>();
   objTransFactory->removeCreator<DtEmitterSystemObjectTranslator>();
   interTransFactory->removeCreator<DtResupplyOfferInteractionTranslator>();
   interTransFactory->removeCreator<DtResupplyCancelInteractionTranslator>();
   interTransFactory->removeCreator<DtResupplyReceivedInteractionTranslator>();

   // Replace the entity translator with our customized version.
   objTransFactory->removeCreator<DtEntityTranslator>();
   objTransFactory->addCreator<ModEntityTranslator>();

   // Replace the data interaction translator with our customized version.
   interTransFactory->removeCreator<DtDataInteractionTranslator>();
   interTransFactory->addCreator<ModDataInterTranslator>();

   return true;
}

---

/*****************************************************************************
 * Copyright (c) 2013 VT MAK
 * All rights reserved.
 ****************************************************************************/


#pragma once

#include <dllExport.h>
#include <portal/pEntity.h>
#include <libDisBroker/entityTrans.h>

namespace MAKVrExchange
{
   namespace DtDisBroker
   {
      class DtDisBroker;
   }
}

class DT_DLL_BROKERPLUGIN ModEntityTranslator
   : public MAKVrExchange::DtDisBroker::DtEntityTranslator
{
public:

   ModEntityTranslator( MAKVrExchange::DtDisBroker::DtDisBroker* broker );

   virtual ~ModEntityTranslator();

   virtual DtEntityStateRepository* translate( DtEntityStateRepository* dest,
      const MAKVrExchange::DtPortalEntity& src );

   virtual MAKVrExchange::DtPortalEntity* translate(
      MAKVrExchange::DtPortalEntity* destination,
      const DtEntityStateRepository& source );

private:

   // Copy Constructor not implemented -- do not copy!
   ModEntityTranslator( const ModEntityTranslator& other );

   // Assignment Operator not implemented -- do not copy!
   ModEntityTranslator& operator = ( const ModEntityTranslator& other );

};

---

/*****************************************************************************
 * Copyright (c) 2013 VT MAK
 * All rights reserved.
 ****************************************************************************/


#include <modEntityTrans.h>

#include <vlpi/disEnums.h>
#include <vl/entitySR.h>

using namespace MAKVrExchange;

// Default pass-through constructor.
ModEntityTranslator::ModEntityTranslator(
      MAKVrExchange::DtDisBroker::DtDisBroker* broker )
   : DtEntityTranslator( broker )
{
}

// Default destructor.
ModEntityTranslator::~ModEntityTranslator()
{
}

// In order to modify how the state is translated and/or set additional
// values, the translate method can be overridden. This version modifies
// how Portal entities are translated to DIS entities.
DtEntityStateRepository* ModEntityTranslator::translate(
   DtEntityStateRepository* dest, const DtPortalEntity& src )
{
   // Call the base class method first. This way all the translation is done
   // and you can selectively go back and modify a few parameters. This is
   // not required of course, but it can be useful.
   DtEntityTranslator::translate( dest, src );

   // We want this translator to always use static dead reckoning.
   dest->setAlgorithm( DtDrStatic );

   // Override the antenna so it's always up.
   dest->setAntennaRaised( true );

   // Return the translated state rep.
   return dest;
}

// In order to modify how the state is translated and/or set additional
// values, the translate method can be overridden. This version modifies
// how DIS entities are translated to Portal entities.
DtPortalEntity* ModEntityTranslator::translate( DtPortalEntity* dest,
   const DtEntityStateRepository& src )
{
   // Call the base class method first. This way all the translation is done
   // and you can selectively go back and modify a few parameters. This is
   // not required of course, but it can be useful.
   DtEntityTranslator::translate( dest, src );

   // Only for entities incoming from DIS, set the guise to something specific.
   dest->setGuise( "DIS Force Guise" );

   // We want this translator to always use static dead reckoning.
   dest->setAlgorithm( DtDrStatic );

   // Override the antenna so it's always up.
   dest->setAntennaRaised( true );

   // Return the translated state rep.
   return dest;
}

---

/****************************************************************************
 * Copyright (c) 2013 VT MAK
 * All rights reserved.
 ****************************************************************************/


#pragma once

#include <dllExport.h>
#include <portal/pDataInter.h>
#include <libDisBroker/dataInTrans.h>

namespace MAKVrExchange
{
   namespace DtDisBroker
   {
      class DtDisBroker;
   }
}

class DT_DLL_BROKERPLUGIN ModDataInterTranslator
   : public MAKVrExchange::DtDisBroker::DtDataInteractionTranslator
{
public:

   ModDataInterTranslator( MAKVrExchange::DtDisBroker::DtDisBroker* broker );

   virtual ~ModDataInterTranslator();

   virtual MAKVrExchange::DtPortalDataInteraction* translate(
      MAKVrExchange::DtPortalDataInteraction* destination,
      const DtDataInteraction& source );

private:

   // Copy Constructor not implemented -- do not copy!
   ModDataInterTranslator( const ModDataInterTranslator& other );

   // Assignment Operator not implemented -- do not copy!
   ModDataInterTranslator& operator = ( const ModDataInterTranslator& other );

};

---

/****************************************************************************
 * Copyright (c) 2013 VT MAK
 * All rights reserved.
 ****************************************************************************/


#include <modDataInterTrans.h>

#include <libDisBroker/disBroker.h>

#include <vl/exerciseConn.h>
#include <vlutil/vlTime.h>

using namespace MAKVrExchange;

// Default pass-through constructor.
ModDataInterTranslator::ModDataInterTranslator(
      MAKVrExchange::DtDisBroker::DtDisBroker* disBroker )
   : DtDataInteractionTranslator( disBroker )
{
}

// Default destructor.
ModDataInterTranslator::~ModDataInterTranslator()
{
}

// In order to modify how the state is translated and/or set additional
// values, the translate method can be overridden. This version modifies
// how DIS data interactions are translated to Portal data interactions.
DtPortalDataInteraction* ModDataInterTranslator::translate(
   DtPortalDataInteraction* destination, const DtDataInteraction& source )
{
   // Call the base class method first. This way all the translation is done
   // and you can selectively go back and modify a few parameters. This is
   // not required of course, but it can be useful.
   DtDataInteractionTranslator::translate( destination, source );

   // Set the message's received time to be the translation time (absolute).
   destination->setTimeReceived( myDisBroker->connection()->clock()->absRealTime() );

   // Return the translated interaction.
   return destination;
}