So geben Sie Datenformate in C# mit IronBarcode aus

Wie kann ich BarCode-Bilder extrahieren und speichern?

Sobald IronBarcode ein Bild liest, werden die darin enthaltenen BarCodes in BarcodeResult als die Eigenschaft BarcodeImage vom Typ AnyBitmap gespeichert. Die Eigenschaft BarcodeImage speichert die gefundenen BarCode-Bilder. Benutzer können dieses Objekt abrufen, um das Bild weiter zu bearbeiten oder als dauerhafte Kopie zu speichern. Dies sorgt für Effizienz und Benutzerfreundlichkeit, da kein zusätzlicher Code zum Extrahieren von BarCode-Bildern aus einem Bild erforderlich ist.

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

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

Der obige Codeausschnitt veranschaulicht einen Anwendungsfall für dieses Ausgabeformat. Konkret erstellt sie ein mehrseitiges TIFF-Bild aus Barcodes, die in einem PDF-Dokument erkannt wurden. Zunächst scannen oder erkennen wir BarCodes in der Beispiel-PDF-Datei. Anschließend erstellen wir eine Liste von AnyBitmap, in der wir die Informationen aus der Eigenschaft BarcodeImage speichern. Schließlich verwenden wir diese Liste, um mithilfe der CreateMultiFrameTiff-Methode eine mehrseitige TIFF-Datei zu erstellen. Diese Technik ist besonders nützlich bei der Verarbeitung mehrseitiger GIF- und TIFF-Dateien.

BarcodeImage Die Eigenschaft aus BarcodeResult speichert nur die Bilder der beim Einlesen gefundenen BarCodes, nicht das gesamte Eingabebild selbst.

Wie identifiziere ich verschiedene BarCode-Typen programmgesteuert?

Diese Eigenschaft hilft dabei, festzustellen, um welche Art von BarCode es sich im Eingabebild oder -dokument handelt. Eine Einschränkung besteht jedoch darin, dass der BarCode-Typ im Bild von IronBarcode unterstützt werden und lesbar sein muss. Weitere Informationen zu den von IronBarcode unterstützten BarCode-Typen 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.

Der folgende Codeausschnitt zeigt, wie BarCode-Werte und der BarCode-Typ aus einem Bild abgerufen werden, indem die Werte auf der Konsole ausgegeben werden.

: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

Ausgehend vom obigen Code-Schnipsel führen wir das Einlesen des BarCodes durch, indem wir die Methode BarcodeReader.Read() auf das Eingabebild anwenden. Dies gibt ein BarcodeResults-Objekt zurück, das alle BarcodeResult speichert, die beim Einlesen aller im Bild verfügbaren BarCodes erfasst wurden. Als Nächstes durchlaufen wir das BarcodeResults-Objekt, um BarcodeResult abzurufen und die BARCODES value und type auf die Konsole zu PRINTEN. Dieser Ansatz funktioniert nahtlos mit verschiedenen BarCode-Typen, einschließlich spezieller Formate wie Code-39-BarCodes.

Wann sollte ich die Ausgabe von Binärwerten verwenden?

Using IronBarcode, users can retrieve the byte array of the BarCode value by accessing the BarcodeResult-object on which they can access the BinaryValue-property. Dies ermöglicht es Benutzern, den BarCode value im Programm weiter zu bearbeiten. Die binäre value-Ausgabe ist besonders nützlich bei der Arbeit mit verschlüsselten Daten, in BarCodes kodierten Dateianhängen oder bei der Integration in Systeme, die eine Datenverarbeitung auf Byte-Ebene erfordern.

Der folgende Codeausschnitt veranschaulicht einen Anwendungsfall für das Abrufen des BarCodes value als Binärdaten:

: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

Wie aus dem obigen Code-Schnipsel ersichtlich, haben wir ein einfaches Programm erstellt, das mehrere BarCodes innerhalb eines Bildes in separate neue binär kodierte Dateien umwandelt. Zunächst scannen wir die Barcodes im Beispiel-PNG-Bild. Sobald wir diese BarCodes erkannt haben, durchlaufen wir sie, greifen auf die Eigenschaft BinaryValue 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 eines BarCodes zugreifen?

Eine weitere Eigenschaft des BarcodeResult-Objekts, auf die Benutzer zugreifen können, sind die Koordinaten des BARCODEs, einschließlich X1, Y1 und X2, Y2 sowie Height und Width innerhalb einer Bilddatei oder eines Dokuments. Diese Eigenschaften sind nützlich, wenn Benutzer Informationen über die Position und die Abmessungen des BarCodes abrufen müssen. Diese räumlichen Informationen sind entscheidend für Anwendungen, die eine präzise Positionierung erfordern, wie beispielsweise die automatisierte Dokumentenverarbeitung, Qualitätskontrollsysteme oder die Implementierung von Ausschnittbereichen für ein optimiertes Scannen von BarCodes.

Lassen Sie uns die Position und die Abmessungen des BarCodes veranschaulichen.

: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 der Überarbeitung

Nach der Überarbeitung

Der obige Codeausschnitt maskiert mehrere Barcodes, die in einer Bilddatei enthalten sind. Dazu 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 ein. Gleichzeitig muss die Eingabebilddatei in ein AnyBitmap-Objekt konvertiert werden, um die Schwärzungsmethode auf das Bild anzuwenden. Sobald wir das BarcodeResults-Objekt haben, können wir eine Schleife anwenden und diese durchlaufen, um die X1, Y1, Width und Height jedes im Bild verfügbaren BarCodes zu erhalten und diese in den CropRectangle-Eigenschaften der AnyBitmap.Redact()-Methode zu verwenden.

Warum ist die Seitenzahl bei mehrseitigen Dokumenten wichtig?

Benutzer können die Seitenzahl abrufen, auf der der BarCode gefunden wurde. Dies ist eine hilfreiche Funktion für Benutzer, die ein mehrseitiges Dokument mit mehreren BarCodes verwenden und die Position der BarCodes im Dokument für die weitere Verarbeitung kennen müssen. Diese Funktionalität ist unerlässlich beim Auslesen von BarCodes aus PDF-Dokumenten oder bei der Verarbeitung von Batch-Dokumenten in Enterprise-Anwendungen.

Sehen Sie sich den folgenden Codeausschnitt 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

Der obige Codeausschnitt veranschaulicht einen Anwendungsfall, bei dem Benutzer benötigen, dass das Programm die value der in einem mehrseitigen PDF-Dokument enthaltenen BarCodes sowie deren jeweilige Seitenzahlen zurückgibt. Der Code verwendet die Methode BarcodeReader.ReadPdf(), um die BarCodes in einem mehrseitigen PDF-Dokument zu lesen, wobei ein BarcodeResults-Objekt zurückgegeben wird, das alle im Dokument gefundenen BarcodeResult speichert. Wir verwenden eine Schleife und durchlaufen jedes Element im Objekt, um den value der BarCodes und die Seitenzahl, auf der die BarCodes gefunden wurden, abzurufen. Abgesehen von diesem Anwendungsfall können Benutzer diese Eigenschaft zum Debuggen verwenden, um zu überprüfen, ob alle BarCodes in einem Dokument gelesen wurden.

Wie erkenne ich die Drehung von BarCodes und die Seitenausrichtung?

Using IronBarcode, users can retrieve information about the barcode orientation and page orientation, where the barcode was found. Um diese beiden Informationen zu extrahieren, greifen Sie auf die Eigenschaften Rotation und PageOrientation des Objekts BarcodeResult zu. Rotation gibt eine Ganzzahl zurück, die den Drehwinkel des gefundenen BarCodes angibt. Diese Funktion arbeitet mit Funktionen zur Bildausrichtungskorrektur zusammen, um ein präzises Einlesen von BarCodes unabhängig vom Scanwinkel zu gewährleisten.

Sehen Sie sich den folgenden Codeausschnitt 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

Der obige Codeausschnitt wurde mit der angehängten Beispiel-PDF-Datei ausgeführt, um zu zeigen, dass Benutzer die Seitenausrichtung und die BarCode-Drehung abrufen können, indem sie jeweils pageOrientation und den BarCode rotation abrufen. Diese Funktion ist vor allem für Debugging-Zwecke nützlich.

Was ist der Unterschied zwischen Text- und Wert-Eigenschaften?

Natürlich sind die wichtigsten Eigenschaften, die Nutzer bei der Verwendung von IronBarcode abrufen möchten, die value und text. Diese beiden Eigenschaften werden oft synonym verwendet und liefern dasselbe Ergebnis value. Abgesehen davon können Benutzer die Methode BarcodeResult.ToString() verwenden, um das gleiche Ergebnis zu erzielen. Bei der Arbeit mit spezialisierten Anwendungen oder beim Exportieren von BarCode-Daten als Streams bieten diese Eigenschaften flexible Möglichkeiten, auf den BarCode-Inhalt in Ihrem bevorzugten Format zuzugreifen.

Das folgende Code-Snippet veranschaulicht dies:

: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 Code-Schnipsel geht hervor, dass Benutzer nur wenige Zeilen Code benötigen, um BarCodes in einem Bild mit IronBarcode zu lesen. Nachdem wir die von der BarcodeReader.Read()-Methode zurückgegebene BarcodeResults durchlaufen haben, geben wir das Ergebnis der Abfrage der Value- und Text-Eigenschaften sowie den Aufruf der BarcodeResult.ToString()-Methode aus, um zu zeigen, dass all diese denselben value zurückgeben.

Kurz gesagt ist IronBarcode eine perfekte API für Benutzer, um vielfältige Operationen im Zusammenhang mit BarCodes durchzuführen, die sich nicht nur auf das Schreiben und Dekodieren von BarCodes beschränken. Dank der Unterstützung verschiedener Ausgabeformate können Nutzer mit dem von IronBarcode zurückgegebenen BarcodeResult-Objekt weitaus mehr erreichen.