使用 C## 图像校正过滤器改进条形码解码

Updated: 2026年6月29日

IronBarcode提供了内置的图像校正过滤器如ContrastFilter，可以通过程序增强模糊或不完美的条码图像，提高读取准确性，而无需外部图像编辑软件或重新捕捉图像。

并非每张图像都是完美的，图像质量差是妨碍 IronBarcode 成功读取条码的主要因素之一。 IronBarcode 不需要重新捕捉图像或使用外部图像增强软件，而是提供内置过滤器，以编程方式提高图像质量。这些过滤器可帮助 IronBarcode 读取困难的图像并提高整体准确性。

继续阅读，了解 IronBarcode 中可用的图像校正过滤器、它们对图像的影响以及如何应用它们。有关更全面的条形码阅读技巧，请查看我们的阅读条形码教程。

快速入门：应用锐化和对比度滤镜以改善条码读取

只需一步，就可以使用IronBarcode的BarcodeReaderOptions中。这可以提高条形码扫描的效率，只需最少的设置和对外部工具的零需求。

1Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode
```
Install-Package BarCode
```

2复制并运行这段代码。

BarcodeResults results = IronBarCode.BarcodeReader.Read("input.png", new IronBarCode.BarcodeReaderOptions { ImageFilters = new IronBarCode.ImageFilterCollection() { new IronBarCode.SharpenFilter(3.5f), new IronBarCode.ContrastFilter(2.0f) } });

BarcodeResults results = IronBarCode.BarcodeReader.Read("input.png", new IronBarCode.BarcodeReaderOptions { ImageFilters = new IronBarCode.ImageFilterCollection() { new IronBarCode.SharpenFilter(3.5f), new IronBarCode.ContrastFilter(2.0f) } });

3部署到您的生产环境中进行测试

通过免费试用立即在您的项目中开始使用IronBarcode

最小工作流程（5 个步骤）

下载 C# 库以使用图像校正滤镜
探索所有可用的图像校正滤镜
用自定义值配置每个过滤器
对不完美的图像样本应用过滤器
从增强图像中读取 BarCode 值

如何应用图像过滤器来改进条形码读取？

要应用过滤器，实例化ImageFilterCollection类，并分别创建每个过滤器的实例。然后将对象分配给BarcodeReaderOptions属性。将选项对象与样本图像一起传递到Read方法中。有关高级安装选项，请访问我们的 NuGet 软件包指南。

请使用下图作为样本图片。

带有数字 4900203187590 的模糊条形码，展示滤镜增强前较差的图像质量

图片样本

图片看起来很模糊。但是亮度尚可接受，白色和黑色也能区分。因此，请至少应用ContrastFilter来提高条码的可读性。请参考下面的代码片段，对图片应用过滤器、读取图片并在控制台上显示结果。

using IronBarCode;
using System;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection()
    {
        new SharpenFilter(3.5f),
        new ContrastFilter(2)
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Write the result value to console
foreach (BarcodeResult result in results)
{
    Console.WriteLine(result.Text);
}

using IronBarCode;
using System;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection()
    {
        new SharpenFilter(3.5f),
        new ContrastFilter(2)
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Write the result value to console
foreach (BarcodeResult result in results)
{
    Console.WriteLine(result.Text);
}

Imports IronBarCode
Imports System

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection() From {
		New SharpenFilter(3.5F),
		New ContrastFilter(2)
	}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Write the result value to console
For Each result As BarcodeResult In results
	Console.WriteLine(result.Text)
Next result

Imports IronBarCode
Imports System

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection() From {
		New SharpenFilter(3.5F),
		New ContrastFilter(2)
	}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Write the result value to console
For Each result As BarcodeResult In results
	Console.WriteLine(result.Text)
Next result

上面的代码片段应用过滤器，读取条形码，并将过滤后的图像导出到磁盘。样本与过滤后图片的对比如下所示。

图片样本

应用图像滤镜后可读性提高的条形码，显示清晰的垂直线条和数字 4902030187590

筛选样本

IronBarcode 提供哪些图像校正过滤器？

IronBarcode 提供多种图像过滤器，专门用于图像校正。这些过滤器有助于读取不完美的条形码图像并提高读取精度。但是，要了解这些过滤器的工作原理，以选择合适的过滤器，避免因使用过多过滤器或使用错误过滤器而产生性能问题。可用的过滤器包括

AdaptiveThresholdFilter
BinaryThresholdFilter
BrightnessFilter
ContrastFilter
InvertFilter
SharpenFilter
ErodeFilter
DilateFilter
HistogramEqualizationFilter
模糊过滤器
- GaussianBlurFilter
- BilateralFilter
- MedianBlurFilter

应用过滤器的顺序取决于它们在ImageFilterCollection中的位置。有关这些过滤器的详细 API 文档，请访问我们的 API Reference。

自适应阈值过滤器如何工作？

AdaptiveThresholdFilter是IronBarcode中可用的一个过滤器，应用Bradley自适应阈值分割技术于图像，它会自动确定二值化图像的阈值。该滤镜适用于光照不均匀和背景强度水平不一的图像。

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new AdaptiveThresholdFilter(0.9f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("adaptiveThreshold_0.9.png");

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new AdaptiveThresholdFilter(0.9f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("adaptiveThreshold_0.9.png");

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New AdaptiveThresholdFilter(0.9F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("adaptiveThreshold_0.9.png")

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New AdaptiveThresholdFilter(0.9F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("adaptiveThreshold_0.9.png")

以下是使用不同值进行筛选后的输出结果。

默认值

低质量条形码图像，显示 UPC 编号 902030187590，存在明显的视觉失真

0.9 价值

构造函数接受用于配置的附加参数：

Upper：用于阈值分割的上部（白色）颜色。
Lower：用于阈值分割的下部（黑色）颜色。
Threshold：用于二值化的阈值限制（0.0-1.0）。
Rectangle：应用处理器的矩形区域。

如上面的输出图像所示，图像经过二值化处理，只有黑和白两种颜色。虽然在条形码读取方面似乎仍不理想，但需要结合使用过滤器。请尝试使用参数灵敏度以达到最佳效果。

二进制阈值过滤器如何工作？

BinaryThresholdFilter通过在指定阈值处分割像素来过滤图像，比较色彩组件的亮度。类似于AdaptiveThresholdFilter，若使用不当，此过滤器可能引入新的或不需要的噪声。不过，IronBarcode 为过滤器属性设置了默认值。

类似于BinaryThresholdFilter接受相同的附加参数进行配置：

Upper：用于阈值分割的上部（白色）颜色。
Lower：用于阈值分割的下部（黑色）颜色。
Threshold：用于二值化的阈值限制（0.0-1.0）。
Rectangle：应用处理器的矩形区域。

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new BinaryThresholdFilter(0.9f)
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("binaryThreshold_0.9.png");

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new BinaryThresholdFilter(0.9f)
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("binaryThreshold_0.9.png");

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New BinaryThresholdFilter(0.9F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("binaryThreshold_0.9.png")

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New BinaryThresholdFilter(0.9F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("binaryThreshold_0.9.png")

以下是对示例图片应用过滤器后的输出示例。

默认值

0.9 价值

观察上面的输出图像，样本已被二值化为黑白两色。然而，由于消除了条形码条，并引入了新的噪声，该过滤器显然不适合该图像。如需处理条形码疑难情况，请参阅我们的未识别条形码疑难解答指南。

如何调整图像亮度以更好地读取条形码？

BrightnessFilter是IronBarcode中图像过滤器集合中的另一个重要过滤器。顾名思义，该过滤器可调整 BarCode 图像的亮度。该构造函数的输入会改变输出图像中的 Amount 亮度。默认值为 1，图像保持不变。数值为 0 时，图像完全变黑；数值超过 1 时，图像变亮。

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new BrightnessFilter(1.5f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("brightness_1.5.png");

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new BrightnessFilter(1.5f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("brightness_1.5.png");

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New BrightnessFilter(1.5F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("brightness_1.5.png")

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New BrightnessFilter(1.5F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("brightness_1.5.png")

以下是对样本输入应用该过滤器后的输出图像。

Blurry UPC barcode sample showing default brightness level before filter enhancement

默认值

带有产品编号 4902030187590 的模糊条形码，展示低亮度或较差的图像质量

1.5 价值

如何使用对比度过滤器来增强条形码图像？

ContrastFilter调整图像的对比度水平。图像对比度是指图像中不同元素之间颜色强度的差异。提高对比度可以增强细节的可视性，使图像显得生动、醒目，而降低对比度则会使图像显得更加柔和、沉稳。有关条形码定制的详细信息，请参阅我们的条形码样式定制指南。

默认值为 1，图像保持不变。数值为 0 时，图像完全为灰色；数值大于 1 时，图像对比度增加。

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new ContrastFilter(1.5f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("contrast_1.5.png");

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new ContrastFilter(1.5f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("contrast_1.5.png");

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New ContrastFilter(1.5F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("contrast_1.5.png")

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New ContrastFilter(1.5F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("contrast_1.5.png")

将该过滤器应用到示例输入中会生成下图。

默认值

1.5 价值

何时应使用反相过滤器？

这种滤镜可以反转图像内部的颜色，使颜色相反，如白变黑、黑变白。它在读取带背景色的 BarCode 图像时特别有用。不同于BinaryThresholdFilter，此过滤器直接反转颜色而无需指定灵敏度。此外，该过滤器可与 CropRectangle 配合使用，以指定图像中需要反转颜色的位置，而不是反转整个图像的颜色。在我们的作物区域教程中了解有关指定作物区域的更多信息。

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new InvertFilter(),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("invert.png");

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new InvertFilter(),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("invert.png");

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New InvertFilter()}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("invert.png")

Imports IronBarCode

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New InvertFilter()}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("invert.png")

下面的输出图像是将该过滤器应用于样本输入图像的结果。

显示数字 480203187590 的模糊 UPC 条形码 - 应用反色滤镜前的原始图像

原始图片

模糊的反色条形码，在深色背景上显示白色条形，带有数字序列 4902030187590

反转

如何使用锐化过滤器修复模糊的 BarCode 图像？

IronBarcode 提供了一个锐化过滤器。该过滤器可增强图像的清晰度，在处理模糊图像时非常有用。通过在实例化滤镜对象时调整 Sigma 值来操纵该滤镜以调整图像的清晰度。默认值为 3，增加西格玛值可提高图像清晰度。有关其他性能优化选项，请查看我们的阅读速度选项指南。

using IronBarCode;
using System;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new SharpenFilter(0.5f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("sharpen_0.5.png");

using IronBarCode;
using System;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new SharpenFilter(0.5f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("sharpen_0.5.png");

Imports IronBarCode
Imports System

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New SharpenFilter(0.5F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("sharpen_0.5.png")

Imports IronBarCode
Imports System

Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New SharpenFilter(0.5F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("sharpen_0.5.png")

下图是示例输入图像的 * 锐化*版本。

默认值

0.5 价值

将上面的图片与原始图片相比，显得更加清晰，有助于使用 IronBarcode 读取条形码。大多数情况下，ImageFilterCollection类中的其他过滤器一起应用。

Erode 过滤器有哪些用途？

ErodeFilter通过删除形状边缘附近的像素来去除小白噪声并加厚条码条。当条码背景有很多白色斑点或条码图像分辨率过低或模糊时，这个过滤器最适合使用，导致条合并。 ErodeFilter使条码条加厚，同时去除背景中的白色斑点。有关处理不完美图像的更多信息，请参阅我们的不完美条形码示例。

通过为过滤器输入代表kernelSize的整数来增加腐蚀效果。内核尺寸越大，对输入图像的影响越强。注意：5x5内核。

作为一个示例，使用较大的内核大小的ErodeFilter来展示过滤器的效果。

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new ErodeFilter(5),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("erodeFilter.jpg");

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new ErodeFilter(5),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("erodeFilter.jpg");

Imports IronBarCode

Dim options As New BarcodeReaderOptions() With {
    .ImageFilters = New ImageFilterCollection(True) From {
        New ErodeFilter(5)
    }
}

' Apply options and read the barcode
Dim results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("erodeFilter.jpg")

Imports IronBarCode

Dim options As New BarcodeReaderOptions() With {
    .ImageFilters = New ImageFilterCollection(True) From {
        New ErodeFilter(5)
    }
}

' Apply options and read the barcode
Dim results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("erodeFilter.jpg")

原始图片

应用 Erode 过滤器

比较上面的输入和输出图像，有些条形图明显变粗，这是因为输入了更大的内核尺寸进行过滤。然而，整体画面中的白色斑点减少了。根据侵蚀过滤器的性质，内核尺寸越大，如果应用得过于激烈，可能会擦除细条，如上图所示。通过更改内核大小值输入到ErodeFilter来测试和细化效果。

Dilate 过滤器如何帮助条码读取？

ErodeFilter的反向，通过向对象边界添加像素来扩展明亮区域（通常是背景）。虽然该过滤器可通过填补小缝隙或增强低对比度区域来修复损坏或模糊的条形码，但请注意其对条形码条的效果与直觉不同。由于扩张会放大明亮的空间，因此会间接稀释黑色条形码条（假设背景为白色）等暗色元素。这使得过滤器在条形码条显得过粗或合并的情况下特别有效，但过度使用会使条形码过分变窄，从而降低扫描精度。

与上面类似，通过为过滤器输入表示kernelSize的整数来增加过滤器的效果。

对于下例，使用较大的内核大小来展示DilateFilter的效果。

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new DilateFilter(5),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("dilateFilter.jpg");

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new DilateFilter(5),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("dilateFilter.jpg");

Imports IronBarCode

Dim options As New BarcodeReaderOptions() With {
    .ImageFilters = New ImageFilterCollection(True) From {
        New DilateFilter(5)
    }
}

' Apply options and read the barcode
Dim results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("dilateFilter.jpg")

Imports IronBarCode

Dim options As New BarcodeReaderOptions() With {
    .ImageFilters = New ImageFilterCollection(True) From {
        New DilateFilter(5)
    }
}

' Apply options and read the barcode
Dim results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("dilateFilter.jpg")

原始图片

应用扩展过滤器

如上图所示，过度使用DilateFilter可能会破坏条码结构，合并紧密间隔的条并在条码中创建安静区域。根据输入图像的不同，通过改变内核大小值的大小来测试和完善图像效果。

何时应使用直方图均衡化筛选器？

HistogramEqualizationFilter通过重新分配像素强度来改善图像对比度，以提高清晰度。它最常用于条形码对比度较低的情况，如褪色或冲淡的图像，或者光照不均匀的图像，如暗影或强光。通过分析图像直方图（即像素亮度分布图），它可以重新分配像素值，通过拉伸强度范围来增强对比度，使暗像素变暗，亮像素变亮。

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new HistogramEqualizationFilter(),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("histogramEqualizationFilter.jpg");

using IronBarCode;

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new HistogramEqualizationFilter(),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export file to disk
results.ExportFilterImagesToDisk("histogramEqualizationFilter.jpg");

Imports IronBarCode

Dim options As New BarcodeReaderOptions() With {
    .ImageFilters = New ImageFilterCollection(True) From {
        New HistogramEqualizationFilter()
    }
}

' Apply options and read the barcode
Dim results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("histogramEqualizationFilter.jpg")

Imports IronBarCode

Dim options As New BarcodeReaderOptions() With {
    .ImageFilters = New ImageFilterCollection(True) From {
        New HistogramEqualizationFilter()
    }
}

' Apply options and read the barcode
Dim results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export file to disk
results.ExportFilterImagesToDisk("histogramEqualizationFilter.jpg")

带有数字 4902030187590 的模糊条形码，用作直方图均衡化滤镜的测试图像

原始图片

应用直方图均衡化滤波器

如上图所示，与原图相比，黑条明显变暗，空格明显变亮。

哪些模糊过滤器可帮助降低 BarCode 噪声？

高斯模糊过滤器如何降低图像噪音？

GaussianBlurFilter对图像应用高斯模糊。这种滤波器通常可以减少图像中的噪点。有关处理不完美条形码的综合指南，请参阅我们的图像方向校正教程。

滤波器的工作原理是使用高斯函数平均图像中的相邻像素值。该方法依赖于两个可调整的因素：

内核：用于平均像素的矩阵。
Sigma：控制模糊强度的值。

默认的3.0，产生中等模糊效果。增加Sigma值会导致更强的模糊效果。您还可以自定义kernel以控制模糊过滤器平均的邻域大小。

using IronBarCode;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new GaussianBlurFilter(3, 3, 3.0f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

// Export file to disk
results.ExportFilterImagesToDisk("gaussianBlur.png");

using IronBarCode;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new GaussianBlurFilter(3, 3, 3.0f),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

// Export file to disk
results.ExportFilterImagesToDisk("gaussianBlur.png");

Imports IronBarCode

Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New GaussianBlurFilter(3, 3, 3.0F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sharpen.webp", myOptionsExample)

' Export file to disk
results.ExportFilterImagesToDisk("gaussianBlur.png")

Imports IronBarCode

Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New GaussianBlurFilter(3, 3, 3.0F)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sharpen.webp", myOptionsExample)

' Export file to disk
results.ExportFilterImagesToDisk("gaussianBlur.png")

将该过滤器应用到示例输入中会生成下图。

锐化图像

高斯模糊图像

何时使用双边过滤器？

BilateralFilter在保持边缘的同时平滑图像。与均匀影响所有像素的简单模糊技术不同，双边滤波器同时考虑了颜色差异和像素距离，使其成为有效的边缘保护平滑技术。

该方法依赖于三个可调整的因素：

NeighborhoodDiameter：像素邻域的直径（默认：5）。
SigmaColor：决定色彩差异影响的色彩影响（默认：75.0）。
SigmaSpace：决定距离影响的空间影响（默认：75.0）。

using IronBarCode;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new BilateralFilter(5, 75, 75),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

// Export file to disk
results.ExportFilterImagesToDisk("bilateral.png");

using IronBarCode;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new BilateralFilter(5, 75, 75),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

// Export file to disk
results.ExportFilterImagesToDisk("bilateral.png");

Imports IronBarCode

Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New BilateralFilter(5, 75, 75)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sharpen.webp", myOptionsExample)

' Export file to disk
results.ExportFilterImagesToDisk("bilateral.png")

Imports IronBarCode

Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New BilateralFilter(5, 75, 75)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sharpen.webp", myOptionsExample)

' Export file to disk
results.ExportFilterImagesToDisk("bilateral.png")

将该过滤器应用到示例输入中会生成下图。

模糊的条形码，展示较差的图像质量，带有垂直线条和数字 4902030187590

锐化图像

双边图像

是什么让 MedianBlur 滤波器在降噪方面与众不同？

MedianBlurFilter通过将每个像素的值替换为周围像素的中值来减少图像中的噪声。该过滤器尤其擅长在去除噪声的同时保留边缘。要探索有关条码读取设置的更多信息，请访问我们的条码阅读器设置指南。

KernelSize：用于中值计算的邻域大小（必须为奇数，默认：5）。

using IronBarCode;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new MedianBlurFilter(5),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

// Export file to disk
results.ExportFilterImagesToDisk("medianBlur.png");

using IronBarCode;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new MedianBlurFilter(5),
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

// Export file to disk
results.ExportFilterImagesToDisk("medianBlur.png");

Imports IronBarCode

Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New MedianBlurFilter(5)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sharpen.webp", myOptionsExample)

' Export file to disk
results.ExportFilterImagesToDisk("medianBlur.png")

Imports IronBarCode

Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New MedianBlurFilter(5)}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sharpen.webp", myOptionsExample)

' Export file to disk
results.ExportFilterImagesToDisk("medianBlur.png")

将该过滤器应用到示例输入中会生成下图。

锐化图像

MedianBlur 图像

如何在每个处理步骤中保存过滤后的图像？

在对 BarCode 应用多个过滤器时，查看每个过滤器方法后的输出可能会比较困难。该功能允许在应用每个过滤器后，按照处理顺序保存过滤后的图像。要启用此功能，首先将ImageFilterCollection构造函数。然后使用ExportFilterImagesToDisk方法为输出图像提供路径和名称。有关保存 BarCode 的更多示例，请参阅我们的将条形码转换为图像示例。

using IronBarCode;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new SharpenFilter(3.5f),
        new AdaptiveThresholdFilter(0.5f),
        new ContrastFilter(2)
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.webp", myOptionsExample);

// Export file to disk
results.ExportFilterImagesToDisk("filteredImage.png");

using IronBarCode;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true) {
        new SharpenFilter(3.5f),
        new AdaptiveThresholdFilter(0.5f),
        new ContrastFilter(2)
    },
};

// Apply options and read the barcode
BarcodeResults results = BarcodeReader.Read("sample.webp", myOptionsExample);

// Export file to disk
results.ExportFilterImagesToDisk("filteredImage.png");

Imports IronBarCode

Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {
		New SharpenFilter(3.5F),
		New AdaptiveThresholdFilter(0.5F),
		New ContrastFilter(2)
	}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.webp", myOptionsExample)

' Export file to disk
results.ExportFilterImagesToDisk("filteredImage.png")

Imports IronBarCode

Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {
		New SharpenFilter(3.5F),
		New AdaptiveThresholdFilter(0.5F),
		New ContrastFilter(2)
	}
}

' Apply options and read the barcode
Private results As BarcodeResults = BarcodeReader.Read("sample.webp", myOptionsExample)

' Export file to disk
results.ExportFilterImagesToDisk("filteredImage.png")

过滤器按代码顺序应用，输出图像反映每次迭代的结果：

Sharpen -> 之后Sharpen
Sharpen + AdaptiveThreshold -> 之后AdaptiveThreshold
Sharpen + AdaptiveThreshold + Contrast -> 之后Contrast

图片样本

Blurry UPC barcode showing number 4902030187590

锐化之后

自适应阈值之后

对比之后

除了BarcodeReaderOptions添加其他属性，以便更精确地读取；请参阅此文章以获取更多信息。

常见问题解答

什么是图像校正过滤器，为什么条形码读取需要它们？

IronBarcode 中的图像校正过滤器是内置工具，可通过编程增强模糊或不完美的条码图像。图像质量差是妨碍成功读取条码的主要因素之一，因此图像校正过滤器是必不可少的。IronBarcode 提供的 SharpenFilter 和 ContrastFilter 等过滤器可在不需要外部图像编辑软件或重新捕获图像的情况下提高读取准确性。

如何应用图像校正过滤器来改进 BarCode 扫描？

要在 IronBarcode 中应用过滤器，需要创建一个 ImageFilterCollection 实例，并向其中添加单个过滤器实例。然后将此集合分配给 BarcodeReaderOptions 的 ImageFilters 属性，并将其传递给读取方法。例如：new BarcodeReaderOptions { ImageFilters = new ImageFilterCollection() { new SharpenFilter(3.5f), new ContrastFilter(2.0f) }.}.

建议使用哪些图像过滤器来处理模糊的 BarCode 图像？

对于模糊的条码图像，IronBarcode 建议至少使用 SharpenFilter 和 ContrastFilter。SharpenFilter 可增强模糊图像的边缘清晰度，而 ContrastFilter 则可改善明暗区域之间的区别。这些滤镜共同作用，使 BarCode 在不进行外部图像处理的情况下更加易读。

能否自定义图像校正滤镜的强度？

是的，IronBarcode 允许您用自定义值配置每个过滤器。例如，锐化过滤器（SharpenFilter）接受一个浮点参数（如 3.5f）来控制锐化强度，对比度过滤器（ContrastFilter）接受一个参数（如 2.0f）来调整对比度水平。这种自定义功能有助于针对不同的图像条件优化滤镜效果。

我是否需要外部图像编辑工具来增强 BarCode 图像？

不，IronBarcode 通过提供内置图像校正过滤器，消除了对外部图像编辑工具的需求。这些编程过滤器（如 SharpenFilter 和 ContrastFilter）可直接在您的 .NET 应用程序中提高图像质量，从而节省时间并避免依赖第三方软件。

When should I use the HistogramEqualization Filter?

The HistogramEqualization Filter enhances contrast by redistributing pixel intensities, making it suitable for barcodes with low contrast or uneven lighting. This filter stretches the intensity range to improve readability.

What does the GaussianBlur Filter do?

The GaussianBlur Filter reduces noise in an image by averaging pixel values using a Gaussian function. It is configurable via kernel size and sigma value, and it applies a moderate blur to help reduce image noise.

How does the Bilateral Filter differ from other blur filters?

The Bilateral Filter reduces noise while preserving edges and takes into account both color differences and pixel distance. It smooths images by considering neighborhood diameter, sigma color, and sigma space parameters.

What is the primary use of the MedianBlur Filter?

The MedianBlur Filter excels at preserving edges while minimizing noise by replacing each pixel's value with the median of its neighbors, making it effective for noise reduction with edge preservation.

How can I save images after each filter is applied in IronBarcode?

In IronBarcode, enable exporting images after each filter step by passing true to the ImageFilterCollection constructor, then use the ExportFilterImagesToDisk method to save the output images at each processing step.