Findosg

查找核心 OpenSceneGraph osg 库（libosg）。

注意

在大多数情况下，建议使用 FindOpenSceneGraph 模块，该模块会自动查找 osg 核心库及其所需的依赖项，例如 OpenThreads。

find_package(OpenSceneGraph)

此模块由 FindOpenSceneGraph 内部使用来查找 osg 库。它不应在典型的 find_package() 命令使用中直接包含。但是，它作为一个独立模块可用，用于需要更精细控制检测的高级用例，例如显式查找 osg 库或绕过自动组件检测。

find_package(osg)

OpenSceneGraph 核心库头文件旨在 C++ 项目源代码中包含，如下所示：

example.cxx
#include <osg/PositionAttitudeTransform>

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

结果变量

此模块定义了以下变量

osg_FOUND

3.3 版本中新增。

一个布尔值，指示是否找到 osg 库。

OSG_LIBRARIES

链接使用 osg 库所需的库。

OSG_LIBRARY

一个结果变量，其值与 OSG_LIBRARIES 变量相同。

缓存变量

以下缓存变量也可以设置

OSG_INCLUDE_DIR

包含使用 osg 库所需的头文件的包含目录。

OSG_LIBRARY_DEBUG

osg 调试库的路径。

提示

此模块接受以下变量

OSGDIR

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

已弃用变量

以下变量提供用于向后兼容性

OSG_FOUND

自 4.2 版本起已弃用： 使用 osg_FOUND，它具有相同的值。

一个布尔值，指示是否找到 osg 库。

示例

使用此模块显式查找 osg 库，并创建一个 导入目标 来封装其使用要求，以便将其链接到项目目标。

find_package(osg)

if(osg_FOUND AND NOT TARGET osg::osg)
  add_library(osg::osg INTERFACE IMPORTED)
  set_target_properties(
    osg::osg
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSG_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSG_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osg::osg)

另请参阅