FindSDL
Определение расположения библиотеки SDL
Импортированные целевые объекты
Новая в версии 3.19.
Этот модуль определяет следующие 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
Новая в версии 3.19: Добавлены переменные SDL_INCLUDE_DIRS, SDL_LIBRARIES и SDL_VERSION[_<PART>].
Переменные кэша
Эти переменные могут быть необязательно установлены, чтобы помочь этому модулю найти правильные файлы:
-
SDL_INCLUDE_DIR -
Расположение SDL.h
-
SDL_LIBRARY -
Имя библиотеки для линковки
Переменные для поиска SDL
Этот модуль реагирует на флаг:
-
SDL_BUILDING_LIBRARY -
Если он определен, то SDL_main не будет включен в ссылку, потому что только приложениям нужен main(). В противном случае предполагается, что вы создаёте приложение, и этот модуль попытается найти и установить соответствующие флаги линковки как часть возвращаемой переменной SDL_LIBRARY.
Устаревшие переменные
Устарело начиная с версии 3.19.
Эти переменные устарели и предоставлены для обратной совместимости:
-
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 этот модуль отдаёт предпочтение версии Framework (если она найдена) перед другими. Пользователям потребуется вручную изменить значения кэша SDL_LIBRARY, чтобы переопределить этот выбор, или установить переменную окружения CMake CMAKE_INCLUDE_PATH для изменения путей поиска.
Обратите внимание, что путь к заголовкам изменился с SDL/SDL.h на просто SDL.h. Это необходимо изменить, так как правильная конвенция SDL — #include "SDL.h", а не <SDL/SDL.h>. Это делается для обеспечения переносимости, так как не все системы размещают файлы в SDL/ (см. FreeBSD).
© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.21/module/FindSDL.html