現(xiàn)科學(xué)計(jì)算可視化)
1. 項(xiàng)目緣起與整體設(shè)計(jì)思路搞科學(xué)計(jì)算可視化這件事最讓人頭疼的往往不是算法本身而是從數(shù)據(jù)到圖像這條鏈路上各種庫(kù)之間的依賴(lài)關(guān)系能把人折騰得夠嗆。我這次要聊的就是怎么把zlib、libpng、MathGL、OpenCV、Qt這幾樣?xùn)|西在VS2019環(huán)境下編譯并串起來(lái)最終跑出一個(gè)能畫(huà)函數(shù)曲面、能顯示圖像、還能交互操作的可視化程序。這套組合聽(tīng)起來(lái)有點(diǎn)雜但實(shí)際用起來(lái)非常順手MathGL 負(fù)責(zé)數(shù)學(xué)繪圖OpenCV 處理圖像數(shù)據(jù)Qt 做界面zlib 和 libpng 則是底層壓縮與圖像格式的支撐。先說(shuō)清楚這個(gè)項(xiàng)目適合誰(shuí)看。如果你正在做數(shù)值計(jì)算、信號(hào)處理、圖像分析或者單純想給自己的 C 程序加一個(gè)能畫(huà)三維曲面的窗口那這套方案基本可以直接抄作業(yè)。它不依賴(lài) Python 那套臃腫的運(yùn)行時(shí)編譯出來(lái)就是原生可執(zhí)行文件啟動(dòng)快、部署簡(jiǎn)單。當(dāng)然前提是你得愿意花點(diǎn)時(shí)間把編譯環(huán)境搭好因?yàn)檫@幾個(gè)庫(kù)的源碼編譯確實(shí)有些坑要踩。為什么選 VS2019 而不是 VS2022 或者 MinGW原因很實(shí)際VS2019 對(duì) C14/17 的支持已經(jīng)足夠穩(wěn)定而且它的 MSVC 編譯器在 Windows 上跟 Qt、OpenCV 的預(yù)編譯包兼容性最好。MathGL 官方雖然也提供 MinGW 的編譯方式但在 Windows 下用 MSVC 編譯出來(lái)的庫(kù)跟 Qt 的 MSVC 版本能無(wú)縫鏈接省去很多 ABI 不匹配的麻煩。至于 zlib 和 libpng它們本身就是 C 庫(kù)用 MSVC 編譯幾乎不會(huì)遇到語(yǔ)言層面的問(wèn)題主要注意運(yùn)行庫(kù)選項(xiàng)一致就行。整體架構(gòu)上我把它分成三層最底層是zlib 和 libpng負(fù)責(zé)數(shù)據(jù)壓縮和 PNG 圖像讀寫(xiě)中間層是MathGL 和 OpenCVMathGL 做數(shù)學(xué)繪圖OpenCV 做圖像處理與矩陣運(yùn)算最上層是Qt負(fù)責(zé)窗口、控件和事件循環(huán)。這樣分層的好處是每一層都可以獨(dú)立替換或升級(jí)。比如你不想用 MathGL 畫(huà)圖換成 QCustomPlot 也行不想用 OpenCV 讀圖換成 Qt 自帶的 QImage 也可以。但既然標(biāo)題里點(diǎn)名了這幾個(gè)庫(kù)我就按這個(gè)組合來(lái)展開(kāi)。還有一個(gè)關(guān)鍵決策全部從源碼編譯還是用預(yù)編譯包我的建議是zlib 和 libpng 從源碼編譯因?yàn)樗鼈兊木幾g過(guò)程非常簡(jiǎn)單而且能確保跟后續(xù)庫(kù)使用相同的運(yùn)行庫(kù)選項(xiàng)。MathGL 也建議從源碼編譯因?yàn)楣俜筋A(yù)編譯包不一定帶 OpenCV 支持而我們需要它跟 OpenCV 協(xié)同工作。OpenCV 和 Qt 則可以用官方預(yù)編譯包但要注意版本匹配——Qt 要用 MSVC2019 64bit 版本OpenCV 要用對(duì)應(yīng) VS2019 的預(yù)編譯庫(kù)。這樣混合策略能省下大量編譯時(shí)間同時(shí)保證關(guān)鍵環(huán)節(jié)可控。2. 核心細(xì)節(jié)解析與實(shí)操要點(diǎn)2.1 zlib 與 libpng 的編譯細(xì)節(jié)zlib 的編譯可以說(shuō)是整個(gè)鏈條里最簡(jiǎn)單的。下載源碼后用 VS2019 的開(kāi)發(fā)者命令提示符進(jìn)入目錄執(zhí)行nmake -f win32/Makefile.msc就能生成zlib.lib和zlib1.dll。但這里有個(gè)細(xì)節(jié)默認(rèn)生成的庫(kù)是 Release 版本如果你后續(xù)要調(diào)試需要手動(dòng)改 Makefile 里的編譯選項(xiàng)加上/Zi和/DEBUG。我一般會(huì)編譯兩份一份 Release 一份 Debug分別放在lib/Release和lib/Debug目錄下后面配置工程時(shí)按配置切換。libpng 的編譯稍微麻煩一點(diǎn)因?yàn)樗蕾?lài) zlib。在 VS2019 里我習(xí)慣用 CMake 來(lái)生成工程文件。具體做法是新建一個(gè)build目錄用 CMake GUI 指定 libpng 源碼路徑和 build 路徑然后設(shè)置ZLIB_LIBRARY和ZLIB_INCLUDE_DIR指向剛才編譯好的 zlib。這里有個(gè)坑libpng 的 CMake 腳本會(huì)自動(dòng)查找 zlib但如果你的 zlib 是手動(dòng)編譯的它可能找不到。解決辦法是在 CMake 里手動(dòng)指定ZLIB_LIBRARY為zlib.lib的完整路徑ZLIB_INCLUDE_DIR為 zlib 源碼目錄。生成工程后用 VS2019 打開(kāi)libpng.sln編譯png_static或png_shared目標(biāo)就能得到libpng16.lib。注意libpng 編譯時(shí)一定要確保PNG_SHARED和PNG_STATIC的選項(xiàng)跟你的使用方式一致。如果你打算靜態(tài)鏈接到最終程序里就編譯靜態(tài)庫(kù)如果打算用 DLL就編譯動(dòng)態(tài)庫(kù)。我一般選靜態(tài)庫(kù)部署時(shí)少帶幾個(gè) DLL。2.2 MathGL 編譯與 OpenCV 支持MathGL 的編譯是整個(gè)項(xiàng)目里最費(fèi)時(shí)間的部分。它依賴(lài) zlib、libpng還可以選擇性地支持 OpenCV。在 CMake 配置階段你需要打開(kāi)enable-opencv選項(xiàng)并指定 OpenCV 的路徑。這里有個(gè)關(guān)鍵點(diǎn)MathGL 的 OpenCV 支持主要用于讀取圖像作為紋理或者進(jìn)行圖像處理如果你不需要這些功能可以關(guān)掉能省不少編譯時(shí)間。但既然標(biāo)題里提到了 OpenCV我建議還是打開(kāi)后面做圖像與繪圖疊加時(shí)會(huì)用到。MathGL 的 CMake 配置里還有幾個(gè)選項(xiàng)值得注意enable-qt要打開(kāi)這樣它才能跟 Qt 集成enable-double建議打開(kāi)科學(xué)計(jì)算里雙精度更穩(wěn)妥enable-openmp看情況如果你做大規(guī)模數(shù)據(jù)繪圖打開(kāi)能加速但會(huì)引入 OpenMP 運(yùn)行時(shí)依賴(lài)。我一般會(huì)打開(kāi)enable-qt和enable-double關(guān)掉enable-openmp因?yàn)?Qt 本身的事件循環(huán)已經(jīng)夠用了OpenMP 在某些環(huán)境下反而會(huì)跟 Qt 的線程模型沖突。編譯 MathGL 時(shí)VS2019 可能會(huì)報(bào)一些警告比如sprintf不安全之類(lèi)的。這些警告不影響編譯結(jié)果但如果你有強(qiáng)迫癥可以在 CMake 里加上-D_CRT_SECURE_NO_WARNINGS來(lái)屏蔽。另外MathGL 的 Qt 模塊會(huì)生成mglqt.lib和對(duì)應(yīng)的 DLL記得把這些 DLL 復(fù)制到最終程序的輸出目錄否則運(yùn)行時(shí)會(huì)提示找不到庫(kù)。2.3 OpenCV 與 Qt 的版本匹配OpenCV 我直接用官方預(yù)編譯包下載opencv-4.x-windows.exe自解壓后里面會(huì)有build/x64/vc16目錄這就是給 VS2019 用的。注意vc16對(duì)應(yīng) VS2019vc15對(duì)應(yīng) VS2017別搞混了。Qt 則用在線安裝器裝Qt 5.15.x的MSVC2019 64bit組件。這里有個(gè)版本兼容性問(wèn)題Qt 5.15 跟 OpenCV 4.x 配合沒(méi)問(wèn)題但如果你用 Qt 6OpenCV 的某些模塊可能會(huì)因?yàn)?C 標(biāo)準(zhǔn)差異而鏈接失敗。所以穩(wěn)妥起見(jiàn)Qt 5.15 OpenCV 4.x 是經(jīng)過(guò)驗(yàn)證的組合。在 VS2019 里配置 Qt 和 OpenCV 時(shí)我習(xí)慣用屬性表.props文件來(lái)管理包含目錄和庫(kù)目錄。這樣新建工程時(shí)直接導(dǎo)入屬性表不用每次都手動(dòng)填。屬性表里主要設(shè)置這幾項(xiàng)Include Directories加上 Qt 的include和 OpenCV 的includeLibrary Directories加上 Qt 的lib和 OpenCV 的libAdditional Dependencies里加上opencv_world4xx.lib、Qt5Core.lib、Qt5Gui.lib、Qt5Widgets.lib等。Debug 配置下要用帶d后綴的庫(kù)比如opencv_world4xxd.lib。提示Qt 的Q_OBJECT宏需要 moc 預(yù)處理如果你在 VS2019 里直接寫(xiě) Qt 類(lèi)記得在工程屬性里配置自定義生成工具或者用 Qt VS Tools 插件。我推薦裝 Qt VS Tools它能自動(dòng)處理 moc、uic、rcc省去手動(dòng)配置的麻煩。3. 實(shí)操過(guò)程與核心環(huán)節(jié)實(shí)現(xiàn)3.1 環(huán)境準(zhǔn)備與目錄結(jié)構(gòu)先規(guī)劃一個(gè)清晰的目錄結(jié)構(gòu)后面配置工程時(shí)不容易亂。我的習(xí)慣是這樣ScientificViz/ ├── 3rdparty/ │ ├── zlib/ │ │ ├── include/ │ │ ├── lib/ │ │ └── bin/ │ ├── libpng/ │ │ ├── include/ │ │ ├── lib/ │ │ └── bin/ │ ├── MathGL/ │ │ ├── include/ │ │ ├── lib/ │ │ └── bin/ │ ├── opencv/ │ │ ├── include/ │ │ ├── lib/ │ │ └── bin/ │ └── Qt/ │ ├── include/ │ ├── lib/ │ └── bin/ ├── src/ │ ├── main.cpp │ ├── MainWindow.cpp │ ├── MainWindow.h │ └── ... └── build/把每個(gè)庫(kù)的頭文件、庫(kù)文件、DLL 分別放在include、lib、bin下這樣在 VS2019 里配置路徑時(shí)一目了然。編譯好的 zlib、libpng、MathGL 都按這個(gè)結(jié)構(gòu)放OpenCV 和 Qt 則從安裝目錄里復(fù)制或直接引用。3.2 VS2019 工程配置步驟新建一個(gè) Qt Widgets Application 工程然后按以下步驟配置設(shè)置 C 標(biāo)準(zhǔn)在工程屬性里C/C - Language - C Language Standard選ISO C17 (/std:c17)。MathGL 和 OpenCV 都支持 C17Qt 5.15 也完全兼容。配置包含目錄在VC Directories - Include Directories里加上$(SolutionDir)3rdparty\zlib\include$(SolutionDir)3rdparty\libpng\include$(SolutionDir)3rdparty\MathGL\include$(SolutionDir)3rdparty\opencv\include$(SolutionDir)3rdparty\Qt\include$(SolutionDir)3rdparty\Qt\include\QtCore$(SolutionDir)3rdparty\Qt\include\QtGui$(SolutionDir)3rdparty\Qt\include\QtWidgets配置庫(kù)目錄在Library Directories里加上對(duì)應(yīng)的lib目錄。配置附加依賴(lài)項(xiàng)在Linker - Input - Additional Dependencies里加上zlib.liblibpng16.libmgl.libmglqt.libopencv_world4xx.libRelease或opencv_world4xxd.libDebugQt5Core.libQt5Gui.libQt5Widgets.lib設(shè)置運(yùn)行庫(kù)在C/C - Code Generation - Runtime Library里Release 選Multi-threaded DLL (/MD)Debug 選Multi-threaded Debug DLL (/MDd)。這個(gè)選項(xiàng)必須跟所有第三方庫(kù)一致否則會(huì)出現(xiàn)鏈接錯(cuò)誤或運(yùn)行時(shí)崩潰。配置 DLL 搜索路徑在Debugging - Environment里加上PATH$(SolutionDir)3rdparty\zlib\bin;$(SolutionDir)3rdparty\libpng\bin;$(SolutionDir)3rdparty\MathGL\bin;$(SolutionDir)3rdparty\opencv\bin;$(SolutionDir)3rdparty\Qt\bin;%PATH%。這樣調(diào)試時(shí)能自動(dòng)找到 DLL。3.3 核心代碼實(shí)現(xiàn)MathGL 繪圖與 OpenCV 圖像疊加先寫(xiě)一個(gè)最簡(jiǎn)單的 MathGL 繪圖窗口驗(yàn)證環(huán)境是否配通。在MainWindow里加一個(gè)QWidget作為繪圖容器然后用 MathGL 的mglGraphQT類(lèi)來(lái)繪制。#include mgl2/qt.h #include mgl2/mgl.h class PlotWidget : public QWidget { Q_OBJECT public: PlotWidget(QWidget *parent nullptr) : QWidget(parent) { m_graph new mglGraphQT(this); m_graph-setSize(800, 600); } void drawSurface() { mglData x(100), y(100), z(100, 100); x.set(-2, 2); y.set(-2, 2); for (int i 0; i 100; i) { for (int j 0; j 100; j) { double xi x.a[i]; double yj y.a[j]; z.a[i j * 100] sin(xi * xi yj * yj) / (xi * xi yj * yj 0.1); } } m_graph-Clf(); m_graph-Surf(z); m_graph-Axis(); m_graph-Update(); } private: mglGraphQT *m_graph; };這段代碼創(chuàng)建了一個(gè) 100x100 的網(wǎng)格計(jì)算了函數(shù)sin(x^2y^2)/(x^2y^20.1)的值然后用Surf繪制曲面。mglGraphQT繼承自QWidget可以直接嵌入 Qt 布局。接下來(lái)加入 OpenCV 的圖像處理。假設(shè)我們要讀取一張圖片做邊緣檢測(cè)然后把邊緣疊加到 MathGL 的曲面上作為紋理。OpenCV 讀取圖片的代碼如下#include opencv2/opencv.hpp cv::Mat loadAndProcessImage(const std::string path) { cv::Mat img cv::imread(path, cv::IMREAD_GRAYSCALE); if (img.empty()) { return cv::Mat(); } cv::Mat edges; cv::Canny(img, edges, 50, 150); return edges; }然后把這個(gè)edges矩陣轉(zhuǎn)成 MathGL 能用的數(shù)據(jù)格式。MathGL 的mglData可以從數(shù)組構(gòu)造所以我們需要把cv::Mat的數(shù)據(jù)指針傳進(jìn)去mglData matToMglData(const cv::Mat mat) { mglData data(mat.cols, mat.rows); for (int i 0; i mat.rows; i) { for (int j 0; j mat.cols; j) { data.a[j i * mat.cols] mat.atuchar(i, j) / 255.0; } } return data; }這樣就能把 OpenCV 處理后的圖像作為 MathGL 的紋理或高度圖來(lái)顯示了。實(shí)際項(xiàng)目中我經(jīng)常用這種方式把醫(yī)學(xué)圖像、遙感圖像或者顯微鏡圖像疊加到三維曲面上效果很直觀。3.4 參數(shù)計(jì)算與選擇過(guò)程在繪制曲面時(shí)網(wǎng)格密度和函數(shù)采樣范圍是兩個(gè)關(guān)鍵參數(shù)。網(wǎng)格太密計(jì)算量大、渲染慢網(wǎng)格太稀曲面看起來(lái)有棱角。我一般用 100x100 到 200x200 之間的網(wǎng)格具體看函數(shù)復(fù)雜度。對(duì)于sin(x^2y^2)/(x^2y^20.1)這種函數(shù)100x100 已經(jīng)足夠平滑了。采樣范圍也要根據(jù)函數(shù)特性來(lái)定。比如這個(gè)函數(shù)在原點(diǎn)附近有峰值范圍取[-2, 2]能完整顯示主瓣和第一旁瓣。如果取[-10, 10]主瓣會(huì)變得很小看起來(lái)不明顯。所以采樣范圍要結(jié)合函數(shù)的空間尺度來(lái)選一般取函數(shù)特征長(zhǎng)度的 3 到 5 倍。OpenCV 的 Canny 邊緣檢測(cè)有兩個(gè)閾值低閾值和高閾值。我通常按 1:2 或 1:3 的比例來(lái)設(shè)比如 50 和 150。低閾值控制弱邊緣的檢出高閾值控制強(qiáng)邊緣的確認(rèn)。如果邊緣斷斷續(xù)續(xù)就降低低閾值如果噪聲太多就提高高閾值。這個(gè)需要根據(jù)具體圖像反復(fù)調(diào)沒(méi)有萬(wàn)能參數(shù)。4. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄4.1 鏈接錯(cuò)誤與運(yùn)行庫(kù)不匹配這是最常見(jiàn)的問(wèn)題癥狀是LNK2038或LNK2005錯(cuò)誤提示RuntimeLibrary不匹配。原因很簡(jiǎn)單你的工程用了/MD但某個(gè)第三方庫(kù)是用/MT編譯的。解決辦法是統(tǒng)一所有庫(kù)的運(yùn)行庫(kù)選項(xiàng)。zlib、libpng、MathGL 在編譯時(shí)都要檢查 CMake 里的CMAKE_MSVC_RUNTIME_LIBRARY選項(xiàng)確保跟主工程一致。OpenCV 官方預(yù)編譯包用的是/MDQt 也是/MD所以主工程用/MD和/MDd就行。注意Debug 配置下一定要用/MDd并且鏈接帶d后綴的庫(kù)。如果你在 Debug 下鏈接了 Release 版的 OpenCV可能會(huì)出現(xiàn)堆損壞或者莫名其妙的崩潰。4.2 MathGL 窗口無(wú)法顯示或閃退如果程序啟動(dòng)后 MathGL 窗口一片空白或者直接閃退先檢查mglqt.dll是否在輸出目錄。MathGL 的 Qt 模塊依賴(lài)這個(gè) DLL如果找不到程序會(huì)靜默失敗。另外mglGraphQT必須在 Qt 的 GUI 線程里創(chuàng)建不能在子線程里直接 new否則會(huì)報(bào)線程錯(cuò)誤。還有一個(gè)坑MathGL 的Update()方法只是刷新內(nèi)部繪圖緩存真正顯示到窗口上還需要 Qt 的事件循環(huán)來(lái)處理。如果你在drawSurface()之后沒(méi)有讓 Qt 處理事件窗口可能不會(huì)立即刷新。解決辦法是在drawSurface()末尾調(diào)用QCoreApplication::processEvents()或者把繪圖操作放在paintEvent里。4.3 OpenCV 讀取圖像失敗cv::imread返回空矩陣通常是因?yàn)槁窂讲粚?duì)或者缺少圖像格式支持。OpenCV 預(yù)編譯包默認(rèn)支持 JPEG、PNG、TIFF 等常見(jiàn)格式但如果你用的是自己編譯的 OpenCV可能沒(méi)打開(kāi)這些格式的支持。檢查 CMake 里的WITH_JPEG、WITH_PNG、WITH_TIFF選項(xiàng)是否打開(kāi)。另外路徑里如果有中文或空格也可能導(dǎo)致讀取失敗建議用絕對(duì)路徑并確保路徑全是英文。4.4 Qt 與 MathGL 的鼠標(biāo)事件沖突MathGL 的mglGraphQT自帶鼠標(biāo)交互比如旋轉(zhuǎn)、縮放。如果你在 Qt 層面也處理鼠標(biāo)事件可能會(huì)沖突。比如你在MainWindow里重寫(xiě)了mouseMoveEvent但 MathGL 也想處理這個(gè)事件結(jié)果就是旋轉(zhuǎn)不靈敏或者跳變。解決辦法是在 MathGL 的mglGraphQT上安裝事件過(guò)濾器把不需要的鼠標(biāo)事件攔截掉或者干脆讓 MathGL 全權(quán)處理繪圖區(qū)域的鼠標(biāo)事件Qt 只處理菜單和按鈕。4.5 常見(jiàn)問(wèn)題速查表問(wèn)題現(xiàn)象可能原因排查方法解決方案鏈接錯(cuò)誤 LNK2038運(yùn)行庫(kù)不匹配檢查各庫(kù)的 Runtime Library 選項(xiàng)統(tǒng)一用 /MD 或 /MDd程序啟動(dòng)閃退缺少 DLL用 Dependency Walker 檢查依賴(lài)復(fù)制缺失的 DLL 到輸出目錄MathGL 窗口空白mglqt.dll 未找到檢查輸出目錄是否有 mglqt.dll復(fù)制 MathGL 的 bin 目錄到輸出目錄OpenCV 讀圖失敗格式不支持或路徑錯(cuò)誤檢查 imread 返回值確認(rèn)路徑正確重新編譯 OpenCV 并打開(kāi)格式支持鼠標(biāo)旋轉(zhuǎn)不靈敏事件沖突檢查是否重寫(xiě)了鼠標(biāo)事件讓 MathGL 獨(dú)占繪圖區(qū)鼠標(biāo)事件曲面顯示有棱角網(wǎng)格太稀增加網(wǎng)格密度把 100x100 改成 200x200編譯 MathGL 報(bào)錯(cuò)CMake 配置不對(duì)檢查 enable-qt 和 enable-opencv確保 Qt 和 OpenCV 路徑正確4.6 獨(dú)家避坑技巧第一個(gè)技巧用屬性表管理配置。VS2019 的工程屬性可以導(dǎo)出為.props文件把包含目錄、庫(kù)目錄、附加依賴(lài)項(xiàng)都寫(xiě)進(jìn)去。新建工程時(shí)直接導(dǎo)入不用重復(fù)填。而且屬性表可以按 Debug/Release 分別設(shè)置切換配置時(shí)自動(dòng)生效。第二個(gè)技巧編譯 MathGL 時(shí)關(guān)掉不需要的模塊。MathGL 支持很多后端比如 FLTK、GLUT、wxWidgets。如果你只用 Qt就在 CMake 里把其他后端全關(guān)掉能省一半編譯時(shí)間。具體是在 CMake 里設(shè)置enable-fltkOFF、enable-glutOFF、enable-wxOFF。第三個(gè)技巧OpenCV 的 DLL 太多用靜態(tài)庫(kù)更省事。OpenCV 官方預(yù)編譯包只提供動(dòng)態(tài)庫(kù)如果你不想帶一堆 DLL可以自己編譯靜態(tài)庫(kù)。在 CMake 里設(shè)置BUILD_SHARED_LIBSOFF編譯出來(lái)的opencv_world4xx.lib就是靜態(tài)庫(kù)鏈接后不需要額外的 DLL。但靜態(tài)庫(kù)體積會(huì)大很多最終 exe 可能上百 MB看你怎么取舍。第四個(gè)技巧MathGL 的字體問(wèn)題。MathGL 默認(rèn)使用系統(tǒng)字體如果中文顯示亂碼需要在mglGraph里設(shè)置字體?？梢杂胢_graph-SetFont(Arial, 12)來(lái)指定英文字體中文則需要用m_graph-SetFont(SimHei, 12)并確保系統(tǒng)里有這個(gè)字體。如果還是亂碼檢查 MathGL 編譯時(shí)是否打開(kāi)了enable-fontconfig或enable-qt的字體支持。5. 擴(kuò)展應(yīng)用與性能優(yōu)化5.1 實(shí)時(shí)數(shù)據(jù)可視化這套組合不僅能畫(huà)靜態(tài)曲面還能做實(shí)時(shí)數(shù)據(jù)可視化。比如你有一個(gè)傳感器不斷產(chǎn)生數(shù)據(jù)可以用 OpenCV 做預(yù)處理然后用 MathGL 實(shí)時(shí)刷新曲線。關(guān)鍵是把繪圖操作放在一個(gè)獨(dú)立的定時(shí)器里每隔 50ms 刷新一次同時(shí)用QElapsedTimer控制刷新頻率避免過(guò)度占用 CPU。實(shí)時(shí)刷新的代碼結(jié)構(gòu)大概是QTimer觸發(fā)updatePlot()在updatePlot()里從數(shù)據(jù)緩沖區(qū)讀取最新數(shù)據(jù)更新mglData然后調(diào)用m_graph-Clf()和m_graph-Plot()最后m_graph-Update()。注意每次刷新前要清空繪圖區(qū)否則舊曲線會(huì)殘留。5.2 多線程與計(jì)算加速如果數(shù)據(jù)量很大繪圖前的計(jì)算可能成為瓶頸。比如你要對(duì) 1000x1000 的矩陣做 FFT 然后畫(huà)頻譜圖單線程計(jì)算可能要幾百毫秒。這時(shí)候可以用 Qt 的QThread或者QtConcurrent把計(jì)算放到后臺(tái)線程計(jì)算完再通知主線程繪圖。MathGL 的繪圖操作必須在主線程執(zhí)行但數(shù)據(jù)準(zhǔn)備可以在子線程完成。具體做法是定義一個(gè)Worker類(lèi)繼承QObject在run()方法里做計(jì)算算完后發(fā)信號(hào)resultReady(mglData)給主線程。主線程收到信號(hào)后更新繪圖。這樣界面不會(huì)卡頓用戶(hù)體驗(yàn)好很多。5.3 部署與打包最終程序要發(fā)布時(shí)需要把依賴(lài)的 DLL 都帶上。我一般用windeployqt工具自動(dòng)復(fù)制 Qt 相關(guān)的 DLL然后手動(dòng)復(fù)制 zlib、libpng、MathGL、OpenCV 的 DLL。如果嫌麻煩可以用Enigma Virtual Box或者Inno Setup打包成一個(gè)安裝包。注意 MathGL 的字體文件和 OpenCV 的opencv_world4xx.dll體積都不小打包前先確認(rèn)哪些是必需的能精簡(jiǎn)就精簡(jiǎn)。提示如果目標(biāo)機(jī)器沒(méi)有安裝 VS2019 運(yùn)行時(shí)還需要帶上vcruntime140.dll和msvcp140.dll。這兩個(gè)文件可以從 VS2019 安裝目錄里找到或者讓用戶(hù)安裝 VC Redistributable。5.4 跨平臺(tái)移植的注意事項(xiàng)這套方案在 Windows 上跑通了如果想移植到 Linux主要改編譯方式。zlib、libpng、MathGL、OpenCV 在 Linux 下都可以用包管理器安裝Qt 也有對(duì)應(yīng)的版本。但要注意 MathGL 的 Qt 模塊在 Linux 下可能依賴(lài)libmgl-qt5包安裝時(shí)確認(rèn)一下。另外Windows 下的路徑分隔符是反斜杠Linux 下是正斜杠代碼里最好用QDir::separator()或者統(tǒng)一用正斜杠Qt 會(huì)自動(dòng)處理。移植到 macOS 也類(lèi)似用 Homebrew 安裝依賴(lài)Xcode 編譯。但 MathGL 在 macOS 下的 Qt 集成可能需要額外配置因?yàn)?macOS 的窗口系統(tǒng)跟 Windows 差異較大。如果只是做科學(xué)計(jì)算可視化不考慮跨平臺(tái)那 Windows 方案已經(jīng)足夠用了。5.5 性能對(duì)比與選型建議最后說(shuō)一下這幾個(gè)庫(kù)的選型邏輯。MathGL 的優(yōu)勢(shì)是繪圖函數(shù)豐富支持 3D 曲面、等值線、矢量場(chǎng)而且跟 Qt 集成度高。OpenCV 的優(yōu)勢(shì)是圖像處理和矩陣運(yùn)算如果你不需要圖像處理其實(shí)可以不用 OpenCV直接用 MathGL 的矩陣運(yùn)算也夠。Qt 的優(yōu)勢(shì)是界面和事件循環(huán)如果你只是畫(huà)個(gè)圖看看甚至可以用 MathGL 自帶的窗口不用 Qt。但如果你要做交互式應(yīng)用Qt 是繞不開(kāi)的。zlib 和 libpng 是底層依賴(lài)一般不用直接調(diào)用但編譯時(shí)必須有。如果你用 OpenCV 讀 PNGOpenCV 內(nèi)部會(huì)調(diào)用 libpng所以這兩個(gè)庫(kù)的版本要跟 OpenCV 兼容。我一般用 zlib 1.2.11 和 libpng 1.6.37這兩個(gè)版本跟 OpenCV 4.x 配合很穩(wěn)定。這套組合我用了好幾年從最初的編譯踩坑到現(xiàn)在的順手拈來(lái)中間積累的經(jīng)驗(yàn)基本都寫(xiě)在這里了。如果你按這個(gè)流程走應(yīng)該能少走很多彎路。遇到問(wèn)題先查依賴(lài)關(guān)系再查運(yùn)行庫(kù)最后查路徑大部分問(wèn)題都能解決。 VS2019編譯zlib、libpng、MathGL、OpenCV、Qt實(shí)現(xiàn)科學(xué)計(jì)算可視化
1. 項(xiàng)目緣起與整體設(shè)計(jì)思路搞科學(xué)計(jì)算可視化這件事最讓人頭疼的往往不是算法本身而是從數(shù)據(jù)到圖像這條鏈路上各種庫(kù)之間的依賴(lài)關(guān)系能把人折騰得夠嗆。我這次要聊的就是怎么把zlib、libpng、MathGL、OpenCV、Qt這幾樣?xùn)|西在VS2019環(huán)境下編譯并串起來(lái)最終跑出一個(gè)能畫(huà)函數(shù)曲面、能顯示圖像、還能交互操作的可視化程序。這套組合聽(tīng)起來(lái)有點(diǎn)雜但實(shí)際用起來(lái)非常順手MathGL 負(fù)責(zé)數(shù)學(xué)繪圖OpenCV 處理圖像數(shù)據(jù)Qt 做界面zlib 和 libpng 則是底層壓縮與圖像格式的支撐。先說(shuō)清楚這個(gè)項(xiàng)目適合誰(shuí)看。如果你正在做數(shù)值計(jì)算、信號(hào)處理、圖像分析或者單純想給自己的 C 程序加一個(gè)能畫(huà)三維曲面的窗口那這套方案基本可以直接抄作業(yè)。它不依賴(lài) Python 那套臃腫的運(yùn)行時(shí)編譯出來(lái)就是原生可執(zhí)行文件啟動(dòng)快、部署簡(jiǎn)單。當(dāng)然前提是你得愿意花點(diǎn)時(shí)間把編譯環(huán)境搭好因?yàn)檫@幾個(gè)庫(kù)的源碼編譯確實(shí)有些坑要踩。為什么選 VS2019 而不是 VS2022 或者 MinGW原因很實(shí)際VS2019 對(duì) C14/17 的支持已經(jīng)足夠穩(wěn)定而且它的 MSVC 編譯器在 Windows 上跟 Qt、OpenCV 的預(yù)編譯包兼容性最好。MathGL 官方雖然也提供 MinGW 的編譯方式但在 Windows 下用 MSVC 編譯出來(lái)的庫(kù)跟 Qt 的 MSVC 版本能無(wú)縫鏈接省去很多 ABI 不匹配的麻煩。至于 zlib 和 libpng它們本身就是 C 庫(kù)用 MSVC 編譯幾乎不會(huì)遇到語(yǔ)言層面的問(wèn)題主要注意運(yùn)行庫(kù)選項(xiàng)一致就行。整體架構(gòu)上我把它分成三層最底層是zlib 和 libpng負(fù)責(zé)數(shù)據(jù)壓縮和 PNG 圖像讀寫(xiě)中間層是MathGL 和 OpenCVMathGL 做數(shù)學(xué)繪圖OpenCV 做圖像處理與矩陣運(yùn)算最上層是Qt負(fù)責(zé)窗口、控件和事件循環(huán)。這樣分層的好處是每一層都可以獨(dú)立替換或升級(jí)。比如你不想用 MathGL 畫(huà)圖換成 QCustomPlot 也行不想用 OpenCV 讀圖換成 Qt 自帶的 QImage 也可以。但既然標(biāo)題里點(diǎn)名了這幾個(gè)庫(kù)我就按這個(gè)組合來(lái)展開(kāi)。還有一個(gè)關(guān)鍵決策全部從源碼編譯還是用預(yù)編譯包我的建議是zlib 和 libpng 從源碼編譯因?yàn)樗鼈兊木幾g過(guò)程非常簡(jiǎn)單而且能確保跟后續(xù)庫(kù)使用相同的運(yùn)行庫(kù)選項(xiàng)。MathGL 也建議從源碼編譯因?yàn)楣俜筋A(yù)編譯包不一定帶 OpenCV 支持而我們需要它跟 OpenCV 協(xié)同工作。OpenCV 和 Qt 則可以用官方預(yù)編譯包但要注意版本匹配——Qt 要用 MSVC2019 64bit 版本OpenCV 要用對(duì)應(yīng) VS2019 的預(yù)編譯庫(kù)。這樣混合策略能省下大量編譯時(shí)間同時(shí)保證關(guān)鍵環(huán)節(jié)可控。2. 核心細(xì)節(jié)解析與實(shí)操要點(diǎn)2.1 zlib 與 libpng 的編譯細(xì)節(jié)zlib 的編譯可以說(shuō)是整個(gè)鏈條里最簡(jiǎn)單的。下載源碼后用 VS2019 的開(kāi)發(fā)者命令提示符進(jìn)入目錄執(zhí)行nmake -f win32/Makefile.msc就能生成zlib.lib和zlib1.dll。但這里有個(gè)細(xì)節(jié)默認(rèn)生成的庫(kù)是 Release 版本如果你后續(xù)要調(diào)試需要手動(dòng)改 Makefile 里的編譯選項(xiàng)加上/Zi和/DEBUG。我一般會(huì)編譯兩份一份 Release 一份 Debug分別放在lib/Release和lib/Debug目錄下后面配置工程時(shí)按配置切換。libpng 的編譯稍微麻煩一點(diǎn)因?yàn)樗蕾?lài) zlib。在 VS2019 里我習(xí)慣用 CMake 來(lái)生成工程文件。具體做法是新建一個(gè)build目錄用 CMake GUI 指定 libpng 源碼路徑和 build 路徑然后設(shè)置ZLIB_LIBRARY和ZLIB_INCLUDE_DIR指向剛才編譯好的 zlib。這里有個(gè)坑libpng 的 CMake 腳本會(huì)自動(dòng)查找 zlib但如果你的 zlib 是手動(dòng)編譯的它可能找不到。解決辦法是在 CMake 里手動(dòng)指定ZLIB_LIBRARY為zlib.lib的完整路徑ZLIB_INCLUDE_DIR為 zlib 源碼目錄。生成工程后用 VS2019 打開(kāi)libpng.sln編譯png_static或png_shared目標(biāo)就能得到libpng16.lib。注意libpng 編譯時(shí)一定要確保PNG_SHARED和PNG_STATIC的選項(xiàng)跟你的使用方式一致。如果你打算靜態(tài)鏈接到最終程序里就編譯靜態(tài)庫(kù)如果打算用 DLL就編譯動(dòng)態(tài)庫(kù)。我一般選靜態(tài)庫(kù)部署時(shí)少帶幾個(gè) DLL。2.2 MathGL 編譯與 OpenCV 支持MathGL 的編譯是整個(gè)項(xiàng)目里最費(fèi)時(shí)間的部分。它依賴(lài) zlib、libpng還可以選擇性地支持 OpenCV。在 CMake 配置階段你需要打開(kāi)enable-opencv選項(xiàng)并指定 OpenCV 的路徑。這里有個(gè)關(guān)鍵點(diǎn)MathGL 的 OpenCV 支持主要用于讀取圖像作為紋理或者進(jìn)行圖像處理如果你不需要這些功能可以關(guān)掉能省不少編譯時(shí)間。但既然標(biāo)題里提到了 OpenCV我建議還是打開(kāi)后面做圖像與繪圖疊加時(shí)會(huì)用到。MathGL 的 CMake 配置里還有幾個(gè)選項(xiàng)值得注意enable-qt要打開(kāi)這樣它才能跟 Qt 集成enable-double建議打開(kāi)科學(xué)計(jì)算里雙精度更穩(wěn)妥enable-openmp看情況如果你做大規(guī)模數(shù)據(jù)繪圖打開(kāi)能加速但會(huì)引入 OpenMP 運(yùn)行時(shí)依賴(lài)。我一般會(huì)打開(kāi)enable-qt和enable-double關(guān)掉enable-openmp因?yàn)?Qt 本身的事件循環(huán)已經(jīng)夠用了OpenMP 在某些環(huán)境下反而會(huì)跟 Qt 的線程模型沖突。編譯 MathGL 時(shí)VS2019 可能會(huì)報(bào)一些警告比如sprintf不安全之類(lèi)的。這些警告不影響編譯結(jié)果但如果你有強(qiáng)迫癥可以在 CMake 里加上-D_CRT_SECURE_NO_WARNINGS來(lái)屏蔽。另外MathGL 的 Qt 模塊會(huì)生成mglqt.lib和對(duì)應(yīng)的 DLL記得把這些 DLL 復(fù)制到最終程序的輸出目錄否則運(yùn)行時(shí)會(huì)提示找不到庫(kù)。2.3 OpenCV 與 Qt 的版本匹配OpenCV 我直接用官方預(yù)編譯包下載opencv-4.x-windows.exe自解壓后里面會(huì)有build/x64/vc16目錄這就是給 VS2019 用的。注意vc16對(duì)應(yīng) VS2019vc15對(duì)應(yīng) VS2017別搞混了。Qt 則用在線安裝器裝Qt 5.15.x的MSVC2019 64bit組件。這里有個(gè)版本兼容性問(wèn)題Qt 5.15 跟 OpenCV 4.x 配合沒(méi)問(wèn)題但如果你用 Qt 6OpenCV 的某些模塊可能會(huì)因?yàn)?C 標(biāo)準(zhǔn)差異而鏈接失敗。所以穩(wěn)妥起見(jiàn)Qt 5.15 OpenCV 4.x 是經(jīng)過(guò)驗(yàn)證的組合。在 VS2019 里配置 Qt 和 OpenCV 時(shí)我習(xí)慣用屬性表.props文件來(lái)管理包含目錄和庫(kù)目錄。這樣新建工程時(shí)直接導(dǎo)入屬性表不用每次都手動(dòng)填。屬性表里主要設(shè)置這幾項(xiàng)Include Directories加上 Qt 的include和 OpenCV 的includeLibrary Directories加上 Qt 的lib和 OpenCV 的libAdditional Dependencies里加上opencv_world4xx.lib、Qt5Core.lib、Qt5Gui.lib、Qt5Widgets.lib等。Debug 配置下要用帶d后綴的庫(kù)比如opencv_world4xxd.lib。提示Qt 的Q_OBJECT宏需要 moc 預(yù)處理如果你在 VS2019 里直接寫(xiě) Qt 類(lèi)記得在工程屬性里配置自定義生成工具或者用 Qt VS Tools 插件。我推薦裝 Qt VS Tools它能自動(dòng)處理 moc、uic、rcc省去手動(dòng)配置的麻煩。3. 實(shí)操過(guò)程與核心環(huán)節(jié)實(shí)現(xiàn)3.1 環(huán)境準(zhǔn)備與目錄結(jié)構(gòu)先規(guī)劃一個(gè)清晰的目錄結(jié)構(gòu)后面配置工程時(shí)不容易亂。我的習(xí)慣是這樣ScientificViz/ ├── 3rdparty/ │ ├── zlib/ │ │ ├── include/ │ │ ├── lib/ │ │ └── bin/ │ ├── libpng/ │ │ ├── include/ │ │ ├── lib/ │ │ └── bin/ │ ├── MathGL/ │ │ ├── include/ │ │ ├── lib/ │ │ └── bin/ │ ├── opencv/ │ │ ├── include/ │ │ ├── lib/ │ │ └── bin/ │ └── Qt/ │ ├── include/ │ ├── lib/ │ └── bin/ ├── src/ │ ├── main.cpp │ ├── MainWindow.cpp │ ├── MainWindow.h │ └── ... └── build/把每個(gè)庫(kù)的頭文件、庫(kù)文件、DLL 分別放在include、lib、bin下這樣在 VS2019 里配置路徑時(shí)一目了然。編譯好的 zlib、libpng、MathGL 都按這個(gè)結(jié)構(gòu)放OpenCV 和 Qt 則從安裝目錄里復(fù)制或直接引用。3.2 VS2019 工程配置步驟新建一個(gè) Qt Widgets Application 工程然后按以下步驟配置設(shè)置 C 標(biāo)準(zhǔn)在工程屬性里C/C - Language - C Language Standard選ISO C17 (/std:c17)。MathGL 和 OpenCV 都支持 C17Qt 5.15 也完全兼容。配置包含目錄在VC Directories - Include Directories里加上$(SolutionDir)3rdparty\zlib\include$(SolutionDir)3rdparty\libpng\include$(SolutionDir)3rdparty\MathGL\include$(SolutionDir)3rdparty\opencv\include$(SolutionDir)3rdparty\Qt\include$(SolutionDir)3rdparty\Qt\include\QtCore$(SolutionDir)3rdparty\Qt\include\QtGui$(SolutionDir)3rdparty\Qt\include\QtWidgets配置庫(kù)目錄在Library Directories里加上對(duì)應(yīng)的lib目錄。配置附加依賴(lài)項(xiàng)在Linker - Input - Additional Dependencies里加上zlib.liblibpng16.libmgl.libmglqt.libopencv_world4xx.libRelease或opencv_world4xxd.libDebugQt5Core.libQt5Gui.libQt5Widgets.lib設(shè)置運(yùn)行庫(kù)在C/C - Code Generation - Runtime Library里Release 選Multi-threaded DLL (/MD)Debug 選Multi-threaded Debug DLL (/MDd)。這個(gè)選項(xiàng)必須跟所有第三方庫(kù)一致否則會(huì)出現(xiàn)鏈接錯(cuò)誤或運(yùn)行時(shí)崩潰。配置 DLL 搜索路徑在Debugging - Environment里加上PATH$(SolutionDir)3rdparty\zlib\bin;$(SolutionDir)3rdparty\libpng\bin;$(SolutionDir)3rdparty\MathGL\bin;$(SolutionDir)3rdparty\opencv\bin;$(SolutionDir)3rdparty\Qt\bin;%PATH%。這樣調(diào)試時(shí)能自動(dòng)找到 DLL。3.3 核心代碼實(shí)現(xiàn)MathGL 繪圖與 OpenCV 圖像疊加先寫(xiě)一個(gè)最簡(jiǎn)單的 MathGL 繪圖窗口驗(yàn)證環(huán)境是否配通。在MainWindow里加一個(gè)QWidget作為繪圖容器然后用 MathGL 的mglGraphQT類(lèi)來(lái)繪制。#include mgl2/qt.h #include mgl2/mgl.h class PlotWidget : public QWidget { Q_OBJECT public: PlotWidget(QWidget *parent nullptr) : QWidget(parent) { m_graph new mglGraphQT(this); m_graph-setSize(800, 600); } void drawSurface() { mglData x(100), y(100), z(100, 100); x.set(-2, 2); y.set(-2, 2); for (int i 0; i 100; i) { for (int j 0; j 100; j) { double xi x.a[i]; double yj y.a[j]; z.a[i j * 100] sin(xi * xi yj * yj) / (xi * xi yj * yj 0.1); } } m_graph-Clf(); m_graph-Surf(z); m_graph-Axis(); m_graph-Update(); } private: mglGraphQT *m_graph; };這段代碼創(chuàng)建了一個(gè) 100x100 的網(wǎng)格計(jì)算了函數(shù)sin(x^2y^2)/(x^2y^20.1)的值然后用Surf繪制曲面。mglGraphQT繼承自QWidget可以直接嵌入 Qt 布局。接下來(lái)加入 OpenCV 的圖像處理。假設(shè)我們要讀取一張圖片做邊緣檢測(cè)然后把邊緣疊加到 MathGL 的曲面上作為紋理。OpenCV 讀取圖片的代碼如下#include opencv2/opencv.hpp cv::Mat loadAndProcessImage(const std::string path) { cv::Mat img cv::imread(path, cv::IMREAD_GRAYSCALE); if (img.empty()) { return cv::Mat(); } cv::Mat edges; cv::Canny(img, edges, 50, 150); return edges; }然后把這個(gè)edges矩陣轉(zhuǎn)成 MathGL 能用的數(shù)據(jù)格式。MathGL 的mglData可以從數(shù)組構(gòu)造所以我們需要把cv::Mat的數(shù)據(jù)指針傳進(jìn)去mglData matToMglData(const cv::Mat mat) { mglData data(mat.cols, mat.rows); for (int i 0; i mat.rows; i) { for (int j 0; j mat.cols; j) { data.a[j i * mat.cols] mat.atuchar(i, j) / 255.0; } } return data; }這樣就能把 OpenCV 處理后的圖像作為 MathGL 的紋理或高度圖來(lái)顯示了。實(shí)際項(xiàng)目中我經(jīng)常用這種方式把醫(yī)學(xué)圖像、遙感圖像或者顯微鏡圖像疊加到三維曲面上效果很直觀。3.4 參數(shù)計(jì)算與選擇過(guò)程在繪制曲面時(shí)網(wǎng)格密度和函數(shù)采樣范圍是兩個(gè)關(guān)鍵參數(shù)。網(wǎng)格太密計(jì)算量大、渲染慢網(wǎng)格太稀曲面看起來(lái)有棱角。我一般用 100x100 到 200x200 之間的網(wǎng)格具體看函數(shù)復(fù)雜度。對(duì)于sin(x^2y^2)/(x^2y^20.1)這種函數(shù)100x100 已經(jīng)足夠平滑了。采樣范圍也要根據(jù)函數(shù)特性來(lái)定。比如這個(gè)函數(shù)在原點(diǎn)附近有峰值范圍取[-2, 2]能完整顯示主瓣和第一旁瓣。如果取[-10, 10]主瓣會(huì)變得很小看起來(lái)不明顯。所以采樣范圍要結(jié)合函數(shù)的空間尺度來(lái)選一般取函數(shù)特征長(zhǎng)度的 3 到 5 倍。OpenCV 的 Canny 邊緣檢測(cè)有兩個(gè)閾值低閾值和高閾值。我通常按 1:2 或 1:3 的比例來(lái)設(shè)比如 50 和 150。低閾值控制弱邊緣的檢出高閾值控制強(qiáng)邊緣的確認(rèn)。如果邊緣斷斷續(xù)續(xù)就降低低閾值如果噪聲太多就提高高閾值。這個(gè)需要根據(jù)具體圖像反復(fù)調(diào)沒(méi)有萬(wàn)能參數(shù)。4. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄4.1 鏈接錯(cuò)誤與運(yùn)行庫(kù)不匹配這是最常見(jiàn)的問(wèn)題癥狀是LNK2038或LNK2005錯(cuò)誤提示RuntimeLibrary不匹配。原因很簡(jiǎn)單你的工程用了/MD但某個(gè)第三方庫(kù)是用/MT編譯的。解決辦法是統(tǒng)一所有庫(kù)的運(yùn)行庫(kù)選項(xiàng)。zlib、libpng、MathGL 在編譯時(shí)都要檢查 CMake 里的CMAKE_MSVC_RUNTIME_LIBRARY選項(xiàng)確保跟主工程一致。OpenCV 官方預(yù)編譯包用的是/MDQt 也是/MD所以主工程用/MD和/MDd就行。注意Debug 配置下一定要用/MDd并且鏈接帶d后綴的庫(kù)。如果你在 Debug 下鏈接了 Release 版的 OpenCV可能會(huì)出現(xiàn)堆損壞或者莫名其妙的崩潰。4.2 MathGL 窗口無(wú)法顯示或閃退如果程序啟動(dòng)后 MathGL 窗口一片空白或者直接閃退先檢查mglqt.dll是否在輸出目錄。MathGL 的 Qt 模塊依賴(lài)這個(gè) DLL如果找不到程序會(huì)靜默失敗。另外mglGraphQT必須在 Qt 的 GUI 線程里創(chuàng)建不能在子線程里直接 new否則會(huì)報(bào)線程錯(cuò)誤。還有一個(gè)坑MathGL 的Update()方法只是刷新內(nèi)部繪圖緩存真正顯示到窗口上還需要 Qt 的事件循環(huán)來(lái)處理。如果你在drawSurface()之后沒(méi)有讓 Qt 處理事件窗口可能不會(huì)立即刷新。解決辦法是在drawSurface()末尾調(diào)用QCoreApplication::processEvents()或者把繪圖操作放在paintEvent里。4.3 OpenCV 讀取圖像失敗cv::imread返回空矩陣通常是因?yàn)槁窂讲粚?duì)或者缺少圖像格式支持。OpenCV 預(yù)編譯包默認(rèn)支持 JPEG、PNG、TIFF 等常見(jiàn)格式但如果你用的是自己編譯的 OpenCV可能沒(méi)打開(kāi)這些格式的支持。檢查 CMake 里的WITH_JPEG、WITH_PNG、WITH_TIFF選項(xiàng)是否打開(kāi)。另外路徑里如果有中文或空格也可能導(dǎo)致讀取失敗建議用絕對(duì)路徑并確保路徑全是英文。4.4 Qt 與 MathGL 的鼠標(biāo)事件沖突MathGL 的mglGraphQT自帶鼠標(biāo)交互比如旋轉(zhuǎn)、縮放。如果你在 Qt 層面也處理鼠標(biāo)事件可能會(huì)沖突。比如你在MainWindow里重寫(xiě)了mouseMoveEvent但 MathGL 也想處理這個(gè)事件結(jié)果就是旋轉(zhuǎn)不靈敏或者跳變。解決辦法是在 MathGL 的mglGraphQT上安裝事件過(guò)濾器把不需要的鼠標(biāo)事件攔截掉或者干脆讓 MathGL 全權(quán)處理繪圖區(qū)域的鼠標(biāo)事件Qt 只處理菜單和按鈕。4.5 常見(jiàn)問(wèn)題速查表問(wèn)題現(xiàn)象可能原因排查方法解決方案鏈接錯(cuò)誤 LNK2038運(yùn)行庫(kù)不匹配檢查各庫(kù)的 Runtime Library 選項(xiàng)統(tǒng)一用 /MD 或 /MDd程序啟動(dòng)閃退缺少 DLL用 Dependency Walker 檢查依賴(lài)復(fù)制缺失的 DLL 到輸出目錄MathGL 窗口空白mglqt.dll 未找到檢查輸出目錄是否有 mglqt.dll復(fù)制 MathGL 的 bin 目錄到輸出目錄OpenCV 讀圖失敗格式不支持或路徑錯(cuò)誤檢查 imread 返回值確認(rèn)路徑正確重新編譯 OpenCV 并打開(kāi)格式支持鼠標(biāo)旋轉(zhuǎn)不靈敏事件沖突檢查是否重寫(xiě)了鼠標(biāo)事件讓 MathGL 獨(dú)占繪圖區(qū)鼠標(biāo)事件曲面顯示有棱角網(wǎng)格太稀增加網(wǎng)格密度把 100x100 改成 200x200編譯 MathGL 報(bào)錯(cuò)CMake 配置不對(duì)檢查 enable-qt 和 enable-opencv確保 Qt 和 OpenCV 路徑正確4.6 獨(dú)家避坑技巧第一個(gè)技巧用屬性表管理配置。VS2019 的工程屬性可以導(dǎo)出為.props文件把包含目錄、庫(kù)目錄、附加依賴(lài)項(xiàng)都寫(xiě)進(jìn)去。新建工程時(shí)直接導(dǎo)入不用重復(fù)填。而且屬性表可以按 Debug/Release 分別設(shè)置切換配置時(shí)自動(dòng)生效。第二個(gè)技巧編譯 MathGL 時(shí)關(guān)掉不需要的模塊。MathGL 支持很多后端比如 FLTK、GLUT、wxWidgets。如果你只用 Qt就在 CMake 里把其他后端全關(guān)掉能省一半編譯時(shí)間。具體是在 CMake 里設(shè)置enable-fltkOFF、enable-glutOFF、enable-wxOFF。第三個(gè)技巧OpenCV 的 DLL 太多用靜態(tài)庫(kù)更省事。OpenCV 官方預(yù)編譯包只提供動(dòng)態(tài)庫(kù)如果你不想帶一堆 DLL可以自己編譯靜態(tài)庫(kù)。在 CMake 里設(shè)置BUILD_SHARED_LIBSOFF編譯出來(lái)的opencv_world4xx.lib就是靜態(tài)庫(kù)鏈接后不需要額外的 DLL。但靜態(tài)庫(kù)體積會(huì)大很多最終 exe 可能上百 MB看你怎么取舍。第四個(gè)技巧MathGL 的字體問(wèn)題。MathGL 默認(rèn)使用系統(tǒng)字體如果中文顯示亂碼需要在mglGraph里設(shè)置字體?？梢杂胢_graph-SetFont(Arial, 12)來(lái)指定英文字體中文則需要用m_graph-SetFont(SimHei, 12)并確保系統(tǒng)里有這個(gè)字體。如果還是亂碼檢查 MathGL 編譯時(shí)是否打開(kāi)了enable-fontconfig或enable-qt的字體支持。5. 擴(kuò)展應(yīng)用與性能優(yōu)化5.1 實(shí)時(shí)數(shù)據(jù)可視化這套組合不僅能畫(huà)靜態(tài)曲面還能做實(shí)時(shí)數(shù)據(jù)可視化。比如你有一個(gè)傳感器不斷產(chǎn)生數(shù)據(jù)可以用 OpenCV 做預(yù)處理然后用 MathGL 實(shí)時(shí)刷新曲線。關(guān)鍵是把繪圖操作放在一個(gè)獨(dú)立的定時(shí)器里每隔 50ms 刷新一次同時(shí)用QElapsedTimer控制刷新頻率避免過(guò)度占用 CPU。實(shí)時(shí)刷新的代碼結(jié)構(gòu)大概是QTimer觸發(fā)updatePlot()在updatePlot()里從數(shù)據(jù)緩沖區(qū)讀取最新數(shù)據(jù)更新mglData然后調(diào)用m_graph-Clf()和m_graph-Plot()最后m_graph-Update()。注意每次刷新前要清空繪圖區(qū)否則舊曲線會(huì)殘留。5.2 多線程與計(jì)算加速如果數(shù)據(jù)量很大繪圖前的計(jì)算可能成為瓶頸。比如你要對(duì) 1000x1000 的矩陣做 FFT 然后畫(huà)頻譜圖單線程計(jì)算可能要幾百毫秒。這時(shí)候可以用 Qt 的QThread或者QtConcurrent把計(jì)算放到后臺(tái)線程計(jì)算完再通知主線程繪圖。MathGL 的繪圖操作必須在主線程執(zhí)行但數(shù)據(jù)準(zhǔn)備可以在子線程完成。具體做法是定義一個(gè)Worker類(lèi)繼承QObject在run()方法里做計(jì)算算完后發(fā)信號(hào)resultReady(mglData)給主線程。主線程收到信號(hào)后更新繪圖。這樣界面不會(huì)卡頓用戶(hù)體驗(yàn)好很多。5.3 部署與打包最終程序要發(fā)布時(shí)需要把依賴(lài)的 DLL 都帶上。我一般用windeployqt工具自動(dòng)復(fù)制 Qt 相關(guān)的 DLL然后手動(dòng)復(fù)制 zlib、libpng、MathGL、OpenCV 的 DLL。如果嫌麻煩可以用Enigma Virtual Box或者Inno Setup打包成一個(gè)安裝包。注意 MathGL 的字體文件和 OpenCV 的opencv_world4xx.dll體積都不小打包前先確認(rèn)哪些是必需的能精簡(jiǎn)就精簡(jiǎn)。提示如果目標(biāo)機(jī)器沒(méi)有安裝 VS2019 運(yùn)行時(shí)還需要帶上vcruntime140.dll和msvcp140.dll。這兩個(gè)文件可以從 VS2019 安裝目錄里找到或者讓用戶(hù)安裝 VC Redistributable。5.4 跨平臺(tái)移植的注意事項(xiàng)這套方案在 Windows 上跑通了如果想移植到 Linux主要改編譯方式。zlib、libpng、MathGL、OpenCV 在 Linux 下都可以用包管理器安裝Qt 也有對(duì)應(yīng)的版本。但要注意 MathGL 的 Qt 模塊在 Linux 下可能依賴(lài)libmgl-qt5包安裝時(shí)確認(rèn)一下。另外Windows 下的路徑分隔符是反斜杠Linux 下是正斜杠代碼里最好用QDir::separator()或者統(tǒng)一用正斜杠Qt 會(huì)自動(dòng)處理。移植到 macOS 也類(lèi)似用 Homebrew 安裝依賴(lài)Xcode 編譯。但 MathGL 在 macOS 下的 Qt 集成可能需要額外配置因?yàn)?macOS 的窗口系統(tǒng)跟 Windows 差異較大。如果只是做科學(xué)計(jì)算可視化不考慮跨平臺(tái)那 Windows 方案已經(jīng)足夠用了。5.5 性能對(duì)比與選型建議最后說(shuō)一下這幾個(gè)庫(kù)的選型邏輯。MathGL 的優(yōu)勢(shì)是繪圖函數(shù)豐富支持 3D 曲面、等值線、矢量場(chǎng)而且跟 Qt 集成度高。OpenCV 的優(yōu)勢(shì)是圖像處理和矩陣運(yùn)算如果你不需要圖像處理其實(shí)可以不用 OpenCV直接用 MathGL 的矩陣運(yùn)算也夠。Qt 的優(yōu)勢(shì)是界面和事件循環(huán)如果你只是畫(huà)個(gè)圖看看甚至可以用 MathGL 自帶的窗口不用 Qt。但如果你要做交互式應(yīng)用Qt 是繞不開(kāi)的。zlib 和 libpng 是底層依賴(lài)一般不用直接調(diào)用但編譯時(shí)必須有。如果你用 OpenCV 讀 PNGOpenCV 內(nèi)部會(huì)調(diào)用 libpng所以這兩個(gè)庫(kù)的版本要跟 OpenCV 兼容。我一般用 zlib 1.2.11 和 libpng 1.6.37這兩個(gè)版本跟 OpenCV 4.x 配合很穩(wěn)定。這套組合我用了好幾年從最初的編譯踩坑到現(xiàn)在的順手拈來(lái)中間積累的經(jīng)驗(yàn)基本都寫(xiě)在這里了。如果你按這個(gè)流程走應(yīng)該能少走很多彎路。遇到問(wèn)題先查依賴(lài)關(guān)系再查運(yùn)行庫(kù)最后查路徑大部分問(wèn)題都能解決。