Add Object List Folder

Table of Contents

• Usage
• Plugin Entry Points and Code

The Add ObjectList Folder example demonstrates the following:

• How to build a plugin module for the VR-Forces 3D Gui
• How to add a folder to organize objects to the Simulation Object List
• How to work with lists of entities and environment objects
• How to use boost signals to be notified of certain VR-Forces GUI events

The Add Object List Folder example is a simple example that shows how to add a new folder to the Simulation Object list and then to assign objects to this folder. The example will place Routes into this folder instead of under the Tactical Graphics folder.

It should be noted that you should only put unorganized objects into this folder. If organized objects (such as Tanks or Humans) are placed into this folder you will not be able to change their force by dragging/dropping to a new Force level folder. If you do try and organize Simulation Objects this way do be aware of the limitiations

Usage

Since this example is loaded as a plugin, it will need to be enabled in the Launcher. In the Launcher, click the Plug-ins button to bring up the Plug-ins Selection dialog. Enable the plugin. Then launch VR-Forces.

1. Start vrfGui.
2. Start vrfSim.
3. Create a new scenario.
4. Create a route.

The 'Simulation Object' panel will display the new Routes folder with the newly created route underneath it

---

Plugin Entry Points and Code

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


#include <vrfGuiCore/vrfGuiExportPlugin.h>
#include <vrfGuiCore/vrfSelectionFilters.h>
#include <vrfGuiCoreQt/vrfOrganizedObjectListPanelPage.h>
#include <vrfGuiCoreQt/vrfObjectListViewItem.h>

#include <QtWidgets/QTreeWidget>

#include <boost/bind.hpp>

using namespace makVrf;
using namespace makVrv;

void SetupRouteRootNode(DtVrfOrganizedObjectListPageLogic* logic, DtDe* de)
{
   DtObjectListViewItem* item = logic->addOrganizedRootNode(QObject::tr("Routes"), 
      DtFilename((de->dePathConfiguration().dataPath() + "/images/overlays/small/line.png").c_str()),
      DtVrfSelectionObjectFilter(DtEntityType(17, 0, 0, 2, 0, 0, 0)), 0,
      QObject::tr("Tactical Graphics"));  // Get this before the tactical graphic filter

   // Comment this line to have the item be initially collapsed
   item->setExpanded(true);
}

bool initDeModule(DtDe* de)
{
   return true;
}

void postInitDeModule(DtDe& de)
{
   // Connect signals to set up the root node and to return it when a route is discovered
   DtVrfOrganizedObjectListPageSignaler::instance(de).signal_setupRootNodes.connect(
      boost::bind(&SetupRouteRootNode, _1, &de));
}

void DtPluginInformation(DtVrfPluginInformation& info)
{
   info.pluginName = "Add Object List Folder";
   info.pluginDescription = "This example will show how to add a folder to the object list for organizing routes";
   info.pluginVersion = "1.00";
   info.pluginCreator = "MAK Technologies";
   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";
}