Create Local Object in GUI

Table of Contents

• Usage
• Classes
• Plugin Entry Points

The Create Local Object in GUI example demonstrates the following:

• How to build a plugin module for the VR-Forces Gui
• How to create a menu and menu items
• How to use the DtLocalObjectManager to create and manage objects that are locally created to the GUI
• How to use the DtIntervisibilityDriver to create intervisibility objects
• How to use the DtCreateMenu class to convert a create name to the entity type it is going to create

This example demonstrates how to use the DtLocalObjectManager to create objects in the GUI that are not published on the network. It also demonstrates how to use the DtIntervisibility driver to create intervisiblity objects.

In this example, a new menu item is added to the VRF GUI which will show a list of items that will be used to create local objects. When created a check mark will be put next to the menu item. If the menu item is selected again the check mark will be removed. This example will create items in all views (2D and 3D)

In this example the intervisibility line will be drawn between the M1A2 and the Airbus. This item will not be enabled until both the M1A2 and Airbus are created.

Usage

Since this example is loaded as a plugin Select Settings, Plugins... and on the Plugins Editor page, use the combo box at the top of the page to select the plug-in. Then enable the Load Plugin checkbox for the guiLocalCreateObject example and re-start VR-Forces.

1. Start vrfGui.
2. Choose Object Demo Menu
3. Select an item to create
4. The item selected will be shown on the display.
5. Select the item just created
6. The item selected will be removed from the display.

Classes

DtGuiLocalCreateObjectMenu

The main menu for this example.

---

Plugin Entry Points

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

//\file guiLocalCreateObject.cxx

//This file defines the generic DT_DLL_VRF_PLUGIN_EXPORT_MACRO.  Use that macro when
//you want to export symbols.  Also, in your CMakeLists.txt file, make sure to
//define the VRFPLUGIN_EXPORTS define to tell the compiler to define the macro as an
//export
#include <vrfGuiCore/vrfGuiExportPlugin.h>
#include "guiLocalCreateObjectMenu.h"

#include <vrvCore/DtDe.h>

#include <QtGui/QMenu>
#include <QtGui/QMessageBox>

#include <boost/bind.hpp>
#include <vrfGuiCoreQt/vrfMainMenu.h>

using namespace makVrf;

bool initDeModule(makVrv::DtDe* de)
{
   DtVrfMainMenu::instance(*de).registerMenu(new DtGuiLocalCreateObjectMenu(*de));
   DtVrfMainMenu::instance(*de).registerMenuItem(new DtGuiLocalCreateObjectLine(*de));
   DtVrfMainMenu::instance(*de).registerMenuItem(new DtGuiLocalCreateObjectArea(*de));
   DtVrfMainMenu::instance(*de).registerMenuItem(new DtGuiLocalCreateObjectWaypoint(*de));
   DtVrfMainMenu::instance(*de).registerMenuItem(new DtGuiLocalCreateObjectM1A2(*de));
   DtVrfMainMenu::instance(*de).registerMenuItem(new DtGuiLocalCreateObjectAirbus320(*de));
   DtVrfMainMenu::instance(*de).registerMenuItem(new DtGuiLocalCreateObjectFan(*de));
   DtVrfMainMenu::instance(*de).registerMenuItem(new DtGuiLocalCreateObjectAttachedLine(*de));

   //Now, add the menu to the master mode configuration.  mainMenu indicates that
   //the example menu is going to be used as a top-level main menu rather than a
   //sub-menu.  Add it before the Task menu.  To leave off the path will
   //put the menu at the end of the menu bar
   DtVrfMainMenu::instance(*de).menuConfiguration().addMenuPathBefore(makVrv::DtMenuPath::mainMenu("DtGuiLocalCreateObjectMenu"),
      makVrv::DtMenuPath::mainMenu("DtTaskMenu"));

   //Now, register all the menu items with the menu configuration
   DtVrfMainMenu::instance(*de).menuConfiguration().addMenuPath(
      makVrv::DtMenuPath::mainMenu("DtGuiLocalCreateObjectMenu").item("DtGuiLocalCreateObjectLine"));
   DtVrfMainMenu::instance(*de).menuConfiguration().addMenuPath(
      makVrv::DtMenuPath::mainMenu("DtGuiLocalCreateObjectMenu").item("DtGuiLocalCreateObjectArea"));
   DtVrfMainMenu::instance(*de).menuConfiguration().addMenuPath(
      makVrv::DtMenuPath::mainMenu("DtGuiLocalCreateObjectMenu").item("DtGuiLocalCreateObjectWaypoint"));
   DtVrfMainMenu::instance(*de).menuConfiguration().addMenuPath(
      makVrv::DtMenuPath::mainMenu("DtGuiLocalCreateObjectMenu").item("DtGuiLocalCreateObjectM1A2"));
   DtVrfMainMenu::instance(*de).menuConfiguration().addMenuPath(
      makVrv::DtMenuPath::mainMenu("DtGuiLocalCreateObjectMenu").item("DtGuiLocalCreateObjectAirbus320"));
   DtVrfMainMenu::instance(*de).menuConfiguration().addMenuPath(
      makVrv::DtMenuPath::mainMenu("DtGuiLocalCreateObjectMenu").item("DtGuiLocalCreateObjectFan"));
   DtVrfMainMenu::instance(*de).menuConfiguration().addMenuPath(
      makVrv::DtMenuPath::mainMenu("DtGuiLocalCreateObjectMenu").item("DtGuiLocalCreateObjectAttachedLine"));
   
   return true;
}

void DtPluginInformation(DtVrfPluginInformation& info)
{
   info.pluginName = "Gui Local Create Object";
   info.pluginDescription = "This example shows how to use the DtLocalObjectManager and create objects without publishing them on the network.";
   info.pluginVersion = "1.00";
   info.pluginCreator = "MAK Technologies";
   info.pluginCreatorEmail = "sales@mak.com";
   info.pluginContactWebPage = "www.mak.com";
   info.pluginContactMailingAddress = "150 Cambridge Park Drive 3rd Floor - Cambridge, MA 02140 USA";
   info.pluginContactPhone = "(617) 876 8085";
}