FindSDL_sound
Определяет библиотеку SDL_sound
Этот модуль зависит от обнаружения SDL и должен вызываться ПОСЛЕ вызова FindSDL.cmake.
Этот модуль определяет
SDL_SOUND_INCLUDE_DIR, where to find SDL_sound.h SDL_SOUND_FOUND, if false, do not try to link to SDL_sound SDL_SOUND_LIBRARIES, this contains the list of libraries that you need to link against. This is a read-only variable and is marked INTERNAL. SDL_SOUND_EXTRAS, this is an optional variable for you to add your own flags to SDL_SOUND_LIBRARIES. This is prepended to SDL_SOUND_LIBRARIES. This is available mostly for cases this module failed to anticipate for and you must add additional flags. This is marked as ADVANCED. SDL_SOUND_VERSION_STRING, human-readable string containing the version of SDL_sound
Этот модуль также определяет (но вам, вероятно, не нужно использовать напрямую)
SDL_SOUND_LIBRARY, the name of just the SDL_sound library you would link against. Use SDL_SOUND_LIBRARIES for you link instructions and not this one.
И может определять следующие переменные по необходимости
MIKMOD_LIBRARY MODPLUG_LIBRARY OGG_LIBRARY VORBIS_LIBRARY SMPEG_LIBRARY FLAC_LIBRARY SPEEX_LIBRARY
Как правило, вы не должны использовать эти переменные напрямую, и вы должны использовать SDL_SOUND_LIBRARIES, которое содержит SDL_SOUND_LIBRARY и другие библиотеки аудио (если необходимо), чтобы успешно скомпилировать на вашей системе.
Создан Эриком Вингом. Этот модуль немного сложнее, чем другие модули семейства FindSDL*. Причина в том, что SDL_sound может быть скомпилирован различными способами, независимыми от платформы. SDL_sound может динамически связываться с другими библиотеками сторонних разработчиков для получения дополнительной поддержки кодеков, таких как Ogg Vorbis, SMPEG, ModPlug, MikMod, FLAC, Speex и потенциально другие. В некоторых случаях, которые мне не до конца понятны, кажется, требуется, чтобы зависимые библиотеки используемых библиотек также были явно связаны для успешной компиляции. SDL_sound в настоящее время не имеет системы, которая позволяла бы знать, как он был скомпилирован. Таким образом, этот модуль CMake выполняет сложную работу по попытке определить, какие библиотеки сторонних разработчиков необходимы для сборки (если таковые имеются). Этот модуль использует грубый подход для создания тестовой программы, которая использует SDL_sound, а затем пытается её скомпилировать. Если сборка завершается ошибкой, он анализирует вывод ошибки на предмет известных имен символов, чтобы определить, какие библиотеки необходимы.
Откликается на переменные окружения $SDLDIR и $SDLSOUNDDIR, которые соответствовали бы ./configure –prefix=$SDLDIR, используемому при построении SDL.
В OSX этот модуль отдаёт предпочтение версии Framework (если найдена) перед другими. Пользователи должны вручную изменить значения кеша SDL_LIBRARY, чтобы переопределить этот выбор, или установить переменную среды CMake CMAKE_INCLUDE_PATH для изменения путей поиска.
© 2000–2019 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.6/module/FindSDL_sound.html