FindOpenGL

Модуль поиска OpenGL и OpenGL Utility Library (GLU).

Дополнительные КОМПОНЕНТЫ

Этот модуль учитывает несколько дополнительных КОМПОНЕНТОВ:

EGL

Интерфейс EGL между OpenGL, OpenGL ES и базовой системой окон.

GLX

Расширение X, которое обеспечивает взаимодействие OpenGL, OpenGL ES с системой окон X.

OpenGL

Платформенно-независимый API для 3D-графики.

GLES2

Добавлена в версии 3.27.

Подмножество API OpenGL для встроенных систем с ограниченными возможностями.

GLES3

Добавлена в версии 3.27.

Подмножество API OpenGL для встроенных систем с более широкими возможностями.

Импортируемые цели

Этот модуль определяет IMPORTED цели:

OpenGL::GL

Определяется для платформ-специфичных библиотек OpenGL, если система имеет OpenGL.

OpenGL::GLU

Определяется, если на системе имеется OpenGL Utility Library (GLU).

OpenGL::OpenGL

Определяется для libOpenGL, если система основана на GLVND.

OpenGL::GLX

Определяется, если система имеет расширение OpenGL для X Window System (GLX).

OpenGL::EGL

Определяется, если система имеет EGL.

OpenGL::GLES2

Добавлена в версии 3.27.

Определяется, если система имеет GLES2.

OpenGL::GLES3

Добавлена в версии 3.27.

Определяется, если система имеет GLES3.

Переменные результатов

Этот модуль устанавливает следующие переменные:

OPENGL_FOUND

Истина, если система имеет OpenGL и все компоненты найдены.

OPENGL_XMESA_FOUND

Истина, если система имеет XMESA.

OPENGL_GLU_FOUND

Истина, если система имеет GLU.

OpenGL_OpenGL_FOUND

Истина, если система имеет библиотеку OpenGL.

OpenGL_GLX_FOUND

Истина, если система имеет GLX.

OpenGL_EGL_FOUND

Истина, если система имеет EGL.

OpenGL::GLES2

Определяется, если система имеет GLES2.

OpenGL::GLES3

Определяется, если система имеет GLES3.

OPENGL_INCLUDE_DIR

Путь к каталогу заголовков OpenGL. Предпочтительна переменная OPENGL_INCLUDE_DIRS.

OPENGL_EGL_INCLUDE_DIRS

Путь к каталогу заголовков EGL.

OPENGL_LIBRARIES

Пути к библиотеке OpenGL, библиотекам системы окон и библиотекам GLU. На Linux это предполагает GLX и никогда не является корректным для целей, основанных на EGL. Клиентам рекомендуется использовать импортируемые цели OpenGL::* вместо этого.

OPENGL_INCLUDE_DIRS

Добавлена в версии 3.29.

Пути к каталогам заголовков OpenGL.

Переменные кэша

Также могут быть установлены следующие переменные кэша:

OPENGL_egl_LIBRARY

Путь к библиотеке EGL.

OPENGL_glu_LIBRARY

Путь к библиотеке GLU.

OPENGL_glx_LIBRARY

Путь к библиотеке GLVND 'GLX'.

OPENGL_opengl_LIBRARY

Путь к библиотеке GLVND 'OpenGL'.

OPENGL_gl_LIBRARY

Путь к библиотеке OpenGL. Новый код должен отдавать предпочтение импортируемым целям OpenGL::*.

OPENGL_gles2_LIBRARY

Добавлена в версии 3.27.

Путь к библиотеке OpenGL GLES2.

OPENGL_gles3_LIBRARY

Добавлена в версии 3.27.

Путь к библиотеке OpenGL GLES3.

OPENGL_GLU_INCLUDE_DIR

Добавлена в версии 3.29.

Путь к каталогу заголовков GLU OpenGL.

Специфичное для Linux

Некоторые системы Linux используют GLVND в качестве нового ABI для OpenGL. GLVND разделяет библиотеки контекстов от самого OpenGL; OpenGL находится в "libOpenGL", а контексты определяются в "libGLX" или "libEGL". GLVND в настоящее время является единственным способом получить функциональность OpenGL 3+ через EGL в формате, переносимом между поставщиками. Проекты могут явно использовать GLVND с помощью целевой библиотеки OpenGL::OpenGL и либо OpenGL::GLX, либо OpenGL::EGL.

Проекты могут использовать целевую библиотеку OpenGL::GL (или переменную OPENGL_LIBRARIES) для использования устаревших интерфейсов GL. Они будут использовать устаревшую библиотеку GL, расположенную по адресу OPENGL_gl_LIBRARY, если она доступна. Если OPENGL_gl_LIBRARY пустая или не найдена, а GLVND доступен, целевая библиотека OpenGL::GL будет использовать GLVND OpenGL::OpenGL и OpenGL::GLX (а переменная OPENGL_LIBRARIES будет использовать соответствующие библиотеки). Таким образом, для целей Linux, не основанных на EGL, целевая библиотека OpenGL::GL является наиболее переносимой.

Переменная OpenGL_GL_PREFERENCE может быть установлена для указания предпочтительного способа предоставления устаревших интерфейсов GL в случае наличия нескольких вариантов. Значение может быть одним из:

GLVND

Если библиотеки GLVND OpenGL и GLX доступны, отдавать предпочтение им. Это принудительно делает OPENGL_gl_LIBRARY пустой.

Изменено в версии 3.11: Это значение по умолчанию, если политика CMP0072 установлена на OLD, и не запрошены какие-либо компоненты (поскольку компоненты соответствуют библиотекам GLVND).

LEGACY

Отдавать предпочтение использованию устаревшей библиотеки libGL, если она доступна.

Для целей EGL клиент должен полагаться на поддержку GLVND в системе пользователя. Подключение должно использовать целевые библиотеки OpenGL::OpenGL OpenGL::EGL. Использование библиотек GLES* теоретически возможно вместо OpenGL::OpenGL, но этот модуль в настоящее время эту функцию не поддерживает; приветствуются предложения по улучшению.

OPENGL_egl_LIBRARY и OPENGL_EGL_INCLUDE_DIRS определены в случае GLVND. Для Linux, не использующего GLVND, и других систем они остаются неопределенными.

Специфичное для macOS

В macOS этот модуль по умолчанию использует версию OpenGL из встроенного набора macOS. Чтобы использовать версию OpenGL X11 на macOS, можно отключить поиск фреймворков. Например:

find_package(X11)
if(APPLE AND X11_FOUND)
  set(CMAKE_FIND_FRAMEWORK NEVER)
  find_package(OpenGL)
  unset(CMAKE_FIND_FRAMEWORK)
else()
  find_package(OpenGL)
endif()

Конечный пользователь, собирающий этот проект, может потребоваться указать CMake свой установленный X11, например, с помощью -DOpenGL_ROOT=/opt/X11.