QRコード専用デザイン

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

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)

QRCodeGenerator.CreateQrCode メソッドはコード作成の唯一のエントリーポイントです。CreateEAN13 はありません。 この図書館は、当初の目的を完全に遵守している。

詳細な機能比較

QRCoderアプローチ

QRCoderは2段階のパターンを使用します。QRCodeDataという中間オブジェクトを生成し、別のレンダラークラスがそれを必要な出力形式に変換します。 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オブジェクトを複数の出力形式に再利用できることです。 レンダラークラスには、PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, BitmapByteQRCode などがあります。

IronBarcodeのアプローチ

IronBarcodeはジェネレーションとレンダリングを静的なBarcodeWriterクラス上で流暢なチェーンに統合しています。 BarcodeEncoding.QRCode パラメータはフォーマットを選択し、ToPngBinaryDataといった端末メソッドが出力を決定します：

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

IronBarcodeの2Dバーコード作成ガイドでは、QRコード、DataMatrix、PDF417、Aztecを含むすべてのサポートされた2D形式を同じBarcodeWriterエントリーポイントでカバーしています。

QRCoderアプローチ

QRCoderのロゴ埋め込みは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)

カラーのカスタマイズは、lightColorパラメータを通じて同様のパターンに従います。

IronBarcodeのアプローチ

IronBarcodeはロゴ埋め込みと色変更をQRCodeWriter結果オブジェクトの名前付きメソッドとして提供しています。 AddBrandLogo メソッドはファイルパスを受け入れ、ChangeBarCodeColor はColor 値を受け入れます：

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がありません。 QRCodeGenerator クラスとすべてのレンダラークラスは生成専用です。 画像、ファイル、またはストリームから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が含まれています。 BarcodeReader.Read は画像ファイル、PDFファイル、ストリーム、およびSystem.Drawing.Bitmapオブジェクトを受け入れます。 呼び出し元が検索するバーコード形式を指定する必要なく、バーコード形式を自動的に検出し、画像内で見つかったすべてのバーコードを返します。

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);       // decoded value
    Console.WriteLine(result.Format);      // 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.Value);       // decoded value
    Console.WriteLine(result.Format);      // 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.Value)       ' decoded value
    Console.WriteLine(result.Format)      ' QRCode, Code128, EAN13, etc.
Next

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

QRCoderアプローチ

QRCoderはQRコードのみを生成します。これは意図的な設計です。 QRCodeGenerator.CreateQrCode メソッドは、このライブラリが提供する唯一の生成エントリーポイントです。 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パラメータを変更するだけでよく、追加のパッケージや新しい名前空間、別個のAPIは不要です：

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はHighestの値を使用します。 マッピングは直接的ですが、列挙型参照はすべての呼び出し箇所で更新する必要があります。 QRCoderが毎回BarcodeWriter.CreateBarcodeパスが使用される際には妥当なデフォルトを適用します。

レンダラークラスの削除

QRCoderのレンダラークラス（QRCode）は、移行後は必要ありません。 IronBarcodeはGeneratedBarcode上での流暢なチェーンにレンダリングを組み込んでいるため、中間レンダラーオブジェクトパターンは引き継がれません。 これらのレンダラークラスをインスタンス化するコードは、BarcodeWriter結果の終端メソッドコールに置き換えることができます。