blob: ec16fc8e39c31229e3499993d30bd626c0e949d0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
# file LICENSE.rst or https://cmake.org/licensing for details.
#[=======================================================================[.rst:
FindosgViewer
-------------
Finds the osgViewer library from the OpenSceneGraph toolkit.
.. note::
In most cases, it's recommended to use the :module:`FindOpenSceneGraph` module
instead and list osgViewer as a component. This will automatically handle
dependencies such as the OpenThreads and core osg libraries:
.. code-block:: cmake
find_package(OpenSceneGraph COMPONENTS osgViewer)
This module is used internally by :module:`FindOpenSceneGraph` to find the
osgViewer library. It is not intended to be included directly during typical
use of the :command:`find_package` command. However, it is available as a
standalone module for advanced use cases where finer control over detection is
needed. For example, to find the osgViewer explicitly or bypass automatic
component detection:
.. code-block:: cmake
find_package(osgViewer)
OpenSceneGraph and osgViewer headers are intended to be included in C++ project
source code as:
.. code-block:: c++
:caption: ``example.cxx``
#include <osg/PositionAttitudeTransform>
#include <osgViewer/Viewer>
// ...
When working with the OpenSceneGraph toolkit, other libraries such as OpenGL may
also be required.
Result Variables
^^^^^^^^^^^^^^^^
This module defines the following variables:
``osgViewer_FOUND``
.. versionadded:: 3.3
Boolean indicating whether the osgViewer library of the OpenSceneGraph
toolkit was found.
``OSGVIEWER_LIBRARIES``
The libraries needed to link against to use osgViewer.
``OSGVIEWER_LIBRARY``
A result variable that is set to the same value as the ``OSGVIEWER_LIBRARIES``
variable.
Cache Variables
^^^^^^^^^^^^^^^
The following cache variables may also be set:
``OSGVIEWER_INCLUDE_DIR``
The include directory containing headers needed to use osgViewer.
``OSGVIEWER_LIBRARY_DEBUG``
The path to the osgViewer debug library.
Hints
^^^^^
This module accepts the following variables:
``OSGDIR``
Environment variable that can be set to help locate the OpenSceneGraph
toolkit, including its osgViewer library, when installed in a custom
location. It should point to the OpenSceneGraph installation prefix used when
it was configured, built, and installed: ``./configure --prefix=$OSGDIR``.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``OSGVIEWER_FOUND``
.. deprecated:: 4.2
Use ``osgViewer_FOUND``, which has the same value.
Boolean indicating whether the osgViewer library of the OpenSceneGraph
toolkit was found.
Examples
^^^^^^^^
Finding osgViewer explicitly with this module and creating an interface
:ref:`imported target <Imported Targets>` that encapsulates its usage
requirements for linking it to a project target:
.. code-block:: cmake
find_package(osgViewer)
if(osgViewer_FOUND AND NOT TARGET osgViewer::osgViewer)
add_library(osgViewer::osgViewer INTERFACE IMPORTED)
set_target_properties(
osgViewer::osgViewer
PROPERTIES
INTERFACE_INCLUDE_DIRECTORIES "${OSGVIEWER_INCLUDE_DIR}"
INTERFACE_LINK_LIBRARIES "${OSGVIEWER_LIBRARIES}"
)
endif()
target_link_libraries(example PRIVATE osgViewer::osgViewer)
See Also
^^^^^^^^
* The :module:`FindOpenSceneGraph` module to find OpenSceneGraph toolkit.
#]=======================================================================]
# Created by Eric Wing.
include(${CMAKE_CURRENT_LIST_DIR}/Findosg_functions.cmake)
OSG_FIND_PATH (OSGVIEWER osgViewer/Viewer)
OSG_FIND_LIBRARY(OSGVIEWER osgViewer)
include(FindPackageHandleStandardArgs)
find_package_handle_standard_args(osgViewer DEFAULT_MSG
OSGVIEWER_LIBRARY OSGVIEWER_INCLUDE_DIR)
|
