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
布尔值,指示是否找到 osg 库。为了向后兼容,
OSG_FOUND
变量也设置为相同的值。OSG_LIBRARIES
链接 osg 库所需的库。
OSG_LIBRARY
一个结果变量,其值与
OSG_LIBRARIES
变量相同。
缓存变量¶
以下缓存变量也可以设置
OSG_INCLUDE_DIR
包含使用 osg 库所需的头文件的包含目录。
OSG_LIBRARY_DEBUG
osg 调试库的路径。
提示¶
此模块接受以下变量
OSGDIR
环境变量,可用于在 OpenSceneGraph 工具包(包括其 osg 库)安装在自定义位置时帮助定位。它应指向配置、构建和安装时使用的 OpenSceneGraph 安装前缀:
./configure --prefix=$OSGDIR
。
示例¶
使用此模块显式查找 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)
另请参阅¶
FindOpenSceneGraph
模块用于查找 OpenSceneGraph 工具包。