Modify Task (modifyTask)

Table of Contents

• Modifying Task Dialog
• How to Run the Example
  • Usage
• Plugin Entry Points

The Modify Task example demonstrates the following:

• How to build a plugin module for the VR-Forces Gui
• How to override existing task dialog functionality and replace with your own
• How to register a task dialog to override an existing task dialog

Modifying Task Dialog

This example adds a new label to the dialog called "Modified By Example" to the Move To Waypoint... task in order to show how an existing dialog can be modified.

How to Run the Example

Usage

In the Launcher, click the Plug-ins button to bring up the Plug-ins Selection dialog. Enable the plugin.

To view the new behavior:

1. Start VR-Forces GUI and SIM.
2. Create a new scenario - e.g. Entitylevel SMS on Ground_DB II terrain.
3. Create a ground entity (e.g. M1A2 Abrams MBT) , and a Waypoint.
4. Right click on the entity and select from the context menu the Task -> Movement -> Move to Waypoint... task.
5. In the displayed Move To Waypoint... dialog, notice the "Modified By Example" label at the bottom, which was added by the example plugin.

Plugin Entry Points

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

//\file modifyTaskPlugin.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 <vrfGuiTaskSetQt/vrfTaskSetDialogManager.h>
#include <vrfGuiTaskSetQt/taskMoveToDialog.h>
#include <vrfGuiCore/menuItems.h>

#include <vrvCore/DtDe.h>
#include <QtWidgets/QGroupBox>
#include <QtWidgets/QLabel>
#include <QtWidgets/QLayout>

//Override of task move to dialog.  Will show how to add a new UI element to the existing dialog
class MyTaskMoveToDialog : public makVrf::DtTaskMoveToDialog
{
public:
   MyTaskMoveToDialog(makVrv::DtDe& de, QWidget* parent, const Qt::WindowFlags& flags = 0)
   : makVrf::DtTaskMoveToDialog(de, parent, flags)
   {
   }

protected:
   //Override the contents method, calling the parent method first to create the contents, then
   //hide the movement box
   virtual QWidget* contents(const std::vector<makVrv::DtSimEntry*>& data)
   {
      QWidget* canvas = makVrf::DtTaskMoveToDialog::contents(data);

      QLabel* label = new QLabel(tr("Modified By Example"), canvas);
      ((QVBoxLayout*)canvas->layout())->insertWidget(2, label);

      return canvas;
   }
};

//Override of creator for task move to dialog.  Will create new instance
//of the move to dialog
class MyTaskMoveToDialogCreator : public makVrf::DtTaskMoveToDialogCreator
{
public:
   virtual makVrf::DtTaskSetDialogInterface* create(makVrv::DtDe& de, QWidget* parent)
   {
      return new MyTaskMoveToDialog(de, parent, theTaskSetCreationFlags);
   }
};

bool initDeModule(makVrv::DtDe* de)
{
   //The DtVrfTaskSetDialogManager is the class that holds all the creators
   //for task and set dialogs.  Install an override creator here to create
   //an instance of the move to dialog
   makVrf::DtVrfTaskSetDialogManager& manager = makVrf::DtVrfTaskSetDialogManager::instance(*de);

   //And add the new creator
   manager.addTaskDialogCreator(DtTaskMoveToAction, new MyTaskMoveToDialogCreator);

   return true;
}

void DtPluginInformation(DtVrfPluginInformation& info)
{
   info.pluginName = "Modify Task";
   info.pluginDescription = "This example shows how to modify an existing task dialog (Move To Waypoint...) to add your own functionality.";
   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";
}