IronBarcodeを使ってC#でデータフォーマットを出力する方法

バーコード画像を抽出して保存するにはどうすればよいですか?

IronBarcodeが画像を読み取ると、画像内で見つかったバーコードはAnyBitmap型のBarcodeImageプロパティとしてBarcodeResultに格納されます。 BarcodeImage プロパティには、見つかったバーコード画像が保存されます。 ユーザーは、このオブジェクトを取得して画像をさらに加工したり、永久コピーとして保存したりすることができます。 これは、画像から BarCode 画像を抽出するための追加コードを排除することで、効率性と使いやすさを提供します。

以下のコード・スニペットは、この出力形式の使用例を示しています：

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

上のコード・スニペットは、この出力形式の使用例を示しています。 具体的には、PDF文書内で検出されたBarCodeから複数ページのTIFF画像を作成します。 最初に、サンプルPDFでバーコードをスキャンまたは検出します。 次に、BarcodeImageプロパティからの情報を保存するAnyBitmapのリストを作成します。 最後に、このリストを使用して、CreateMultiFrameTiffメソッドを使用してマルチページTIFFを生成します。 このテクニックは、複数ページのGIFファイルやTIFFファイルを処理するときに特に役立ちます。

異なる BarCode タイプをプログラムで識別するにはどうすればよいですか?

このプロパティは、入力画像または文書に存在するバーコードのタイプを判別するのに役立ちます。 ただし、画像内のバーコードタイプがIronBarcodeでサポートされ、読み取り可能でなければならないという制限があります。 IronBarcodeでサポートされているバーコードの種類については、こちらの記事をご参照ください。 さらに、サポートされているバーコード形式の完全なリストを調べ、特定の要件との互換性を確認してください。

以下のコードスニペットは、コンソールに値を出力することによって、画像内のバーコード値とバーコードタイプを取得する方法を示しています。

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

上記のコードスニペットから、入力画像に対してBarcodeReader.Read()メソッドを呼び出してバーコードの読み取りを行います。 これにより、画像内のすべてのバーコードに関連するBarcodeResultを保存するBarcodeResultsオブジェクトが返されます。 次に、BarcodeResultsオブジェクトを繰り返し処理し、BarcodeResultを取り出してコンソールにバーコードの値とタイプを印刷します。 このアプローチは、Code 39 barcodesのような特殊な形式を含む、さまざまなバーコードタイプでシームレスに動作します。

バイナリ値出力はいつ使うべきですか?

IronBarcodeを使用すると、ユーザーはBarcodeResultオブジェクトからBinaryValueプロパティにアクセスすることで、バーコード値のバイト配列を取得することができます。 これにより、プログラム内でバーコード値をさらに操作できます。 バイナリ値出力は、暗号化されたデータ、BarCodeでエンコードされたファイル添付、またはバイトレベルのデータ処理を必要とするシステムとの統合を扱う場合に特に便利です。

以下のコードスニペットは、バーコード値をバイナリデータとして取得するユースケースを示しています：

: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++;
}

上記のコードスニペットを観察すると、画像内の複数のバーコードを新しいバイナリエンコードファイルに変換する直感的なプログラムを作成しました。 最初に、サンプルのPNG画像でバーコードをスキャンします。 これらのバーコードを検出したら、それらを繰り返し処理し、BinaryValue プロパティにアクセスし、それを使用して新しいバイナリ ファイルを作成します。 このテクニックは、複数の BarCode を読み取り、それらのバイナリ データを個別に処理する必要がある場合に特に役立ちます。

バーコードの位置と寸法にアクセスするにはどうすればよいですか?

ユーザーがアクセスできるBarcodeResultオブジェクトの別のプロパティとして、画像ファイルやドキュメント内のバーコードの座標 (X1, Y1, および X2, Y2) と、その高さおよび幅があります。 これらのプロパティは、ユーザーがバーコードの位置や寸法に関する情報を取得する必要がある場合に役立ちます。 この空間情報は、自動文書処理、品質管理システム、最適化された BarCode スキャン用の crop regions を実装する場合など、正確な位置決めが必要なアプリケーションにとって非常に重要です。

バーコードの位置と寸法を示しましょう。

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

編集前

編集後

上記のコード・スニペットは、画像ファイル内の複数の BarCode を再編集しています。これを実現するために、IronBarcodeとIronDrawingという2つのライブラリを組み合わせて使用しています。 BarcodeResultオブジェクトを取得してそこからプロパティを抽出するために、最初にBarcodeReader.Read()メソッドを使用して画像ファイルにあるバーコードを読み取ります。 同時に、入力画像ファイルをAnyBitmapオブジェクトに変換し、画像に再編集メソッドを適用する必要があります。 BarcodeResultsオブジェクトが取得できたら、ループを適用してそれを繰り返し処理し、画像内にある各バーコードのX1, Y1, Width, Heightを取得して、それらをAnyBitmap.Redact()メソッドのCropRectangleプロパティで使用します。

複数ページの文書でページ番号が重要なのはなぜですか?

ユーザーは、BarCodeが見つかったページ番号を取得することができます。 これは、複数の BarCode を含む複数ページのドキュメントを使用し、さらに処理するためにドキュメント内で見つかったバーコードの場所を知る必要があるユーザーに役立つ機能です。 この機能は、PDF文書からBarCodeを読み取ったり、企業アプリケーションでバッチ文書を処理したりするときに不可欠です。

下のコードを見てください：

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

上のコード・スニペットは、ユーザーが複数ページのPDF文書で見つかったBarCodeの値とそれぞれのページ番号を返すプログラムを必要とするユースケースの1つを示しています。 コードは、BarcodeReader.ReadPdf()メソッドを使用して、マルチページのPDFドキュメント内のバーコードを読み取り、ドキュメント内で見つかったすべてのBarcodeResultsを格納するBarcodeResultsオブジェクトを返します。 それぞれのオブジェクト内の項目を繰り返し処理して、バーコードの値とそのバーコードが見つかったページ番号を取得します。 この使用例とは別に、ユーザーはこのプロパティを使用して、ドキュメント内のすべての BarCode が読み取られたかどうかをデバッグできます。

バーコードの回転とページの向きを検出するには?

IronBarcodeを使用すると、ユーザーはバーコードの向きやバーコードが見つかったページの向きの情報を取得することができます。 これら2つの情報を抽出するには、BarcodeResultオブジェクトからRotationとPageOrientationプロパティにアクセスします。 Rotation は、見つかったバーコードの回転角度を表す整数を返します。 この機能は、画像の向き補正機能と連動し、スキャンの角度に関係なくバーコードを正確に読み取ります。

下のコードを見てください：

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

上記のコードスニペットは、BarcodeResult.PageOrientationとBarcodeResult.Rotationの値をそれぞれ取得することによって、ユーザーがページの向きとバーコードの回転を取得できることを証明するために、サンプルPDF入力を添付して実行されました。 この機能は主にデバッグ目的で役立ちます。

[{i:(IronBarcode は、 0 、 90 、 180 、 270度の回転のバーコードのみを読み取ることができます。 指定した以外の回転値がある場合、IronBarcodeは値を返しません。 PageOrientationは、PageOrientationオブジェクトを返し、PortraitまたはLandscapeから構成されます。

テキスト プロパティと値プロパティの違いは何ですか?

もちろん、ユーザーがIronBarcodeを使用する際に取得したい主なプロパティは、その値とテキストです。 これらの2つのプロパティは、しばしば互換的に使用され、同じ値を返します。 それとは別に、ユーザーはBarcodeResult.ToString()メソッドを使用して同じ結果を得ることができます。 特殊なアプリケーションで作業する場合や、バーコードデータをストリームとしてエクスポートする場合、これらのプロパティは、好みの形式でバーコードコンテンツにアクセスする柔軟な方法を提供します。

以下のコードスニペットはデモンストレーションを示しています：

: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());
}

上記のコードスニペットから、ユーザーはIronBarcodeを使用して画像内のバーコードを読み取るために必要なコードはわずか数行です。 BarcodeReader.Read()メソッドによって返されたBarcodeResultsを繰り返し処理した後、ValueとTextプロパティを取得した結果をコンソールに出力し、BarcodeResult.ToString()メソッドを呼び出して、これらがすべて同じ値を返すことを示します。

要するに、IronBarcodeはユーザーがバーコードに関するさまざまな操作を行うための完璧なAPIです。書き込みやデコードに限りません。 様々な出力データ形式がサポートされているため、ユーザーはIronBarcodeが返すBarcodeResultオブジェクトでより多くのことができます。