FindosgIntrospection

查找 OpenSceneGraph 工具包中的 osgIntrospection 库。

注意

osgIntrospection 库已从 OpenSceneGraph 工具包中移除,自 OpenSceneGraph 版本 3.0 起。

注意

在大多数情况下,建议改用 FindOpenSceneGraph 模块,并将 osgIntrospection 列为组件。这将自动处理 OpenThreads 和核心 osg 库等依赖项。

find_package(OpenSceneGraph COMPONENTS osgIntrospection)

此模块由 FindOpenSceneGraph 内部使用,以查找 osgIntrospection 库。它不打算在典型使用 find_package() 命令时直接包含。但是,它作为一个独立模块可用于需要更精细控制检测的高级用例。例如,显式查找 osgIntrospection 或绕过自动组件检测。

find_package(osgIntrospection)

OpenSceneGraph 和 osgIntrospection 头文件旨在作为 C++ 项目源代码包含:

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

使用 OpenSceneGraph 工具包时,可能还需要其他库,例如 OpenGL。

结果变量

此模块定义了以下变量

osgIntrospection_FOUND

一个布尔值,指示是否找到 OpenSceneGraph 工具包的 osgIntrospection 库。为了向后兼容,OSGINTROSPECTION_FOUND 变量也设置为相同的值。

OSGINTROSPECTION_LIBRARIES

使用 osgIntrospection 所需链接的库。

OSGINTROSPECTION_LIBRARY

一个结果变量,其值与 OSGINTROSPECTION_LIBRARIES 变量相同。

缓存变量

以下缓存变量也可以设置

OSGINTROSPECTION_INCLUDE_DIR

包含使用 osgIntrospection 所需头文件的目录。

OSGINTROSPECTION_LIBRARY_DEBUG

osgIntrospection 调试库的路径。

提示

此模块接受以下变量

OSGDIR

当 OpenSceneGraph 工具包(包括其 osgIntrospection 库)安装在自定义位置时,可以设置此环境变量来帮助定位。它应该指向配置、构建和安装 OpenSceneGraph 时使用的安装前缀:./configure --prefix=$OSGDIR

示例

使用此模块显式查找 osgIntrospection,并创建一个封装其使用要求的接口 导入的目标,以便将其链接到项目目标。

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)

另请参阅