813d030 Add module to get information about a git repo b2070d7 Fix installing docs optionally, even on old cmake versions e8cbbf5 Hide the module variable if we find it manually c1ad55e Fix opencv finder for old libraries 9ca6a00 Make the opencv module handle finding the config file, if it exists. beabdbd Merge commit 'aca0ca0aea326a4b8c10f6638024a6e8c0279d02' e36bb5b Merge branch 'master' of git@github.com:rpavlik/wiimote-head-tracker-gui.git b75b7df Improve wiiuse locator 92f1870 Remove all old build systems ee0ce40 Add Windows HID library finder b8878cb Update wiiuse finder to locate DLL from cmake-based install 5b7d5d9 Add a Bluez find module ee17e2a Update cmake modules 30e28b2 Update cmake files dc48ba7 Fix windows build 1958481 Fix RPATH handling on Linux 3fe03cd Initial commit git-subtree-dir: cmake git-subtree-split: 813d0301a4ed5b53d8187608c2986904ce99ab4e
VRAC CMake Modules
Ryan Pavlik
rpavlik@iastate.edu abiryan@ryand.net http://academic.cleardefinition.com
Iowa State University HCI Graduate Program/VRAC
Introduction
This is a collection of CMake modules that I've produced during the course of a variety of software development. There are a number of find modules, especially for virtual reality and physical simulation packages, some utility modules of more general interest, and some patches or workarounds for CMake itself.
Each module is generally documented, and depending on how busy I was when I created it, the documentation can be fairly complete.
How to Integrate
These modules are probably best placed wholesale into a "cmake" subdirectory of your project source.
If you use Git, try installing git-subtree, so you can easily use this repository for subtree merges, updating simply.
For the initial checkout:
cd projectdir
git subtree add --squash --prefix=cmake git://github.com/rpavlik/cmake-modules.git master
For updates:
cd projectdir
git subtree pull --squash --prefix=cmake git://github.com/rpavlik/cmake-modules.git master
If you use some other version control, you can export a copy of this directory without the git metadata by calling:
./export-to-directory.sh yourprojectdir/cmake
You might also consider exporting to a temp directory and merging changes, since this will not overwrite by default. You can pass -f to overwrite existing files.
How to Use
At the minimum, all you have to do is add a line like this near the top of your root CMakeLists.txt file (but not before your project() call):
list(APPEND CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake")
You might also want the extra automatic features/fixes included with the modules, for that, just add another line following the first one:
include(UseBackportedModules)
Licenses
The modules that I wrote myself are all subject to this license:
Copyright Iowa State University 2009-2010
Distributed under the Boost Software License, Version 1.0.
(See accompanying file
LICENSE_1_0.txtor copy at http://www.boost.org/LICENSE_1_0.txt)
Modules based on those included with CMake are under the OSI-approved BSD license, which is included in each of those modules. A few other modules are modified from other sources - when in doubt, look at the .cmake.
Important License Note!
If you find this file inside of another project, rather at the top-level directory, you're in a separate project that is making use of these modules. That separate project can (and probably does) have its own license specifics.