18.3 - Rebuilding the VR-Forces Application

Table of Contents

• 18.3.1 Building the VR-Forces Application for Windows
• 18.3.2 Building the VR-Forces Application for Linux

This section describes how to use the sample project files supplied with VR-Forces to rebuild the VR-Forces application.

Note

When you build a VR-Forces application, you must build it against the version of VR-Link that your version of VR-Forces was built against. Please see VR-Forces Release Notes for your version of VR-Forces, to find out which version of VR-Link to use.

18.3.1 Building the VR-Forces Application for Windows

Please review the prerequisites for building VR-Forces in 18.2 - Prerequisites for Building VR-Forces Applications.

The sample project files create the release and debug executables vrfSimUser.exe and vrfSimUserDebug.exe. This naming convention ensures that you do not inadvertently overwrite the executables supplied by MAK. The files are placed in the . directory.

The . directory contains MS VC++ project files. The project file contains release and debug configurations. The projects are:

• vrfSimUserDIS - projects that build the DIS version of the VR-Forces back-end and front-end
• vrfSimUserHLA13, vrfSimUserHLA1516, and vrfSimUserHLA1516e - projects that build the HLA versions of the VR-Forces back-end.

The sample projects enable you to add additional features using the VR-Forces toolkit. You can extend the existing VR-Forces simulation back-end. You can also use the sample project as a starting point for building your own application that uses components of the VR-Forces toolkit.

Note

In order to run HLA versions, you need to have your computer configured to find the proper RTI DLLs. Refer to "Installing an RTI", in VR-Forces Users Guide.

18.3.2 Building the VR-Forces Application for Linux

To build VR-Forces for Linux, you must have VR-Link. If you building an HLA application, you must also have a supported RTI.

Before building the VR-Forces application, set the following environment variabls:

• QTDIR. Set to the location of the Qt libraries.
• MAK_VRLDIR. Set to the location of your VR-Link installation. Be sure to use the version of VR-Link specified in VR-Forces Release Notes for your version of VR-Forces. The VR-Link tree must have a symbolic link to the RTI tree as described in "Compiling for a Particular Simulation Standard Under UNIX" in VR-Link Developers Guide.
• MAK_RTIDIR (HLA builds only). Set to the location of your RTI installation.

You must be in the ./appsrc/vrfSim directory to build vrfSim. By default, make will build all the VR-Forces configurations. You can prevent certain configurations from being built by specifying NO_DIS=1, NO_HLA1516=1 or NO_HLA13=1 on your command line.

Follow a comparable process to build vrfGui.

Note

VR-Forces applications must run from the proper ./bin directory. The files can be copied to their correct ./bin directories automatically by using the "install" target on the make line.

[<< Prerequisites for Building VR-Forces Applications] [Home] [Top of Page] [Building an Application that Uses the VR-Forces Toolkit >>]