12 - Compiling and Linking

Table of Contents

• 12.1 Compiling and Linking on UNIX
• 12.2 Compiling and Linking on Windows

This page explains how to compile and link a plug-in created with the RTIspy plug-in API.

There is a single RTIspy API for both the three RTI implementations. The precompile directive controls the compilation of code as either 1.3 (DtIFSPEC13), 1516 (DtIFSPEC1516), or HLA Evolved (DtIFSPEC1516e). You must use the definition appropriate to the specification you are compiling for. When a plug-in is developed and compiled, it should adhere to the types and components of the respective implementation. The HTML class documents are generated from preprocessed files to present the classes as they are compiled for the respective implementations.

12.1 Compiling and Linking on UNIX

When compiling source files that make up your plug-in DLL, you must compile against the RTIspy header files in the ./plugins/include directory, as follows:

-I rtiDir/include

where rtiDir is the path to the root of your MAK RTI installation.

When you link your shared library, there is usually no need to link with any MAK libraries. Your plug-in will find the symbols it needs in the RTI libraries at run-time. You must link against the RTI libraries, including the specialized RTI versions of the VR-Link utility libraries. Include the following object and library modules in your project settings:

• libRTI-NG.lib
• rtimatrixRT.lib
• rtimtlRT.lib
• rtivlutilRT.lib.

Provide a path to the MAK RTI ./lib directory in your additional library path. Example Makefiles are in the ./plugins/examples/printer directory.

Note

The RTIspy 1516 plug-ins must be linked against librti1516.lib. The RTIspy plug-ins for HLA Evolved must be linked against librti1516e.lib.

12.2 Compiling and Linking on Windows

Under Windows, you must set the paths to the RTIspy include directory (./plugins/include) in your project settings. When you link your shared library, you must link against the RTI libraries, including the specialized RTI versions of the VR-Link utility libraries. Include the following object and library modules in your project settings:

• libRTI-NG.lib
• rtimatrixRT.lib
• rtimtlRT.lib
• rtivlutilRT.lib.

To build debug versions of your DLL, append a d to the library name, for example, rtimatrixRTd.lib. Provide a path to the MAK RTI ./lib directory in your additional library path.

Note

The RTIspy 1516 plug-ins must be linked against librti1516.lib. The RTIspy plug-ins for HLA Evolved must be linked against librti1516e.lib.

Example project files are in the ./plugins/examples/printer directory.

[<< Accessing RID File Parameters] [Home] [Top of Page] [Loading Plug-Ins >>]