exampleExtendVisualizerPage

Table of Contents

• Overview
• Expected Result
• Example details
• Building the Example
• Running the Example
• Example Source Files
• exampleExtendVisualizerPlugin.cxx
• exampleExtendVisualizerPlugin.h
• MyEntityArticulatedStateModelVisualizer.h
• MyEntityArticulatedStateModelVisualizer.cxx

Overview

This example show how to extend the state model visualizer and turn all the entities in XR mode to red.

Expected Result

Extend Visualizer Result

Example details

In this example we derived from the class DtEntityArticulatedStateModelVisualizer to create a new class MyEntityArticulatedStateModelVisualizer. The only thing this class does in the constructor is to force the entity's id for colorization. This will just to prove it is overriding the original visualizer. To see the effect switch to XR mode to see all the entities in red.

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/exampleExtendVisualizer_stealth.bat (on Windows) or ./bin64/exampleExtendVisualizer_stealth.sh (on Linux). Load MakLand terrain, once Vantage is started, connect with the selected <protocol>. Swicth the observer to "XR" and all the entities will be red. For more information about running examples, please see Running Applications and Examples.

Example Source Files

• exampleExtendVisualizerPlugin.cxx
• exampleExtendVisualizerPlugin.h
• MyEntityArticulatedStateModelVisualizer.h
• MyEntityArticulatedStateModelVisualizerinl
• protocolSpecificNamespaceh

---

exampleExtendVisualizerPlugin.cxx

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


#include "exampleExtendVisualizerPlugin.h"

#include <vrvCore/DtDe.h>
#include <vrvCore/DtStateVisualizerFactory.h>
#include <iostream>

#include "MyEntityArticulatedStateModelVisualizer.h"

using namespace makVrv;

namespace exampleExtendVisualizer
{
   void postInitializeWork(DtDe* de)
   {
      // We're done with the signal, so disconnect from it
      de->signal_postInitialize.disconnect(boost::bind(&postInitializeWork, de));

      // Added this to override the DtVrlinkEntityArticulatedStateModelVisualizer
      DtStateVisualizerFactory::instance(*de).addStateVisualizerCreator(*de,
         new MyEntityArticulatedStateModelVisualizerCreator);
   }

   void init(DtDe& de)
   {
      // Ensure that init only gets called once
      // (not strictly necessary here, but this is good practice in general)
      DT_DE_INIT_ONCE(de);

      if (de.isInMasterMode())
      {
         // The custom state visualizer must be registered after the DE's initialization 
         // is finished, to make sure the default state visualizers have been registered.
         de.signal_postInitialize.connect(boost::bind(&postInitializeWork, &de));
      }
   }
}

bool initDeModule(makVrv::DtDe* de)
{
   // Setup the plug-in. Normally, the init function and functionality
   // should be in its own library.
   exampleExtendVisualizer::init(*de);
   return true;
}

exampleExtendVisualizerPlugin.h

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


#pragma once

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

// Setup proper plugin export symbol
#define DT_DE_PLUGIN_EXPORT_MACRO DT_DLL_EXAMPLEEXTENDVISUALIZER

// Declare & export the plugin initialization function (bool initDeModule(DtDe* de))
#include <vrvCore/exportPlugin.h>

namespace makVrv { class DtDe; }

MyEntityArticulatedStateModelVisualizer.h

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


#pragma once
#include "exampleExtendVisualizerPlugin.h"
#include <vrvCore/DtSharedEntityDisplaySettings.h>
#include <vrvCore/DtEntityStateListener.h>
#include <vrvCore/DtEntityArticulatedStateModelVisualizer.h>

namespace makVrv
{
   class DT_DLL_EXAMPLEEXTENDVISUALIZER MyEntityArticulatedStateModelVisualizer : 
      public DtEntityArticulatedStateModelVisualizer
   {
   public:
      MyEntityArticulatedStateModelVisualizer(DtBaseConnection& simulation, 
         DtStateListener& listener, int modelSet);

      virtual ~MyEntityArticulatedStateModelVisualizer();
   protected:

   };

   typedef DtStateVisualizerCreatorTemplate<MyEntityArticulatedStateModelVisualizer> 
      MyEntityArticulatedStateModelVisualizerCreator;
}

MyEntityArticulatedStateModelVisualizer.cxx

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


#include "MyEntityArticulatedStateModelVisualizer.h"
#include <vrvVrl/DtEntityAppearanceMapper.h>

namespace makVrv
{
   MyEntityArticulatedStateModelVisualizer::MyEntityArticulatedStateModelVisualizer(
      DtBaseConnection& simulation, DtStateListener& listener, int modelSet)
   : DtEntityArticulatedStateModelVisualizer(simulation, listener, modelSet)
   {
      std::cout << "MyEntityArticulatedStateModelVisualizer created" << std::endl;
      DtEntityArticulatedStateModelVisualizer::setColorizedColor( 1.0, 0.0, 0.0, 1.0 );
   }

   MyEntityArticulatedStateModelVisualizer::~MyEntityArticulatedStateModelVisualizer()
   {
   }
   
}

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