FindosgUtil

查找 OpenSceneGraph 工具包中的 osgUtil 库。

注意

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

find_package(OpenSceneGraph COMPONENTS osgUtil)

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

find_package(osgUtil)

OpenSceneGraph 和 osgUtil 头文件旨在 C++ 项目源代码中按如下方式包含：

example.cxx
#include <osg/PositionAttitudeTransform>
#include <osgUtil/SceneView>
// ...

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

结果变量

此模块定义了以下变量

osgUtil_FOUND

3.3 版本中新增。

一个布尔值，指示是否找到 OpenSceneGraph 工具包的 osgUtil 库。

OSGUTIL_LIBRARIES

使用 osgUtil 所需链接的库。

OSGUTIL_LIBRARY

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

缓存变量

以下缓存变量也可以设置

OSGUTIL_INCLUDE_DIR

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

OSGUTIL_LIBRARY_DEBUG

osgUtil 调试库的路径。

提示

此模块接受以下变量

OSGDIR

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

已弃用变量

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

OSGUTIL_FOUND

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

一个布尔值，指示是否找到 OpenSceneGraph 工具包的 osgUtil 库。

示例

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

find_package(osgUtil)

if(osgUtil_FOUND AND NOT TARGET osgUtil::osgUtil)
  add_library(osgUtil::osgUtil INTERFACE IMPORTED)
  set_target_properties(
    osgUtil::osgUtil
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGUTIL_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGUTIL_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgUtil::osgUtil)

另请参阅