573c9d746c
5.4 KiB
chengnan
项目链接：https://git.luochen570.cn/luochen570/chengnan
chengnan 是一个 Windows 图像显示与处理课程项目，使用 Qt Widgets + OpenCV + CMake + C++17 开发。
作业要求对应情况
- 使用 Qt 设计界面：已使用 Qt Widgets 实现菜单栏、工具栏和双栏图像显示界面。
- 打开图片、保存图片、另存图片：已实现。
- 缩放、平移、旋转：
- 缩放：工具栏滑块、放大、缩小、原始大小、双击适配窗口。
- 平移：图片位于
QScrollArea中，放大后可通过滚动条平移查看。 - 旋转：左旋 90°、右旋 90°。
- 图片处理：灰度化、反色、目标提取、简单分类。
- 处理前后对比：主界面左右两个
QWidget区域分别显示处理前和处理后图像。 - 显示方式：使用 Qt Widgets 显示图片，未使用
cv::imshow。 - OpenCV 处理线程：灰度化、反色、目标提取、简单分类通过 Qt 线程执行，避免处理时阻塞界面。
- Windows 应用构建发布：
.gitea/workflows/build-windows-release.yml会在 Gitea Actions 的 Linux Runner 中交叉构建 Windows x64 程序并上传 Release 附件。
功能
当前实现：
- 打开图片：PNG、JPG、JPEG、BMP、GIF、WebP 等 Qt 支持的格式
- 保存当前处理后图片
- 另存为 PNG / JPG / BMP 等格式
- 处理前 / 处理后双栏对比显示
- 缩放：工具栏滑块、放大、缩小、原始大小
- 平移：放大后使用滚动条移动查看区域
- 双击图片适配窗口
- 旋转：左旋 90°、右旋 90°
- 翻转：水平翻转、垂直翻转
- OpenCV 图片处理：灰度化、目标提取、简单分类
- 其它处理：反色
文件结构
chengnan/
├── .gitea/workflows/build-windows-release.yml
├── CMakeLists.txt
├── MainWindow.cpp
├── MainWindow.h
├── main.cpp
└── readme.md
除工作流和 readme.md 外，工程根目录只保留 CMakeLists.txt、main.cpp、MainWindow.h、MainWindow.cpp 四个文件。
Windows 编译需要的工具
推荐环境：Windows 10 / Windows 11 x64。
必须安装：
-
Git for Windows
- 下载：https://git-scm.com/download/win
- 用于克隆项目源码。
-
CMake 3.16 或更高版本
- 下载：https://cmake.org/download/
- 安装时建议勾选
Add CMake to the system PATH。
-
Qt 6 或 Qt 5，包含 Widgets 模块
- 下载：https://www.qt.io/download-qt-installer-oss
- 推荐安装 Qt 6.x 的 MSVC 64-bit 套件，例如
msvc2019_64或msvc2022_64。
-
OpenCV 4.x Windows 预编译包
- 下载：https://opencv.org/releases/
- 解压后 CMake 需要能找到 OpenCV 的
build目录，例如C:\opencv\build。
-
Visual Studio 2022 Build Tools 或 Visual Studio 2022
- 下载：https://visualstudio.microsoft.com/zh-hans/downloads/
- 需要安装组件：
使用 C++ 的桌面开发。 - 提供 MSVC 编译器和 Windows SDK。
获取源码
git clone https://git.luochen570.cn/luochen570/chengnan.git
cd chengnan
手动构建
在已配置 Visual Studio C++ 编译环境的 PowerShell 或 “x64 Native Tools Command Prompt for VS 2022” 中执行：
cmake -S . -B build-windows -G "Visual Studio 17 2022" -A x64 -DCMAKE_PREFIX_PATH="C:\Qt\6.7.3\msvc2022_64;C:\opencv\build"
cmake --build build-windows --config Release
打包 Qt 运行库：
C:\Qt\6.7.3\msvc2022_64\bin\windeployqt.exe --release --no-translations build-windows\Release\chengnan.exe
还需要把 OpenCV 的运行库 DLL（例如 opencv_world4100.dll）复制到 chengnan.exe 同目录。
Gitea Actions / GitHub Actions 风格工作流
仓库中的 .gitea/workflows/build-windows-release.yml 使用 Linux Runner 的 Fedora 容器交叉构建 Windows x64 应用并发布 Release 附件：
- 安装 MinGW-w64、Qt MinGW、OpenCV MinGW 依赖
- 使用
x86_64-w64-mingw32-cmake配置 Windows 目标程序 - 使用 Ninja 在 Linux 上交叉编译生成
chengnan.exe - 打包
chengnan.exe、Qt DLL、OpenCV DLL、Qt 插件目录 - 上传
.zip和.sha256到仓库 Release
发布上传使用仓库 Secret：RELEASE_TOKEN。如果没有配置该 Secret，工作流会尝试使用运行环境提供的 GITHUB_TOKEN。
常见问题
找不到 Qt
确认 CMake 的 CMAKE_PREFIX_PATH 包含 Qt 套件目录，而不是 Qt 根目录。例如应使用：
C:\Qt\6.7.3\msvc2022_64
不要写成：
C:\Qt
找不到 OpenCV
确认 CMake 的 CMAKE_PREFIX_PATH 包含 OpenCV 的 build 目录。例如：
C:\opencv\build
该目录下通常能找到 OpenCVConfig.cmake。
找不到 MSVC 编译器
请安装 Visual Studio 2022 的 使用 C++ 的桌面开发，然后在 “x64 Native Tools Command Prompt for VS 2022” 或已配置 VS 环境的 PowerShell 里运行构建命令。
exe 复制到其它电脑无法运行
不要只复制单个 chengnan.exe。需要同时复制 Qt / OpenCV DLL 和 Qt 插件目录，或直接使用 Gitea Actions 发布的 zip 附件。
开发说明
main.cpp：应用入口，创建并显示主窗口MainWindow.h：主窗口和图片标签类声明MainWindow.cpp：菜单、工具栏、图片显示、OpenCV 图像处理和 Qt 线程逻辑CMakeLists.txt：Qt Widgets + OpenCV CMake 构建配置readme.md：项目说明文档