FindSDL

Определение библиотеки SDL

Импортированные цели

Этот модуль определяет следующую IMPORTED цель:

SDL::SDL

Библиотека SDL, если найдена

Переменные результатов

Этот модуль установит следующие переменные в вашем проекте:

SDL_INCLUDE_DIRS

путь к SDL.h

SDL_LIBRARIES

имя библиотеки для линковки

SDL_FOUND

если ложь, не пытаться линковать к SDL

SDL_VERSION

строка, содержащая версию SDL, если найдена

SDL_VERSION_MAJOR

главная версия SDL

SDL_VERSION_MINOR

вторая версия SDL

SDL_VERSION_PATCH

поправочная версия SDL

Переменные кэша

Эти переменные могут быть опционально установлены для помощи этому модулю в поиске правильных файлов:

SDL_INCLUDE_DIR

путь к SDL.h

SDL_LIBRARY

имя библиотеки для линковки

Переменные для определения местоположения SDL

Этот модуль реагирует на флаг:

SDL_BUILDING_LIBRARY

Если это определено, то SDL_main не будет линковаться, поскольку только приложениям нужен main(). В противном случае предполагается, что вы создаете приложение, и этот модуль попытается найти и установить правильные флаги линковки в качестве части возвращаемой переменной SDL_LIBRARY.

Устаревшие переменные

Эти переменные устарели и предоставлены для обратной совместимости:

SDL_VERSION_STRING

человекопонятная строка, содержащая версию SDL, если найдена. Идентично SDL_VERSION

Не забудьте включить SDLmain.h и SDLmain.m в свой проект для версии фреймворка OS X. (Другие версии линкованы с -lSDLmain, которую этот модуль попытается найти за вас.) Также для OS X этот модуль автоматически добавит -framework Cocoa.

Дополнительная заметка: Если вы видите пустую SDL_LIBRARY_TEMP в своей конфигурации и нет SDL_LIBRARY, это означает, что CMake не нашел вашу библиотеку SDL (SDL.dll, libsdl.so, SDL.framework и т. д.). Установите SDL_LIBRARY_TEMP, чтобы указать на вашу библиотеку SDL, и снова выполните конфигурацию. Аналогично, если вы видите пустую SDLMAIN_LIBRARY, вы должны установить это значение соответственно. Эти значения используются для генерации окончательной переменной SDL_LIBRARY, но когда эти значения не установлены, SDL_LIBRARY не создается.

$SDLDIR — это переменная среды, которая соответствует ./configure --prefix=$SDLDIR, используемой при построении SDL. l.e.galup 9-20-02

В OSX этот модуль будет отдавать предпочтение версии фреймворка (если она найдена) перед другими. Пользователям придётся вручную изменить значения кеша SDL_LIBRARY, чтобы переопределить этот выбор, или установить переменную среды CMake CMAKE_INCLUDE_PATH, чтобы изменить пути поиска.

Обратите внимание, что путь к заголовку изменился с SDL/SDL.h на просто SDL.h. Это изменение необходимо из-за «правильного» соглашения SDL: #include "SDL.h", а не <SDL/SDL.h>. Это сделано для обеспечения портативности, поскольку не все системы размещают файлы в SDL/ (см. FreeBSD).