FindosgParticle

查找 OpenSceneGraph 工具包中的 osgParticle NodeKit。

注意

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

find_package(OpenSceneGraph COMPONENTS osgParticle)

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

find_package(osgParticle)

OpenSceneGraph 和 osgParticle 头文件应在 C++ 项目源代码中包含为

example.cxx
#include <osg/PositionAttitudeTransform>
#include <osgParticle/FireEffect>
// ...

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

结果变量

此模块定义了以下变量

osgParticle_FOUND

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

OSGPARTICLE_LIBRARIES

使用 osgParticle NodeKit 所需链接的库。

OSGPARTICLE_LIBRARY

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

缓存变量

以下缓存变量也可以设置

OSGPARTICLE_INCLUDE_DIR

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

OSGPARTICLE_LIBRARY_DEBUG

osgParticle 调试库的路径。

提示

此模块接受以下变量

OSGDIR

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

示例

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

find_package(osgParticle)

if(osgParticle_FOUND AND NOT TARGET osgParticle::osgParticle)
  add_library(osgParticle::osgParticle INTERFACE IMPORTED)
  set_target_properties(
    osgParticle::osgParticle
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGPARTICLE_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGPARTICLE_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgParticle::osgParticle)

另请参阅