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