C#のOCR CodeProjectチュートリアル：IronOCRで画像からテキストを抽出する

IronOCRを.NETプロジェクトにインストールするにはどうすればよいですか？

.NET 10プロジェクトにOCR機能を追加する最も簡単な方法は、 NuGetパッケージマネージャーを使用することです。 プロジェクトディレクトリでターミナルを開き、dotnet CLIコマンドを実行するか、Visual Studio内のパッケージマネージャーコンソールを使用してください。

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

インストール後、 NuGetパッケージマネージャーは必要なアセンブリをすべてダウンロードし、参照を自動的に設定します。 IronOCRは、 .NET Framework 4.6.2以降、 .NET Core 3.1以降、および.NET 5から.NET 10までを対象としているため、コンソールアプリ、 ASP.NET Coreサービス、WPFアプリケーション、Azure Functionsなど、幅広い環境で動作します。

ローカル環境でテストする場合は、ライセンスキーを登録する必要はありません。ライセンスが適用されるまで、出力には試用版の透かしが表示されます。 using ディレクティブを追加し、本番環境で使用する準備ができたら、起動時に一度だけキーを渡してください。

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

価格とアクティベーションの詳細については、 IronOCRのライセンスページをご覧ください。

画像ファイルからテキストを抽出するにはどうすればよいですか？

OCR のコアワークフローは、3 つのオブジェクトで構成されています。IronTesseract (エンジン)、OcrInput (入力コンテナ)、および OcrResult (出力)。 以下のサンプルコードはPNG画像を読み込み、認識したテキストをコンソールに出力します。

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

スキャンした文書やTIFFファイルはどのように処理しますか？

複数ページのTIFFファイルは、文書スキャンワークフローでよく使用されます。 IronOCRは、LoadImageFramesを使用してこれらを処理します。これにより、処理するフレーム(ページ)を正確に選択できます。これは、大規模なアーカイブのサブセットのみが必要な場合に便利です。

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}:");
    Console.WriteLine(page.Text);
}

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}:");
    Console.WriteLine(page.Text);
}

OCRの言語サポートはどのように設定するのですか？

IronOCRはデフォルトでは英語のテキストを読み取ります。 他の言語のドキュメントを処理するには、対応する言語のNuGetパッケージをインストールし、IronTesseract インスタンスの Language プロパティを設定します。

dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.Japanese

dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.Japanese

次にエンジンを設定し、バイリンガル文書の場合は、第二言語を追加します。

using IronOcr;
using IronOcr.Languages;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.German;

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronOcr.Languages;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.German;

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

IronOCRは125以上の言語をサポートしており、各言語は軽量なNuGetパッケージとして個別に配布されています。 これにより、本番環境用のバイナリファイルのサイズを小さく保つことができます。アプリケーションが実際に必要とする言語データのみが含まれるためです。 AddSecondaryLanguage を呼び出すと、エンジンは認識時にプライマリ言語モデルとセカンダリ言語モデルをブレンドします。

OCRエラーへの対処方法と認識精度の向上方法について教えてください

実稼働環境のアプリケーションでは、OCRパイプラインにおけるエラー処理が必要です。画像品質の問題、ファイルの欠落、サポートされていないフォーマットなどが原因で例外が発生する可能性があります。 try/catchブロックで呼び出しを囲むことで、クリーンなリカバリパスが確保されます。

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

精度が期待値よりも低い場合に役立つ追加設定をいくつかご紹介します。

• ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto -- Tesseract が単一列、複数列、単語のレイアウトを自動的に選択できるようにします
• ocr.Configuration.ReadBarCodes = false -- テキストのみのドキュメントを処理し、より高速なスループットが必要な場合は、バーコード検出を無効にします
• ocr.Configuration.TesseractVersion = TesseractVersion.Tesseract5 -- 最速のエンジンを使用することを保証します

フィールドが予測可能な位置に表示される構造化フォームの場合は、領域ベースのOCRを使用して、重要な領域のみを読み取ります。

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

認識対象を切り抜き領域に限定することで、大きな画像の場合、処理時間を最大90%短縮できます。 この技術は、請求書番号の抽出、フォームフィールドの読み取り、および身分証明書のスキャンに最適です。 詳細については、地域OCR操作ガイドをご覧ください。

認識されたテキストから検索可能なPDFを作成するにはどうすればよいですか？

スキャンした画像アーカイブを検索可能なPDFファイルに変換することは、OCRの最も価値の高い活用事例の一つです。 生成されたファイルは、元の視覚的な外観を保持しつつ、PDFビューア、検索エンジン、スクリーンリーダーがインデックス化できる目に見えないテキストレイヤーを埋め込んでいます。

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

テキストと並んで表示されるバーコードはどのように読み取るのですか？

IronOCRは、印刷されたテキストと同じ画像に埋め込まれたバーコードやQRコードを読み取ることができるため、別途バーコードライブラリを実行する必要がなくなります。 1つの設定プロパティで機能を有効にします。

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

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

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

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

サポートされているバーコード形式には、Code 128、Code 39、EAN-13、EAN-8、UPC-A、UPC-E、PDF417、データマトリックス、およびQRコードが含まれます。 詳細はIronOCRのバーコード読み取りガイドをご覧ください。

この機能は、配送ラベル、患者用リストバンド、製品タグなどに人間が読めるテキストと機械が読めるバーコードの両方が記載されている物流、医療、小売業などの分野で特に役立ちます。

IronOCRと他の.NET OCRオプションを比較するにはどうすればよいでしょうか？

.NET向けのOCRライブラリを評価する開発者は、通常、 IronOCR、Tesseract .NET、およびGoogle Cloud VisionやAzure コンピュータービジョンなどのクラウドサービスを検討します。 以下の表は、主な相違点をまとめたものです。

Googleがオープンソースプロジェクトとして維持管理しているTesseractは、 IronOCRとTesseract .NETの両方を内部的に支えている。 IronOCRは、.NETの慣用的なパッケージング、自動モデル管理、およびTesseractの生のバインディングにはない本番環境出力機能（検索可能なPDF、hOCRエクスポート）を追加します。 Azure コンピュータービジョンは最先端のクラウド精度を提供しますが、ネットワーク遅延と呼び出しごとのコストが発生するため、大量の処理やオフラインのワークフローには適していません。

データプライバシー規制により、医療記録、法的文書、財務諸表などの文書を外部サービスに送信することが禁止されているシナリオでは、 IronOCRのようなオンプレミス型のライブラリが適切な選択肢となります。

次のステップは何ですか?

これで、 NuGetによるインストール、基本的な画像からテキストへの抽出、複数ページの TIFF 処理、言語設定、エラー処理、領域ベースの読み取り、バーコード検出、検索可能な PDF 生成など、あらゆる.NET 10 アプリケーションに OCR を追加するための構成要素が揃いました。

さらに詳しく知りたい場合は、以下のIronOCRリソースをご覧ください。

• IronOCRドキュメントホーム-- 完全なAPIリファレンスと機能ガイド -画像フィルターチュートリアル-- すべての前処理フィルターの詳細ガイド -バーコード読み取りガイド- QRコードとテキスト付きリニアバーコード -領域OCRの使い方- フォームやIDの切り抜き認識 -言語リファレンス-- サポートされている125以上の言語の完全なリスト
• APIリファレンス-- すべてのクラス、メソッド、およびプロパティ

ライセンスに関するご質問や、 IronOCRを本番環境に導入する方法については、 IronOCRのライセンスページをご覧ください。 無料トライアルライセンスでは、評価期間中は出力にウォーターマークが表示されません。また、 Iron Softwareのサポートチームは、どのプランでも技術的な質問に対応いたします。

今IronOCRを始めましょう。

無料で始める