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)
另请参阅¶
FindOpenSceneGraph
模块用于查找 OpenSceneGraph 工具包。