summaryrefslogtreecommitdiffstats
path: root/dev/MinGfx/CMakeLists.txt
diff options
context:
space:
mode:
Diffstat (limited to 'dev/MinGfx/CMakeLists.txt')
-rw-r--r--dev/MinGfx/CMakeLists.txt790
1 files changed, 395 insertions, 395 deletions
diff --git a/dev/MinGfx/CMakeLists.txt b/dev/MinGfx/CMakeLists.txt
index e3da874..72974c4 100644
--- a/dev/MinGfx/CMakeLists.txt
+++ b/dev/MinGfx/CMakeLists.txt
@@ -1,395 +1,395 @@
-# Copyright (c) 2017,2018 Regents of the University of Minnesota.
-# All rights reserved.
-#
-# Original Author(s) of this File:
-# Daniel Keefe, Jan 2018, University of Minnesota -- This build system is inspired by
-# the AUTOBUILD_DEPENDENCY approach I developed for the MinVR Open Source project.
-# Tom Sgouros (Brown Univ.) and Dan Orban (Univ. of Minn.) also contributed to earlier
-# versions of MinVR's build system and the use of cmake in other research software used
-# in the IV/LAB. So, this is also at least loosly inspired by their contributions.
-# See minvr.org for a full list of contributors to that project.
-#
-# Author(s) of Significant Updates/Modifications to the File:
-# ...
-
-
-
-
-#### BASIC PROJECT SETUP ####
-
-# Depends on cmake 3.9+ for its more advanced FindOpenGL.cmake module
-cmake_minimum_required (VERSION 3.9)
-
-# Search path for cmake support scripts
-list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake" "${CMAKE_CURRENT_SOURCE_DIR}/cmake/Modules/")
-
-# Version is <major>.<minor>.<patch>
-cmake_policy(SET CMP0048 NEW) # Required for setting version number as part of the project() command
-project(MinGfx_Toolkit VERSION 1.0.0)
-
-# This will be appended to the install destinations so that multiple versions of MinGfx
-# can be safely installed on the same system. This intentionally does not include a
-# patch number because patches should be small changes that do not change the API.
-set(MINGFX_VERSION_STR -${MinGfx_Toolkit_VERSION_MAJOR}.${MinGfx_Toolkit_VERSION_MINOR})
-
-# Organize folder structure for Xcode, Visual Studio, etc.
-set_property(GLOBAL PROPERTY USE_FOLDERS ON)
-
-# For better formatting of output while configuring with cmake
-include(MessageMacros)
-
-# If you "autobuild" external dependencies as part of the cmake configure process, then they will be
-# downloaded to this directory.
-set(AUTOBUILD_DOWNLOAD_DIR "${CMAKE_CURRENT_SOURCE_DIR}/external" CACHE STRING "Location for external project sources downloaded by AutoBuild.")
-
-
-set(CMAKE_INSTALL_MESSAGE ALWAYS)
-
-include(AutoBuild)
-AutoBuild_init()
-
-
-#### ADJUST NAMES OF OUTPUT FILES BASED ON BUILD TYPE ####
-
-h1("CONFIGURING BUILD TYPES")
-
-# To distinguish between debugging, release, and other builds, we'll
-# add a postfix to the name of the lib or exe that we generate.
-
-set(CMAKE_DEBUG_POSTFIX "d")
-set(CMAKE_RELEASE_POSTFIX "")
-set(CMAKE_RELWITHDEBINFO_POSTFIX "rd")
-set(CMAKE_MINSIZEREL_POSTFIX "s")
-
-if (CMAKE_BUILD_TYPE MATCHES "Release")
- set(CMAKE_BUILD_POSTFIX "${CMAKE_RELEASE_POSTFIX}")
-elseif (CMAKE_BUILD_TYPE MATCHES "MinSizeRel")
- set(CMAKE_BUILD_POSTFIX "${CMAKE_MINSIZEREL_POSTFIX}")
-elseif (CMAKE_BUILD_TYPE MATCHES "RelWithDebInfo")
- set(CMAKE_BUILD_POSTFIX "${CMAKE_RELWITHDEBINFO_POSTFIX}")
-elseif (CMAKE_BUILD_TYPE MATCHES "Debug")
- set(CMAKE_BUILD_POSTFIX "${CMAKE_DEBUG_POSTFIX}")
-else()
- set(CMAKE_BUILD_POSTFIX "")
-endif()
-
-
-
-
-#### SETUP DIRECTORIES FOR BUILDING AND INSTALLING ####
-
-h1("CONFIGURING BUILD/INSTALL LOCATIONS")
-
-h2("Configuring build directories.")
-
-message(STATUS "Tests, other binaries: ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}")
-message(STATUS "Libraries: ${CMAKE_LIBRARY_OUTPUT_DIRECTORY}")
-
-
-h2("Configuring installation directories.")
-if (CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
- set (CMAKE_INSTALL_PREFIX "${CMAKE_BINARY_DIR}/install" CACHE PATH "default install path" FORCE )
-endif()
-
-# When we autobuild dependencies, we install them in CMAKE_INSTALL_PREFIX, and then look for them
-# there using find_package(). So, this makes sure the install prefix is in the path that
-# find_package() searches.
-list(APPEND CMAKE_MODULE_PATH ${CMAKE_INSTALL_PREFIX})
-list(APPEND CMAKE_PREFIX_PATH ${CMAKE_INSTALL_PREFIX})
-
-# These are relative to ${CMAKE_INSTALL_PREFIX}
-set(INSTALL_BIN_DEST bin)
-set(INSTALL_LIB_DEST lib/MinGfx${MINGFX_VERSION_STR})
-set(INSTALL_INCLUDE_DEST include/MinGfx${MINGFX_VERSION_STR})
-set(INSTALL_SHADERS_DEST share/MinGfx${MINGFX_VERSION_STR}/shaders)
-set(INSTALL_DATA_DEST share/MinGfx${MINGFX_VERSION_STR}/data)
-set(INSTALL_DOC_DEST share/MinGfx${MINGFX_VERSION_STR}/docs)
-set(INSTALL_CMAKECONFIG_DEST lib/cmake/MinGfx${MINGFX_VERSION_STR})
-
-message(STATUS "Tests, other binaries: ${CMAKE_INSTALL_PREFIX}/${INSTALL_BIN_DEST}")
-message(STATUS "MinGfx library: ${CMAKE_INSTALL_PREFIX}/${INSTALL_LIB_DEST}")
-message(STATUS "MinGfx header files: ${CMAKE_INSTALL_PREFIX}/${INSTALL_INCLUDE_DEST}")
-message(STATUS "MinGfx shader programs: ${CMAKE_INSTALL_PREFIX}/${INSTALL_SHADERS_DEST}")
-message(STATUS "MinGfx data files: ${CMAKE_INSTALL_PREFIX}/${INSTALL_DATA_DEST}")
-message(STATUS "MinGfx documentation files: ${CMAKE_INSTALL_PREFIX}/${INSTALL_DOC_DEST}")
-message(STATUS "CMake Config Package for including MinGfx in other projects: ${CMAKE_INSTALL_PREFIX}/${INSTALL_CMAKECONFIG_DEST}")
-
-# Configure a header file to pass some of the CMake settings to the source code
-configure_file(
- ${CMAKE_CURRENT_SOURCE_DIR}/src/mingfx_config.h.in
- ${CMAKE_CURRENT_SOURCE_DIR}/src/mingfx_config.h
-)
-
-
-#### SET ANY COMPILER FLAGS ####
-
-h1("CONFIGURING COMPLIER FLAGS")
-
-
-
-message(STATUS "Building for " ${CMAKE_SYSTEM_NAME} ".")
-message(STATUS "Compiler supported features = ${CMAKE_CXX_COMPILE_FEATURES}")
-
-
-# Linux specific
-if (${CMAKE_SYSTEM_NAME} MATCHES "Linux")
- add_definitions(-DLINUX)
- set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fPIC")
- set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++14")
-endif()
-
-
-# Apple specific
-if (${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
- add_definitions(-DOSX)
-
- # Since for some stupid reason Apple has now deprecated OpenGL
- #set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-deprecated")
- add_definitions(-DGL_SILENCE_DEPRECATION)
-
- # RPATH settings, see https://cmake.org/Wiki/CMake_RPATH_handling
- set(CMAKE_MACOSX_RPATH ON)
-
- # use, i.e. don't skip the full RPATH for the build tree
- SET(CMAKE_SKIP_BUILD_RPATH FALSE)
-
- # when building, don't use the install RPATH already
- # (but later on when installing)
- SET(CMAKE_BUILD_WITH_INSTALL_RPATH FALSE)
-
- SET(CMAKE_INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib")
-
- # add the automatically determined parts of the RPATH
- # which point to directories outside the build tree to the install RPATH
- SET(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
-
- # the RPATH to be used when installing, but only if it's not a system directory
- LIST(FIND CMAKE_PLATFORM_IMPLICIT_LINK_DIRECTORIES "${CMAKE_INSTALL_PREFIX}/lib" isSystemDir)
- IF("${isSystemDir}" STREQUAL "-1")
- SET(CMAKE_INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib")
- ENDIF("${isSystemDir}" STREQUAL "-1")
-
- set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++14")
-endif()
-
-
-# Windows specific
-if (WIN32)
- add_definitions(-DWIN32)
- set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /Z7")
-endif()
-
-
-
-
-#### DEFINE THE LIBRARY WE WANT TO BUILD ####
-
-h1("CONFIGURING LIBMINGFX")
-
-h2("Configuring core library source.")
-message(STATUS "Adding src to the build.")
-
-# Intentionally using include() rather than add_subdirectory() so that the MinGfx target
-# is defined in the scope of this CMakeLists.txt file. That way, sudirs that depend
-# upon it can list it as a dependency.
-include(src/CMakeLists.txt)
-
-
-
-
-#### DEFINE ADDITIONAL BUILD TARGETS, LIKE TEST PROGRAMS, ETC. ####
-
-h1("CONFIGURING PROGRAMS AND DATA")
-
-h2("Cofiguring test programs.")
-message(STATUS "Adding all subirectories of tests to the build.")
-add_subdirectory(tests/blank_window)
-add_subdirectory(tests/gui_plus_opengl)
-
-
-h2("Cofiguring data.")
-message(STATUS "Identifying data to install.")
-install(
- DIRECTORY data/
- DESTINATION ${INSTALL_DATA_DEST}
-)
-
-
-
-#### OPTIONALLY, BUILD DOXYGEN-STYLE DOCUMENTATION ####
-
-h1("CONFIGURING DOCUMENTATION")
-
-h2("Configuring Web-Based Documentation.")
-option(WITH_DOCUMENTATION "Builds web-based documentation for the library. (Requires doxygen)")
-if (WITH_DOCUMENTATION)
- message(STATUS "ON: Will build and install MinGfx Web-Based Documentation.")
-else()
- message(STATUS "OFF: NOT building MinGfx Web-Based Documentation.")
-endif()
-
-if (WITH_DOCUMENTATION)
- find_package(Doxygen)
- if(NOT DOXYGEN_FOUND)
- message(FATAL_ERROR "Doxygen is needed to build the documentation.")
- endif()
-
- set(DOXY_FILES
- doc/Doxyfile.in
- doc/api.md
- doc/installation.md
- doc/mainpage.md
- doc/header.html
- doc/index.html
- doc/footer.html
- doc/customdoxygen.css
- )
-
- set(OTHER_DOCS
- README.md
- LICENSE.txt
- )
-
- # Process the config file and put it in the build directory.
- set(DOXYFILE_IN ${CMAKE_CURRENT_SOURCE_DIR}/doc/Doxyfile.in)
- set(DOXYFILE ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
- configure_file(${DOXYFILE_IN} ${DOXYFILE} @ONLY)
-
- add_custom_target(doc ALL
- ${DOXYGEN_EXECUTABLE} ${DOXYFILE}
- DEPENDS ${DOXY_FILES} ${OTHER_DOCS}
- SOURCES ${DOXY_FILES} ${OTHER_DOCS}
- WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
- COMMENT "Generating documentation with Doxygen"
- VERBATIM
- )
-
- set_source_files_properties(${DOXY_FILES} PROPERTIES HEADER_FILE_ONLY TRUE)
- source_group("Doxygen Files" FILES ${DOXY_FILES})
-
- set_source_files_properties(${OTHER_DOCS} PROPERTIES HEADER_FILE_ONLY TRUE)
- source_group("Other Docs" FILES ${OTHER_DOCS})
-
- install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html
- DESTINATION ${INSTALL_DOC_DEST}
- COMPONENT Docs
- OPTIONAL
- )
-
- install(FILES doc/index.html
- DESTINATION ${INSTALL_DOC_DEST}
- COMPONENT Docs
- OPTIONAL
- )
-endif()
-
-
-
-
-
-#### CREATE/INSTALL A CMAKE CONFIG PACKAGE TO HELP OTHERS LINK TO THE LIBRARY ####
-
-h1("WRITING CMAKE CONFIG PACKAGE")
-
-# The documentation for setting this up is so bad. These pages all helped. My current
-# understanding (dfk) is summarized below to help others.
-# https://cmake.org/cmake/help/git-master/manual/cmake-packages.7.html#creating-packages
-# https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html#target-usage-requirements
-# http://foonathan.net/blog/2016/03/03/cmake-install.html
-# https://archive.fosdem.org/2013/schedule/event/moderncmake/attachments/slides/258/export/events/attachments/moderncmake/slides/258/cmake_fosdem_2013.pdf
-
-# CMake Package Config in a Nutshell:
-
-# CMake config packages are the newer, recommended way of distributing projects built with CMake.
-# They replace the older FindModule.cmake approach for including dependencies in a cmake project,
-# but not everyone has yet switched over to the new approach. Both styles can work together, and
-# this seems to often be required because many libraries are not yet distributing a *Config.cmake
-# file with their install tree.
-
-
-# 1. The Difference Between "Find Modules" (Find*.cmake) and "Config Packages" (*Config.cmake)
-
-# Whereas, Find*.cmake files are either installed on the system or written by downstream projects.
-# *Config.cmake files are created and installed by the upstream projects (e.g., we want generate
-# MinVRConfig.cmake and install it whenever the MinVR project in installed).
-
-# When you use a Find Module, it defines several variables (e.g., OPENGL_INCLUDE_DIR, OPENGL_LIBRARIES)
-# that you must then be sure to add to the include dirs and libs to link with your project.
-# Config Packages are different. Instead, they "export" the targets defined in the original project
-# (e.g., the target MinGfx is used in this file to build libMinGfx.a) so that the client project
-# may refer to these targets directly. This is pretty cool because we can define the MinGfx target
-# in such a way that cmake even knows which header files are associated with it, and will add the
-# required include flags whenever the MinGfx target is used.
-
-
-# 2. How to use Config Packages in a client CMakeLists.txt
-
-# With the config package appraoch, client projects only need to include two lines to use our library:
-
-# find_package(MinGfx REQUIRED)
-# ... then, after add_executable(${PROJECT_NAME}) or add_library(${PROJECT_NAME})
-# target_link_libraries(${PROJECT_NAME} PUBLIC MinGfx)
-
-
-# 3. Finding *Config.cmake files
-
-# Config packages are files of the form MyProjNameConfig.cmake (or *-config.cmake). Each library
-# provides and installs its own config package. So, here we will create one to install with MinGfx.
-# If created correctly, these packages can be relocatable, i.e., not specific to the install path
-# used on a particular machine. When you call find_package(...) cmake looks for packages in a
-# variety of locations (e.g., /usr/local/lib/cmake/*).
-
-# Since config packages are supposed to be written by and installed by the upstream dependencies,
-# my understanding is that you should not attempt to write you own version of a config package if
-# you encounter a project that is not (yet) using the config package appraoch. Instead, use the
-# older Find Module appraoch. If CMake ships with a Find*.cmake file for that project, then use
-# it. If not, then you can write your own. Since making this switch, many of the newer
-# Find*.cmake scripts that ship with CMake have been updated to support imported targets. They
-# are still called something like FindOpenGL.cmake, but in addition to just setting vars like
-# OPENGL_INCLUDE_DIR, they also define targets, such as OpenGL::GL. We use these when we can
-# because they are more robust. When you do target_link_libraries(myproj PULBIC OpenGL::GL)
-# cmake knows to not only link with the the opengl library but also to include its headers and
-# link with all dependencies.
-
-
-# This tells cmake to generate a MinGfxTargets.cmake file that works for importing all targets
-# associated with the MinGfx export group from the install tree. This file is where all the
-# important cmake magic happens. It is auto-generated. This call also installs the file to
-# the appropriate location.
-install(EXPORT MinGfxTargets
- NAMESPACE MinGfx::
- FILE MinGfxTargets.cmake
- DESTINATION ${INSTALL_CMAKECONFIG_DEST}
-)
-
-# This is a very small wrapper around the MinGfxTargets.cmake file. It's possible to use this
-# configure_file() command to replace variables (e.g., special defines, install paths) in the
-# file, but we do not currently need that functionality.
-configure_file(
- cmake/MinGfxConfig.cmake.in
- "${CMAKE_CURRENT_BINARY_DIR}/cmake/MinGfxConfig.cmake"
- COPYONLY
-)
-
-# This auto-generates a standard CMake config version file. Using this, client projects can
-# check to see if a specific version of MinGfx is installed on the system.
-include(CMakePackageConfigHelpers)
-set_property(TARGET MinGfx PROPERTY VERSION ${MinGfx_Toolkit_VERSION})
-write_basic_package_version_file(
- "${CMAKE_CURRENT_BINARY_DIR}/cmake/MinGfxConfigVersion.cmake"
- VERSION ${MinGfx_Toolkit_VERSION}
- COMPATIBILITY AnyNewerVersion
-)
-
-# The two Config files also get installed
-install(
- FILES
- "${CMAKE_CURRENT_BINARY_DIR}/cmake/MinGfxConfig.cmake"
- "${CMAKE_CURRENT_BINARY_DIR}/cmake/MinGfxConfigVersion.cmake"
- DESTINATION
- "${INSTALL_CMAKECONFIG_DEST}"
-)
-
-
-AutoBuild_check_status()
-
+# Copyright (c) 2017,2018 Regents of the University of Minnesota.
+# All rights reserved.
+#
+# Original Author(s) of this File:
+# Daniel Keefe, Jan 2018, University of Minnesota -- This build system is inspired by
+# the AUTOBUILD_DEPENDENCY approach I developed for the MinVR Open Source project.
+# Tom Sgouros (Brown Univ.) and Dan Orban (Univ. of Minn.) also contributed to earlier
+# versions of MinVR's build system and the use of cmake in other research software used
+# in the IV/LAB. So, this is also at least loosly inspired by their contributions.
+# See minvr.org for a full list of contributors to that project.
+#
+# Author(s) of Significant Updates/Modifications to the File:
+# ...
+
+
+
+
+#### BASIC PROJECT SETUP ####
+
+# Depends on cmake 3.9+ for its more advanced FindOpenGL.cmake module
+cmake_minimum_required (VERSION 3.9)
+
+# Search path for cmake support scripts
+list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake" "${CMAKE_CURRENT_SOURCE_DIR}/cmake/Modules/")
+
+# Version is <major>.<minor>.<patch>
+cmake_policy(SET CMP0048 NEW) # Required for setting version number as part of the project() command
+project(MinGfx_Toolkit VERSION 1.0.0)
+
+# This will be appended to the install destinations so that multiple versions of MinGfx
+# can be safely installed on the same system. This intentionally does not include a
+# patch number because patches should be small changes that do not change the API.
+set(MINGFX_VERSION_STR -${MinGfx_Toolkit_VERSION_MAJOR}.${MinGfx_Toolkit_VERSION_MINOR})
+
+# Organize folder structure for Xcode, Visual Studio, etc.
+set_property(GLOBAL PROPERTY USE_FOLDERS ON)
+
+# For better formatting of output while configuring with cmake
+include(MessageMacros)
+
+# If you "autobuild" external dependencies as part of the cmake configure process, then they will be
+# downloaded to this directory.
+set(AUTOBUILD_DOWNLOAD_DIR "${CMAKE_CURRENT_SOURCE_DIR}/external" CACHE STRING "Location for external project sources downloaded by AutoBuild.")
+
+
+set(CMAKE_INSTALL_MESSAGE ALWAYS)
+
+include(AutoBuild)
+AutoBuild_init()
+
+
+#### ADJUST NAMES OF OUTPUT FILES BASED ON BUILD TYPE ####
+
+h1("CONFIGURING BUILD TYPES")
+
+# To distinguish between debugging, release, and other builds, we'll
+# add a postfix to the name of the lib or exe that we generate.
+
+set(CMAKE_DEBUG_POSTFIX "d")
+set(CMAKE_RELEASE_POSTFIX "")
+set(CMAKE_RELWITHDEBINFO_POSTFIX "rd")
+set(CMAKE_MINSIZEREL_POSTFIX "s")
+
+if (CMAKE_BUILD_TYPE MATCHES "Release")
+ set(CMAKE_BUILD_POSTFIX "${CMAKE_RELEASE_POSTFIX}")
+elseif (CMAKE_BUILD_TYPE MATCHES "MinSizeRel")
+ set(CMAKE_BUILD_POSTFIX "${CMAKE_MINSIZEREL_POSTFIX}")
+elseif (CMAKE_BUILD_TYPE MATCHES "RelWithDebInfo")
+ set(CMAKE_BUILD_POSTFIX "${CMAKE_RELWITHDEBINFO_POSTFIX}")
+elseif (CMAKE_BUILD_TYPE MATCHES "Debug")
+ set(CMAKE_BUILD_POSTFIX "${CMAKE_DEBUG_POSTFIX}")
+else()
+ set(CMAKE_BUILD_POSTFIX "")
+endif()
+
+
+
+
+#### SETUP DIRECTORIES FOR BUILDING AND INSTALLING ####
+
+h1("CONFIGURING BUILD/INSTALL LOCATIONS")
+
+h2("Configuring build directories.")
+
+message(STATUS "Tests, other binaries: ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}")
+message(STATUS "Libraries: ${CMAKE_LIBRARY_OUTPUT_DIRECTORY}")
+
+
+h2("Configuring installation directories.")
+if (CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
+ set (CMAKE_INSTALL_PREFIX "${CMAKE_BINARY_DIR}/install" CACHE PATH "default install path" FORCE )
+endif()
+
+# When we autobuild dependencies, we install them in CMAKE_INSTALL_PREFIX, and then look for them
+# there using find_package(). So, this makes sure the install prefix is in the path that
+# find_package() searches.
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_INSTALL_PREFIX})
+list(APPEND CMAKE_PREFIX_PATH ${CMAKE_INSTALL_PREFIX})
+
+# These are relative to ${CMAKE_INSTALL_PREFIX}
+set(INSTALL_BIN_DEST bin)
+set(INSTALL_LIB_DEST lib/MinGfx${MINGFX_VERSION_STR})
+set(INSTALL_INCLUDE_DEST include/MinGfx${MINGFX_VERSION_STR})
+set(INSTALL_SHADERS_DEST share/MinGfx${MINGFX_VERSION_STR}/shaders)
+set(INSTALL_DATA_DEST share/MinGfx${MINGFX_VERSION_STR}/data)
+set(INSTALL_DOC_DEST share/MinGfx${MINGFX_VERSION_STR}/docs)
+set(INSTALL_CMAKECONFIG_DEST lib/cmake/MinGfx${MINGFX_VERSION_STR})
+
+message(STATUS "Tests, other binaries: ${CMAKE_INSTALL_PREFIX}/${INSTALL_BIN_DEST}")
+message(STATUS "MinGfx library: ${CMAKE_INSTALL_PREFIX}/${INSTALL_LIB_DEST}")
+message(STATUS "MinGfx header files: ${CMAKE_INSTALL_PREFIX}/${INSTALL_INCLUDE_DEST}")
+message(STATUS "MinGfx shader programs: ${CMAKE_INSTALL_PREFIX}/${INSTALL_SHADERS_DEST}")
+message(STATUS "MinGfx data files: ${CMAKE_INSTALL_PREFIX}/${INSTALL_DATA_DEST}")
+message(STATUS "MinGfx documentation files: ${CMAKE_INSTALL_PREFIX}/${INSTALL_DOC_DEST}")
+message(STATUS "CMake Config Package for including MinGfx in other projects: ${CMAKE_INSTALL_PREFIX}/${INSTALL_CMAKECONFIG_DEST}")
+
+# Configure a header file to pass some of the CMake settings to the source code
+configure_file(
+ ${CMAKE_CURRENT_SOURCE_DIR}/src/mingfx_config.h.in
+ ${CMAKE_CURRENT_SOURCE_DIR}/src/mingfx_config.h
+)
+
+
+#### SET ANY COMPILER FLAGS ####
+
+h1("CONFIGURING COMPLIER FLAGS")
+
+
+
+message(STATUS "Building for " ${CMAKE_SYSTEM_NAME} ".")
+message(STATUS "Compiler supported features = ${CMAKE_CXX_COMPILE_FEATURES}")
+
+
+# Linux specific
+if (${CMAKE_SYSTEM_NAME} MATCHES "Linux")
+ add_definitions(-DLINUX)
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fPIC")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++14")
+endif()
+
+
+# Apple specific
+if (${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
+ add_definitions(-DOSX)
+
+ # Since for some stupid reason Apple has now deprecated OpenGL
+ #set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-deprecated")
+ add_definitions(-DGL_SILENCE_DEPRECATION)
+
+ # RPATH settings, see https://cmake.org/Wiki/CMake_RPATH_handling
+ set(CMAKE_MACOSX_RPATH ON)
+
+ # use, i.e. don't skip the full RPATH for the build tree
+ SET(CMAKE_SKIP_BUILD_RPATH FALSE)
+
+ # when building, don't use the install RPATH already
+ # (but later on when installing)
+ SET(CMAKE_BUILD_WITH_INSTALL_RPATH FALSE)
+
+ SET(CMAKE_INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib")
+
+ # add the automatically determined parts of the RPATH
+ # which point to directories outside the build tree to the install RPATH
+ SET(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
+
+ # the RPATH to be used when installing, but only if it's not a system directory
+ LIST(FIND CMAKE_PLATFORM_IMPLICIT_LINK_DIRECTORIES "${CMAKE_INSTALL_PREFIX}/lib" isSystemDir)
+ IF("${isSystemDir}" STREQUAL "-1")
+ SET(CMAKE_INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib")
+ ENDIF("${isSystemDir}" STREQUAL "-1")
+
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++14")
+endif()
+
+
+# Windows specific
+if (WIN32)
+ add_definitions(-DWIN32)
+ set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /Z7")
+endif()
+
+
+
+
+#### DEFINE THE LIBRARY WE WANT TO BUILD ####
+
+h1("CONFIGURING LIBMINGFX")
+
+h2("Configuring core library source.")
+message(STATUS "Adding src to the build.")
+
+# Intentionally using include() rather than add_subdirectory() so that the MinGfx target
+# is defined in the scope of this CMakeLists.txt file. That way, sudirs that depend
+# upon it can list it as a dependency.
+include(src/CMakeLists.txt)
+
+
+
+
+#### DEFINE ADDITIONAL BUILD TARGETS, LIKE TEST PROGRAMS, ETC. ####
+
+h1("CONFIGURING PROGRAMS AND DATA")
+
+h2("Cofiguring test programs.")
+message(STATUS "Adding all subirectories of tests to the build.")
+add_subdirectory(tests/blank_window)
+add_subdirectory(tests/gui_plus_opengl)
+
+
+h2("Cofiguring data.")
+message(STATUS "Identifying data to install.")
+install(
+ DIRECTORY data/
+ DESTINATION ${INSTALL_DATA_DEST}
+)
+
+
+
+#### OPTIONALLY, BUILD DOXYGEN-STYLE DOCUMENTATION ####
+
+h1("CONFIGURING DOCUMENTATION")
+
+h2("Configuring Web-Based Documentation.")
+option(WITH_DOCUMENTATION "Builds web-based documentation for the library. (Requires doxygen)")
+if (WITH_DOCUMENTATION)
+ message(STATUS "ON: Will build and install MinGfx Web-Based Documentation.")
+else()
+ message(STATUS "OFF: NOT building MinGfx Web-Based Documentation.")
+endif()
+
+if (WITH_DOCUMENTATION)
+ find_package(Doxygen)
+ if(NOT DOXYGEN_FOUND)
+ message(FATAL_ERROR "Doxygen is needed to build the documentation.")
+ endif()
+
+ set(DOXY_FILES
+ doc/Doxyfile.in
+ doc/api.md
+ doc/installation.md
+ doc/mainpage.md
+ doc/header.html
+ doc/index.html
+ doc/footer.html
+ doc/customdoxygen.css
+ )
+
+ set(OTHER_DOCS
+ README.md
+ LICENSE.txt
+ )
+
+ # Process the config file and put it in the build directory.
+ set(DOXYFILE_IN ${CMAKE_CURRENT_SOURCE_DIR}/doc/Doxyfile.in)
+ set(DOXYFILE ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
+ configure_file(${DOXYFILE_IN} ${DOXYFILE} @ONLY)
+
+ add_custom_target(doc ALL
+ ${DOXYGEN_EXECUTABLE} ${DOXYFILE}
+ DEPENDS ${DOXY_FILES} ${OTHER_DOCS}
+ SOURCES ${DOXY_FILES} ${OTHER_DOCS}
+ WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+ COMMENT "Generating documentation with Doxygen"
+ VERBATIM
+ )
+
+ set_source_files_properties(${DOXY_FILES} PROPERTIES HEADER_FILE_ONLY TRUE)
+ source_group("Doxygen Files" FILES ${DOXY_FILES})
+
+ set_source_files_properties(${OTHER_DOCS} PROPERTIES HEADER_FILE_ONLY TRUE)
+ source_group("Other Docs" FILES ${OTHER_DOCS})
+
+ install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html
+ DESTINATION ${INSTALL_DOC_DEST}
+ COMPONENT Docs
+ OPTIONAL
+ )
+
+ install(FILES doc/index.html
+ DESTINATION ${INSTALL_DOC_DEST}
+ COMPONENT Docs
+ OPTIONAL
+ )
+endif()
+
+
+
+
+
+#### CREATE/INSTALL A CMAKE CONFIG PACKAGE TO HELP OTHERS LINK TO THE LIBRARY ####
+
+h1("WRITING CMAKE CONFIG PACKAGE")
+
+# The documentation for setting this up is so bad. These pages all helped. My current
+# understanding (dfk) is summarized below to help others.
+# https://cmake.org/cmake/help/git-master/manual/cmake-packages.7.html#creating-packages
+# https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html#target-usage-requirements
+# http://foonathan.net/blog/2016/03/03/cmake-install.html
+# https://archive.fosdem.org/2013/schedule/event/moderncmake/attachments/slides/258/export/events/attachments/moderncmake/slides/258/cmake_fosdem_2013.pdf
+
+# CMake Package Config in a Nutshell:
+
+# CMake config packages are the newer, recommended way of distributing projects built with CMake.
+# They replace the older FindModule.cmake approach for including dependencies in a cmake project,
+# but not everyone has yet switched over to the new approach. Both styles can work together, and
+# this seems to often be required because many libraries are not yet distributing a *Config.cmake
+# file with their install tree.
+
+
+# 1. The Difference Between "Find Modules" (Find*.cmake) and "Config Packages" (*Config.cmake)
+
+# Whereas, Find*.cmake files are either installed on the system or written by downstream projects.
+# *Config.cmake files are created and installed by the upstream projects (e.g., we want generate
+# MinVRConfig.cmake and install it whenever the MinVR project in installed).
+
+# When you use a Find Module, it defines several variables (e.g., OPENGL_INCLUDE_DIR, OPENGL_LIBRARIES)
+# that you must then be sure to add to the include dirs and libs to link with your project.
+# Config Packages are different. Instead, they "export" the targets defined in the original project
+# (e.g., the target MinGfx is used in this file to build libMinGfx.a) so that the client project
+# may refer to these targets directly. This is pretty cool because we can define the MinGfx target
+# in such a way that cmake even knows which header files are associated with it, and will add the
+# required include flags whenever the MinGfx target is used.
+
+
+# 2. How to use Config Packages in a client CMakeLists.txt
+
+# With the config package appraoch, client projects only need to include two lines to use our library:
+
+# find_package(MinGfx REQUIRED)
+# ... then, after add_executable(${PROJECT_NAME}) or add_library(${PROJECT_NAME})
+# target_link_libraries(${PROJECT_NAME} PUBLIC MinGfx)
+
+
+# 3. Finding *Config.cmake files
+
+# Config packages are files of the form MyProjNameConfig.cmake (or *-config.cmake). Each library
+# provides and installs its own config package. So, here we will create one to install with MinGfx.
+# If created correctly, these packages can be relocatable, i.e., not specific to the install path
+# used on a particular machine. When you call find_package(...) cmake looks for packages in a
+# variety of locations (e.g., /usr/local/lib/cmake/*).
+
+# Since config packages are supposed to be written by and installed by the upstream dependencies,
+# my understanding is that you should not attempt to write you own version of a config package if
+# you encounter a project that is not (yet) using the config package appraoch. Instead, use the
+# older Find Module appraoch. If CMake ships with a Find*.cmake file for that project, then use
+# it. If not, then you can write your own. Since making this switch, many of the newer
+# Find*.cmake scripts that ship with CMake have been updated to support imported targets. They
+# are still called something like FindOpenGL.cmake, but in addition to just setting vars like
+# OPENGL_INCLUDE_DIR, they also define targets, such as OpenGL::GL. We use these when we can
+# because they are more robust. When you do target_link_libraries(myproj PULBIC OpenGL::GL)
+# cmake knows to not only link with the the opengl library but also to include its headers and
+# link with all dependencies.
+
+
+# This tells cmake to generate a MinGfxTargets.cmake file that works for importing all targets
+# associated with the MinGfx export group from the install tree. This file is where all the
+# important cmake magic happens. It is auto-generated. This call also installs the file to
+# the appropriate location.
+install(EXPORT MinGfxTargets
+ NAMESPACE MinGfx::
+ FILE MinGfxTargets.cmake
+ DESTINATION ${INSTALL_CMAKECONFIG_DEST}
+)
+
+# This is a very small wrapper around the MinGfxTargets.cmake file. It's possible to use this
+# configure_file() command to replace variables (e.g., special defines, install paths) in the
+# file, but we do not currently need that functionality.
+configure_file(
+ cmake/MinGfxConfig.cmake.in
+ "${CMAKE_CURRENT_BINARY_DIR}/cmake/MinGfxConfig.cmake"
+ COPYONLY
+)
+
+# This auto-generates a standard CMake config version file. Using this, client projects can
+# check to see if a specific version of MinGfx is installed on the system.
+include(CMakePackageConfigHelpers)
+set_property(TARGET MinGfx PROPERTY VERSION ${MinGfx_Toolkit_VERSION})
+write_basic_package_version_file(
+ "${CMAKE_CURRENT_BINARY_DIR}/cmake/MinGfxConfigVersion.cmake"
+ VERSION ${MinGfx_Toolkit_VERSION}
+ COMPATIBILITY AnyNewerVersion
+)
+
+# The two Config files also get installed
+install(
+ FILES
+ "${CMAKE_CURRENT_BINARY_DIR}/cmake/MinGfxConfig.cmake"
+ "${CMAKE_CURRENT_BINARY_DIR}/cmake/MinGfxConfigVersion.cmake"
+ DESTINATION
+ "${INSTALL_CMAKECONFIG_DEST}"
+)
+
+
+AutoBuild_check_status()
+