NaviTrack Tutorial:Creating module:Adding module
Here, we will add "MyTutorialModule" to your NaviTrack.
Contents
Step 1: Deploy your source codes
Put your *.cxx files into "src/input/", and *.h into "include/OpenTracker/input".
In UNIX:
% cp *.cxx <your NaviTrack directory>/src/input/ % cp *.h <your NaviTrack directory>/include/OpenTracker/input/
Step 2: Configure Cmake
Configure your "CMakeLists.txt" at the root of your NaviTrack source tree, so that NaviTrack is compiled with your own module.
In SET(SOURCES ...) section in CMakeLists.txt (starts from L.126), add paths to your *.cxx files as:
SET(SOURCES src/core/Event.cxx src/core/EventAttributeBase.cxx src/core/Translator.cxx ... src/input/CustomTransformation.cxx src/input/SpaceTravellerModule.cxx src/input/MyTutorialModule.cxx <----- Here !!! src/tool/OT_ACE_Log.cxx src/input/QuatToMatrix.cxx src/types/Image.cxx )
Step 3: Register your module in SPLModule
SPLModule is a special module to register all NaviTrack modules, whenever the NaviTracker is started. This registration enables the NaviTrack to recognize names of modules described in a XML configuration file.
In addSPLModules() function in src/misc/SPLModules.cxx (starts from L.50): add your own module using OT_REGISTER_MODULE() macro as:
OPENTRACKER_API int addSPLModules() { OT_REGISTER_MODULE(NaviTrack, NULL); OT_REGISTER_MODULE(SpaceTravellerModule, NULL); OT_REGISTER_MODULE(NDIModule, NULL); OT_REGISTER_MODULE(MyTutorialModule, NULL); <--- Here !!! ....
Step 4: Configure and build it!
Now you are ready to configure and build your NaviTrack.
Run CMake to reflect your change in CMakeLists.txt and run make.