m_opencv.h 7.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165
  1. #ifndef M_OPENCV_H
  2. #define M_OPENCV_H
  3. #include <QObject>
  4. #include <QImage>
  5. #include <QFuture>
  6. #include <opencv2/opencv.hpp>
  7. #include <opencv2/highgui/highgui.hpp>
  8. #include <opencv2/imgproc/imgproc.hpp>
  9. #include <opencv2/videoio.hpp>
  10. #include <opencv2/videoio/legacy/constants_c.h>
  11. #include <opencv2/xfeatures2d.hpp>
  12. #include <opencv2/xfeatures2d/nonfree.hpp> //SIFT
  13. #include <opencv2/photo.hpp> // CLAHE
  14. #include <opencv2/calib3d.hpp> // findHomography, warpPerspective
  15. #include <opencv2/imgcodecs.hpp>
  16. using namespace std;
  17. using namespace cv;
  18. using namespace cv::xfeatures2d;
  19. class OpencvFunc : public QObject
  20. {
  21. Q_OBJECT
  22. public:
  23. explicit OpencvFunc(QObject *parent = nullptr);
  24. QString brenner(cv::Mat &image);
  25. QString Laplacian(cv::Mat &image); // mean(|Laplacian|) - 平均幅度
  26. QString Tenengrad(cv::Mat &image);
  27. QString calculateSharpness(const QImage& image);
  28. int CustomSharpening(const QString &path);
  29. Mat qim2mat(QImage &qim);
  30. // ==================== 显微专用清晰度评价 ====================
  31. // 综合评分:Laplacian 方差(聚焦金标准)+ Tenengrad + Brenner
  32. struct MicroscopeFocusMetrics {
  33. double laplacianVar; // Laplacian 方差(显微聚焦金标准)
  34. double tenengrad; // Tenengrad 梯度能量
  35. double brenner; // Brenner 二阶差分能量
  36. double combinedScore; // 综合评分(越大越清晰)
  37. };
  38. // 推荐用 evaluateFocusScore 替换单指标的 brenner/Laplacian/Tenengrad
  39. MicroscopeFocusMetrics evaluateFocusScore(const cv::Mat& image);
  40. // ==================== 对比度增强算法 ====================
  41. // 1) CLAHE(限制对比度的自适应直方图均衡)—— 显微最常用,处理不均匀照明
  42. // 在 LAB 空间的 L 通道做,避免色相偏移
  43. // clipLimit: 直方图裁剪阈值,2.0~4.0 适合显微,>5 会过增强
  44. // tileGridSize: 局部直方图块大小,8 即 8x8,显微推荐 4~16
  45. cv::Mat enhanceContrastCLAHE(const cv::Mat& src,
  46. double clipLimit = 2.0,
  47. int tileGridSize = 8);
  48. // 2) 自动对比度(百分位拉伸 / Percentile Stretch)
  49. // 把 [lowPct, highPct] 百分位映射到 [0,255],抗离群点(灰尘/气泡)
  50. // lowPct=1, highPct=99 是业界默认,显微相机的灰尘像素不会被拉爆
  51. cv::Mat enhanceContrastAuto(const cv::Mat& src,
  52. double lowPct = 1.0,
  53. double highPct = 99.0);
  54. // 3) Gamma 校正(非线性亮度拉伸)
  55. // gamma<1: 提亮暗部(暗场显微常用)
  56. // gamma>1: 压暗亮部(荧光过曝区恢复)
  57. // auto=true 时按图像平均亮度自动选 gamma(0.4~2.4)
  58. cv::Mat enhanceContrastGamma(const cv::Mat& src, double gamma = 1.0, bool _auto = false);
  59. // 4) 多尺度 Retinex (MSR) —— 显微不均匀照明的"杀手锏"
  60. // 经典 Jobson et al. 1997 多尺度 Retinex,比 CLAHE 更能消除
  61. // 视场中心-边缘的亮度差(显微镜的典型问题)
  62. // sigmas: 多尺度高斯标准差(像素),推荐 {15, 80, 250}(显微默认)
  63. cv::Mat enhanceContrastRetinexMSR(const cv::Mat& src,
  64. const std::vector<double>& sigmas = {15.0, 80.0, 250.0});
  65. // 5) 对比度增强统一入口(推荐 QML 用这一个)
  66. // pipeline: 0=CLAHE 1=Auto 2=Gamma 3=RetinexMSR 4=CLAHE+Auto
  67. cv::Mat enhanceContrast(const cv::Mat& src, int pipeline = 4);
  68. // 6) 文件路径版(异步 + 同步),适合 QML 直接调用
  69. Q_INVOKABLE QString enhanceContrastPath(const QString& imagePath, int pipeline = 4);
  70. Q_INVOKABLE void enhanceContrastPathAsync(const QString& imagePath, int pipeline = 4);
  71. // 7) 显微专用锐化(边缘保护 + LAB L 通道 + 多尺度)
  72. // 解决普通 unsharp mask 在显微图上放大噪声的问题
  73. // amount: 锐化强度,0.5~1.5(与 unsharpMask 同样的 scale)
  74. // sigma: 高斯半径,匹配物镜 PSF:20x 物镜 ~1.0,40x ~0.5
  75. // noiseFloor: 噪声门限(拉普拉斯幅度),低于此的像素不锐化
  76. cv::Mat sharpenMicroscope(const cv::Mat& src,
  77. double amount = 1.0,
  78. double sigma = 1.0,
  79. double noiseFloor = 5.0);
  80. // ==================== DWT多聚焦融合算法 ====================
  81. QString fuseImages(const QStringList& imagePaths);
  82. // 带进度回调的融合版本(回调在主线程执行)
  83. QString fuseImages(const QStringList& imagePaths, std::function<void(const QString&, int)> progressCallback);
  84. // 主融合函数:融合多张不同焦点的图像(从QML调用,异步)
  85. // imagePaths: 输入图像文件路径列表
  86. Q_INVOKABLE void fuseImagesAsync(const QStringList& imagePaths);
  87. // 主融合函数:融合多张不同焦点的图像
  88. // images: 输入图像列表,所有图像必须尺寸相同
  89. // levels: 小波分解层数,默认为3层
  90. // 返回:融合后的图像
  91. cv::Mat multiFocusFusion(const std::vector<cv::Mat>& images, int levels = 3);
  92. // 单张图像的Haar小波分解
  93. // src: 输入图像(单通道,浮点型)
  94. // levels: 分解层数
  95. // 返回:分解后的小波系数列表(LL, LH, HL, HH)
  96. std::vector<std::vector<cv::Mat>> haarDWT(const cv::Mat& src, int levels);
  97. // Haar小波逆变换
  98. // coeffs: 小波系数列表
  99. // 返回:重构后的图像
  100. cv::Mat haarIDWT(const std::vector<std::vector<cv::Mat>>& coeffs);
  101. // 计算图像的聚焦度图(清晰度图)
  102. // image: 输入图像
  103. // 返回:聚焦度图,值越大表示越清晰
  104. cv::Mat calculateFocusMap(const cv::Mat& image);
  105. // 创建平滑的权重图
  106. // focusMaps: 各图像的聚焦度图
  107. // sigma: 高斯平滑的标准差,默认为5
  108. // 返回:各图像的权重图
  109. std::vector<cv::Mat> createWeightMaps(const std::vector<cv::Mat>& focusMaps, double sigma = 5.0);
  110. // ==================== 高级流水线 (DWT+ECC+CLAHE+Bilateral) ====================
  111. // 完整融合管线:
  112. // 1) CLAHE 预处理(Lab L 通道直方图均衡,避免色偏)
  113. // 2) ECC 图像配准(基于 ORB 特征 + 单应性,将其它图 warp 到参考系)
  114. // 3) 3 级 Haar DWT 融合(低频取均值,高频取 |max| + 一致性校验)
  115. // 4) 双边滤波后处理(保边去噪)
  116. // 返回融合结果,并把原始输入拷贝到 outDir/inputs/ 与融合图放在同目录
  117. cv::Mat fuseAdvanced(const std::vector<cv::Mat>& images, const QString& outDir = QString());
  118. // ==================== Unsharp Mask 锐化 ====================
  119. // Unsharp Mask 锐化算法:
  120. // 1) 对原图进行高斯模糊得到模糊版本
  121. // 2) 计算边缘 mask = original - blurred
  122. // 3) 将 mask 按比例叠加回原图
  123. // result = original + amount * (original - blurred)
  124. // src: 输入图像(支持单通道灰度和多通道彩色)
  125. // amount: 锐化强度,推荐范围 0.5-2.0,值越大锐化越强
  126. // sigma: 高斯模糊标准差,推荐范围 1.0-3.0,值越大边缘检测范围越大
  127. // 返回:锐化后的图像
  128. cv::Mat unsharpMask(const cv::Mat& src, double amount = 1.0, double sigma = 1.5);
  129. signals:
  130. // 融合进度信号
  131. void fusionProgress(const QString& message, int percent);
  132. // 融合完成信号
  133. void fuseFinished(const QString& resultPath);
  134. // 对比度增强完成信号(异步任务用)
  135. void contrastEnhanced(const QString& resultPath, int pipeline);
  136. private:
  137. };
  138. #endif // M_OPENCV_H