exampleDisConnection

Table of Contents

• Overview
• Expected Result
• Example details
• Building the Example
• Running the Example
• Example Source Files
• exampleDisConnectionInit.cxx
• exampleDisConnectionInit.h
• exampleDisConnection.h

Overview

This example shows how to create a very simple plug-in that creates a DIS driver and automatically connects to a DIS exercise.

Expected Result

DIS Connection Result

Example details

It shows how to create a new Dis Driver object, add it to the driver manager and set it up to start automatically.

Building the Example

VR-Vantage includes pre-built versions of the example plug-in. To build it yourself, follow the instructions at Building VR-Vantage Examples, Applications, and Plug-ins.

Running the Example

This example is a plug-in. You can run it by running ./bin64/exampleDisConnection_stealth.bat (on Windows) or ./bin64/exampleDisConnection_stealth.sh (on Linux). Menu "Settings->Connections...", you will see the "MyDisDriver" connection that was added. For more information about running examples, please see Running Applications and Examples.

Example Source Files

• exampleDisConnectionInit.cxx
• exampleDisConnectionInit.h
• exampleDisConnection.h

---

exampleDisConnectionInit.cxx

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


#include "exampleDisConnection.h"
#include "exampleDisConnectionInit.h"

#include <vrvCore/DtDe.h>
#include <vrvCore/DtDriverFactory.h>
#include <vrvCore/DtDriverManager.h>
#include <vrvDis/vrvDis.h>
#include <vrvDis/DtDisDriver.h>

#include <vrvUtil/signalslib.h>

#include <functional>

bool initDeModule(makVrv::DtDe* de)
{
   makVrv::vrvExampleDisConnection::init(*de);
   return true;
}

namespace makVrv
{
   namespace vrvExampleDisConnection
   {
      static vrvSignalsLib::connection postInitializeConnection;

      //name for example driver that this example creates
      static const std::string exampleDriverName = "myDisDriver";

      //Create the example dis driver
      void createDriver(DtDe* de)
      {

         // We're done with the signal, so disconnect from it
         postInitializeConnection.disconnect();

         //Step 1: Create the DIS driver.
         DtDisDriver* disDriver = dynamic_cast<DtDisDriver*>(
            DtDriverFactory::instance(*de).
            createDriver(std::string("DtDisDriver"), exampleDriverName));

         // Step 2: Create the DIS Connection initializer and add it to the DIS driver.
         DtDisExerciseConnInitializer exConnInitializer;
         exConnInitializer.setExerciseId(1);
         exConnInitializer.setMulticastTtl(-1);
         exConnInitializer.setPort(3000);
         exConnInitializer.setReceiveBufferSize(1048576);
         exConnInitializer.setSendBufferSize(-1);
         exConnInitializer.setSiteId(2);
         exConnInitializer.setUseAsynchIO(true);

         disDriver->setExerciseSettings(exConnInitializer);

         // Step 3: Add the DIS driver to the display engine.
         // The driver is now owned by the display engine. Do not delete it.
         de->driverManager().addDriver(disDriver);
      }




      void init(DtDe& de)
      {
         DT_DE_INIT_ONCE(de);

         try
         {
            //connect to the post initialize signal so the driver is created at 
            // the proper time
            postInitializeConnection = de.signal_postInitialize.connect(std::bind(
               &createDriver, &de));

            //Add the example drivers name to the list of drivers to start when 
            // the De starts all the drivers. 
            DtDeInitializer initializer = de.deInitializer();
            std::vector< std::string > autoStartList = initializer.autoStartDrivers();

            //this name needs to match the name used in createDriver() above
            // when the driver is created
            autoStartList.push_back(exampleDriverName);
            initializer.setAutoStartDrivers(autoStartList);
            de.setDeInitializer(initializer);

         }
         DtCATCH_AND_PROPAGATE(DtCorruptedState)
      }
   }

}

exampleDisConnectionInit.h

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

#pragma once

// Get proper local export symbol
#include "exampleDisConnection.h"

// Setup proper plugin export symbol
#define DT_DE_PLUGIN_EXPORT_MACRO DT_DLL_EXAMPLEDISCONNECTION

// Export plugging function bool initDeModule(DtDe* de);
#include <vrvCore/exportPlugin.h>

namespace makVrv
{
   class DtDe;
   namespace vrvExampleDisConnection
   {
      DT_DLL_EXAMPLEDISCONNECTION void init(DtDe& anIG);
   }
}

exampleDisConnection.h

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


#ifndef exampleDisConnection_H_
#define exampleDisConnection_H_

#ifdef _WIN32
#ifdef EXAMPLEDISCONNECTION_EXPORTS
#define DT_DLL_EXAMPLEDISCONNECTION __declspec ( dllexport )
#else
#define DT_DLL_EXAMPLEDISCONNECTION __declspec ( dllimport )
#endif
#else
#define DT_DLL_EXAMPLEDISCONNECTION
#endif


#endif

[<< Examples] [Home] [Top of Page]