 |
VR-Forces 4.10 Class Documentation
|
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
|
VR-Forces 4.10 Class Documentation
|
The examples are pre-compiled and installed by the SDK installer so it is not necessary to build them in order to try them out. To activate the pre-built plug-ins, please see section "5.9.1. Loading a Plug-in", in VR-Forces Users Guide.
Before you can build an example or a custom application, you must install the supporting software that your installation depends on and you must configure environment variables, so that the example project files can find these prerequisites.
You must do the following:
If you are building for HLA, install a supported RTI. We recommend using the MAK High Performance RTI, but RTIs from other vendors are supported as well, as long as they comply with the appropriate versions of the HLA Standards. A developer's license does not include a license for the MAK RTI. However, the MAK RTI allows you to run federations of up to two federates without requiring a license. You can download the MAK RTI at: http://www.mak.com/resources/bonus-material.html.
If you install an RTI, set the environment variable MAK_RTIDIR to the full path to the RTI installation (for example, C:\MAK\makRti4.2).
Note: The example project files look for RTI header files in a directory called "include" directly under $(MAK_RTIDIR), and look for RTI link libraries in a directory called "lib" directly under $(MAK_RTIDIR). If you are using an RTI that does not follow that directory-naming convention, you may need to change the project settings in order for the build system to find your RTI headers and libraries.
If you want to build the front-end examples, you must install Qt, the cross-platform GUI development kit upon which the GUI is built. Qt is available at qt.digia.com and pre-built versions are available from MAK at http://www.mak.com/support/resources/bonus-material. It is freely licensed under the LGPL version 2.1.
If you install Qt, set the following environment variables:
See VR-Forces Release Notes for the version of Qt used by your release of VR-Forces.
To build VR-Forces examples, simply open the project file of the example you wish to use and build it. The newly built DLL or shared object will automatically be copied to the "build" directory where it can be loaded via the Plug-in management interface documented in Managing Plug-ins in VR-Forces Users Guide. Stand-alone executables will automatically be copied into the "bin" directory.
VR-Forces does not include debug DLLs on Windows systems. This is done because the debug versions of the VRF DLLs run so slowly that it is not practical to run the debug version of the application, and it is possible to effectively debug applications using release mode DLLs if built correctly.
On Windows, it is required to link debug DLLs with other debug DLLs, which means that it is not possible to create a VRF plugin built in debug mode.
The best way to debug plugins for VR-Forces is to build in the “RelWithDebInfo” configuration and to turn off optimizations for the plugin modules being debugged. This allows the Visual Studio environment to break on specific lines, step through code, and show variable values, all while using a release build of the plugin, and linking against the release version DLLs of VR-Forces.
The examples/VR-Vantage directory contains examples from VR-Vantage (upon which VR-Forces is based). Not all the examples from VR-Vantage are present, specifically any examples of VR-Vantage IG and any others which are either not relevant to or which are duplicated by VR-Forces examples.
The plug-in system used by VR-Vantage is different than that of VR-Forces and will require different steps in order to use the examples. Since the VR-Vantage examples are shipped pre-built, it is not necessary to build them. If you wish to use them, however, you can do so in one of two ways:
1) Copy the individual VR-Vantage example from it's built directory to the apporporiate plugin[64] directory (debug or release). When the gui is run it will automatically load the plugin. For example you can copy the exampleAccessor plugin from C:.5\examples\exampleAccessory\build64\RelWithDebInfo\exampleAccessory.dll to the plugins64 directory 2) Use the –plugin command line. For example, to load the exampleSymbolFacade1.dll example:
vrfgui --dis --plugin ..\examples\exampleSymbolFacade1\build64\RelWithDebInfo\exampleSymbolFacade1.dllYou can use the CMAKE program (found at cmake.org) to regenerate distributed project examples or to generate your own project from a CMakeLists.txt file.
In order to generate project files using cmake you will need to have at least version 2.8 of cmake installed on your system. You will then need to open a shell window and change your directory to your VR-Forces install's main directory directory. You can use cmake –help to see what compilers are available. You can then choose your compiler to build your project files. For example, if you wish to generate a VC12 2013 set of project files you would execute the following command:
cmake -G "Visual Studio 12 2013 Win64"
This will regenerate all project files and incorporate any changes you may have made and create a vrforcesExamples_64.sln solution.
It will also automatically generate the necessary moc or uic statements for additional Qt sources.
You may create your own example project by copying one of the existing projects and modifying the CMakeLists.txt file to subsitute in your project name. Once created you will need to add your example to the CMakeLists.txt file in the examples directory in the appropriate protocol or non-protocol section.
[<< Creating and Initializing the Simulation Engine] [Home] [Top of Page]