mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-05 21:31:08 -06:00
Code Issues Packages Projects Releases Wiki Activity

Merge topic 'patch-FindGLUT'

Browse Source 
eecc3d545b FindGLUT: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10686
This commit is contained in:
Brad King
2025-04-22 13:11:48 +00:00
committed by Kitware Robot
parent 18e07af049 eecc3d545b
commit 58c1683f8d
1 changed files with 28 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
Modules/FindGLUT.cmake
View File

@@ -5,17 +5,18 @@
FindGLUT
--------
Find OpenGL Utility Toolkit (GLUT) library and include files.
Finds the OpenGL Utility Toolkit (GLUT) library, which provides a simple API for
creating windows, handling input, and managing events in OpenGL applications.
Imported Targets
^^^^^^^^^^^^^^^^
.. versionadded:: 3.1
This module defines the :prop_tgt:`IMPORTED` targets:
This module provides the following :ref:`Imported Targets`:
``GLUT::GLUT``
Defined if the system has GLUT.
.. versionadded:: 3.1
Target encapsulating the GLUT usage requirements, available if GLUT is found.
Result Variables
^^^^^^^^^^^^^^^^
@@ -23,45 +24,48 @@ Result Variables
This module defines the following variables:
``GLUT_FOUND``
True if ``glut`` was found.
Boolean indicating whether GLUT is found.
``GLUT_INCLUDE_DIRS``
.. versionadded:: 3.23
Where to find GL/glut.h, etc.
Include directories needed to use GLUT. Starting with CMake 3.23, this
variable is intended to be used in target usage requirements instead of the
cache variable ``GLUT_INCLUDE_DIR``, which is intended for finding GLUT.
``GLUT_LIBRARIES``
List of libraries for using ``glut``.
List of libraries needed to link against for using GLUT.
Cache Variables
^^^^^^^^^^^^^^^
This module may set the following variables depending on platform.
This module may set the following cache variables depending on platform.
These variables may optionally be set to help this module find the
correct files, but clients should not use these as results:
correct files, but should not be used as result variables:
``GLUT_INCLUDE_DIR``
The full path to the directory containing ``GL/glut.h``,
not including ``GL/``.
The full path to the directory containing ``GL/glut.h`` (without the ``GL/``).
``GLUT_glut_LIBRARY``
The full path to the glut library.
``GLUT_Xmu_LIBRARY``
The full path to the Xmu library.
The full path to the ``glut`` library.
``GLUT_Xi_LIBRARY``
The full path to the Xi Library.
The full path to the dependent ``Xi`` (X Input Device Extension) library on
some systems.
Obsolete Variables
^^^^^^^^^^^^^^^^^^
``GLUT_Xmu_LIBRARY``
The full path to the dependent ``Xmu`` (X Miscellaneous Utilities) library on
some systems.
The following variables may also be provided, for backwards compatibility:
Examples
^^^^^^^^
``GLUT_INCLUDE_DIR``
This is one of above `Cache Variables`_, but prior to CMake 3.23 was
also a result variable. Prefer to use ``GLUT_INCLUDE_DIRS`` instead
in CMake 3.23 and above.
Finding GLUT and linking it to a project target:
.. code-block:: cmake
find_package(GLUT)
target_link_libraries(project_target PRIVATE GLUT::GLUT)
#]=======================================================================]
include(${CMAKE_CURRENT_LIST_DIR}/SelectLibraryConfigurations.cmake)