File: FindosgIntrospection.cmake

package info (click to toggle)
cmake 4.1.0-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 147,284 kB
  • sloc: ansic: 403,915; cpp: 290,772; sh: 4,102; python: 3,357; yacc: 3,106; lex: 1,189; f90: 532; asm: 471; lisp: 375; cs: 270; java: 266; fortran: 230; perl: 217; objc: 215; xml: 198; makefile: 97; javascript: 83; pascal: 63; tcl: 55; php: 25; ruby: 22
file content (125 lines) | stat: -rw-r--r-- 4,074 bytes parent folder | download
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
# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
# file LICENSE.rst or https://cmake.org/licensing for details.

#[=======================================================================[.rst:
FindosgIntrospection
--------------------

Finds the osgIntrospection library from the OpenSceneGraph toolkit.

.. note::

  The osgIntrospection library has been removed from the OpenSceneGraph toolkit
  as of OpenSceneGraph version 3.0.

.. note::

  In most cases, it's recommended to use the :module:`FindOpenSceneGraph` module
  instead and list osgIntrospection as a component.  This will automatically
  handle dependencies such as the OpenThreads and core osg libraries:

  .. code-block:: cmake

    find_package(OpenSceneGraph COMPONENTS osgIntrospection)

This module is used internally by :module:`FindOpenSceneGraph` to find the
osgIntrospection 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 osgIntrospection explicitly or bypass
automatic component detection:

.. code-block:: cmake

  find_package(osgIntrospection)

OpenSceneGraph and osgIntrospection headers are intended to be included in C++
project source code as:

.. code-block:: c++
  :caption: ``example.cxx``

  #include <osg/PositionAttitudeTransform>
  #include <osgIntrospection/Reflection>
  // ...

When working with the OpenSceneGraph toolkit, other libraries such as OpenGL may
also be required.

Result Variables
^^^^^^^^^^^^^^^^

This module defines the following variables:

``osgIntrospection_FOUND``
  Boolean indicating whether the osgIntrospection library of the OpenSceneGraph
  toolkit is found.  For backward compatibility, the ``OSGINTROSPECTION_FOUND``
  variable is also set to the same value.

``OSGINTROSPECTION_LIBRARIES``
  The libraries needed to link against to use osgIntrospection.

``OSGINTROSPECTION_LIBRARY``
  A result variable that is set to the same value as the
  ``OSGINTROSPECTION_LIBRARIES`` variable.

Cache Variables
^^^^^^^^^^^^^^^

The following cache variables may also be set:

``OSGINTROSPECTION_INCLUDE_DIR``
  The include directory containing headers needed to use osgIntrospection.

``OSGINTROSPECTION_LIBRARY_DEBUG``
  The path to the osgIntrospection debug library.

Hints
^^^^^

This module accepts the following variables:

``OSGDIR``
  Environment variable that can be set to help locate the OpenSceneGraph
  toolkit, including its osgIntrospection 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``.

Examples
^^^^^^^^

Finding osgIntrospection 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(osgIntrospection)

  if(osgIntrospection_FOUND AND NOT TARGET osgIntrospection::osgIntrospection)
    add_library(osgIntrospection::osgIntrospection INTERFACE IMPORTED)
    set_target_properties(
      osgIntrospection::osgIntrospection
      PROPERTIES
        INTERFACE_INCLUDE_DIRECTORIES "${OSGINTROSPECTION_INCLUDE_DIR}"
        INTERFACE_LINK_LIBRARIES "${OSGINTROSPECTION_LIBRARIES}"
    )
  endif()

  target_link_libraries(example PRIVATE osgIntrospection::osgIntrospection)

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   (OSGINTROSPECTION osgIntrospection/Reflection)
OSG_FIND_LIBRARY(OSGINTROSPECTION osgIntrospection)

include(FindPackageHandleStandardArgs)
find_package_handle_standard_args(osgIntrospection DEFAULT_MSG
    OSGINTROSPECTION_LIBRARY OSGINTROSPECTION_INCLUDE_DIR)