Wie man Datenformate in C#35; mit IronBarcode ausgibt

Wie kann ich BarCode-Bilder extrahieren und speichern?

Sobald IronBarcode ein Bild liest, werden die im Bild gefundenen Barcodes in BarcodeResult als BarcodeImage-Eigenschaft vom Typ AnyBitmap gespeichert. Die BarcodeImage-Eigenschaft speichert die gefundenen Barcode-Bilder. Die Benutzer können dieses Objekt abrufen, um das Bild weiter zu bearbeiten oder es als dauerhafte Kopie zu speichern. Dies sorgt für Effizienz und Benutzerfreundlichkeit, da zusätzlicher Code zum Extrahieren von Strichcodebildern aus einem Bild entfällt.

Sehen Sie sich den folgenden Codeausschnitt an, der einen möglichen Anwendungsfall für dieses Ausgabeformat zeigt:

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BarcodeImage.cs

using IronBarCode;
using IronSoftware.Drawing;
using System.Collections.Generic;

// Read barcode from PDF file
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Create list for barcodes
List<AnyBitmap> barcodeList = new List<AnyBitmap>();

foreach (BarcodeResult barcode in result)
{
    barcodeList.Add(barcode.BarcodeImage);
}

// Create multi-page TIFF
AnyBitmap.CreateMultiFrameTiff(barcodeList).SaveAs("barcodeImages.tif");

Imports IronBarCode
Imports IronSoftware.Drawing
Imports System.Collections.Generic

' Read barcode from PDF file
Private result As BarcodeResults = BarcodeReader.ReadPdf("test.pdf")

' Create list for barcodes
Private barcodeList As New List(Of AnyBitmap)()

For Each barcode As BarcodeResult In result
	barcodeList.Add(barcode.BarcodeImage)
Next barcode

' Create multi-page TIFF
AnyBitmap.CreateMultiFrameTiff(barcodeList).SaveAs("barcodeImages.tif")

Das obige Codeschnipsel veranschaulicht einen Anwendungsfall für dieses Ausgabeformat. Konkret wird ein mehrseitiges TIFF-Bild aus Barcodes erstellt, die in einem PDF-Dokument erkannt werden. Zuerst scannen oder erkennen wir Barcodes im Beispiel-PDF. Dann erstellen wir eine Liste von AnyBitmap, in der wir die Informationen von der BarcodeImage-Eigenschaft speichern. Schließlich verwenden wir diese Liste, um mit der Methode CreateMultiFrameTiff ein mehrseitiges TIFF zu erzeugen. Diese Technik ist besonders nützlich bei der Verarbeitung von mehrseitigen GIF- und TIFF-Dateien.

Wie identifiziere ich verschiedene BarCode-Typen programmatisch?

Mit dieser Eigenschaft lässt sich feststellen, welche Art von Barcode im Eingabebild oder -dokument vorhanden ist. Die Einschränkung ist jedoch, dass der Barcodetyp innerhalb des Bildes von IronBarcode unterstützt werden und lesbar sein muss. Weitere Informationen über die von IronBarcode unterstützten Barcodetypen finden Sie in diesem Artikel. Sehen Sie sich außerdem die vollständige Liste der unterstützten Barcode-Formate an, um die Kompatibilität mit Ihren spezifischen Anforderungen sicherzustellen.

Das folgende Codeschnipsel zeigt, wie man Barcodewerte und Barcodetyp in einem Bild abruft, indem man die Werte auf der Konsole ausgibt.

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BarcodeType.cs

using IronBarCode;
using System;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("bc3.png");

// Output barcode type to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine("The barcode value is " + barcode.ToString() + " and the barcode type is " + barcode.BarcodeType);
}

Imports IronBarCode
Imports System

' Read barcode from PNG
Private result As BarcodeResults = BarcodeReader.Read("bc3.png")

' Output barcode type to console
For Each barcode As BarcodeResult In result
	Console.WriteLine("The barcode value is " & barcode.ToString() & " and the barcode type is " & barcode.BarcodeType)
Next barcode

Vom obigen Codeausschnitt aus führen wir das Barcode-Lesen durch, indem wir die BarcodeReader.Read()-Methode auf das Eingabebild aufrufen. Dies ergibt ein BarcodeResults-Objekt, das alle BarcodeResults speichert, die beim Lesen aller im Bild verfügbaren Barcodes gefunden wurden. Als Nächstes iterieren wir durch das BarcodeResults-Objekt, um das BarcodeResult abzurufen, und bekommen den Barcode-Wert und -Typ, um ihn in die Konsole auszugeben. Dieser Ansatz funktioniert nahtlos mit verschiedenen Barcodetypen, einschließlich spezieller Formate wie Code 39 Barcodes.

Wann sollte ich die Ausgabe von Binärwerten verwenden?

Mit IronBarcode können Benutzer das Byte-Array des Barcodewertes abrufen, indem sie auf die Eigenschaft BinaryValue des BarcodeResult-Objekts zugreifen. Dadurch können die Benutzer den Barcode-Wert weiter im Programm manipulieren. Die Ausgabe von Binärwerten ist besonders nützlich bei der Arbeit mit verschlüsselten Daten, Dateianhängen, die in Barcodes kodiert sind, oder bei der Integration in Systeme, die eine Datenverarbeitung auf Byte-Ebene erfordern.

Der untenstehende Codeausschnitt zeigt einen Anwendungsfall, bei dem der Barcode-Wert als Binärdaten abgerufen wird:

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-BinaryValue.cs

using IronBarCode;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("multiple-barcodes.png");

int i = 1;
foreach (BarcodeResult barcode in result)
{
    var binaryValue = barcode.BinaryValue;
    var barcodeType = IronBarCode.BarcodeEncoding.QRCode;

    // Create QR code
    GeneratedBarcode generatedBarcode = BarcodeWriter.CreateBarcode(binaryValue, barcodeType);

    // Export QR code
    generatedBarcode.SaveAsPng($"qrFromBinary{i}.png");
    i++;
}

Imports IronBarCode

' Read barcode from PNG
Private result As BarcodeResults = BarcodeReader.Read("multiple-barcodes.png")

Private i As Integer = 1
For Each barcode As BarcodeResult In result
	Dim binaryValue = barcode.BinaryValue
	Dim barcodeType = IronBarCode.BarcodeEncoding.QRCode

	' Create QR code
	Dim generatedBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(binaryValue, barcodeType)

	' Export QR code
	generatedBarcode.SaveAsPng($"qrFromBinary{i}.png")
	i += 1
Next barcode

Unter Beobachtung des obigen Codeausschnitts haben wir ein einfaches Programm erstellt, das mehrere Barcodes innerhalb eines Bildes in separate neue binär codierte Dateien umwandelt. Anfangs scannen wir die Barcodes im Beispiel-PNG-Bild. Sobald wir diese BarCodes erkannt haben, gehen wir sie durch, greifen auf die BinaryValue-Eigenschaft zu und verwenden sie, um neue Binärdateien zu erstellen. Diese Technik ist besonders wertvoll, wenn Sie mehrere BarCodes lesen und deren Binärdaten einzeln verarbeiten müssen.

Wie kann ich auf die Position und die Abmessungen von BarCodes zugreifen?

Eine weitere Eigenschaft des BarcodeResult-Objekts, die Benutzer zugreifen können, sind die Barcode-Koordinaten, einschließlich X1, Y1 und X2, Y2, sowie seine Höhe und Breite innerhalb einer Bilddatei oder eines Dokuments. Diese Eigenschaften sind nützlich, wenn Benutzer Informationen über die Position und die Abmessungen des Strichcodes abrufen müssen. Diese räumlichen Informationen sind entscheidend für Anwendungen, die eine präzise Positionierung erfordern, wie z. B. die automatisierte Dokumentenverarbeitung, Qualitätskontrollsysteme oder die Implementierung von Beschnittregionen für das optimierte Scannen von Barcodes.

Lassen Sie uns die Position und die Abmessungen des Barcodes demonstrieren.

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-height-width.cs

using IronBarCode;
using IronSoftware.Drawing;
using System.Linq;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("multiple-barcodes.png");

AnyBitmap bitmap = AnyBitmap.FromFile("multiple-barcodes.png");

foreach (BarcodeResult barcode in result)
{
    PointF[] barcodePoints = barcode.Points;

    float x1 = barcodePoints.Select(b => b.X).Min();
    float y1 = barcodePoints.Select(b => b.Y).Min();

    Rectangle rectangle = new Rectangle((int)x1, (int)y1, (int)barcode.Width!, (int)barcode.Height!);

    bitmap = bitmap.Redact(rectangle, Color.Magenta);

    // Save the image
    bitmap.SaveAs("redacted.png", AnyBitmap.ImageFormat.Png);
}

Imports System
Imports IronBarCode
Imports IronSoftware.Drawing
Imports System.Linq

' Read barcode from PNG
Private result As BarcodeResults = BarcodeReader.Read("multiple-barcodes.png")

Private bitmap As AnyBitmap = AnyBitmap.FromFile("multiple-barcodes.png")

For Each barcode As BarcodeResult In result
	Dim barcodePoints() As PointF = barcode.Points

	Dim x1 As Single = barcodePoints.Select(Function(b) b.X).Min()
	Dim y1 As Single = barcodePoints.Select(Function(b) b.Y).Min()

'INSTANT VB TODO TASK: There is no VB equivalent to the C# 'null-forgiving operator':
'ORIGINAL LINE: Rectangle rectangle = new Rectangle((int)x1, (int)y1, (int)barcode.Width!, (int)barcode.Height!);
	Dim rectangle As New Rectangle(CInt(Math.Truncate(x1)), CInt(Math.Truncate(y1)), CInt(barcode.Width), CInt(barcode.Height))

	bitmap = bitmap.Redact(rectangle, Color.Magenta)

	' Save the image
	bitmap.SaveAs("redacted.png", AnyBitmap.ImageFormat.Png)
Next barcode

Vor dem Redigieren

Nach dem Redigieren

Das obige Codeschnipsel löscht mehrere BarCodes in einer Bilddatei. Um dies zu erreichen, verwenden wir eine Kombination aus zwei Bibliotheken, IronBarcode und IronDrawing. Um das BarcodeResult-Objekt zu erhalten und die Eigenschaften daraus zu extrahieren, lesen wir zunächst die in einer Bilddatei verfügbaren Barcodes mit der BarcodeReader.Read()-Methode. Gleichzeitig muss die Eingabebilddatei in ein AnyBitmap-Objekt umgewandelt werden, um die Redaktionsmethode auf das Bild anzuwenden. Sobald wir das BarcodeResults-Objekt haben, können wir eine Schleife anwenden und durch sie iterieren, um X1, Y1, Breite und Höhe jedes in dem Bild verfügbaren Barcodes zu erhalten und sie in den CropRectangle-Eigenschaften der AnyBitmap.Redact()-Methode zu verwenden.

Warum ist die Seitenzahl für mehrseitige Dokumente wichtig?

Die Benutzer können die Seitenzahl abrufen, auf der der Barcode gefunden wurde. Dies ist eine hilfreiche Funktion für Benutzer, die ein mehrseitiges Dokument verwenden, das mehrere Barcodes enthält, und die für die weitere Verarbeitung wissen müssen, wo sich die Barcodes im Dokument befinden. Diese Funktionalität ist unerlässlich für das Lesen von Barcodes aus PDF-Dokumenten oder die Verarbeitung von Stapeldokumenten in Unternehmensanwendungen.

Sehen Sie sich den Codeausschnitt unten an:

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-page-number.cs

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Output page number to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine("The barcode value " + barcode.ToString() + " is found on page number " + barcode.PageNumber);
}

Imports IronBarCode
Imports System

' Read barcode from PDF
Private result As BarcodeResults = BarcodeReader.ReadPdf("test.pdf")

' Output page number to console
For Each barcode As BarcodeResult In result
	Console.WriteLine("The barcode value " & barcode.ToString() & " is found on page number " & barcode.PageNumber)
Next barcode

Das obige Code-Snippet zeigt einen Anwendungsfall, bei dem das Programm den Wert von Barcodes in einem mehrseitigen PDF-Dokument und die entsprechenden Seitenzahlen zurückgeben soll. Der Code verwendet die Methode BarcodeReader.ReadPdf(), um die Barcodes in einem mehrseitigen PDF-Dokument zu lesen, das ein BarcodeResults-Objekt zurückgibt, das jedes BarcodeResult speichert, das im Dokument gefunden wurde. Wir wenden eine Schleife an und iterieren durch jedes Element im Objekt, um den Wert der Barcodes und die Seite, auf der die Barcodes gefunden wurden, abzurufen. Abgesehen von diesem Anwendungsfall können Benutzer diese Eigenschaft verwenden, um zu überprüfen, ob alle Barcodes in einem Dokument gelesen wurden.

Wie erkenne ich die Drehung des Barcodes und die Seitenausrichtung?

Mit IronBarcode können Benutzer Informationen über die Ausrichtung des Barcodes und die Seitenausrichtung, in der der Barcode gefunden wurde, abrufen. Um diese beiden Informationen zu extrahieren, greifen Sie auf die Eigenschaften Rotation und PageOrientation des Objekts BarcodeResult zu. Rotation gibt eine ganze Zahl zurück, die den Drehwinkel des gefundenen Barcodes angibt. Diese Funktion arbeitet mit der Bildausrichtungskorrektur zusammen, um ein genaues Lesen von Barcodes unabhängig vom Scanwinkel zu gewährleisten.

Sehen Sie sich den Codeausschnitt unten an:

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-orientation.cs

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Output page orientation and rotation to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine(barcode.Value);
    Console.WriteLine(barcode.PageOrientation);
    Console.WriteLine(barcode.Rotation);
}

Imports IronBarCode
Imports System

' Read barcode from PDF
Private result As BarcodeResults = BarcodeReader.ReadPdf("test.pdf")

' Output page orientation and rotation to console
For Each barcode As BarcodeResult In result
	Console.WriteLine(barcode.Value)
	Console.WriteLine(barcode.PageOrientation)
	Console.WriteLine(barcode.Rotation)
Next barcode

Das obige Codeschnipsel wurde mit der beigefügten PDF-Beispieleingabe ausgeführt, um zu beweisen, dass Benutzer die Seitenausrichtung und die Barcodedrehung abrufen können, indem sie den Wert von BarcodeResult.PageOrientation bzw. BarcodeResult.Rotation erhalten. Diese Funktion ist hauptsächlich für Debugging-Zwecke nützlich.

Was ist der Unterschied zwischen Text- und Werteigenschaften?

Natürlich ist die Haupteigenschaft, die Benutzer abrufen möchten, wenn sie IronBarcode verwenden, der Wert und der Text. Diese beiden Eigenschaften werden oft austauschbar verwendet und geben denselben Wert zurück. Abgesehen davon können Benutzer die Methode BarcodeResult.ToString() verwenden, um das gleiche Ergebnis zu erzielen. Bei der Arbeit mit spezialisierten Anwendungen oder beim Export von Barcodedaten als Streams bieten diese Eigenschaften flexible Möglichkeiten für den Zugriff auf den Barcode-Inhalt in Ihrem bevorzugten Format.

Der folgende Codeausschnitt demonstriert:

:path=/static-assets/barcode/content-code-examples/how-to/output-data-formats-text-value.cs

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("barcodestamped3.pdf");

// Output text value to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine(barcode.Value);
    Console.WriteLine(barcode.Text);
    Console.WriteLine(barcode.ToString());
}

Imports IronBarCode
Imports System

' Read barcode from PDF
Private result As BarcodeResults = BarcodeReader.ReadPdf("barcodestamped3.pdf")

' Output text value to console
For Each barcode As BarcodeResult In result
	Console.WriteLine(barcode.Value)
	Console.WriteLine(barcode.Text)
	Console.WriteLine(barcode.ToString())
Next barcode

Aus dem obigen Codeschnipsel geht hervor, dass Benutzer nur ein paar Zeilen Code benötigen, um mit IronBarcode Barcodes in einem Bild zu lesen. Nach der Iteration durch die BarcodeResults, die von der Methode BarcodeReader.Read() zurückgegeben werden, geben wir das Ergebnis des Abrufs der Eigenschaften Value und Text auf der Konsole aus und rufen die Methode BarcodeResult.ToString() auf, um zu zeigen, dass sie alle denselben Wert zurückgeben.

Zusammenfassend ist IronBarcode ein perfektes API für Benutzer, um mehrere Vorgänge im Zusammenhang mit Barcodes durchzuführen, nicht nur Beschreiben und Dekodieren von Barcodes. Da verschiedene Ausgabedatenformate unterstützt werden, können Benutzer mit dem von IronBarcode zurückgegebenen BarcodeResult-Objekt viel mehr tun.