FindosgManipulator

查找 OpenSceneGraph 工具包中的 osgManipulator NodeKit。

注意

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

find_package(OpenSceneGraph COMPONENTS osgManipulator)

此模块由 FindOpenSceneGraph 内部用于查找 osgManipulator NodeKit。通常情况下，不建议在执行 find_package() 命令时直接包含它。但是，它作为一个独立模块可用于更高级的用例，例如需要更精细地控制检测，或者显式查找 osgManipulator 或绕过自动组件检测。

find_package(osgManipulator)

OpenSceneGraph 和 osgManipulator 的头文件旨在 C++ 项目源代码中包含为：

example.cxx

#include <osg/PositionAttitudeTransform>
#include <osgManipulator/TrackballDragger>
// ...

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

结果变量

此模块定义了以下变量

osgManipulator_FOUND

3.3 版本中新增。

布尔值，指示是否找到 OpenSceneGraph 工具包的 osgManipulator NodeKit。

OSGMANIPULATOR_LIBRARIES

链接使用 osgManipulator 所需的库。

OSGMANIPULATOR_LIBRARY

一个结果变量，其值与 OSGMANIPULATOR_LIBRARIES 变量相同。

缓存变量

以下缓存变量也可以设置

OSGMANIPULATOR_INCLUDE_DIR

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

OSGMANIPULATOR_LIBRARY_DEBUG

osgManipulator 调试库的路径。

提示

此模块接受以下变量

OSGDIR

环境变量，当 OpenSceneGraph 工具包（包括其 osgManipulator NodeKit）安装在自定义位置时，可用于帮助定位。它应指向配置、构建和安装 OpenSceneGraph 时使用的安装前缀：./configure --prefix=$OSGDIR。

已弃用变量

以下变量提供用于向后兼容性

OSGMANIPULATOR_FOUND

4.2 版本已弃用： 请使用 osgManipulator_FOUND，其值相同。

布尔值，指示是否找到 OpenSceneGraph 工具包的 osgManipulator NodeKit。

示例

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

find_package(osgManipulator)

if(osgManipulator_FOUND AND NOT TARGET osgManipulator::osgManipulator)
  add_library(osgManipulator::osgManipulator INTERFACE IMPORTED)
  set_target_properties(
    osgManipulator::osgManipulator
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGMANIPULATOR_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGMANIPULATOR_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgManipulator::osgManipulator)

另请参阅

• 用于查找 OpenSceneGraph 工具包的 FindOpenSceneGraph 模块。