FindosgGA

查找 OpenSceneGraph 工具包中的 osgGA 库。

注意

在大多数情况下，建议使用 FindOpenSceneGraph 模块并将 osgGA 列为组件。这将自动处理 OpenThreads 和核心 osg 库等依赖项。

find_package(OpenSceneGraph COMPONENTS osgGA)

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

find_package(osgGA)

OpenSceneGraph 和 osgGA 头文件应在 C++ 项目源代码中以下列方式包含：

example.cxx

#include <osg/PositionAttitudeTransform>
#include <osgGA/FlightManipulator>
// ...

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

结果变量

此模块定义了以下变量

osgGA_FOUND

布尔值，指示是否找到 OpenSceneGraph 工具包的 osgGA 库。为了向后兼容，OSGGA_FOUND 变量也设置为相同的值。

OSGGA_LIBRARIES

使用 osgGA 所需链接的库。

OSGGA_LIBRARY

结果变量，其值与 OSGGA_LIBRARIES 变量相同。

缓存变量

以下缓存变量也可以设置

OSGGA_INCLUDE_DIR

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

OSGGA_LIBRARY_DEBUG

osgGA 调试库的路径。

提示

此模块接受以下变量

OSGDIR

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

示例

使用此模块显式查找 osgGA，并创建一个 导入目标，封装其用于链接到项目目标的用法要求。

find_package(osgGA)

if(osgGA_FOUND AND NOT TARGET osgGA::osgGA)
  add_library(osgGA::osgGA INTERFACE IMPORTED)
  set_target_properties(
    osgGA::osgGA
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGGA_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGGA_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgGA::osgGA)

另请参阅

• FindOpenSceneGraph 模块用于查找 OpenSceneGraph 工具包。