FindOpenAL.cmake 4.03 KB
Newer Older
1 2 3
#.rst:
# FindOpenAL
# ----------
4 5
#
#
6 7 8 9 10 11 12 13 14 15
#
# Locate OpenAL This module defines OPENAL_LIBRARY OPENAL_FOUND, if
# false, do not try to link to OpenAL OPENAL_INCLUDE_DIR, where to find
# the headers
#
# $OPENALDIR is an environment variable that would correspond to the
# ./configure --prefix=$OPENALDIR used in building OpenAL.
#
# Created by Eric Wing.  This was influenced by the FindSDL.cmake
# module.
16

17 18 19 20 21 22 23 24 25 26
#=============================================================================
# Copyright 2005-2009 Kitware, Inc.
#
# Distributed under the OSI-approved BSD License (the "License");
# see accompanying file Copyright.txt for details.
#
# This software is distributed WITHOUT ANY WARRANTY; without even the
# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# See the License for more information.
#=============================================================================
27
# (To distribute this file outside of CMake, substitute the full
28 29
#  License text for the above reference.)

30 31
# This makes the presumption that you are include al.h like
# #include "al.h"
32
# and not
33 34
# #include <AL/al.h>
# The reason for this is that the latter is not entirely portable.
35
# Windows/Creative Labs does not by default put their headers in AL/ and
36
# OS X uses the convention <OpenAL/al.h>.
37 38
#
# For Windows, Creative Labs seems to have added a registry key for their
39
# OpenAL 1.1 installer. I have added that key to the list of search paths,
40
# however, the key looks like it could be a little fragile depending on
41 42 43
# if they decide to change the 1.00.0000 number for bug fix releases.
# Also, they seem to have laid down groundwork for multiple library platforms
# which puts the library in an extra subdirectory. Currently there is only
44
# Win32 and I have hardcoded that here. This may need to be adjusted as
45 46 47
# platforms are introduced.
# The OpenAL 1.0 installer doesn't seem to have a useful key I can use.
# I do not know if the Nvidia OpenAL SDK has a registry key.
48 49 50
#
# For OS X, remember that OpenAL was added by Apple in 10.4 (Tiger).
# To support the framework, I originally wrote special framework detection
51 52
# code in this module which I have now removed with CMake's introduction
# of native support for frameworks.
53 54
# In addition, OpenAL is open source, and it is possible to compile on Panther.
# Furthermore, due to bugs in the initial OpenAL release, and the
55
# transition to OpenAL 1.1, it is common to need to override the built-in
56
# framework.
57 58 59 60 61 62 63
# Per my request, CMake should search for frameworks first in
# the following order:
# ~/Library/Frameworks/OpenAL.framework/Headers
# /Library/Frameworks/OpenAL.framework/Headers
# /System/Library/Frameworks/OpenAL.framework/Headers
#
# On OS X, this will prefer the Framework version (if found) over others.
64
# People will have to manually change the cache values of
65 66 67
# OPENAL_LIBRARY to override this selection or set the CMake environment
# CMAKE_INCLUDE_PATH to modify the search paths.

68
find_path(OPENAL_INCLUDE_DIR al.h
69
  HINTS
70
    ENV OPENALDIR
71 72 73 74 75 76 77 78 79 80
  PATH_SUFFIXES include/AL include/OpenAL include
  PATHS
  ~/Library/Frameworks
  /Library/Frameworks
  /sw # Fink
  /opt/local # DarwinPorts
  /opt/csw # Blastwave
  /opt
  [HKEY_LOCAL_MACHINE\\SOFTWARE\\Creative\ Labs\\OpenAL\ 1.1\ Software\ Development\ Kit\\1.00.0000;InstallDir]
)
81

82 83 84 85 86 87
if(CMAKE_SIZEOF_VOID_P EQUAL 8)
  set(_OpenAL_ARCH_DIR libs/Win64)
else()
  set(_OpenAL_ARCH_DIR libs/Win32)
endif()

88
find_library(OPENAL_LIBRARY
89
  NAMES OpenAL al openal OpenAL32
90
  HINTS
91
    ENV OPENALDIR
92
  PATH_SUFFIXES lib64 lib libs64 libs ${_OpenAL_ARCH_DIR}
93 94 95 96 97 98 99 100 101
  PATHS
  ~/Library/Frameworks
  /Library/Frameworks
  /sw
  /opt/local
  /opt/csw
  /opt
  [HKEY_LOCAL_MACHINE\\SOFTWARE\\Creative\ Labs\\OpenAL\ 1.1\ Software\ Development\ Kit\\1.00.0000;InstallDir]
)
102

103
unset(_OpenAL_ARCH_DIR)
104

105 106
# handle the QUIETLY and REQUIRED arguments and set OPENAL_FOUND to TRUE if
# all listed variables are TRUE
107
include(${CMAKE_CURRENT_LIST_DIR}/FindPackageHandleStandardArgs.cmake)
108
FIND_PACKAGE_HANDLE_STANDARD_ARGS(OpenAL  DEFAULT_MSG  OPENAL_LIBRARY OPENAL_INCLUDE_DIR)
109

110
mark_as_advanced(OPENAL_LIBRARY OPENAL_INCLUDE_DIR)