型式仕様要件

Spire.BarcodeのBarcodeScanner.Scan()はファイルパスのみを受け取るオーバーロードがありません。 読み取り操作を行うには、呼び出し元のコードが事前にバーコード形式を宣言する必要があります。 単一フォーマットのワークフローではこれで問題ありませんが、混合フォーマットのドキュメント処理では、候補となる反復ループが生成されます。

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

候補配列に追加される型ごとに、追加のスキャン処理が発生します。 リストに記載されていないフォーマットは、黙って見過ごされる。 開発者は、網羅的な型インベントリを維持し、新しいフォーマットがワークフローに導入されるたびに再テストを行う責任があります。

詳細な機能比較

Spire.バーコードアプローチ

Spire.BarcodeのBarCodeTypeパラメータを必要とします。 フォーマットが既知で保証されている場合は、単一型呼び出しが適切です。

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("barcode.png", BarCodeType.Code128)

For Each value As String In results
    Console.WriteLine(value)
Next

フォーマットが事前に不明な場合、利用可能な唯一の方法は、候補となるタイプを順に調べていくことです。各反復処理は完全なスキャンパスであり、リストに存在しないフォーマットは黙って見落とされます。 結果はstring[]で、タイプ情報を持たないため、フォーマットに基づくダウンストリームルーティングには、呼び出し側による追加の状態管理が必要です。

IronBarcodeのアプローチ

IronBarcodeのBarcodeReader.Read()にはタイプパラメータが必要ありません。 このライブラリは、サポートされているすべてのシンボル体系において、フォーマットを一度の処理で自動的に検出します。 画像からバーコードを読み取る処理は、ソースにいくつの異なるフォーマットが含まれていても、単一のメソッド呼び出しで済みます。

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarCode

' IronBarcode: automatic format detection
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

各結果オブジェクトにはValue、および位置メタデータが含まれています。 フォーマットに基づく下流ルーティングでは、追加の状態は必要ありません。型は結果自体に含まれています。

Spire.Barcode 無料ティア

FreeSpire.Barcodeは、生成されたバーコード画像に大きな評価用透かしを適用します。 透かしがバーコードを覆い隠しているため、製品での使用には適さず、生成品質の適切な評価も妨げられる。 無料版ではスキャン性能が意図的に低下しているため、評価中に測定されたスループット値は、商用版のSpire.Barcodeの性能を表すものではありません。 無料版の場合、実行中に警告ダイアログが表示されないようにするには、E-iceblueから取得した登録キーが必要です。 無料プランで利用できるシンボルセットは、有料プランで提供されているシンボルセットの一部です。 これらの制約を総合すると、FreeSpire.Barcode に基づいて構築された評価は、商用製品が提供する機能を正確に反映していないことを意味します。

IronBarcodeトライアルモード

IronBarcodeのトライアル版は、ライセンスキーなしで使用できるライセンスパッケージです。 完全な記号体系サポートと行動制限なしで、フルスピードで読書が可能です。 読書速度と精度に関するオプションは、試用版とライセンス版で同じように動作します。 トライアルモードで生成されたバーコード出力には、画像の端に小さな透かしが入ります。 バーコード自体を覆い隠すことはありません。 IronBarcodeの評価中に測定される動作は、本番環境に出荷される動作と同じです。

Spire.バーコードアプローチ

Spire.Barcodeには、ネイティブのPDF読み取り機能はありません。 PDFファイルからバーコードを抽出するには、開発者はSpire.PDFパッケージを別途インストールし、別個のSpire.PDFライセンスを購入し、バーコードスキャンを開始する前に手動のページ反復と画像抽出コードを書く必要があります。

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

Dim pdf As New PdfDocument()
pdf.LoadFromFile("document.pdf")

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required for each scan call
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

このパターンでは、2つのNuGetパッケージ、2つのライセンス契約、および開発者が作成したページ管理コードが必要です。 PDFファイル内でバーコードがラスター画像ではなくベクター画像に埋め込まれている場合、画像抽出方法ではバーコードを完全に検出できない可能性があります。

IronBarcodeのアプローチ

IronBarcodeは、追加の依存関係なしにPDFファイルをネイティブに処理します。 PDFドキュメントからバーコードを読み取るのは、画像ファイルと同じBarcodeReader.Read() APIを使用した単一のメソッド呼び出しです。 各結果オブジェクトにはページ番号が含まれています。

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

Imports IronBarcode

' IronBarcode: native PDF reading from the same Read() method
Dim results = BarcodeReader.Read("document.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}")
Next

手動でのページ抽出、二次パッケージ、追加ライセンスの購入は一切不要です。

Spire.バーコードアプローチ

Spire.Barcodeの生成モデルは、可変のBarcodeSettings設定オブジェクトに中心があります。 開発者は設定をインスタンス化し、プロパティを個別に設定し、設定オブジェクトをGenerateImage()を呼び出します。

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("barcode.png", ImageFormat.Png)

可変な設定オブジェクトは、単一のインスタンスが複数の生成操作で再利用される場合に、設定が意図せず呼び出し間で共有される可能性があることを意味します。 ジェネレータークラスは、独自の構成ロジックを持たない追加のインスタンス化ステップを追加します。

IronBarcodeのアプローチ

IronBarcodeは、オプションで流暢なメソッドチェーン機能を備えた静的ファクトリメソッドを使用します。 管理対象となる設定オブジェクトもジェネレーターインスタンスもありません。

// IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

// IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

カスタムロゴ入りのQRコードは、 IronBarcodeのすべてのライセンスプランで利用可能です。

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

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

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

混合フォーマット文書処理

単一の既知のバーコード形式から始めたチームは、時間の経過とともに形式の多様性が増していくことに気づくことが多い。Code128ラベルから始まった倉庫管理アプリケーションは、DataMatrix、GS1-128、またはQRコードを使用するサプライヤーからの出荷を受け取るようになる可能性がある。 ワークフローに新しいフォーマットが追加されるたびに、型推測ループ内の候補配列を更新し、検出ロジックを再テストし、反復順序によって既存のフォーマットが置き換えられていないことを確認する必要があります。 フォーマットの多様性が高まり、そのループの保守オーバーヘッドが継続的な開発コストとなる段階に達すると、チームは自動検出によってその負担を完全に解消できるかどうかを評価する。

PDF統合

文書を多く扱うアプリケーションでは、バーコードを単独の画像ではなくPDFファイルから抽出する必要が生じる場面によく遭遇します。 Spire.Barcodeのワークフローでは、この移行を行うには、Spire.PDFのライセンスを取得し、別のパッケージを統合し、バーコード読み取りを行う前にページ反復処理と画像抽出のインフラストラクチャを作成する必要があります。 当初の購入時にこの要件を想定していなかったチームは、概念的にはバーコード読み取りに属するタスクのために、2つの製品ライセンスと2つのAPIインターフェースを管理することになる。 PDFサポートには別途購入が必要であることが判明した場合、製品選定を見直すきっかけとなることはよくある。

無料評価プランの制限事項

FreeSpire.Barcodeを評価した後、商用ライセンスを購入したチームの中には、商用製品が評価結果とは異なる動作を示すと報告するケースがある。 これは意図的な設計です。無料版では意図的に読み取り性能を低下させ、使用できるシンボルセットを制限しているため、評価中に実施されたベンチマークやフォーマット対応テストの結果は、商用版には適用されません。 購入後にこの不一致に気づいたチームは、試用期間中の挙動が本番環境での挙動を反映している代替製品を探すことが多い。

製品数の削減

テクノロジー・スタックを標準化する組織は、Spire.Barcodeを、それぞれ独自のライセンス費用と更新サイクルを持つ、増え続けるE-iceblue製品の構成要素の一つとして認識することがあります。 Spire.Barcodeの主な目的が、Spire.DocやSpire.XLSとの緊密な統合ではなく、文書処理パイプライン内でのバーコード読み取りである場合、チームは、単一の自己完結型バーコードライブラリを使用することで、ライセンスの複雑さとサポート範囲の両方を削減できるかどうかを評価します。

BarCodeTypeパラメータの削除

Spire.BarcodeのコードベースでのBarCodeType引数を持ちます。 これらの呼び出しをBarcodeReader.Read()で置き換えると、タイプパラメータが完全に削除されます。 タイプ推測ループ — 選択肢のBarCodeType値を反復するforeachブロック — は完全に削除可能です; 単一のBarcodeReader.Read()呼び出しがループ全体を置き換えます。

戻り値の型を更新する

Spire.Barcodeのstring[]を返します。 IronBarcodeはBarcodeResultsコレクションを返します。 string[]に割り当てたり、そのタイプを期待するメソッドに結果を渡す呼び出しサイトは更新が必要です。 配列として値を抽出するには.Select(r => r.Value).ToArray()を使用します; 最初の結果にアクセスするには.First()?.Valueを使用します。

Spire.PDFパッケージの削除

PDFファイルからのバーコード抽出をサポートするためだけにSpire.PDFがインストールされていた場合、IronBarcodeに移行後に削除できます。 すべてのBarcodeReader.Read("file.pdf")呼び出しに置き換えられます。 バーコード以外のドキュメント操作にSpire.PDFが使用されている場合は、それを保持し、バーコード関連のコードパスのみを置き換えるべきです。

名前空間の変更

using IronBarCode;に置き換えます。 BarcodeEncodingに置き換えられ、読み取りには同等のものはありません。 ライセンス初期化はIronBarCode.License.LicenseKeyプロパティ割り当てへの変更となります。