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)

另请参阅