FindosgFX

查找 OpenSceneGraph 工具包中的 osgFX 节点工具包 (NodeKit)。

注意

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

find_package(OpenSceneGraph COMPONENTS osgFX)

此模块由 FindOpenSceneGraph 内部使用，用于查找 osgFX 节点工具包。它不适用于通过典型的 find_package() 命令直接包含。但是，它可以作为一个独立的模块，用于需要更精细控制检测的高级用例。例如，显式查找 osgFX 或绕过自动组件检测。

find_package(osgFX)

OpenSceneGraph 和 osgFX 头文件 intended to be included in C++ project source code as

example.cxx

#include <osg/PositionAttitudeTransform>
#include <osgFX/BumpMapping>
// ...

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

结果变量

此模块定义了以下变量

osgFX_FOUND

3.3 版本中新增。

一个布尔值，指示是否找到了 OpenSceneGraph 工具包的 osgFX 节点工具包。

OSGFX_LIBRARIES

使用 osgFX 所需链接的库。

OSGFX_LIBRARY

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

缓存变量

以下缓存变量也可以设置

OSGFX_INCLUDE_DIR

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

OSGFX_LIBRARY_DEBUG

osgFX 调试库的路径。

提示

此模块接受以下变量

OSGDIR

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

已弃用变量

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

OSGFX_FOUND

已弃用，自版本 4.2 起: 使用 osgFX_FOUND，其值相同。

一个布尔值，指示是否找到了 OpenSceneGraph 工具包的 osgFX 节点工具包。

示例

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

find_package(osgFX)

if(osgFX_FOUND AND NOT TARGET osgFX::osgFX)
  add_library(osgFX::osgFX INTERFACE IMPORTED)
  set_target_properties(
    osgFX::osgFX
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGFX_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGFX_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgFX::osgFX)

另请参阅

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