FindosgQt¶
查找 OpenSceneGraph 工具集中的 osgQt 实用库。
注意
在大多数情况下,建议改用 FindOpenSceneGraph
模块,并将 osgQt 列为组件。这将自动处理 OpenThreads 和核心 osg 库等依赖项。
find_package(OpenSceneGraph COMPONENTS osgQt)
此模块由 FindOpenSceneGraph
内部使用以查找 osgQt 库。它不打算在典型的 find_package()
命令使用过程中直接包含。但是,它也可作为一个独立的模块,用于需要更精细地控制检测的复杂用例。例如,显式查找 osgQt 或绕过自动组件检测。
find_package(osgQt)
OpenSceneGraph 和 osgQt 头文件旨在按照以下方式包含到 C++ 项目源代码中:
example.cxx
¶#include <osg/PositionAttitudeTransform>
#include <osgQt/GraphicsWindowQt>
// ...
使用 OpenSceneGraph 工具包时,可能还需要其他库,例如 OpenGL。
结果变量¶
此模块定义了以下变量
osgQt_FOUND
一个布尔值,指示是否找到 OpenSceneGraph 工具集中的 osgQt 库。为了向后兼容,
OSGQT_FOUND
变量也设置为相同的值。OSGQT_LIBRARIES
链接以使用 osgQt 所需的库。
OSGQT_LIBRARY
一个结果变量,其值与
OSGQT_LIBRARIES
变量的值相同。
缓存变量¶
以下缓存变量也可以设置
OSGQT_INCLUDE_DIR
包含使用 osgQt 所需头文件的目录。
OSGQT_LIBRARY_DEBUG
osgQt 调试库的路径。
提示¶
此模块接受以下变量
OSGDIR
环境变量,当 OpenSceneGraph 工具集安装在自定义位置时,可以设置此环境变量来帮助定位它,包括其 osgQt 库。它应该指向配置、构建和安装 OpenSceneGraph 时使用的安装前缀:
./configure --prefix=$OSGDIR
。
示例¶
使用此模块显式查找 osgQt,并创建一个封装其使用要求的接口 导入的目标,以便将其链接到项目目标。
find_package(osgQt)
if(osgQt_FOUND AND NOT TARGET osgQt::osgQt)
add_library(osgQt::osgQt INTERFACE IMPORTED)
set_target_properties(
osgQt::osgQt
PROPERTIES
INTERFACE_INCLUDE_DIRECTORIES "${OSGQT_INCLUDE_DIR}"
INTERFACE_LINK_LIBRARIES "${OSGQT_LIBRARIES}"
)
endif()
target_link_libraries(example PRIVATE osgQt::osgQt)
另请参阅¶
用于查找 OpenSceneGraph 工具集的
FindOpenSceneGraph
模块。