3 # SDL2_LIBRARY, the name of the library to link against
4 # SDL2_FOUND, if false, do not try to link to SDL2
5 # SDL2_INCLUDE_DIR, where to find SDL.h
7 # This module responds to the the flag:
8 # SDL2_BUILDING_LIBRARY
9 # If this is defined, then no SDL2main will be linked in because
10 # only applications need main().
11 # Otherwise, it is assumed you are building an application and this
12 # module will attempt to locate and set the the proper link flags
13 # as part of the returned SDL2_LIBRARY variable.
15 # Don't forget to include SDLmain.h and SDLmain.m your project for the
16 # OS X framework based version. (Other versions link to -lSDL2main which
17 # this module will try to find on your behalf.) Also for OS X, this
18 # module will automatically add the -framework Cocoa on your behalf.
21 # Additional Note: If you see an empty SDL2_LIBRARY_TEMP in your configuration
22 # and no SDL2_LIBRARY, it means CMake did not find your SDL2 library
23 # (SDL2.dll, libsdl2.so, SDL2.framework, etc).
24 # Set SDL2_LIBRARY_TEMP to point to your SDL2 library, and configure again.
25 # Similarly, if you see an empty SDL2MAIN_LIBRARY, you should set this value
26 # as appropriate. These values are used to generate the final SDL2_LIBRARY
27 # variable, but when these values are unset, SDL2_LIBRARY does not get created.
30 # $SDL2DIR is an environment variable that would
31 # correspond to the ./configure --prefix=$SDL2DIR
32 # used in building SDL2.
35 # Modified by Eric Wing.
36 # Added code to assist with automated building by using environmental variables
37 # and providing a more controlled/consistent search behavior.
38 # Added new modifications to recognize OS X frameworks and
39 # additional Unix paths (FreeBSD, etc).
40 # Also corrected the header search path to follow "proper" SDL guidelines.
41 # Added a search for SDL2main which is needed by some platforms.
42 # Added a search for threads which is needed by some platforms.
43 # Added needed compile switches for MinGW.
45 # On OSX, this will prefer the Framework version (if found) over others.
46 # People will have to manually change the cache values of
47 # SDL2_LIBRARY to override this selection or set the CMake environment
48 # CMAKE_INCLUDE_PATH to modify the search paths.
50 # Note that the header path has changed from SDL2/SDL.h to just SDL.h
51 # This needed to change because "proper" SDL convention
52 # is #include "SDL.h", not <SDL2/SDL.h>. This is done for portability
53 # reasons because not all systems place things in SDL2/ (see FreeBSD).
55 #=============================================================================
56 # Copyright 2003-2009 Kitware, Inc.
58 # Distributed under the OSI-approved BSD License (the "License");
59 # see accompanying file Copyright.txt for details.
61 # This software is distributed WITHOUT ANY WARRANTY; without even the
62 # implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
63 # See the License for more information.
64 #=============================================================================
65 # (To distribute this file outside of CMake, substitute the full
66 # License text for the above reference.)
68 # message("<FindSDL2.cmake>")
76 /opt/local # DarwinPorts
82 FIND_PATH(SDL2_INCLUDE_DIR SDL.h
85 PATH_SUFFIXES include/SDL2 include
86 PATHS ${SDL2_SEARCH_PATHS}
89 if(CMAKE_SIZEOF_VOID_P EQUAL 8)
90 set(PATH_SUFFIXES lib64 lib/x64 lib)
92 set(PATH_SUFFIXES lib/x86 lib)
95 FIND_LIBRARY(SDL2_LIBRARY_TEMP
99 PATH_SUFFIXES ${PATH_SUFFIXES}
100 PATHS ${SDL2_SEARCH_PATHS}
103 IF(NOT SDL2_BUILDING_LIBRARY)
104 IF(NOT ${SDL2_INCLUDE_DIR} MATCHES ".framework")
105 # Non-OS X framework versions expect you to also dynamically link to
106 # SDL2main. This is mainly for Windows and OS X. Other (Unix) platforms
107 # seem to provide SDL2main for compatibility even though they don't
108 # necessarily need it.
109 FIND_LIBRARY(SDL2MAIN_LIBRARY
113 PATH_SUFFIXES ${PATH_SUFFIXES}
114 PATHS ${SDL2_SEARCH_PATHS}
116 ENDIF(NOT ${SDL2_INCLUDE_DIR} MATCHES ".framework")
117 ENDIF(NOT SDL2_BUILDING_LIBRARY)
119 # SDL2 may require threads on your system.
120 # The Apple build may not need an explicit flag because one of the
121 # frameworks may already provide it.
122 # But for non-OSX systems, I will use the CMake Threads package.
124 FIND_PACKAGE(Threads)
127 # MinGW needs an additional link flag, -mwindows
128 # It's total link flags should look like -lmingw32 -lSDL2main -lSDL2 -mwindows
130 SET(MINGW32_LIBRARY mingw32 "-mwindows" CACHE STRING "mwindows for MinGW")
133 IF(SDL2_LIBRARY_TEMP)
135 IF(NOT SDL2_BUILDING_LIBRARY)
137 SET(SDL2_LIBRARY_TEMP ${SDL2MAIN_LIBRARY} ${SDL2_LIBRARY_TEMP})
138 ENDIF(SDL2MAIN_LIBRARY)
139 ENDIF(NOT SDL2_BUILDING_LIBRARY)
141 # For OS X, SDL2 uses Cocoa as a backend so it must link to Cocoa.
142 # CMake doesn't display the -framework Cocoa string in the UI even
143 # though it actually is there if I modify a pre-used variable.
144 # I think it has something to do with the CACHE STRING.
145 # So I use a temporary variable until the end so I can set the
146 # "real" variable in one-shot.
148 SET(SDL2_LIBRARY_TEMP ${SDL2_LIBRARY_TEMP} "-framework Cocoa")
151 # For threads, as mentioned Apple doesn't need this.
152 # In fact, there seems to be a problem if I used the Threads package
153 # and try using this line, so I'm just skipping it entirely for OS X.
155 SET(SDL2_LIBRARY_TEMP ${SDL2_LIBRARY_TEMP} ${CMAKE_THREAD_LIBS_INIT})
160 SET(SDL2_LIBRARY_TEMP ${MINGW32_LIBRARY} ${SDL2_LIBRARY_TEMP})
163 # Set the final string here so the GUI reflects the final state.
164 SET(SDL2_LIBRARY ${SDL2_LIBRARY_TEMP} CACHE STRING "Where the SDL2 Library can be found")
165 # Set the temp variable to INTERNAL so it is not seen in the CMake GUI
166 SET(SDL2_LIBRARY_TEMP "${SDL2_LIBRARY_TEMP}" CACHE INTERNAL "")
167 ENDIF(SDL2_LIBRARY_TEMP)
169 # message("</FindSDL2.cmake>")
171 INCLUDE(FindPackageHandleStandardArgs)
173 FIND_PACKAGE_HANDLE_STANDARD_ARGS(SDL2 REQUIRED_VARS SDL2_LIBRARY SDL2_INCLUDE_DIR)