Spec-Zone.ru › CMake 3.12

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

© 2000–2019 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.12/module/FindSDL_sound.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API