cmake/FindSDL2.cmake

   1 # - Locate SDL2 library (modified from CMake's FindSDL.cmake)
   2 # This module defines
   3 #  SDL2_LIBRARY, the name of the library to link against
   4 #  SDL2_FOUND, if false, do not try to link to SDL
   5 #  SDL2_INCLUDE_DIR, where to find SDL.h
   6 #  SDL2_VERSION_STRING, human-readable string containing the version of SDL2
   7 #
   8 # This module responds to the the flag:
   9 #  SDL2_BUILDING_LIBRARY
  10 #    If this is defined, then no SDL_main will be linked in because
  11 #    only applications need main().
  12 #    Otherwise, it is assumed you are building an application and this
  13 #    module will attempt to locate and set the the proper link flags
  14 #    as part of the returned SDL2_LIBRARY variable.
  15 #
  16 # Additional Note: If you see an empty SDL2_LIBRARY_TEMP in your configuration
  17 # and no SDL2_LIBRARY, it means CMake did not find your SDL2 library
  18 # (SDL2.dll, libsdl2.so, SDL2.framework, etc).
  19 # Set SDL2_LIBRARY_TEMP to point to your SDL2 library, and configure again.
  20 # Similarly, if you see an empty SDL2MAIN_LIBRARY, you should set this value
  21 # as appropriate. These values are used to generate the final SDL2_LIBRARY
  22 # variable, but when these values are unset, SDL2_LIBRARY does not get created.
  23 #
  24 #
  25 # $SDL2DIR is an environment variable that would
  26 # correspond to the ./configure --prefix=$SDL2DIR
  27 # used in building SDL.
  28 #
  29
  30 #=============================================================================
  31 # Copyright 2014 Justin Jacobs
  32 #
  33 # Distributed under the OSI-approved BSD License (the "License");
  34 # see accompanying file Copyright.txt for details.
  35 #
  36 # This software is distributed WITHOUT ANY WARRANTY; without even the
  37 # implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  38 # See the License for more information.
  39 #=============================================================================
  40
  41 if(EMSCRIPTEN)
  42   set(SDL2_LIBRARY "nul" CACHE STRING "emscripten override" FORCE)
  43   set(SDL2_INCLUDE_DIR "${CMAKE_SYSTEM_INCLUDE_PATH}/SDL2" CACHE STRING "emscripten override" FORCE)
  44 else()
  45   find_path(SDL2_INCLUDE_DIR SDL.h
  46     HINTS
  47       "${SDL2DIR}"
  48         ENV SDL2DIR
  49         PATH_SUFFIXES include/SDL2 include
  50   )
  51
  52   if(CMAKE_SIZEOF_VOID_P EQUAL 8)
  53     set(VC_LIB_PATH_SUFFIX lib/x64)
  54   else()
  55     set(VC_LIB_PATH_SUFFIX lib/x86)
  56
  57   find_library(SDL2_LIBRARY_TEMP
  58     NAMES SDL2
  59     HINTS
  60       "${SDL2DIR}"
  61           ENV SDL2DIR
  62     PATH_SUFFIXES lib "${VC_LIB_PATH_SUFFIX}"
  63 endif()
  64
  65 if(NOT SDL2_BUILDING_LIBRARY)
  66   if(NOT ${SDL2_INCLUDE_DIR} MATCHES ".framework")
  67         # Non-OS X framework versions expect you to also dynamically link to
  68         # SDLmain. This is mainly for Windows and OS X. Other (Unix) platforms
  69         # seem to provide SDLmain for compatibility even though they don't
  70         # necessarily need it.
  71         find_library(SDL2MAIN_LIBRARY
  72           NAMES SDL2main
  73           HINTS
  74             "${SDL2DIR}"
  75                 ENV SDL2DIR
  76           PATH_SUFFIXES lib "${VC_LIB_PATH_SUFFIX}"
  77           PATHS
  78           /sw
  79           /opt/local
  80           /opt/csw
  81           /opt
  82         )
  83   endif()
  84 endif()
  85
  86 # SDL2 may require threads on your system.
  87 # The Apple build may not need an explicit flag because one of the
  88 # frameworks may already provide it.
  89 # But for non-OSX systems, I will use the CMake Threads package.
  90 if(NOT APPLE)
  91   find_package(Threads)
  92 endif()
  93
  94 # MinGW needs an additional library, mwindows
  95 # It's total link flags should look like -lmingw32 -lSDLmain -lSDL -lmwindows
  96 # (Actually on second look, I think it only needs one of the m* libraries.)
  97 if(MINGW)
  98   set(MINGW32_LIBRARY mingw32 CACHE STRING "mwindows for MinGW")
  99 endif()
 100
 101 if(SDL2_LIBRARY_TEMP)
 102   # For SDLmain
 103   if(SDL2MAIN_LIBRARY AND NOT SDL2_BUILDING_LIBRARY)
 104         list(FIND SDL2_LIBRARY_TEMP "${SDL2MAIN_LIBRARY}" _SDL2_MAIN_INDEX)
 105         if(_SDL2_MAIN_INDEX EQUAL -1)
 106           set(SDL2_LIBRARY_TEMP "${SDL2MAIN_LIBRARY}" ${SDL2_LIBRARY_TEMP})
 107         endif()
 108         unset(_SDL2_MAIN_INDEX)
 109   endif()
 110
 111   # For OS X, SDL uses Cocoa as a backend so it must link to Cocoa.
 112   # CMake doesn't display the -framework Cocoa string in the UI even
 113   # though it actually is there if I modify a pre-used variable.
 114   # I think it has something to do with the CACHE STRING.
 115   # So I use a temporary variable until the end so I can set the
 116   # "real" variable in one-shot.
 117   if(APPLE)
 118         set(SDL2_LIBRARY_TEMP ${SDL2_LIBRARY_TEMP} "-framework Cocoa")
 119   endif()
 120
 121   # For threads, as mentioned Apple doesn't need this.
 122   # In fact, there seems to be a problem if I used the Threads package
 123   # and try using this line, so I'm just skipping it entirely for OS X.
 124   if(NOT APPLE)
 125         set(SDL2_LIBRARY_TEMP ${SDL2_LIBRARY_TEMP} ${CMAKE_THREAD_LIBS_INIT})
 126   endif()
 127
 128   # For MinGW library
 129   if(MINGW)
 130         set(SDL2_LIBRARY_TEMP ${MINGW32_LIBRARY} ${SDL2_LIBRARY_TEMP})
 131   endif()
 132
 133   # Set the final string here so the GUI reflects the final state.
 134   set(SDL2_LIBRARY ${SDL2_LIBRARY_TEMP} CACHE STRING "Where the SDL2 Library can be found")
 135   # Set the temp variable to INTERNAL so it is not seen in the CMake GUI
 136   set(SDL2_LIBRARY_TEMP "${SDL2_LIBRARY_TEMP}" CACHE INTERNAL "")
 137 endif()
 138
 139 if(SDL2_INCLUDE_DIR AND EXISTS "${SDL2_INCLUDE_DIR}/SDL_version.h")
 140   file(STRINGS "${SDL2_INCLUDE_DIR}/SDL_version.h" SDL2_VERSION_MAJOR_LINE REGEX "^#define[ \t]+SDL_MAJOR_VERSION[ \t]+[0-9]+$")
 141   file(STRINGS "${SDL2_INCLUDE_DIR}/SDL_version.h" SDL2_VERSION_MINOR_LINE REGEX "^#define[ \t]+SDL_MINOR_VERSION[ \t]+[0-9]+$")
 142   file(STRINGS "${SDL2_INCLUDE_DIR}/SDL_version.h" SDL2_VERSION_PATCH_LINE REGEX "^#define[ \t]+SDL_PATCHLEVEL[ \t]+[0-9]+$")
 143   string(REGEX REPLACE "^#define[ \t]+SDL_MAJOR_VERSION[ \t]+([0-9]+)$" "\\1" SDL2_VERSION_MAJOR "${SDL2_VERSION_MAJOR_LINE}")
 144   string(REGEX REPLACE "^#define[ \t]+SDL_MINOR_VERSION[ \t]+([0-9]+)$" "\\1" SDL2_VERSION_MINOR "${SDL2_VERSION_MINOR_LINE}")
 145   string(REGEX REPLACE "^#define[ \t]+SDL_PATCHLEVEL[ \t]+([0-9]+)$" "\\1" SDL2_VERSION_PATCH "${SDL2_VERSION_PATCH_LINE}")
 146   set(SDL2_VERSION_STRING ${SDL2_VERSION_MAJOR}.${SDL2_VERSION_MINOR}.${SDL2_VERSION_PATCH})
 147   unset(SDL2_VERSION_MAJOR_LINE)
 148   unset(SDL2_VERSION_MINOR_LINE)
 149   unset(SDL2_VERSION_PATCH_LINE)
 150   unset(SDL2_VERSION_MAJOR)
 151   unset(SDL2_VERSION_MINOR)
 152   unset(SDL2_VERSION_PATCH)
 153 endif()
 154
 155 include(FindPackageHandleStandardArgs)
 156
 157 FIND_PACKAGE_HANDLE_STANDARD_ARGS(SDL2
 158                                                                   REQUIRED_VARS SDL2_LIBRARY SDL2_INCLUDE_DIR
 159                                                                   VERSION_VAR SDL2_VERSION_STRING)
 160