修复注释乱码

2026-04-14 17:11:31 +08:00
parent b8bcefc84b
commit cd03e30bb8
58 changed files with 761 additions and 767 deletions
@@ -1,26 +1,26 @@
 // ============================================================================
 // Copyright © 2026 Hexagon Technology Center GmbH. All Rights Reserved.
-// æ–‡ä»¶å�? HDREnhancementProcessor.cs
-// æ��è¿°: é«˜åŠ¨æ€�èŒƒå›´ï¼ˆHDRï¼‰å›¾åƒ�å¢žå¼ºç®—å?
+// 文件名: HDREnhancementProcessor.cs
+// 描述: 高动态范围（HDR）图像增强算子
 // 功能:
-//   - å±€éƒ¨è‰²è°ƒæ˜ å°„ï¼ˆLocal Tone Mappingï¼?
-//   - è‡ªé€‚åº”å¯¹æ•°æ˜ å°„ï¼ˆAdaptive Logarithmic Mappingï¼?
+//   - 局部色调映射（Local Tone Mapping）
+//   - 自适应对数映射（Adaptive Logarithmic Mapping）
 //   - Drago色调映射
 //   - 双边滤波色调映射
-//   - å¢žå¼ºå›¾åƒ�æš—éƒ¨å’Œäº®éƒ¨ç»†èŠ?
+//   - 增强图像暗部和亮部细节
 // 算法: 基于色调映射的HDR增强
-// ä½œè€? æ�Žä¼Ÿ wei.lw.li@hexagon.com
+// 作者: 李伟 wei.lw.li@hexagon.com
 // ============================================================================

 using Emgu.CV;
 using Emgu.CV.Structure;
-using Serilog;
 using XP.ImageProcessing.Core;
+using Serilog;

 namespace XP.ImageProcessing.Processors;

 /// <summary>
-/// é«˜åŠ¨æ€�èŒƒå›´å›¾åƒ�å¢žå¼ºç®—å?
+/// 高动态范围图像增强算子
 /// </summary>
 public class HDREnhancementProcessor : ImageProcessorBase
 {
@@ -138,8 +138,8 @@ public class HDREnhancementProcessor : ImageProcessorBase
    }

    /// <summary>
-    /// å±€éƒ¨è‰²è°ƒæ˜ å°?
-    /// å°†å›¾åƒ�åˆ†è§£ä¸ºåŸºç¡€å±‚ï¼ˆå…‰ç…§ï¼‰å’Œç»†èŠ‚å±‚ï¼Œåˆ†åˆ«å¤„ç�†å�Žå�ˆæˆ?
+    /// 局部色调映射
+    /// 将图像分解为基础层（光照）和细节层，分别处理后合成
    /// Base = GaussianBlur(log(I))
    /// Detail = log(I) - Base
    /// Output = exp(Base_compressed + Detail * boost)
@@ -156,22 +156,22 @@ public class HDREnhancementProcessor : ImageProcessorBase
            for (int x = 0; x < width; x++)
                floatImage.Data[y, x, 0] = floatImage.Data[y, x, 0] / 255.0f + 0.001f;

-        // å¯¹æ•°åŸ?
+        // 对数域
        var logImage = new Image<Gray, float>(width, height);
        for (int y = 0; y < height; y++)
            for (int x = 0; x < width; x++)
                logImage.Data[y, x, 0] = (float)Math.Log(floatImage.Data[y, x, 0]);

-        // åŸºç¡€å±‚ï¼šå¤§å°ºåº¦é«˜æ–¯æ¨¡ç³Šæ��å�–å…‰ç…§åˆ†é‡?
+        // 基础层：大尺度高斯模糊提取光照分量
        int kernelSize = (int)(sigmaSpace * 6) | 1;
        if (kernelSize < 3) kernelSize = 3;
        var baseLayer = new Image<Gray, float>(width, height);
        CvInvoke.GaussianBlur(logImage, baseLayer, new System.Drawing.Size(kernelSize, kernelSize), sigmaSpace);

-        // ç»†èŠ‚å±?
+        // 细节层
        var detailLayer = logImage - baseLayer;

-        // åŽ‹ç¼©åŸºç¡€å±‚çš„åŠ¨æ€�èŒƒå›?
+        // 压缩基础层的动态范围
        double baseMin = double.MaxValue, baseMax = double.MinValue;
        for (int y = 0; y < height; y++)
        {
@@ -200,7 +200,7 @@ public class HDREnhancementProcessor : ImageProcessorBase
            }
        }

-        // å�ˆæˆ�ï¼šåŽ‹ç¼©å�Žçš„åŸºç¡€å±?+ å¢žå¼ºçš„ç»†èŠ‚å±‚
+        // 合成：压缩后的基础层 + 增强的细节层
        var combined = new Image<Gray, float>(width, height);
        for (int y = 0; y < height; y++)
        {
@@ -287,7 +287,7 @@ public class HDREnhancementProcessor : ImageProcessorBase
            for (int x = 0; x < width; x++)
                floatImage.Data[y, x, 0] /= 255.0f;

-        // è®¡ç®—å…¨å±€æœ€å¤§äº®åº?
+        // 计算全局最大亮度
        float globalMax = 0;
        for (int y = 0; y < height; y++)
            for (int x = 0; x < width; x++)
@@ -364,7 +364,7 @@ public class HDREnhancementProcessor : ImageProcessorBase
            for (int x = 0; x < width; x++)
                floatImage.Data[y, x, 0] /= 255.0f;

-        // å…¨å±€æœ€å¤§äº®åº?
+        // 全局最大亮度
        float maxLum = 0;
        for (int y = 0; y < height; y++)
            for (int x = 0; x < width; x++)
@@ -410,7 +410,7 @@ public class HDREnhancementProcessor : ImageProcessorBase

    /// <summary>
    /// 双边滤波色调映射
-    /// ä½¿ç”¨å�Œè¾¹æ»¤æ³¢åˆ†ç¦»åŸºç¡€å±‚å’Œç»†èŠ‚å±?
+    /// 使用双边滤波分离基础层和细节层
    /// 双边滤波保边特性使得细节层更加精确
    /// </summary>
    private Image<Gray, byte> BilateralToneMapping(Image<Gray, byte> inputImage,
@@ -419,20 +419,20 @@ public class HDREnhancementProcessor : ImageProcessorBase
        int width = inputImage.Width;
        int height = inputImage.Height;

-        // è½¬æ�¢ä¸ºæµ®ç‚¹å¹¶å�–å¯¹æ•?
+        // 转换为浮点并取对数
        var floatImage = inputImage.Convert<Gray, float>();
        var logImage = new Image<Gray, float>(width, height);
        for (int y = 0; y < height; y++)
            for (int x = 0; x < width; x++)
                logImage.Data[y, x, 0] = (float)Math.Log(floatImage.Data[y, x, 0] / 255.0f + 0.001);

-        // å�Œè¾¹æ»¤æ³¢æ��å�–åŸºç¡€å±‚ï¼ˆä¿�è¾¹å¹³æ»‘ï¼?
+        // 双边滤波提取基础层（保边平滑）
        int diameter = (int)(sigmaSpace * 2) | 1;
        if (diameter < 3) diameter = 3;
        if (diameter > 31) diameter = 31;

        var baseLayer = new Image<Gray, float>(width, height);
-        // è½¬æ�¢ä¸?byte è¿›è¡Œå�Œè¾¹æ»¤æ³¢ï¼Œå†�è½¬å›ž float
+        // 转换为 byte 进行双边滤波，再转回 float
        var logNorm = NormalizeToByteImage(logImage);
        var baseNorm = new Image<Gray, byte>(width, height);
        CvInvoke.BilateralFilter(logNorm, baseNorm, diameter, sigmaColor, sigmaSpace);
@@ -454,10 +454,10 @@ public class HDREnhancementProcessor : ImageProcessorBase
            for (int x = 0; x < width; x++)
                baseLayer.Data[y, x, 0] = (float)(baseNorm.Data[y, x, 0] / 255.0 * logRange + logMin);

-        // ç»†èŠ‚å±?= å¯¹æ•°å›¾åƒ� - åŸºç¡€å±?
+        // 细节层 = 对数图像 - 基础层
        var detailLayer = logImage - baseLayer;

-        // åŽ‹ç¼©åŸºç¡€å±?
+        // 压缩基础层
        double baseMin = double.MaxValue, baseMax = double.MinValue;
        for (int y = 0; y < height; y++)
            for (int x = 0; x < width; x++)