MVE Developers Guide

Wiki Home ▸ MVE Developers Guide

API Level Documentation

MVE uses Doxygen as API level documentation tool. In order to build the docs, you need to have Doxygen installed on your system. To generate the API documentation, use the following commands (note the subtle but important distinction between doc and docs).

# cd mve
# make doc
# webbrowser docs/doxygen.html

Programming with MVE

To write your own code based on MVE, there is not much you have to do. Set your include path and link to the libraries to create your binary. You can also copy one of our Makefiles to get started. This will compile all .cc files and create a binary with the name of the containing directory.

Here are a few examples how to use the libraries:

• Code Example: Create a View from Images
• Code Example: Iterate over Images in a Scene

Hacking MVE

MVE has a strict style policy. Please look at The MVE Coding Style and How to Contribute for information. When changes to MVE have an impact on already developed code, we may provide tools to fix affected code in an automated way here: Support and Updates.

Testing with GoogleTest

MVE uses Google's testing framework for unit tests. The test cases are located in the mve/tests/ directory and can be built and executed with make test.

Compile and prepare GoogleTest in the following way:

• Download a copy of Google's testing framework.
• Export the environment variable GTEST_PATH and point to the gtest directory.
• cd $GTEST_PATH/make and run make. This compiles the test framework which is used for linking.

Some functionality is hard to test with unit tests. Some test files (with a main() function) still exist in the library directories and are prefixed with _test_*. They can be built with make _test_NAME. However, these kind of tests are deprecated and should be converted to test cases!