QRCoder.NET vs IronBarcode：C#バーコードライブラリの比較

QRコード専用デザイン

QRCoderは、データ作成ステップとレンダリングステップを分離します。CODE-39149--@@は中間オブジェクトを生成し、それをレンダラー・クラスに渡します。 このパターンは、追加のオブジェクトが必要になるという代償を伴いますが、出力フォーマットを精密に制御できます。

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

' PNG bytes via PngByteQRCode
Dim pngQR As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = pngQR.GetGraphic(20) ' 20px per module
File.WriteAllBytes("qr.png", pngBytes)

' SVG string via SvgQRCode
Dim svgContent As String = New SvgQRCode(qrCodeData).GetGraphic(10)
File.WriteAllText("qr.svg", svgContent)

CODE-39151--@@メソッドは、コード作成のための唯一のエントリーポイントです。 この図書館は、当初の目的を完全に遵守している。

詳細な機能比較

QRCoderアプローチ

QRCoderは2段階のパターンを使用します：CODE-39165--@@は、データとエラー訂正レベルをエンコードした中間オブジェクトを生成し、別のレンダラー・クラスがその中間オブジェクトを希望の出力フォーマットに変換します。 ECCレベルは必須パラメータであり、デフォルト値はありません。開発者は明示的に選択する必要があります。

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

Dim qrCode As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = qrCode.GetGraphic(20) ' pixels per module
File.WriteAllBytes("qr.png", pngBytes)

このパターンには、コードデータを再生成することなく、qrCodeData@オブジェクトを複数の出力形式で再利用できるという利点があります。 レンダリングクラスには、@--CODE-39168--@、@--CODE-39169--@、@--CODE-39170--@、@--CODE-39171--@、@--CODE-39172--@などがあります。

IronBarcodeのアプローチ

IronBarcodeは生成とレンダリングを静的なBarcodeWriterクラス上の流暢なチェーンに集約します。 CODE-39174--@@パラメータでフォーマットを選択し、@@--CODE-39175--@や@@--CODE-39176--@などのターミナルメソッドで出力を決定します：

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

Imports IronBarCode

' Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(400, 400) _
    .SaveAsPng("qr.png")

明示的なエラー訂正制御が必要な場合は、QRCodeWriter@クラスがフォーマット固有のオプションを提供します：

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)
qr.SaveAsPng("qr.png")

IronBarcode2次元バーコード作成ガイドは、同じ@--CODE-39178--@@エントリポイントを通して、QRコード、DataMatrix、PDF417、Aztecを含むサポートされているすべての2次元フォーマットをカバーしています。

QRCoderアプローチ

QRCoderのロゴ埋め込みは、QRCode@レンダラー・クラス（PngByteQRCodeとは異なる）を通して行われ、GetGraphicオーバーロードがSystem.Drawing.Bitmapを受け入れます。 これは、呼び出しコードがSystem.Drawingと直接連携し、ロゴファイルを読み込む必要があることを意味します：

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

Imports QRCoder
Imports System.Drawing

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H) ' High ECC required when logo occludes part of the code

Dim qrCode As New QRCode(qrCodeData)
Dim logoBitmap As New Bitmap("logo.png")
Dim qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap)
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png)

色のカスタマイズは、GetGraphicオーバーロードのdarkColorとlightColorパラメータを通して同様のパターンに従います。

IronBarcodeのアプローチ

IronBarcodeはロゴの埋め込みと色の変更を結果オブジェクトの名前付きメソッドとして公開します。 CODE-39188--@@メソッドはファイルパスを受け付け、@--CODE-39189--@@メソッドは@--CODE-39190--@@値を受け付けます：

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

Imports IronBarCode
Imports System.Drawing

' Logo embedding
Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-logo.png")

' Colour customisation
Dim coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500)
coloredQr.ChangeBarCodeColor(Color.DarkBlue)
coloredQr.SaveAsPng("colored-qr.png")

QRコードスタイルのカスタマイズガイドでは、ロゴのサイズ、色の組み合わせ、静音ゾーンの制御について詳しく説明しています。

QRCoderアプローチ

QRCoderにはバーコード読み取りAPIがありません。 CODE-39191--@@クラスとすべてのレンダラー・クラスは生成のみです。 画像、ファイル、またはストリームからQRコードをデコードする方法はありません。 QRコードの生成と読み取りの両方を必要とするアプリケーションは、独自のAPI、独自のネームスペース、独自のメンテナンスサイクルを持つ別のライブラリ（通常はZXing .NET ）を追加する必要があります。

//QRCoderhas no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

//QRCoderhas no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

'QRCoder has no reading API.
' These methods do not exist:
'   qrGenerator.Decode("image.png")
'   QRCodeReader.Read("image.png")
'
' A separate library (e.g., ZXing.Net) is required for decoding.

これは設計上の決定であり、見落としではありません。QRCoderは明確に生成ライブラリです。

IronBarcodeのアプローチ

IronBarcodeには、同じパッケージ内に読み取りAPIが含まれています。 画像ファイル、PDFファイル、ストリーム、オブジェクトを受け付けます。 呼び出し元が検索するバーコード形式を指定する必要なく、バーコード形式を自動的に検出し、画像内で見つかったすべてのバーコードを返します。

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // QRCode, Code128, EAN13, etc.
}

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // QRCode, Code128, EAN13, etc.
}

Imports IronBarCode

' Reading a QR code — no separate library required
Dim results = BarcodeReader.Read("qr.png")
For Each result In results
    Console.WriteLine(result.Text)        ' decoded value
    Console.WriteLine(result.BarcodeType) ' QRCode, Code128, EAN13, etc.
Next

画像からのバーコード読み取りガイドでは、 PDF、複数ページ文書、ストリーム、低解像度またはノイズの多い画像から、同じ入力ポイントを通してバーコードを読み取る方法を解説しています。

QRCoderアプローチ

QRCoderはQRコードのみを生成します。これは意図的な設計です。 CODE-39194--@@メソッドは、ライブラリが提供する唯一の世代エントリポイントです。 QRコードから始まり、後にCode 128配送ラベル、EAN-13製品コード、またはDataMatrix医薬品コンプライアンスコードを必要とするプロジェクトでは、追加される各フォーマットに対応するために、2つ目のライブラリを導入する必要があります。

using QRCoder;

//QRCoderis limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// コード128 requires a different library (e.g., NetBarcode)
// データマトリックス requires yet another library
// Reading any format requires yet another library

using QRCoder;

//QRCoderis limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// コード128 requires a different library (e.g., NetBarcode)
// データマトリックス requires yet another library
// Reading any format requires yet another library

Imports QRCoder

'QRCoder is limited to QR — other formats require separate packages
Dim qrGenerator As New QRCodeGenerator()
Dim qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M)

' コード128 requires a different library (e.g., NetBarcode)
' データマトリックス requires yet another library
' Reading any format requires yet another library

IronBarcodeのアプローチ

IronBarcodeは同じBarcodeWriter.CreateBarcode@エントリーポイントを通してすべてのフォーマットファミリーをカバーします。 QRコードからCode 128、DataMatrixに切り替えるには、BarcodeEncoding@パラメータを変更するだけです：

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

Imports IronBarCode

' All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode) _
    .SaveAsPng("campaign-qr.png")

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product-code.png")

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-code.png")

フォーマット要件はQRコードを超えて拡大する

ほとんどのバーコード要件はQRコードから始まりますが、QRCoderはその初期段階を確実に処理します。 緊張感が生じるのは、別のフォーマットが話題に上ってきた時だ。 出荷にコード128ラベルが必要な物流チーム、EAN-13製品コードを必要とする小売業務、シリアル化にDataMatrixを必要とする製薬ワークフローなど、新しいフォーマットが登場するたびに、チームはNuGetの依存関係を一つ追加せざるを得なくなります。 ライブラリを追加するたびに、新しい名前空間を習得する必要が生じ、新しいリリースサイクルを監視する必要が生じ、 .NETのアップグレード時にバージョン競合が発生する可能性も高まります。

バーコード読み取りが必須となる

キャンペーン用の送信用QRコードを生成するアプリケーションは、生成専用システムである。 入荷貨物の処理、到着時の製品コードの検証、イベントでのチケットの認証なども行うアプリケーションは、生成・読み取りシステムである。 QRCoderには設計上、読み取り機能がありません。その不足分は別のライブラリで補う必要があります。 読み取りライブラリの導入は、バーコードサブシステムの統合フットプリントを大幅に変更します。特に、読み取りライブラリが独自のフォーマット仕様要件やスレッドセーフティ制約を課す場合はなおさらです。

複数図書館の保守管理負担

QRCoderベースのプロジェクトにおける自然な蓄積パターンは、予測可能な経路をたどります。QRコード生成のためのQRCoder、配送ラベル用の1次元バーコードライブラリ、そしてデコード用の読み取りライブラリです。 各ライブラリは、独自のドキュメント、独自のバージョン管理サイクル、および独自の互換性のない変更履歴を持っています。 あるライブラリにとってマイナーな.NETバージョンのアップグレードが、別のライブラリにとって互換性のない変更と重なる場合がある。 長年にわたってこうした蓄積を管理してきたチームは、隠れたコストは最初の統合にあるのではなく、複数のアップグレードサイクルにわたる複合的なメンテナンス費用にあると報告している。

PDFドキュメントのサポート

QRCoderでは、PDFレポートに埋め込むためのバーコードを生成したり、文書処理パイプラインで受信したPDF文書からバーコードを抽出したりすることはできません。 PDFをサポートするには、バーコード機能を備えた完全なPDFライブラリ、または専用のライブラリの組み合わせが必要です。 請求書処理、コンプライアンス報告、テンプレート化されたPDFからのラベル生成など、文書中心のワークフローを構築するチームは、プロジェクトのライフサイクルの早い段階で、QRCoderの適用範囲がPDFの要件と交差することに気づきます。

ペイロードジェネレーター文字列フォーマット

QRCoderのPayloadGenerator@ヘルパークラスは、公開QRコード・ペイロード標準に準拠した文字列を生成します。 例えば、WiFiフォーマットでは、WIFI:T:WPA;S:NetworkName;P:Password;;が生成されます。 これらの文字列は、QRコード仕様で文書化された公開標準フォーマットであるため、ヘルパークラスを使用せずにIronBarcodeで直接構築できます。 多くのPayloadGenerator@を使用するチームは、文字列の構築を複製する小さな静的ヘルパーメソッドを書くことを計画してください。

ECCLevel 列挙型マッピング

QRCoderは、L、M、Q、Hの値でQRCodeGenerator.ECCLevelを使用します。 IronBarcodeはQRCodeWriter.QrErrorCorrectionLevel、@@--CODE-39225--@、@@--CODE-39226--@、@@--CODE-39227--@、@@--CODE-39228--@を使用しています。 マッピングは直接的ですが、列挙型参照はすべての呼び出し箇所で更新する必要があります。 QRCoderではCreateQrCode呼び出しごとに明示的にECCを選択する必要がありましたが、IronBarcodeではBarcodeWriter.CreateBarcodeパスが使用された場合に賢明なデフォルトを適用します。

レンダラークラスの削除

QRCoderのレンダラー・クラス（@--CODE-39231--@、@--CODE-39232--@、@--CODE-39233--@、@--CODE-39234--@、@--CODE-39235--@）は、移行後に不要になります。 IronBarcodeはレンダリングをフルエントチェーンに組み込んでいるため、中間レンダラオブジェクトパターンは引き継がれません。 これらのレンダラー・クラスをインスタンス化するコードは、BarcodeWriter@の結果のターミナル・メソッド呼び出しに置き換えることができます。