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).