The most common build system used for VXL is CMake. You should first download and install CMake. VXL requires CMake version 2.6.3 or higher.
Extract the VXL source into the directory vxl-1.14. Create a separate output directory bin parallel to the source directory:
.../.../... ---+--- vxl-1.14 ---+--- vxl | | | +--- vcl | ... | +--- bin
Let us call the former
$VXLSRC and the latter
Change current directory to
$VXLBIN and run CMake, specifying
as the source directory.
ccmake $VXLSRCor the command line front-end
cmake -i $VXLSRC
$VXLBIN, respectively. In the box on the upper right, choose the build system you use.
Repeatedly select "Configure" ("C" on Unix) until the entries stop
changing and you get the chance to generate the makefiles ("OK" on
Windows, and "G" on Unix).
You may ignore any "something-NOTFOUND" message since these refer to optional components. But if you are sure that one of these components is present on your system, manually fill in the correct path and re-run configure.
In the CMake interface, you can choose which parts of the VXL tree to build. The default is to build everything except vgui and its dependents. Building vgui requires the presence of OpenGL and GLU. Often, these are in a platform specific area of the machine, and hence cannot be detected by CMake. If you have these on your system, and wish to build vgui, set BUILD_VGUI to "ON" and make sure the appropriate entries in the CMake cache are valid. With Windows, the required libraries (MFC and OpenGL) are shipped with the operating system, so you should be able to build vgui without any issues.
Now you can build the libraries.
$VXLBIN\vxl.dswinto Developer Studio and building the ALL_BUILD target. This project is a little larger than Developer Studio can sometimes cope with, so you can do a full build from the command line:
vcvars32.bat msdev vxl.dsw /MAKE "ALL_BUILD - Win32 Debug"Or the speedier release version
msdev vxl.dsw /MAKE "ALL_BUILD - Win32 Release"
$VXLBIN\vxl.slninto Developer Studio and building the ALL_BUILD target.
You can run the test suite using the
ctest program that came with CMake
Have a look through the Build FAQ.
If you think you have found a bug, or if you have an installation or build problem, please submit a bug report on the Issues Tracker. Also supply the following information unless you know for certain it is not relevant:
gcc -v" and "
g++ -v" (yes, both, please - they have been known to differ). For other compilers try
--versionor read the manual.