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.
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 для изменения путей поиска.