OsgQt源码编译

原创于 2025-07-10 15:33:01 发布 · 242 阅读

4 ·

CC 4.0 BY-SA版权

系列文章目录

文章目录

系列文章目录
前言
一、准备工作
二、编译osgQt源码

前言

在 Windows 11 下编译 osgQt(OpenSceneGraph 与 Qt 的集成模块)如果拿源码编译，不做任何配置和准备确实有点问题，但我们可以一步步走完流程。以下是一个完整的编译指南，适用于 Visual Studio 和 Qt 环境：

一、准备工作

操作系统：Windows 11或windows10

编译器：Visual Studio(推荐 2017 或更高版本)，我这里使用visual studio2022

Qt 版本：建议使用 Qt 5.12.x 或 5.14.x(MSVC 对应版本)，我这里使用Qt5.14.2

CMake：最新版，我这里使用CMake4.03

Git：用于克隆源码

osg：默认已编译完成，如果需要请看下面的文档

使用vcpkg编译OsgEarth 也可以在官网下载编译好的osg

官方OpenSceneGraph 3.6.5 – Visual C++ 2022 – 64-bit – Release+Debug下载地址

OsgQt源码编译_osgQt源码编译

osg 3rdparty

osg 3rdpary源码下载地址也可以直接下载官方编译好的osg 3rdparty

OsgQt源码编译_osgQt_02

OsgQt源码 OsgQt源码下载地址

二、编译osgQt源码

1.使用CMake工具生成osgQt.sln
注意，Qt5.14.2 默认不再包含 QtWebKitWidgets 模块，这是因为 Qt 官方在 Qt 5.6 之后就移除了 QtWebKit，转而推荐使用 Qt WebEngine。
解决办法：忽略
实在较真的话：可以自己编译 QtWebKit
如果你找不到合适的QtWebKit预编译版本，可以从源码编译：

bash

git clone https://github.com/qtwebkit/qtwebkit.git

cd qtwebkit

mkdir build && cd build

cmake … -G “Visual Studio 15 2017 Win64” -DCMAKE_PREFIX_PATH=“D:/Qt/Qt5.14.2/5.14.2/msvc2017_64”

cmake --build . --config Release

编译完成后，将生成的库文件复制到 Qt 安装目录。

OsgQt源码编译_osgQt_03

2.下面选项依赖osg库，手动配置好

OsgQt源码编译_CMake_04

OsgQt源码编译_CMake_05

3.点击CMake工具的“configure”，

我使用用cmake4.0.3编译osgQt源码，报错 CMake Error at CMakeLists.txt:5 (CMAKE_MINIMUM_REQUIRED): Compatibility with CMake < 3.5 has been removed from CMake. Update the VERSION argument value. Or, use the … syntax to tell CMake that the project requires at least but has been updated to work with policies introduced by or earlier. Or, add -DCMAKE_POLICY_VERSION_MINIMUM=3.5 to try configuring anyway. Configuring incomplete, errors occurred!

解决办法：

打开源码中的CMakeLists.txt

OsgQt源码编译_osgQt源码编译_06

(1)把

修改成

(2)把

修改成

(3)在
CMakeLists.txt 顶部添加：

(4)删除或注释掉 include(Documentation.cmake)，如果有的话

2.启动osgQt.sln

(1)编译器报错：

未定义标识符 “OSGTEXT_GLYPH_INTERNALFORMAT”

未定义标识符 “OSGTEXT_GLYPH_FORMAT”

“OSGTEXT_GLYPH_INTERNALFORMAT”: 未声明的标识符

“OSGTEXT_GLYPH_FORMAT”: 未声明的标识符

“OSGTEXT_GLYPH_INTERNALFORMAT”: 未声明的标识符

OsgQt源码编译_osgQt源码编译_07

解决办法：

D:\workSpace\osg\OsgQt\osgQt-master\src\osgQt\QFontImplementation.cpp

文件下，把代码：

glyph->setImage(imageWidth, imageHeight, 1,
	OSGTEXT_GLYPH_INTERNALFORMAT,
	OSGTEXT_GLYPH_FORMAT, GL_UNSIGNED_BYTE,
	data,
	osg::Image::USE_NEW_DELETE,
	1);
glyph->setInternalTextureFormat(OSGTEXT_GLYPH_INTERNALFORMAT);

修改成

glyph->setImage(imageWidth, imageHeight, 1,
	GL_ALPHA,
	GL_ALPHA, GL_UNSIGNED_BYTE,
	data,
	osg::Image::USE_NEW_DELETE,
	1);
glyph->setInternalTextureFormat(GL_ALPHA);

(2)编译器又报错：

version WORDs separated by commas expected

无法打开输入文件“…\lib\osgQt.lib”

OsgQt源码编译_CMake_08