FindosgSim

查找 OpenSceneGraph 工具包中的 osgSim NodeKit。

注意

在大多数情况下,建议使用 FindOpenSceneGraph 模块并列出 osgSim 作为组件。这将自动处理依赖项,例如 OpenThreads 和核心 osg 库。

find_package(OpenSceneGraph COMPONENTS osgSim)

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

find_package(osgSim)

OpenSceneGraph 和 osgSim 头文件旨在以以下方式包含在 C++ 项目源代码中:

example.cxx
#include <osg/PositionAttitudeTransform>
#include <osgSim/ImpostorSprite>
// ...

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

结果变量

此模块定义了以下变量

osgSim_FOUND

布尔值,指示是否找到 OpenSceneGraph 工具包的 osgSim NodeKit。为了向后兼容,OSGSIM_FOUND 变量也设置为相同的值。

OSGSIM_LIBRARIES

使用 osgSim 需要链接的库。

OSGSIM_LIBRARY

结果变量,设置为与 OSGSIM_LIBRARIES 变量相同的值。

缓存变量

以下缓存变量也可以设置

OSGSIM_INCLUDE_DIR

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

OSGSIM_LIBRARY_DEBUG

osgSim 调试库的路径。

提示

此模块接受以下变量

OSGDIR

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

示例

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

find_package(osgSim)

if(osgSim_FOUND AND NOT TARGET osgSim::osgSim)
  add_library(osgSim::osgSim INTERFACE IMPORTED)
  set_target_properties(
    osgSim::osgSim
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGSIM_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGSIM_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgSim::osgSim)

另请参阅