FindosgTerrain¶
查找 OpenSceneGraph 工具包中的 osgTerrain NodeKit。
注意
在大多数情况下,建议改用 FindOpenSceneGraph
模块,并将 osgTerrain 列为组件。这将自动处理 OpenThreads 和核心 osg 库等依赖项。
find_package(OpenSceneGraph COMPONENTS osgTerrain)
此模块由 FindOpenSceneGraph
内部使用,以查找 osgTerrain NodeKit。在典型的 find_package()
命令使用期间,不打算直接包含它。但是,它作为一个独立模块可用,用于需要更精细控制检测的高级用例。例如,显式查找 osgTerrain 或绕过自动组件检测。
find_package(osgTerrain)
OpenSceneGraph 和 osgTerrain 头文件旨在包含在 C++ 项目源代码中,如下所示:
example.cxx
¶#include <osg/PositionAttitudeTransform>
#include <osgTerrain/Terrain>
// ...
使用 OpenSceneGraph 工具包时,可能还需要其他库,例如 OpenGL。
结果变量¶
此模块定义了以下变量
osgTerrain_FOUND
一个布尔值,指示是否找到了 OpenSceneGraph 工具包的 osgTerrain NodeKit。为了向后兼容,
OSGTERRAIN_FOUND
变量也设置为相同的值。OSGTERRAIN_LIBRARIES
使用 osgTerrain 所需链接的库。
OSGTERRAIN_LIBRARY
一个结果变量,设置为与
OSGTERRAIN_LIBRARIES
变量相同的值。
缓存变量¶
以下缓存变量也可以设置
OSGTERRAIN_INCLUDE_DIR
包含使用 osgTerrain 所需头文件的包含目录。
OSGTERRAIN_LIBRARY_DEBUG
osgTerrain 调试库的路径。
提示¶
此模块接受以下变量
OSGDIR
环境变量,当 OpenSceneGraph 工具包(包括其 osgTerrain NodeKit)安装在自定义位置时,可以设置它来帮助定位。它应该指向配置、构建和安装 OpenSceneGraph 时使用的安装前缀:
./configure --prefix=$OSGDIR
。
示例¶
使用此模块显式查找 osgTerrain,并创建一个接口 导入目标,该目标封装了其使用要求,以便将其链接到项目目标。
find_package(osgTerrain)
if(osgTerrain_FOUND AND NOT TARGET osgTerrain::osgTerrain)
add_library(osgTerrain::osgTerrain INTERFACE IMPORTED)
set_target_properties(
osgTerrain::osgTerrain
PROPERTIES
INTERFACE_INCLUDE_DIRECTORIES "${OSGTERRAIN_INCLUDE_DIR}"
INTERFACE_LINK_LIBRARIES "${OSGTERRAIN_LIBRARIES}"
)
endif()
target_link_libraries(example PRIVATE osgTerrain::osgTerrain)
另请参阅¶
查找 OpenSceneGraph 工具包的
FindOpenSceneGraph
模块。