How to read Barcodes from PDF Documents

PDFドキュメントから直接バーコードを読む

IronBarcodeが画像からバーコードを読む能力だけでなく、PDFドキュメントからバーコードを読む能力にも優れていることを誇りに思います。 これにより、ユーザーはPDFドキュメントを画像に変換してIronBarcodeに読み込ませる手間から解放されます。 PDFドキュメントはより複雑で画像とは異なるため、異なる読み取り方法としてBarcodeReader.ReadPdf()メソッドを使用する必要があります。 このメソッドは、以下を含むさまざまなタイプのPDFドキュメント入力を受け入れます。

• byte[]配列: バイト配列としてのPDFドキュメント。
• IEnumerable<Byte[]>: コレクションに格納されたバイト配列としてのPDFドキュメント。
• MemoryStream: MemoryStreamタイプとしてのPDFドキュメント。
• IEnumerable<Stream>: MemoryStreamのコレクションとしてのPDFドキュメント。
• String: 文字列としてのPDFドキュメントパス。 すでにプロジェクトにコピーされているPDFドキュメントの場合、これは文字列としてのPDFドキュメントの名前です。
• IEnumerable<String>: コレクションに格納されたPDFドキュメントのパス/名前文字列。

上記の入力タイプとは別に、BarcodeReader.ReadPdf()は、より高度な/改善された読み取りを行うためのPdfBarcodeReaderOptionsも受け入れます。これは次のサブトピックで説明します。 では、PDFドキュメントのバーコードを読むためのBarcodeReader.ReadPdf()メソッドの使用方法を示すコードスニペットを見てみましょう。

: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

上記のコードスニペットから、IronBarcodeを使用してバーコードを読み取るために、PDFドキュメントのファイルパス文字列をBarcodeReader.ReadPdf()メソッドに追加して、バーコード値を読み取り、結果を変数に保存することができます。 PDFドキュメントで見つかったすべてのバーコードの値をコンソールに出力したい場合は、foreachループを使用して変数に見つかった各要素を反復して、ToString()メソッドを呼び出して印刷するだけです。 そのうえで、上記のコードスニペットでは、BarcodeReader.ReadPdf()での引数としてPDFドキュメント名のコレクションを使用する方法も示しています。

: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

PDFバーコードリーダーオプションの設定

画像からバーコードを読むのと同様に、PDFドキュメントからバーコードを読む際にも、PdfBarcodeReaderOptionsと呼ばれるバーコードリーダーのプロパティを調整または調節できます。 PdfBarcodeReaderOptionsのプロパティを調整することで、品質、精度、およびパフォーマンスの向上に大きく役立ちます。 BarcodeReaderOptionsのすべての調整可能なプロパティはPdfBarcodeReaderOptionsに継承され、一部の追加プロパティはPDFドキュメント用です。 ユーザーは、PDFドキュメントからバーコードを読み取りたいPdfBarcodeReaderOptionsを適用するページ番号またはページ番号のコレクションを指定して、新しいPdfBarcodeReaderOptionsインスタンスを作成する際に指定できます。 以下のコードスニペットはデモンストレーションを示しています：

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

次に、BarcodeReaderOptionsで利用可能なものとは別に、調整可能なPdfBarcodeReaderOptionsの追加プロパティを確認してみましょう。

PDFドキュメントからの高度なバーコード読み取り

PdfBarcodeReaderOptionsで調整可能なプロパティを知っている今、プロジェクト内で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

上記のコードスニペットはIronBarcodeでPdfBarcodeReaderOptionsプロパティをどのように実装するかを示しています。 PdfBarcodeReaderOptionsは、プロパティにアクセスして調整する前に、変数名で初期化する必要があります。 コードスニペットでは、PDFドキュメントのページ番号のリストがPdfBarcodeReaderOptionsを初期化する際の引数として使用されていることがわかります。 これは、PdfBarcodeReaderの設定を適用したいページ番号を指定します。 ユーザーはまたPageNumbersとしてPdfBarcodeReaderOptionsプロパティにPDFページ番号を指定することもできます。

一方で、BarcodeReaderOptionsからExpectMultipleBarcodesやExpectBarcodeTypesといったプロパティをPdfBarcodeReaderOptionsで使用できることもわかります。これは、元のクラスから継承されています。 これにより、全体的な読み取りパフォーマンスと精度が大幅に向上します。 PdfBarcodeReaderOptionsで設定したプロパティをバーコード読み取りに適用するには、読み取り対象のPDFドキュメントのファイルパスを最初の引数として、BarcodeReader.ReadPdf()メソッドの2番目の引数として作成したPdfBarcodeReaderOptionsクラスの変数名を入力します。