VR-Exchange includes solution and project files in the example directories of the Windows version and makefiles in the example directories for the Linux version.

Please examine these files for a full picture of the build process.

9.1 VR-Exchange Libraries

VR-Exchange has the following libraries:

libPortal - contains all classes and functions used to manage VR-Exchange, as well as the protocol-independent data messages that are exchanged between brokers. Brokers and pseudo-brokers, such as vrxMessageDump and the Portal require this library.
libBroker contains classes that make development of brokers easier.
libHla13Broker, libHla1516Broker, and libHla1516eBroker are the HLA broker implementations. These libraries contain code to translate the VR-Exchange protocol-independent messages to the HLA classes.
libTenaBroker is the TENA broker implementation.
libDisBroker is the DIS broker implementation.
libPortalApp is the base library for the Portal application.

9.2 Third Party Libraries

VR-Exchange brokers require the following third party libraries:

VR-Link - The non-HLA components use vl, vlUtil, xml, and matrix. The libHlaBroker library uses vlHLA13 or vlHLA1516. The libTenaBroker library uses vlTENA. The libDisBroker library uses vlDIS.

Note
Use of VR-Link is not covered by the VR-Exchange license; you must purchase a separate license to use it. Please see your MAK sales representative for details.
pThreads - VR-Exchange uses pThreads for shared memory queue locking. Because pThreads are not available on Windows, VR-Exchange uses the PTHREADS-WIN32 library. The PTHREADS-WIN32 library is distributed under the GNU Lesser General Public License. No modifications to the library have been made by MAK. In future releases this dependency may be removed.

If you want to rebuild GUI components of the Portal or the brokers supplied with VR-Exchange, you need Qt. Qt is available as a free download under the LGPL version 2.1 license at www.qtsoftware.com. This version should be satisfactory for most VR-Exchange customers. If you need a Qt commercial license, you must purchase the license from Qt Software.

You do not need Qt to build new brokers or build the Portal without its GUI. You can purchase a Qt license from Trolltech: www.qtsoftware.com. Please see VR-Exchange Release Notes for the required version of Qt.

TENA users must install TENA middleware and any libraries required by their LROM. HLA users must install an RTI.

9.3 Building Brokers

There are no special pre-processor flags required to build a broker. VR-Exchange includes release and debug versions of Windows libraries. Debug versions use the naming convention library_named.lib. The table lists the libraries required to build brokers for Windows and Linux.

Libraries Required to Build Brokers
Windows Libraries	Linux LIbraries
lib{protocol}Broker.lib	{protocol}broker
libBroker.lib	Broker
libPortal.lib	Portal
vl.lib	vl
vlutil.lib	vlutil
vl{protocol}.lib	vl{protocol}
matrix.lib	matrix
mtl.lib	mtl
libxml2.lib	xml
pthreadVC2.lib	pthread
QtCore4.lib	QtCore
QtGui4.lib	QtGui
commonDialogs.lib	commonDialogs
commonWidgets.lib	commonWidgets

On Windows, the simpleBroker example requires the library vl5.

9.4 Rebuilding the HLA Broker

The table lists the libraries you need to rebuild the HLA broker.

HLA Broker Libraries
Windows Libraries	Linux LIbraries
vlPortal.lib	portal
libvl.lib	vl
vlutil.lib	vlutil
matrix.lib	matrix
mtl.lib	mtl
libxml2.lib	xml
pthreadVC2.lib	pthread
QtCore4.lib	QtCore4
QtGui4.lib	QtGui4
vlHLA13.lib, vlHLA1516.lib, or vlHLA1516e.lib )	hla13Broker, hla1516Broker, or hla1516eBroker
libHla1516Broker.lib (or libHla13Broker.lib)	broker
commonDialogs.lib	commonDialogs
commonWidgets.lib	commonWidgets

To rebuild the HLA broker on Windows, you must have the following RTI libraries (included with your RTI):

librti1516.lib (for HLA 1516), librti1516e.lib (for HLA Evolved), or libRTI-NG.lib (for HLA 1.3)
libfedtime1516.lib (for HLA 1516), libfedtime1516e.lib (for HLA Evolved), or libFedTime.lib (for HLA 1.3)

For the HLA broker several VR-Link compiler flags are required. Please consult the VR-Link documentation for instructions about how to build a VR-Link HLA federate.

9.5 LROM Mapper Library Dependencies

VR-Exchange includes release and debug versions of the following LROM Mappers: coLromMapperRT and makLromMapperRT. You can use VR-Link to build custom LROM Mappers.

The LROM mapper files have several dynamic library dependencies that are not supplied with either VR-Link or VR-Exchange. You can get these libraries the following ways from the TENA SDA web site:

Download the TENA Middleware
Download the appropriate Object Model.

9.6 Rebuilding the TENA Broker

If you build a TENA broker, you must link in the vlTENART library. You must set the VR-Link compiler flag DtTENA. This library has the dynamic library dependencies listed in this section. The libraries are available from the indicated sources.

Libraries required for each platform are essentially the same. The libraries supplied with TENA Middleware and the MAK Object Model use the following naming convention:

Library_name-os-[d-]version.extension

where:

Library_name is the platform-independent portion of the name
os is the operating system: xp-vc71 for Windows VC++ 7.1; xp-vc80 for Windows VC++ 8.0; rhelws4-gcc34 for Red Hat Linux Enterprise Workstation 4 using gcc 3.4
d specifies a debug version
version is the version of the library
extension is dll for Windows, or so for Linux.

The following libraries are supplied with the TENA Middleware:

ACE-os-1.5.1d.ext
libDCT_DIME-os-v5.2.2.ext
libDCT_Utils-os-v5.2.2.ext
TAO_PortableServer-os-1.5.1d.ext
TAO-os-1.5.1d.ext
libTENA_Middleware-os-v5.2.2.ext.

The following libraries are supplied with the MAK Object Model:

libTENA-PlatformType-v1-os-v5.2.2_0.ext
libTENA-PlatformType-v1-csvReader-v2-os-v5.2.2_0.ext
libTENA-Time-v1.1-os-v5.2.2_0.ext
libTENA-Time-v1.1-fullConversion-v2-os-v5.2.2_0.ext
libTENA-UniqueID-v2-os-v5.2.2_0.ext
libTENA-UniqueID-v2-userDefined-v1-os-v5.2.2_0.ext.

The following MAK libraries are provided with VR-Exchange. On Windows, debug libraries have a "d" before the extension, for example, vlTENARTd.lib.

Libraries Provided by MAK for Use with TENA
Windows	Linux
vlTENA.lib	vlTENA
vlutil.lib	vlutil
matrix.lib	matrix
vl.lib	vl
mtl.lib	mtl
libTenaBroker.lib	TenaBroker
commonWidgets.lib	commonWidgets
commonDialogs.lib	commonDialogs
QtCore4.lib	QtCore4
QtGui4.lib	QtGui4
libBroker.lib	Broker
libxml2.lib	libxml2
pthreadVC2.lib	pthreadVC2

9.7 Rebuilding the DIS Broker

To build the DIS broker, you must specify several VR-Link compiler flags. Please consult the VR-Link documentation for instructions about how to build a VR-Link application for DIS.

Libraries Required to Build the DIS Broker
Windows Libraries	Linux LIbraries
vl.lib	vl
vlutil.lib	vlutil
matrix.lib	matrix
mtl.lib	mtl
libxml2.lib	xml2
pthreadVC2.lib	portal
QtCore4.lib	QtCore4
QtGui4.lib	QtGui4b
vlDIS.lib	vlDIS
libDisBroker.lib	disBroker
commonDialogs.lib	commonDialogs.lib
commonWidgets.lib	commonWidgets.lib
	broker

[<< Extending the Portal Application] [Home] [Top of Page]

Table of Contents