Verwendung von C# Bildkorrekturfiltern zur Verbesserung der Dekodierung von Barcodes

Wie wende ich Bildfilter an, um das Lesen von Barcodes zu verbessern?

Um Filter anzuwenden, instanziieren Sie die Klasse ImageFilterCollection und erstellen Sie Instanzen jedes Filters einzeln. Weisen Sie dann das Objekt der Eigenschaft ImageFilters des Objekts BarcodeReaderOptions zu. Übergeben Sie das Optionenobjekt zusammen mit dem Beispielbild an die Methode Read. Erweiterte Installationsoptionen finden Sie in unserem Leitfaden für NuGet-Pakete.

Verwenden Sie das unten stehende Bild als Beispielbild.

Beispielbild

Das Bild erscheint recht unscharf. Allerdings ist die Helligkeit akzeptabel, und die weißen und schwarzen Farben sind unterscheidbar. Wenden Sie daher mindestens den SharpenFilter und den ContrastFilter an, um die Lesbarkeit von Barcodes zu verbessern. Im folgenden Codeschnipsel können Sie Filter auf das Bild anwenden, es lesen und die Ergebnisse auf der Konsole anzeigen.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-apply-filter.cs

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

Das obige Codeschnipsel wendet Filter an, liest den Strichcode und exportiert das gefilterte Bild auf die Festplatte. Der Vergleich zwischen dem Beispiel und den gefilterten Bildern ist unten dargestellt.

Beispielbild

Gefiltertes Beispiel

Welche Bildkorrekturfilter sind in IronBarcode verfügbar?

IronBarcode bietet mehrere Bildfilter, die speziell für die Bildkorrektur entwickelt wurden. Diese Filter helfen beim Lesen unvollkommener Barcode-Bilder und verbessern die Lesegenauigkeit. Sie müssen jedoch verstehen, wie diese Filter funktionieren, um geeignete Filter auszuwählen und Leistungsprobleme zu vermeiden, die durch die Verwendung von zu vielen oder falschen Filtern entstehen. Verfügbare Filter sind:

• AdaptiveThresholdFilter
• BinaryThresholdFilter
• BrightnessFilter
• ContrastFilter
• InvertFilter
• SharpenFilter
• ErodeFilter
• DilateFilter
• HistogramEqualizationFilter
• Unschärfefilter
  • GaussianBlurFilter
  • BilateralFilter
  • MedianBlurFilter

Die Reihenfolge, in der die Filter angewendet werden, richtet sich nach ihrer Platzierung innerhalb der ImageFilterCollection. Eine ausführliche API-Dokumentation zu diesen Filtern finden Sie in unserer API-Referenz.

Wie funktioniert der adaptive Schwellenwertfilter?

AdaptiveThresholdFilter ist ein in IronBarcode verfügbarer Filter, der die Bradley Adaptive Threshold Technik auf das Bild anwendet, die automatisch die Schwelle für die Binarisierung eines Bildes bestimmt. Dieser Filter eignet sich ideal für Bilder mit ungleichmäßiger Beleuchtung und unterschiedlichen Hintergrundintensitäten.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-adaptive-threshold.cs

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")

Unten sind die Ergebnisse der Anwendung des Filters mit verschiedenen Werten aufgeführt.

Standardwert

0.9 Wert

Der Konstruktor akzeptiert zusätzliche Parameter für die Konfiguration:

• Upper: Obere (weiße) Farbe für die Schwellenwertbestimmung.
• Lower: Niedrigere (schwarze) Farbe für die Schwellenwertbildung.
• Threshold: Schwellenwert (0.0-1.0) für die Binarisierung.
• Rectangle: Rechteckiger Bereich, auf den der Prozessor angewendet werden soll.

Wie im obigen Ausgabebild zu sehen ist, wurde das Bild binarisiert, um nur die Farben Schwarz und Weiß zu erhalten. Obwohl es für das Lesen von Barcodes noch nicht ideal erscheint, müssen Filter in Kombinationen verwendet werden. Experimentieren Sie mit der Empfindlichkeit der Parameter, um die besten Ergebnisse zu erzielen.

Wie funktioniert der binäre Schwellenwertfilter?

Der BinaryThresholdFilter filtert ein Bild, indem er die Pixel am angegebenen Schwellenwert aufteilt und dabei die Leuchtdichte einer Farbkomponente vergleicht. Ähnlich wie der AdaptiveThresholdFilter kann auch dieser Filter neue oder unerwünschte Störungen verursachen, wenn er nicht korrekt verwendet wird. IronBarcode hat jedoch Standardwerte für die Filtereigenschaften festgelegt.

Ähnlich wie der AdaptiveThresholdFilter akzeptiert auch der BinaryThresholdFilter die gleichen zusätzlichen Parameter zur Konfiguration:

• Upper: Obere (weiße) Farbe für die Schwellenwertbestimmung.
• Lower: Niedrigere (schwarze) Farbe für die Schwellenwertbildung.
• Threshold: Schwellenwert (0.0-1.0) für die Binarisierung.
• Rectangle: Rechteckiger Bereich, auf den der Prozessor angewendet werden soll.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-binary-threshold.cs

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")

Unten ist die Beispielausgabe der Anwendung von Filtern auf das Beispielbild aufgeführt.

Standardwert

0.9 Wert

Im obigen Ausgabebild wurde das Beispiel in schwarz-weiße Farbe binarisiert. Dieser Filter ist jedoch eindeutig nicht für dieses Bild geeignet, da Striche aus dem Barcode entfernt und neues Rauschen eingeführt wurde. Für den Umgang mit schwierigen Barcode-Szenarien lesen Sie bitte unseren Leitfaden zur Fehlerbehebung bei nicht erkannten Barcodes.

Wie stelle ich die Bildhelligkeit ein, um Barcodes besser lesen zu können?

BrightnessFilter ist ein weiterer wesentlicher Filter in der Bildfilter-Sammlung von IronBarcode. Wie der Name schon sagt, passt dieser Filter die Helligkeit des Barcode-Bildes an. Die Eingabe für diesen Konstruktor variiert den Anteil der Helligkeit im Ausgabebild. Der Standardwert ist 1, was das Bild unverändert lässt. Ein Wert von 0 erzeugt ein komplett schwarzes Bild, während Werte über 1 das Bild heller machen.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-brightness.cs

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")

Unten ist das Ausgabebild nach dem Anwenden dieses Filters auf den Beispielinput gezeigt.

Standardwert

1.5 Wert

Wie verwende ich den Kontrastfilter zur Verbesserung von Barcode-Bildern?

Der ContrastFilter passt den Kontrast in einem Bild an. Bildkontrast bezieht sich auf den Unterschied in der Farbintensität zwischen verschiedenen Elementen in einem Bild. Die Erhöhung des Kontrasts verstärkt die Sichtbarkeit von Details, wodurch das Bild lebendig und auffällig wirkt, während die Reduzierung des Kontrasts das Bild weicher und dezenter erscheinen lässt. Weitere Einzelheiten zur Anpassung von Barcodes finden Sie in unserem Leitfaden zur Anpassung von Barcodestilen.

Der Standardwert ist 1, was das Bild unverändert lässt. Ein Wert von 0 erzeugt ein komplett graues Bild, während Werte über 1 den Bildkontrast erhöhen.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-contrast.cs

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")

Das Anwenden dieses Filters auf den Beispielinput ergibt das unten gezeigte Bild.

Standardwert

1.5 Wert

Wann sollte ich den Invert-Filter verwenden?

Dieser Filter kehrt die Farben innerhalb eines Bildes um, indem er entgegengesetzte Farben erzeugt, z. B. wird Weiß zu Schwarz und Schwarz zu Weiß. Er ist besonders nützlich, wenn ein Barcode-Bild mit einer Hintergrundfarbe gelesen wird. Anders als der BinaryThresholdFilter invertiert dieser Filter die Farben direkt, ohne dass die Empfindlichkeit angegeben werden muss. Außerdem kann dieser Filter mit einem CropRectangle verwendet werden, um die Stelle im Bild festzulegen, an der die Farbe invertiert werden soll, anstatt die Farben für das gesamte Bild zu invertieren. Erfahren Sie mehr über die Angabe von Ausschnittbereichen in unserem Ausschnittbereich-Tutorial.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-invert.cs

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")

Das unten stehende Ausgabebild ist das Ergebnis der Anwendung dieses Filters auf das Beispiel-Eingabebild.

Originalbild

Umgekehrt

Wie korrigiere ich verschwommene Barcode-Bilder mit dem Scharfzeichnungsfilter?

IronBarcode bietet einen Schärfungsfilter. Dieser Filter verbessert die Schärfe eines Bildes und ist sehr nützlich bei unscharfen Bildern. Manipulieren Sie diesen Filter, um die Schärfe eines Bildes anzupassen, indem Sie den Sigma-Wert beim Instanziieren des Filterobjekts anpassen. Der Standardwert ist 3. Erhöhen Sie den Sigma-Wert, um die Bildschärfe zu erhöhen. Weitere Optionen zur Leistungsoptimierung finden Sie in unserem Leitfaden zu Lesegeschwindigkeitsoptionen.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-sharpen.cs

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")

Das folgende Bild ist die geschärfte Version des Beispieleingabebildes.

Standardwert

0.5 Wert

Vergleicht man das obige Bild mit dem Originalbild, erscheint es schärfer und hilft beim Lesen von Barcodes mit IronBarcode. In den meisten Fällen wird SharpenFilter immer zusammen mit anderen Filtern der Klasse ImageFilterCollection angewendet.

Wozu wird der Erode-Filter verwendet?

Der ErodeFilter entfernt winziges weißes Rauschen und verdichtet Strichcodes, indem er Pixel in der Nähe der Kanten von Formen entfernt. Dieser Filter eignet sich am besten für Szenarien, in denen der Barcode-Hintergrund viele weiße Flecken aufweist oder wenn das Barcode-Bild zu niedrig aufgelöst oder unscharf ist, was zu verschmolzenen Strichen führt. Der ErodeFilter macht Balken dicker und entfernt weiße Flecken im Hintergrund. Weitere Informationen zum Umgang mit unvollständigen Bildern finden Sie in unserem Beispiel für unvollständige Barcodes.

Verstärken Sie den Erosionseffekt, indem Sie für den Filter eine ganze Zahl eingeben, die kernelSize darstellt. Je größer die Kernelgröße, desto stärker ist der Effekt auf das Eingabebild. Beachten Sie, dass kernelSize ein Quadrat ist und in diesem Beispiel ein 5x5 Kernel wäre.

Verwenden Sie als Beispiel den ErodeFilter mit einer größeren Kernelgröße, um die Auswirkungen des Filters zu zeigen.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-erode.cs

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")

Originalbild

Angewandter Erode-Filter

Vergleicht man die obigen Eingabe- und Ausgabebilder, so sind einige Balken sichtbar dicker, was auf die aggressivere Art der Eingabe einer größeren Kernelgröße zum Filtern zurückzuführen ist. Allerdings haben die weißen Flecken im gesamten Bild abgenommen. Es liegt in der Natur des Erosionsfilters, dass bei zu aggressiver Anwendung dünne Balken gelöscht werden können, je größer der Kernel ist, wie in der Abbildung oben gezeigt. Testen und verfeinern Sie die Wirkung, indem Sie den Wert für die Kernelgröße ändern, der in den ErodeFilter eingegeben wird.

Wie hilft der Dilate-Filter beim Lesen von Barcodes?

Der DilateFilter funktioniert als Umkehrung des ErodeFilters, indem er helle Bereiche – typischerweise den Hintergrund – durch das Hinzufügen von Pixeln zu den Objektgrenzen erweitert. Dieser Filter repariert beschädigte oder schwache Barcodes, indem er kleine Lücken auffüllt oder kontrastarme Bereiche verbessert. Beachten Sie jedoch, dass seine Wirkung auf Barcode-Balken von der Intuition abweicht. Da die Dilatation helle Bereiche vergrößert, dünnt sie indirekt dunkle Elemente aus, wie z. B. schwarze Striche in Barcodes (bei weißem Hintergrund). Dies macht den Filter besonders effektiv in Szenarien, in denen Barcode-Balken zu dick oder verschmolzen erscheinen, aber übermäßiger Gebrauch kann die Scan-Genauigkeit verringern, indem die Balken zu stark verengt werden.

Ähnlich wie oben beschrieben, kann die Wirkung des Filters erhöht werden, indem eine ganze Zahl eingegeben wird, die den kernelSize für den Filter darstellt.

Verwenden Sie für das folgende Beispiel eine größere Kernelgröße, um die Auswirkungen des DilateFilter zu veranschaulichen.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-dilate.cs

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")

Originalbild

Angewandter Dilatationsfilter

Wie in der obigen Abbildung zu sehen ist, kann die aggressive Verwendung von DilateFilter die Barcodestruktur zerstören, indem eng beieinander liegende Balken zusammengeführt werden und Ruhezonen in den Barcodes entstehen. Testen und verfeinern Sie die Auswirkungen auf das Bild, indem Sie den Wert für die Kernelgröße je nach Eingabebild größer oder kleiner wählen.

Wann sollte ich den HistogramEqualization Filter verwenden?

Der HistogramEqualizationFilter verbessert den Bildkontrast durch Umverteilung der Pixelintensitäten, um die Klarheit zu verbessern. Es wird am häufigsten verwendet, wenn der Barcode entweder einen geringen Kontrast aufweist, wie z. B. verblasste oder verwaschene Bilder, oder Bilder mit ungleichmäßiger Beleuchtung, wie z. B. dunkle Schatten oder helles Blendlicht. Durch die Analyse des Bildhistogramms, das die Verteilung der Pixelhelligkeit darstellt, werden die Pixelwerte durch die Erhöhung des Kontrasts durch Streckung des Intensitätsbereichs neu verteilt, wobei dunkle Pixel dunkler und helle Pixel heller werden.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-histogram-equalization-filter.cs

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")

Originalbild

Angewandter Histogramm-Entzerrungsfilter

Wie im obigen Bild zu sehen ist, sind die schwarzen Balken deutlich dunkler und die Leerzeichen deutlich heller als im Originalbild.

Welche Unschärfefilter können bei der Rauschunterdrückung von Barcodes helfen?

Wie reduziert der GaussianBlur-Filter das Bildrauschen?

Der GaussianBlurFilter wendet einen Gaußschen Weichzeichner auf ein Bild an. Dieser Filter reduziert in der Regel das Rauschen in einem Bild. Eine umfassende Anleitung zum Umgang mit unvollkommenen Barcodes finden Sie in unserem Tutorial zur Korrektur der Bildausrichtung.

Der Filter funktioniert, indem benachbarte Pixelwerte im Bild mithilfe einer Gaußschen Funktion gemittelt werden. Die Methode beruht auf zwei anpassbaren Faktoren:

• Kernel: eine Matrix, die zum Mitteln der Pixel verwendet wird.
• Sigma: ein Wert, der die Intensität der Unschärfe steuert.

Die Standardgröße von kernel beträgt 3x3 Pixel, und der Standardwert von Sigma beträgt 3.0, was zu einer mäßigen Unschärfe führt. Eine Erhöhung des Wertes Sigma führt zu einem stärkeren Unschärfeeffekt. Sie können auch den Parameter kernel anpassen, um die Größe der Nachbarschaft zu steuern, die der Weichzeichnungsfilter mittelt.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-gaussianblur.cs

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")

$vbLabelText   $csharpLabel

Das Anwenden dieses Filters auf den Beispielinput ergibt das unten gezeigte Bild.

Bild schärfen

Bild GaussianBlur

Wann sollte ich den bilateralen Filter verwenden?

Der BilateralFilter glättet Bilder unter Beibehaltung der Kanten. Im Gegensatz zu einfachen Unschärfetechniken, die alle Pixel gleichmäßig beeinflussen, berücksichtigt der bilaterale Filter sowohl Farbunterschiede als auch den Pixelabstand, wodurch er für eine kantenerhaltende Glättung geeignet ist.

Die Methode beruht auf drei anpassbaren Faktoren:

• NeighborhoodDiameter: Durchmesser der Pixelumgebung (Standard: 5).
• SigmaColor: Farbeinfluss zur Bestimmung der Farbdifferenzwirkung (Standardwert: 75,0).
• SigmaSpace: Räumlicher Einfluss zur Bestimmung der Entfernungswirkung (Standardwert: 75,0).

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-bilateral.cs

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")

$vbLabelText   $csharpLabel

Das Anwenden dieses Filters auf den Beispielinput ergibt das unten gezeigte Bild.

Bild schärfen

Bilaterales Bild

Was macht den MedianBlur-Filter zur Rauschunterdrückung anders?

Der MedianBlurFilter reduziert das Rauschen in einem Bild, indem er den Wert eines jeden Pixels durch den Medianwert der umliegenden Pixel ersetzt. Dieser Filter zeichnet sich besonders durch die Erhaltung von Kanten und die Entfernung von Rauschen aus. Wenn Sie mehr über die Einstellungen zum Lesen von Barcodes erfahren möchten, besuchen Sie unseren Leitfaden zu den Einstellungen von Barcode-Lesegeräten.

• KernelSize: Größe der Nachbarschaft für die Medianberechnung (muss ungerade sein, Standardwert: 5).

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-medianblur.cs

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")

$vbLabelText   $csharpLabel

Das Anwenden dieses Filters auf den Beispielinput ergibt das unten gezeigte Bild.

Bild schärfen

MedianBlur Bild

Wie kann ich gefilterte Bilder bei jedem Verarbeitungsschritt speichern?

Wenn mehrere Filter auf den Barcode angewendet werden, kann es schwierig sein, die Ausgabe nach jeder Filtermethode zu sehen. Diese Funktion ermöglicht das Speichern des gefilterten Bildes nach jeder Filteranwendung, in der Reihenfolge, in der sie verarbeitet werden. Um diese Funktion zu aktivieren, übergeben Sie zuerst true an den ImageFilterCollection- Konstruktor. Verwenden Sie anschließend die Methode ExportFilterImagesToDisk, um den Pfad und den Namen für die Ausgabebilder anzugeben. Weitere Beispiele für das Speichern von Barcodes finden Sie in unserem Beispiel für die Umwandlung von Barcodes in Bilder.

:path=/static-assets/barcode/content-code-examples/how-to/image-correction-save-iterations.cs

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")

Die Filter werden in der Reihenfolge des Codes angewendet, und die Ausgabebilder spiegeln die Ergebnisse jeder Iteration wider:

• Sharpen -> Nach Sharpen
• Sharpen + AdaptiveThreshold -> Nach AdaptiveThreshold
• Sharpen + AdaptiveThreshold + Contrast -> Nach Contrast

Beispielbild

Nach Sharpen

Nach Adaptive Threshold

Nach Contrast

Neben den ImageFilters Eigenschaften sollten Sie BarcodeReaderOptions weitere Eigenschaften hinzufügen, um eine genauere Lesbarkeit zu erreichen; siehe diesen Artikel für weitere Informationen.