Overview

Shows how to add a new view control to the VR-Vantage Control Toolkit.

Expected Result

We use exampleSendControl to demonstrate the view control message created in this example. Using exampleSendControl, you can observe the following behavior:

Before you enter 'L'

After you enter 'L'

Note: An F/A-18 Hornet was added manually to better illustrate the change in lighting.

Example details

The VR-Vantage Control Toolkit lets you send DIS or HLA messages that can remotely control a VR-Vantage application. It has messages for most VR-Vantage display settings. This example shows how to add new control messages by adding a viewLightScale view control message.

VR-Vantage does not send view controls so in order to test the receipt of this new view control a new application will need to be created to send them. We show how to send view controls in exampleSendControl but also use this example to demonstrate the view control message created in this example.

Please review the comments in the files for details.

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/exampleViewControl_stealth.bat (on Windows from cmd.exe) or ./bin64/exampleViewControl_stealth.sh (on Linux). For more information about running examples, please see Running Applications and Examples.

Example Source Files

MyLightScaleCommand.cxx

/*******************************************************************************
** Copyright (c) 2019 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
#include "MyLightScaleCommand.h"
#include <vrvCore/DtDe.h>
#include <vrvCore/DtDeSharedState.h>
using namespace makVrv;
namespace MyViewControl
{
   MyLightScaleCommand::MyLightScaleCommand()
      : DtVrvCommand()
      , myDiffuseLightScale(0)
      , myAmbientLightScale(0)
      , myDiffuseLightScaleSet(false)
      , myAmbientLightScaleSet(false)
   {
      myCommandType = (vrvControlToolkit::DtVrvControlTypeEnum) 
        MyControlToolkit::Control_LightScale;
   }
   MyLightScaleCommand::~MyLightScaleCommand()
   {
   }
      
   bool MyLightScaleCommand::diffuseLightScaleSet() const
   {
      return myDiffuseLightScaleSet;
   }
   int MyLightScaleCommand::diffuseLightScale() const
   {
      return myDiffuseLightScale;
   }
   void MyLightScaleCommand::setDiffuseLightScale( int scale )
   {
      myDiffuseLightScale = scale;
      myDiffuseLightScaleSet = true;
   }
   bool MyLightScaleCommand::ambientLightScaleSet() const
   {
      return myAmbientLightScaleSet;
   }
   int MyLightScaleCommand::ambientLightScale() const
   {
      return myAmbientLightScale;
   }
   void MyLightScaleCommand::setAmbientLightScale( int scale )
   {
      myAmbientLightScale = scale;
      myAmbientLightScaleSet = true;
   }
  
   void MyLightScaleCommand::execute(DtDe& de)
   {
      if ( diffuseLightScaleSet() )
      {
          de.sharedState().setLightingDiffuseScale(diffuseLightScale());
      }      
      if ( ambientLightScaleSet() )
      {
         de.sharedState().setLightingAmbientScale(ambientLightScale());
      }
   }
   MyLightScaleCommandCreator::MyLightScaleCommandCreator(GlobalIdConvertFunc func)
      : DtVrvCommandCreator(func)
   {
   }
   MyLightScaleCommandCreator::~MyLightScaleCommandCreator() 
   {
   }
   DtVrvCommand* MyLightScaleCommandCreator::create( 
      vrvControlToolkit::DtVrvControl_v1* control )
   {
      MyLightScaleCommand* retCmd = 0;
      if ( control->myVersion == 1 )
      {
         if( control->mySize == sizeof( MyControlToolkit::MyLightScale_v1 ) )
         {
            retCmd = new MyLightScaleCommand();
            MyControlToolkit::MyLightScale_v1* lightScaleControl = 
               (MyControlToolkit::MyLightScale_v1*) control;
            if ( lightScaleControl->myValuesSetFlags & 
               MyControlToolkit::MyLightScale_v1::DiffuseLightScaleSet )
            {
               retCmd->setDiffuseLightScale( lightScaleControl->myDiffuseLightScale );
            }
            if ( lightScaleControl->myValuesSetFlags & 
               MyControlToolkit::MyLightScale_v1::AmbientLightScaleSet )
            {
               retCmd->setAmbientLightScale( lightScaleControl->myAmbientLightScale);
            }
         }
      }
      return retCmd;
   }
}

MyLightScaleCommand.h

/*******************************************************************************
** Copyright (c) 2019 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
#pragma once
#include "exampleViewControlPlugin.h"
#include <vrvCore/DtVrvCommand.h>
#include "MyViewControlDataTypes.h"
using namespace makVrv;
namespace MyViewControl
{
   class DT_DLL_EXAMPLEVIEWCONTROL MyLightScaleCommand : public DtVrvCommand
   {
   public: 
      MyLightScaleCommand();
      virtual ~MyLightScaleCommand();
      
      virtual bool diffuseLightScaleSet() const;
      virtual int diffuseLightScale() const;
      // effect of setting diffuseLightScaleSet() to true     
      virtual void setDiffuseLightScale( int scale );
      virtual bool ambientLightScaleSet() const;
      virtual int ambientLightScale() const;
      // effect of setting ambientLightScaleSet() to true
      virtual void setAmbientLightScale( int scale );
      virtual void execute(DtDe& de);
   protected:
      int myDiffuseLightScale;
      int myAmbientLightScale;
 
      bool myDiffuseLightScaleSet;
 
      bool myAmbientLightScaleSet;
   };
   class DT_DLL_EXAMPLEVIEWCONTROL MyLightScaleCommandCreator 
      : public DtVrvCommandCreator
   {
   public:
      MyLightScaleCommandCreator(GlobalIdConvertFunc func);
      virtual ~MyLightScaleCommandCreator();
      virtual DtVrvCommand* create(vrvControlToolkit::DtVrvControl_v1* control);
   };
}

MyViewControlDataTypes.h

/*******************************************************************************
** Copyright (c) 2019 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
#pragma once
#include <vrvControl/vrvControlToolkitDataTypes.h>
namespace MyControlToolkit
{
   // Declare the enumerants to use for you custom view control messages.  This
   // could be added directly to vrvControlToolkitDataTypes.h, but then you 
   // would need to re-merge with each new release.  It makes more sense to 
   // manage your own packets this way.
   enum MyVrvControlTypeEnum 
   {
      Control_LightScale = vrvControlToolkit::Control_UserStart
   };
   // Declare the packet(s) that will contain your view control message(s). 
   // This message will set a scale factor for the diffuse and/or ambient light
   // values in the scene
   struct MyLightScale_v1  : public vrvControlToolkit::DtVrvControl_v1
   {
      inline MyLightScale_v1();
      inline ~MyLightScale_v1();
     // Similar to VR-Link net types, the The vrvControlToolkit types will
     // manage byte-swapping if needed.
      vrvControlToolkit::DtUInt32 myDiffuseLightScale; // (0 - ??)
      vrvControlToolkit::DtUInt32 myAmbientLightScale; // (0 - ??)
     // This enumeration describes bit values set in the myValuesSetFlags
     // member to indicate which of the messages members should be processed
      enum LightScaleSettingsUsed
      {
         DiffuseLightScaleSet = 1,
         AmbientLightScaleSet = 2,
      };
     // Bit-encoded integer that indicates which values are set
      vrvControlToolkit::DtUInt8 myValuesSetFlags;
   };
}
#include "MyViewControlDataTypes.inl"

MyViewControlDataTypes.inl

/*******************************************************************************
** Copyright (c) 2019 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
#pragma once
#include "MyViewControlDataTypes.h"
namespace MyControlToolkit
{
   //----------------------Light Scale Command ----------------------
   MyLightScale_v1::MyLightScale_v1()
      : vrvControlToolkit::DtVrvControl_v1()
   {
      // Base struct setup
      myType = (vrvControlToolkit::DtVrvControlTypeEnum)Control_LightScale;
      myVersion = 1;
      mySize = sizeof(MyLightScale_v1);
      // Initial Values
      myDiffuseLightScale = 0;
      myAmbientLightScale = 0;
      myValuesSetFlags = 0;
   }
   MyLightScale_v1::~MyLightScale_v1()
   {
   }
}

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

Table of Contents