FindosgShadow

查找 OpenSceneGraph 工具包中的 osgShadow NodeKit。

注意

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

find_package(OpenSceneGraph COMPONENTS osgShadow)

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

find_package(osgShadow)

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

example.cxx

#include <osg/PositionAttitudeTransform>
#include <osgShadow/ShadowTexture>
// ...

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

结果变量

此模块定义了以下变量

osgShadow_FOUND

3.3 版本中新增。

一个布尔值，指示是否找到了 OpenSceneGraph 工具包的 osgShadow NodeKit。

OSGSHADOW_LIBRARIES

使用 osgShadow 所需链接的库。

OSGSHADOW_LIBRARY

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

缓存变量

以下缓存变量也可以设置

OSGSHADOW_INCLUDE_DIR

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

OSGSHADOW_LIBRARY_DEBUG

osgShadow 调试库的路径。

提示

此模块接受以下变量

OSGDIR

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

已弃用变量

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

OSGSHADOW_FOUND

自 4.2 版本起已弃用： 使用 osgShadow_FOUND，其值相同。

一个布尔值，指示是否找到了 OpenSceneGraph 工具包的 osgShadow NodeKit。

示例

使用此模块显式查找 osgShadow，并创建一个接口 导入的目标，该目标封装了将 osgShadow 链接到项目目标的使用要求。

find_package(osgShadow)

if(osgShadow_FOUND AND NOT TARGET osgShadow::osgShadow)
  add_library(osgShadow::osgShadow INTERFACE IMPORTED)
  set_target_properties(
    osgShadow::osgShadow
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGSHADOW_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGSHADOW_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgShadow::osgShadow)

另请参阅

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