Simpler way of declaring libraries used in CMake using the virtual libraries notation. This notation allows to express include and libraries dependencies at once. Provided with packages for applications dealing with OpenGL, Computer Vision and Media
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake_modules
test
.gitignore
Findcmakego.cmake
LICENSE
README.md
cmakego.cmake

README.md

cmakego

Simpler way of declaring libraries used in CMake using the virtual libraries notation. This notation allows to express include and librarie dependencies at once. Provided with packages for applications dealing with OpenGL, Computer Vision and Media

usage

Make the cmakego.cmake accessible to the cmake using CMAKE_MODULE_PATH and then first include it, then use the command usepackage:

cmake -DCMAKE_MODULE_PATH=~/Dropbox/repos/cmakego .

First method is based on find_package much like catkin

find_package(cmagego REQUIRED COMPONENTS ... [REQUIRED])

The second requires inclusion of the script and then the usepackage macro:

usepackage(packagename1 ... [GLOBAL] [REQUIRED])

The library name is the name of the packagename1 such as eigen, opengl or others. When found it will create the special target p::packagename.

Then the p::packagename can be used in the target_link_libraries of a target to satisfy at once both includes and libraries.

	add_executable(go1 go1.cpp)
	target_link_libraries(go1 p::glew p::glfw p::glm p::boost p::assimp)

When REQUIRED is present then the package is enforced otherwise the cmake will terminate.

When GLOBAL is used then the virtual target is added to the global list via link_libraries and include_directories. In this way it is available to all the other targets.

In addition ALL the dependencies included by cmakego are included in the variable CMAKEGO_PACKAGES

example

The following example uses OpeNGL, GLEW, GLFW, GLM and AssImp. Note that dependences have been created between glew/glfw and opengl so the latter is automatically pulled and added.

	cmake_minimum_required(VERSION 3.0)

	add_definitions(--std=c++11 -DGLM_FORCE_RADIANS)
	find_package(cmakego COMPONENTS glfw glew glm boost assimp)

	add_executable(go1 go1.cpp)
	target_link_libraries(go1 p::glew p::glfw p::glm p::boost p::assimp)

Libraries

real libraries

The supported libraries come from the domain of 3D OpenGL/AR/vision being related to the things we typically work with:

  • aruco: opencv
  • asio
  • assimp
  • boost
  • cairo
  • curl
  • display (virtual)
  • egl
  • eigen
  • ffmpeg (and submodules)
  • flann
  • freenect
  • freenect2
  • freetype
  • glew: opengl
  • glfw: opengl, display
  • glib2
  • glm
  • gstreamer: glib2
  • json
  • kdl
  • lame
  • leap
  • libusb (1.0)
  • lz4
  • nlopt
  • ogre
  • ois (for ogre)
  • opencv2
  • opencv3
  • opengl
  • opengles2
  • openni2
  • ovr (Oculus)
  • portaudio
  • qt4
  • qt5
  • rbdl
  • sdl2
  • tinyxml
  • tinyxml2
  • x264
  • yaml
  • zeromq
  • zlib

virtual libraries

  • display: this is a library for accessing the native system (X11 under Linux, CoCoa under OSX)

TODO

  • Provide another repository with simple examples for testing the libraries in a simple way. We are interested in coverin all the libraries above.

  • Start decomposing the cmakego in functional pieces, now all the libraries are selected in the main script