IronBarcode を使用して C# でバーコード画像を作成する方法

バーコード値

BarcodeWriter.CreateBarcode()メソッドには、バーコード値に対して複数のデータ型を受け入れます。 これにはbyte[] 配列、MemoryStream、およびstringが含まれます。 文字列の長さと許可される文字はバーコードの種類によって異なりますが、これはすべてドキュメントで詳しく説明されています。

バーコードエンコーディングの種類

IronBarcodeは、書き込み用のさまざまなバーコード形式をサポートしており、この完全なリストは私たちのサポートされているバーコード形式の記事で見つけることができます。 これらのバーコードタイプはそれぞれ独自のプロパティ、専門知識、および用途を持っています—どれがあなたの使用ケースに最適かをドキュメントで調査することができます。

幅と高さ

出力バーコード画像の幅と高さをピクセル単位で設定します。 デフォルトでは、この両方の測定値は_250 px_に設定されています。 QRやPDF417などのいくつかのバーコードタイプは、準拠するために特定のサイズを持つ必要があるため、バーコードの必要なサイズに一致しない入力幅と高さがある場合、バーコードは準拠したサイズで生成され、残りのスペースは空白で埋められます。 バーコードに対してサイズが小さすぎると、例外がスローされます。

バーコードを画像としてインポート

BarcodeWriter.CreateBarcode()メソッドでバーコードを作成する際、GeneratedBarcodeオブジェクトが生成されます。 このオブジェクトを使用して、複数の画像形式に対応したいくつかのSaveAs()メソッドでバーコードを保存できます。 これらのメソッドには次のものが含まれます:

• SaveAsGif(): このメソッドはGeneratedBarcodeをGIF画像ファイルとして保存し、画像ファイルパスを文字列引数として受け入れます。
• SaveAsJpeg(): このメソッドはGeneratedBarcodeをJPEG画像ファイルとして保存し、画像ファイルパスを文字列引数として受け入れます。
• SaveAsPng(): このメソッドはGeneratedBarcodeをPNG画像ファイルとして保存し、画像ファイルパスを文字列引数として受け入れます。
• SaveAsTiff(): このメソッドはGeneratedBarcodeをTIFF画像ファイルとして保存し、画像ファイルパスを文字列引数として受け入れます。
• SaveAsWindowsBitmap(): このメソッドはGeneratedBarcodeをBMP画像ファイルとして保存し、画像ファイルパスを文字列引数として受け入れます。
• SaveAsImage(): これは画像ファイルとしてGeneratedBarcodeを保存するための一般的なメソッドであり、ファイルパスを入力するときに希望するファイル形式の拡張子を指定する必要があります。

バーコードを生成して画像ファイルとして保存

ここでは、BarcodeWriter.CreateBarcode()を使用して_Code128_バーコードを作成し、JPEG画像ファイルとしてディスクに保存する様子を示します。

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-one-dimensional.cs

using IronBarCode;

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");

Imports IronBarCode

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")

QRコードの値

BarcodeWriter.CreateBarcode()メソッドに似ており、QRCodeWriter.CreateQrCode()はまず数値、アルファベット、または英数字のQRコードの値を受け入れます。 これらの値はbyte[] 配列、MemoryStream、およびSystem.String型でメソッド内に入力できます。

QRコードサイズ

ユーザーはInt32型としてメソッドにQRコードサイズを直接指定することもできます。 このメソッドで使用されるQRコードサイズの測定単位はピクセル(px)です。 デフォルトのQRコードサイズは500 pxです。

QRエラー訂正レベル

QRErrorCorrectionLevelはQRCodeWriterクラスのメンバープロパティであり、4つのフィールドがあります: 最高、高、中、低です。 基本的に、このプロパティはQRコードのフォールトトレランスレベルであり、高い訂正レベルではより複雑なQRコードを作成し、損傷している場合や部分的に隠れている場合でも、エラー読み取りが起こりにくくなります。 このプロパティの各フィールドを詳細に説明し、生成されたQRコードの外観の違いを見てみましょう。

QRErrorCorrectionLevel.Highest

最高の訂正レベルで生成されたQRコードは、最も複雑なQRコード画像になり、その30%がエラー訂正です。 生成されたQRコードにはロゴや画像グラフィックスをQRコードにスタンプすることもできます。

QRErrorCorrectionLevel.High

プロパティフィールドを高に設定すると、QRコードイメージに25%のエラー訂正が適用されます。 これは、QRErrorCorrectionLevel.Highestから生成されたQRコード画像よりも複雑性が低くなります。

QRErrorCorrectionLevel.Medium

このフィールドはQRコード画像に15%のエラー訂正を適用します。 この設定を使用することで、ユーザーはQRコードをより速く生成することができます； ただし、エラーに対してより脆弱になります。

QRErrorCorrectionLevel.Low

これは最も低い設定で、QRコード画像に7％のエラー訂正を適用し、最も複雑でないQRコードを生成します。

QRバージョン

QRバージョンは、QRコードのシンボルバージョンで、1から40までの範囲があります。高いQRバージョンは、より複雑なQRコードを生成し、ユーザーがより多くのデータを保存できるようにします。低いバージョンは逆になります。 ただし、QRバージョンが低すぎると、ユーザーがバージョンで許可される以上のデータをエンコードしようとする際に問題が発生する可能性があります。 QRバージョンを0に設定すると、エンコードする値に基づいて適切なQRバージョンが自動的に割り当てられます。 Please refer to this site for more information on QR version: QR Version

QRコード画像の作成

以下のコードスニペットは、IronBarcodeでQRCodeWriter.CreateQrCode()メソッドを使用してQRコードを書き込む方法と、それをSaveAsJpeg()メソッドを使用して画像ファイルとしてディスクに保存する方法を示しています。

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-qr.cs

using IronBarCode;

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");

Imports IronBarCode

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion:= 0).SaveAsJpeg("QRMedium.jpeg")

上のコードスニペットでは、QRコードにエンコードする値として英数字の値を使用し、生成されたQRコードの測定値として250ピクセルを使用しました。 生成されたQRコードのエラー訂正を中に設定し、プログラムがQRコード値に適したQRコードバージョンを決定できるようにしました。 さらに、QRコード画像ファイル名とJPEGという画像形式拡張子を引数として受け入れるSaveAsJpeg()も使用しました。