How to read Barcodes from PDF Documents

Lisez directement les codes-barres des documents PDF

Outre la capacité d'IronBarcodes à lire les codes-barres à partir d'images, IronBarcode est également fier de sa capacité à lire les codes-barres à partir de documents PDF. Cela évite aux utilisateurs la difficulté de convertir des documents PDF en images avant de les utiliser dans IronBarcode pour la lecture. Étant donné que les documents PDF sont plus complexes et différents des images, une méthode de lecture différente doit également être utilisée, à savoir la méthode BarcodeReader.ReadPdf(). Cette méthode accepte divers types d'entrée de documents PDF, y compris :

• tableau de byte[] : document PDF sous forme de tableau d'octets.
• IEnumerable<Byte[]> : documents PDF sous forme de tableaux d'octets stockés dans une collection.
• MemoryStream : documents PDF sous forme de type MemoryStream.
• IEnumerable<Stream> : documents PDF sous forme de collection de MemoryStream.
• String : chemin d'accès au document PDF sous forme de chaîne. Si le document PDF est déjà copié dans le projet, cela sera le nom du document PDF sous forme de chaîne.
• IEnumerable<String> : chemins/noms de documents PDF stockés dans une collection.

En dehors des types d'entrée mentionnés ci-dessus, BarcodeReader.ReadPdf() accepte également PdfBarcodeReaderOptions pour une lecture plus avancée/améliorée que nous aborderons dans le sous-sujet suivant. Voyons maintenant l'extrait de code ci-dessous qui illustre l'utilisation de la méthode BarcodeReader.ReadPdf() pour lire les codes-barres dans les documents PDF.

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-pdf-1.cs

using IronBarCode;
using System;
using System.Collections.Generic;

List<String> docs = new List<String>();
docs.Add(@"pdf_a.pdf");
docs.Add(@"pdf_b.pdf");

var myBarcode = BarcodeReader.ReadPdfs(docs);   //can also accept individual PDF document file path as argument

foreach (var value in myBarcode)
{
    Console.WriteLine(value.ToString());
}

Imports IronBarCode
Imports System
Imports System.Collections.Generic

Private docs As New List(Of String)()
docs.Add("pdf_a.pdf")
docs.Add("pdf_b.pdf")

Dim myBarcode = BarcodeReader.ReadPdfs(docs) 'can also accept individual PDF document file path as argument

For Each value In myBarcode
	Console.WriteLine(value.ToString())
Next value

À partir de l'extrait de code ci-dessus, nous pouvons voir que pour lire les codes-barres à l'aide d'IronBarcode, nous pouvons simplement ajouter la chaîne de chemin de fichier du document PDF dans la méthode BarcodeReader.ReadPdf() pour lire la valeur du code-barre et stocker le résultat dans une variable. Si vous souhaitez imprimer les valeurs de tous les codes-barres trouvés dans le document PDF sur la console, utilisez simplement une boucle foreach pour itérer et imprimer chaque élément trouvé dans la variable en appelant la méthode ToString() sur eux. En outre, l'extrait de code ci-dessus démontre également l'utilisation d'une collection de noms de documents PDF comme argument dans BarcodeReader.ReadPdf().

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-pdf-read-from-multiple-pdf.cs

using IronBarCode;
using System;
using System.Collections.Generic;
using System.IO;

// Get all PDF files from a directory and add to list
string folderPath = @"PATH_TO_YOUR_FOLDER";
List<string> docs = new List<string>(Directory.GetFiles(folderPath, "*.pdf"));

// Read barcodes from all PDFs
var docResult = BarcodeReader.ReadPdfs(docs);

// Print results
foreach (var doc in docResult)
{
    foreach (var item in doc)
    {
        Console.WriteLine("Barcode " + item.ToString() + " found at page " + item.PageNumber);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Définition des options du lecteur de codes-barres PDF

De la même manière que pour lire les codes-barres à partir d'images, la lecture des codes-barres à partir de documents PDF permet également aux utilisateurs de régler ou d'ajuster les propriétés dans le lecteur de codes-barres appelé PdfBarcodeReaderOptions. L'ajustement des propriétés dans PdfBarcodeReaderOptions aidera grandement à la lecture en termes de qualité, précision et performance. Toutes les propriétés ajustables dans BarcodeReaderOptions sont héritées dans PdfBarcodeReaderOptions, avec quelques propriétés supplémentaires pour les documents PDF. Les utilisateurs peuvent spécifier le numéro de page ou la collection de numéros de pages du document PDF auquel ils souhaitent que s'appliquent les PdfBarcodeReaderOptions lors de l'instanciation d'une nouvelle instance de PdfBarcodeReaderOptions. L'extrait de code ci-dessous démontre :

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-pdf-2.cs

using IronBarCode;
using System.Collections.Generic;

List<int> pageNumber = new List<int>() { 1, 2, 3 };

PdfBarcodeReaderOptions PdfOptions = new PdfBarcodeReaderOptions(pageNumber)  // can also use individual page number as argument
{
    // Properties of PDF Barcode reader options
};

Imports IronBarCode
Imports System.Collections.Generic

Private pageNumber As New List(Of Integer)() From {1, 2, 3}

Private PdfOptions As New PdfBarcodeReaderOptions(pageNumber)

Découvrons maintenant les propriétés supplémentaires disponibles dans PdfBarcodeReaderOptions pour la manipulation, en dehors de celles disponibles dans BarcodeReaderOptions.

Lecture avancée de codes-barres à partir de documents PDF

Maintenant que nous connaissons les propriétés dans PdfBarcodeReaderOptions disponibles pour les ajustements et les modifications, voyons comment les appliquer dans le projet pour lire les codes-barres dans un document PDF.

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-pdf-3.cs

using IronBarCode;
using System;
using System.Collections.Generic;

List<int> pageNumber = new List<int>() { 1, 2, 3 };

PdfBarcodeReaderOptions PdfOptions = new PdfBarcodeReaderOptions(pageNumber)
{
    DPI = 150,
    //PageNumbers = pageNumber,      //this property is not needed if page numbers has been specified as the argument in PdfBarcodeReaderOptions
    Password = "barcode",
    Scale = 3.5,
    //properties below are some of the properties inherited from BarcodeReaderOptions
    Speed = ReadingSpeed.Detailed,
    ExpectBarcodeTypes = BarcodeEncoding.Code93,
    ExpectMultipleBarcodes = true
};

var myBarcode = BarcodeReader.ReadPdf(@"pdf_a_filepath.pdf", PdfOptions);
foreach (var value in myBarcode)
{
    Console.WriteLine(value.ToString());
}

Imports IronBarCode
Imports System
Imports System.Collections.Generic

Private pageNumber As New List(Of Integer)() From {1, 2, 3}

Private PdfOptions As New PdfBarcodeReaderOptions(pageNumber) With {
	.DPI = 150,
	.Password = "barcode",
	.Scale = 3.5,
	.Speed = ReadingSpeed.Detailed,
	.ExpectBarcodeTypes = BarcodeEncoding.Code93,
	.ExpectMultipleBarcodes = True
}

Private myBarcode = BarcodeReader.ReadPdf("pdf_a_filepath.pdf", PdfOptions)
For Each value In myBarcode
	Console.WriteLine(value.ToString())
Next value

L'extrait de code ci-dessus montre comment implémenter les propriétés de PdfBarcodeReaderOptions dans IronBarcode. Le PdfBarcodeReaderOptions doit d'abord être initialisé avec un nom de variable avant d'accéder et d'ajuster les propriétés. Dans l'extrait de code, nous pouvons voir que la liste des numéros de pages du document PDF a été utilisée comme argument lors de l'initialisation de PdfBarcodeReaderOptions. Cela spécifie le numéro de page auquel nous voulons que les paramètres de PdfBarcodeReader s'appliquent. Les utilisateurs peuvent également spécifier le numéro de page PDF dans la propriété PdfBarcodeReaderOptions sous forme de PageNumbers.

D'autre part, nous pouvons également voir que nous pouvons utiliser des propriétés de BarcodeReaderOptions telles que ExpectMultipleBarcodes et ExpectBarcodeTypes dans PdfBarcodeReaderOptions car elles sont héritées de la classe d'origine. Cela aidera grandement à la performance générale de la lecture et à la précision. Pour appliquer les propriétés définies de PdfBarcodeReaderOptions dans la lecture des codes-barres, entrez le nom de variable de la classe PdfBarcodeReaderOptions que nous avons créée comme deuxième argument dans la méthode BarcodeReader.ReadPdf(), avec le chemin du fichier du document PDF à lire comme premier argument.