FindosgWidget

查找 OpenSceneGraph 工具包中的 osgWidget NodeKit。

注意

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

find_package(OpenSceneGraph COMPONENTS osgWidget)

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

find_package(osgWidget)

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

example.cxx

#include <osg/PositionAttitudeTransform>
#include <osgWidget/Widget>
// ...

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

结果变量

此模块定义了以下变量

osgWidget_FOUND

一个布尔值，指示是否找到 OpenSceneGraph 工具包的 osgWidget NodeKit。为了向后兼容，OSGWIDGET_FOUND 变量也设置为相同的值。

OSGWIDGET_LIBRARIES

使用 osgWidget 所需链接的库。

OSGWIDGET_LIBRARY

一个结果变量，设置为与 OSGWIDGET_LIBRARIES 变量相同的值。

缓存变量

以下缓存变量也可以设置

OSGWIDGET_INCLUDE_DIR

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

OSGWIDGET_LIBRARY_DEBUG

osgWidget 调试库的路径。

提示

此模块接受以下变量

OSGDIR

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

示例

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

find_package(osgWidget)

if(osgWidget_FOUND AND NOT TARGET osgWidget::osgWidget)
  add_library(osgWidget::osgWidget INTERFACE IMPORTED)
  set_target_properties(
    osgWidget::osgWidget
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGWIDGET_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGWIDGET_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgWidget::osgWidget)

另请参阅

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