AzureのOCR vs IronOCR: .NETプロジェクトに最適な光学式文字認識ソリューションは？

WinRT非同期スタック

Windows.Media.Ocr を使用した基本的な OCR 操作では、認識を開始する前に、WinRT API サーフェスの複数のレイヤーをナビゲートする必要があります。

// Windows.Media.Ocr: 6+ async steps before receiving any text
// Requires net8.0-windows10.0.19041.0 TFM — will not compile cross-platform

public async Task<string> ExtractTextAsync(string imagePath)
{
    // Step 1: WinRT file system access
    var file = await StorageFile.GetFileFromPathAsync(imagePath);

    // Step 2: Open WinRT stream
    using var stream = await file.OpenAsync(FileAccessMode.Read);

    // Step 3: Create bitmap decoder
    var decoder = await BitmapDecoder.CreateAsync(stream);

    // Step 4: Decode to SoftwareBitmap
    var bitmap = await decoder.GetSoftwareBitmapAsync();

    // Step 5: Check language availability — null if not installed on this machine
    var engine = OcrEngine.TryCreateFromLanguage(
        new Windows.Globalization.Language("en-US"));
    if (engine == null)
        throw new Exception("OCR engine not available for this language");

    // Step 6: Recognize
    var result = await engine.RecognizeAsync(bitmap);
    return result.Text;
}

// Windows.Media.Ocr: 6+ async steps before receiving any text
// Requires net8.0-windows10.0.19041.0 TFM — will not compile cross-platform

public async Task<string> ExtractTextAsync(string imagePath)
{
    // Step 1: WinRT file system access
    var file = await StorageFile.GetFileFromPathAsync(imagePath);

    // Step 2: Open WinRT stream
    using var stream = await file.OpenAsync(FileAccessMode.Read);

    // Step 3: Create bitmap decoder
    var decoder = await BitmapDecoder.CreateAsync(stream);

    // Step 4: Decode to SoftwareBitmap
    var bitmap = await decoder.GetSoftwareBitmapAsync();

    // Step 5: Check language availability — null if not installed on this machine
    var engine = OcrEngine.TryCreateFromLanguage(
        new Windows.Globalization.Language("en-US"));
    if (engine == null)
        throw new Exception("OCR engine not available for this language");

    // Step 6: Recognize
    var result = await engine.RecognizeAsync(bitmap);
    return result.Text;
}

Imports System.Threading.Tasks
Imports Windows.Media.Ocr
Imports Windows.Storage
Imports Windows.Graphics.Imaging
Imports Windows.Storage.Streams
Imports Windows.Globalization

Public Async Function ExtractTextAsync(imagePath As String) As Task(Of String)
    ' Step 1: WinRT file system access
    Dim file As StorageFile = Await StorageFile.GetFileFromPathAsync(imagePath)

    ' Step 2: Open WinRT stream
    Using stream As IRandomAccessStream = Await file.OpenAsync(FileAccessMode.Read)

        ' Step 3: Create bitmap decoder
        Dim decoder As BitmapDecoder = Await BitmapDecoder.CreateAsync(stream)

        ' Step 4: Decode to SoftwareBitmap
        Dim bitmap As SoftwareBitmap = Await decoder.GetSoftwareBitmapAsync()

        ' Step 5: Check language availability — Nothing if not installed on this machine
        Dim engine As OcrEngine = OcrEngine.TryCreateFromLanguage(New Language("en-US"))
        If engine Is Nothing Then
            Throw New Exception("OCR engine not available for this language")
        End If

        ' Step 6: Recognize
        Dim result As OcrResult = Await engine.RecognizeAsync(bitmap)
        Return result.Text
    End Using
End Function

engineのヌルチェックは任意ではありません。 コードを実行しているマシンにターゲット言語パックがインストールされていない場合、TryCreateFromLanguageはnullを返し、認識は不可能です。 代替手段はない。 アプリケーションは、ユーザーにエラーを表示するか、あるいはエラーを通知せずに処理を終了する必要がある。

詳細な機能比較

Windows.Media.OCR アプローチ

WinRTへの依存関係は、コードが1行も実行される前にプロジェクトファイル内で顕在化します。 TargetFramework はWindowsプラットフォームバージョンを指定する必要があります:

<PropertyGroup>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
</PropertyGroup>

<PropertyGroup>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
</PropertyGroup>

そのTFMでは、Linuxコンテナからプロジェクトを使用することはできません。 ASP.NETデプロイの標準的なLinuxベースのイメージであるnet8.0（Windowsサフィックスなし）をターゲットとしたプロジェクトで参照しようとすると、実行時エラーではなくコンパイルエラーが発生します。 ベンダーロックインはビルド時に強制されます。

OCRワーカーがLinux上で動作するマイクロサービスアーキテクチャ、またはクロスプラットフォームのDockerイメージを生成するCI/CDパイプラインでOCR要件が発生した場合、Windows.Media.Ocrは評価対象ではなく、最初のピークを迎える前に除外されます。

IronOCRのアプローチ

IronOCRは、プラットフォーム固有のTFMなしでnet9.0をターゲットにしています。 同じNuGetパッケージとアプリケーションバイナリは、Windows、Linux、macOS のいずれのプラットフォームでも動作します。 DockerにIronOCRをデプロイするには、Linuxベースのイメージにapt-getラインが1つ必要で、他には何も必要ありません:

FROM mcr.microsoft.com/dotnet/aspnet:8.0
#Linuxdependency for System.Drawing
RUN apt-get update && apt-get install -y libgdiplus

COPY --from=build /app/publish /app
WORKDIR /app
ENTRYPOINT ["dotnet", "YourApp.dll"]

アプリケーションコード自体は、Windows版とLinux版で変更されていません。

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// なし platform TFM, no WinRT, no conditional compilation
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// なし platform TFM, no WinRT, no conditional compilation
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

Imports IronOcr

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim text As String = New IronTesseract().Read("document.jpg").Text

IronOCRは、AWS Lambda 、 Linux上のAzure Functions 、およびLinuxサーバー上で、コードの変更なしで直接動作します。 展開対象は構成上の懸念事項であり、アーキテクチャ上の制約ではない。

Windows.Media.OCR アプローチ

要求された言語がインストールされていない場合、OcrEngine.TryCreateFromLanguageはnullを返します。 OCR対応言語パックが全く存在しない場合、TryCreateFromUserProfileLanguagesはnullを返します。 どちらの方法もヌル値の処理が必要であり、どちらもスムーズな復旧手段を提供していません。つまり、コードから言語をインストールしたり、アプリケーションに言語をバンドルしたりする方法はありません。

// Windows.Media.Ocr: language availability is a runtime unknown
// Returns null if the language pack is not installed on this machine

var engine = OcrEngine.TryCreateFromLanguage(
    new Windows.Globalization.Language("fr-FR"));

if (engine == null)
{
    // French OCR is simply unavailable — no recovery path
    // User must go to Windows Settings > Language to install French
    throw new InvalidOperationException(
        "French OCR unavailable. Install the French language pack in Windows Settings.");
}

var result = await engine.RecognizeAsync(bitmap);

// Windows.Media.Ocr: language availability is a runtime unknown
// Returns null if the language pack is not installed on this machine

var engine = OcrEngine.TryCreateFromLanguage(
    new Windows.Globalization.Language("fr-FR"));

if (engine == null)
{
    // French OCR is simply unavailable — no recovery path
    // User must go to Windows Settings > Language to install French
    throw new InvalidOperationException(
        "French OCR unavailable. Install the French language pack in Windows Settings.");
}

var result = await engine.RecognizeAsync(bitmap);

Imports Windows.Globalization
Imports Windows.Media.Ocr

' Windows.Media.Ocr: language availability is a runtime unknown
' Returns Nothing if the language pack is not installed on this machine

Dim engine = OcrEngine.TryCreateFromLanguage(New Language("fr-FR"))

If engine Is Nothing Then
    ' French OCR is simply unavailable — no recovery path
    ' User must go to Windows Settings > Language to install French
    Throw New InvalidOperationException("French OCR unavailable. Install the French language pack in Windows Settings.")
End If

Dim result = Await engine.RecognizeAsync(bitmap)

Windows.Media.Ocr を使用した多言語文書処理アプリケーションをデプロイするには、デプロイ先のすべてのマシンで Windows 言語パックのインストールを調整する必要があります。 共有サーバーやグループポリシーで管理されているユーザーのマシンでは、これは開発者の制御範囲外です。

IronOCRのアプローチ

IronOCRは、言語モデルを専用のNuGetパッケージとして提供しており、アプリケーションバイナリと同時にデプロイされます。 言語データはビルド成果物とともに転送され、OSの設定には含まれません。 125以上の言語をサポートすることはdotnet add package操作です:

dotnet add package IronOcr.Languages.French, IronOcr.Languages.German, IronOcr.Languages.Arabic, IronOcr.Languages.ChineseSimplified

// IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Works on any machine, any OS, zero OS configuration required
var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

// IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Works on any machine, any OS, zero OS configuration required
var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

Imports IronOcr

' IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.French
ocr.AddSecondaryLanguage(OcrLanguage.German)

' Works on any machine, any OS, zero OS configuration required
Dim result = ocr.Read("multilingual-document.jpg")
Console.WriteLine(result.Text)

言語カタログには、ラテン語、CJK文字、アラビア語、ヘブライ語、デーヴァナーガリー文字、キリル文字、および数学記号などの特殊な文字セットがすべて含まれています。 各言語パックのバージョンはIronOCRパッケージのバージョンと連動しているため、本番環境で使用される言語モデルは、ローカル環境でテストされたものと一致します。

Windows.Media.OCR アプローチ

APIはSoftwareBitmapを受け入れ、テキストを返します。 その2点間の画質の変化は設定できません。 最適でない入力の精度を向上させる必要がある開発者は、SoftwareBitmapを構築する前にWindows Imaging Component APIを使用して手動で前処理を実装する必要があります。 それは独自の保守負担を伴う別のコードベースであり、OCR API自体がWindows専用であるのと同じ理由で、Windows専用のままになっている。

// Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
// Skewed, noisy, or low-resolution images degrade accuracy with no remedy
// Manual preprocessing via separate Windows Imaging APIs is the only option

var bitmap = await decoder.GetSoftwareBitmapAsync();
// bitmap goes directly to recognition with no quality improvement
var result = await engine.RecognizeAsync(bitmap);

// Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
// Skewed, noisy, or low-resolution images degrade accuracy with no remedy
// Manual preprocessing via separate Windows Imaging APIs is the only option

var bitmap = await decoder.GetSoftwareBitmapAsync();
// bitmap goes directly to recognition with no quality improvement
var result = await engine.RecognizeAsync(bitmap);

Imports System.Threading.Tasks

' Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
' Skewed, noisy, or low-resolution images degrade accuracy with no remedy
' Manual preprocessing via separate Windows Imaging APIs is the only option

Dim bitmap = Await decoder.GetSoftwareBitmapAsync()
' bitmap goes directly to recognition with no quality improvement
Dim result = Await engine.RecognizeAsync(bitmap)

標準的な、鮮明な文書スキャン（管理されたスキャン環境、一定の照明、最低300 DPI、正しい向き）であれば、この制限は許容範囲内です。 携帯電話のカメラ、自動給紙のずれがあるフラットベッドスキャナー、ファックス文書、またはコピーされた資料から画像を受け取る文書処理パイプラインの場合、これは前処理レイヤーをゼロから構築するか、精度の低下を受け入れるかのどちらかを意味します。

IronOCRのアプローチ

IronOCRのOcrInputクラスは、順番に適用される個々のフィルタメソッドを備えた前処理パイプラインを提供します。 画像品質補正フィルターは、生産文書処理における最も一般的な精度低下要因に対処します。

// IronOCR: explicit preprocessing pipeline
// Each filter targets a specific quality defect
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();              // Correct page rotation up to ~40 degrees
input.DeNoise();             // Remove scanner speckle and compression artifacts
input.Contrast();            // Boost contrast on faded or washed-out text
input.Binarize();            // Convert to black/white with optimal threshold
input.EnhanceResolution(300); // Scale image to 300 DPI for recognition

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

// IronOCR: explicit preprocessing pipeline
// Each filter targets a specific quality defect
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();              // Correct page rotation up to ~40 degrees
input.DeNoise();             // Remove scanner speckle and compression artifacts
input.Contrast();            // Boost contrast on faded or washed-out text
input.Binarize();            // Convert to black/white with optimal threshold
input.EnhanceResolution(300); // Scale image to 300 DPI for recognition

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

Imports IronOcr

' IronOCR: explicit preprocessing pipeline
' Each filter targets a specific quality defect
Using input As New OcrInput()
    input.LoadImage("low-quality-scan.jpg")

    input.Deskew()              ' Correct page rotation up to ~40 degrees
    input.DeNoise()             ' Remove scanner speckle and compression artifacts
    input.Contrast()            ' Boost contrast on faded or washed-out text
    input.Binarize()            ' Convert to black/white with optimal threshold
    input.EnhanceResolution(300) ' Scale image to 300 DPI for recognition

    Dim result = New IronTesseract().Read(input)
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

一般的なケースでは、IronOCRはファイルパスにReadを直接呼び出す際に自動前処理を適用し、エンジンが品質問題を検出して、明示的なフィルタ構成なしに修正します。 画像フィルタチュートリアルは、ToGrayScaleを含む、特殊なシナリオのための完全なフィルタセットをカバーしています。 色補正フィルターと向き補正は、標準以外の色プロファイルを持つドキュメントや、複数の角度で回転されたドキュメントに対応するために、処理パイプラインをさらに拡張します。

Windows.Media.OCR アプローチ

APIにはPDFへのパスは含まれていません。 Windows.Media.OcrでスキャンしたPDFをOCRするために、開発者は次のように行います: 個別のPDFレンダリングライブラリ（Windowsに組み込まれていないもの）を使用して各ページをRecognizeAsyncを呼び出し、結果を手動で連結します。 そのレンダリングライブラリ自体には、追加のライセンスおよび展開に関する考慮事項があります。 Windows.Media.Ocr コードは、実装全体のごく一部です。

// Windows.Media.Ocr: no PDF support
// Requires external PDF renderer to rasterize pages before OCR
// Conceptual pattern — a PDF rendering library is not provided by Windows APIs

// Step 1: Use external PDF library to render page to bitmap (not shown)
// Step 2: Pass rendered bitmap to Windows OCR
// var bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex); // external library required

var engine = OcrEngine.TryCreateFromUserProfileLanguages();
if (engine == null)
    throw new Exception("No OCR language available");

// Step 3: Recognize the rasterized page
// var result = await engine.RecognizeAsync(bitmap);
// Step 4: Collect and concatenate results across all pages manually

// Windows.Media.Ocr: no PDF support
// Requires external PDF renderer to rasterize pages before OCR
// Conceptual pattern — a PDF rendering library is not provided by Windows APIs

// Step 1: Use external PDF library to render page to bitmap (not shown)
// Step 2: Pass rendered bitmap to Windows OCR
// var bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex); // external library required

var engine = OcrEngine.TryCreateFromUserProfileLanguages();
if (engine == null)
    throw new Exception("No OCR language available");

// Step 3: Recognize the rasterized page
// var result = await engine.RecognizeAsync(bitmap);
// Step 4: Collect and concatenate results across all pages manually

' Windows.Media.Ocr: no PDF support
' Requires external PDF renderer to rasterize pages before OCR
' Conceptual pattern — a PDF rendering library is not provided by Windows APIs

' Step 1: Use external PDF library to render page to bitmap (not shown)
' Step 2: Pass rendered bitmap to Windows OCR
' Dim bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex) ' external library required

Dim engine = OcrEngine.TryCreateFromUserProfileLanguages()
If engine Is Nothing Then
    Throw New Exception("No OCR language available")
End If

' Step 3: Recognize the rasterized page
' Dim result = Await engine.RecognizeAsync(bitmap)
' Step 4: Collect and concatenate results across all pages manually

外部PDFレンダリングのステップを追加するだけで、当初は"無料で組み込み済みの"ソリューションだったものが、依存関係、学習曲線、そして新たな障害発生箇所を抱えることになる。

IronOCRのアプローチ

IronOCRはPDFをネイティブに読み取ります。 外部レンダラーなし、ラスタライズ工程なし、手動ページ組み立てなし。 画像パスを受け入れる同じIronTesseract.Readメソッドは、PDFパスも受け入れます。 .NETにおけるPDF OCRはたった1行のコードで実現できます。

// IronOCR: native PDF support — no external renderer needed
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// Password-protected PDFs
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// 検索可能なPDF output: make a scanned PDF text-searchable
var ocrResult = new IronTesseract().Read("scanned-archive.pdf");
ocrResult.SaveAsSearchablePdf("searchable-output.pdf");

// IronOCR: native PDF support — no external renderer needed
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// Password-protected PDFs
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// 検索可能なPDF output: make a scanned PDF text-searchable
var ocrResult = new IronTesseract().Read("scanned-archive.pdf");
ocrResult.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

' IronOCR: native PDF support — no external renderer needed
Dim text As String = New IronTesseract().Read("scanned-document.pdf").Text

' Password-protected PDFs
Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")
    Dim result = New IronTesseract().Read(input)
    Console.WriteLine(result.Text)
End Using

' 検索可能なPDF output: make a scanned PDF text-searchable
Dim ocrResult = New IronTesseract().Read("scanned-archive.pdf")
ocrResult.SaveAsSearchablePdf("searchable-output.pdf")

検索可能なPDF機能は、元のスキャン画像の上にテキストレイヤーを埋め込むことで、視覚的な忠実度を維持しながら、全文検索やコピー＆ペーストを可能にするPDFを生成します。 これは、文書管理システムやコンプライアンスアーカイブにおける一般的な要件です。 Windows.Media.Ocr は、その API のどのレベルにおいても、この出力を生成することはできません。

アプリケーションがWindowsデスクトップの容量を超えました

最も一般的なきっかけは、Windows以外の展開対象を導入する要件変更です。 当初はWindowsの内部ツールとして開発されたデスクトップユーティリティが、Webサービス、Dockerベースのマイクロサービス、またはクラウド機能へと昇格する。 その瞬間、Windows.Media.Ocr が障害物となる。 OCRコンポーネントは、対象プラットフォームにAPIが存在しないため、完全に書き直す必要があります。ポートも互換性シムも、問題を解決する条件付きコンパイルフラグもありません。 IronOCRを事前に導入していたチームは、今回の書き換え作業の必要はありません。

言語要件がインストール済みパックを超えています

文書処理パイプラインは、しばしばその範囲を拡大する。 英語の請求書を処理するために構築されたシステムに、フランス語、ドイツ語、アラビア語、または日本語の文書を処理する必要性が生じる。 Windows.Media.Ocr を使用する場合、これらの言語をサポートするには、開発者マシン、テスト用仮想マシン、本番サーバー、およびそれらに含まれるすべてのコンテナなど、すべての展開対象にわたって OS 言語パックのインストールを調整する必要があります。 グループポリシーで管理される環境や、OSのフットプリントが最小限のクラウドVMでは、そのような連携は現実的ではありません。 IronOCRのNuGetベースの言語パックはアプリケーションと共にデプロイされるため、OSとの連携は不要です。

PDF処理が対象範囲に追加されました

当初の要件が"フラットベッドスキャナーからの画像をOCR処理する"だった場合、Windows.Media.Ocrは機能します。 要件が"アーカイブに蓄積されたスキャン済みPDFの処理も行う"まで拡大すると、2つ目のライブラリが検討対象に加わる。 そのライブラリは、追加の依存関係、追加のライセンス上の考慮事項、そして追加の障害発生箇所となる。 画像OCRとPDF OCRの両方を統一されたAPIで必要とするチームにとって、 IronOCRは最初から2つのライブラリを使用するアーキテクチャを排除できることが分かります。

実世界の入力では精度が低下する

管理されたスキャン環境は、鮮明な画像を生み出す。 実際の入力データ（携帯電話で撮影した写真、わずかに傾いたフラットベッドスキャン、古いファックスで受信した文書、コピーされた資料など）は、Windows.Media.Ocr では修正できない精度低下を引き起こします。 顧客からテキストメッセージが届かなかったという苦情が寄せられ始めると、チームはこれまで省略していた前処理手順が必要になったことに気づく。 WindowsイメージングAPIを使用した前処理を後付けすることは、相当な開発作業となり、ソリューションがWindows専用のままになってしまう。 IronOCRの前処理パイプラインは既に完成している。

サーバー展開に関する疑問が生じる

Windows.Media.Ocr のドキュメントでは、クライアントアプリケーション向けの API が明確に位置づけられています。 サーバー環境（ユーザーがアップロードしたドキュメントを処理するASP.NETアプリケーション、ドキュメントキューを利用するWindowsサービスなど）で実行するには、デスクトップエクスペリエンスがインストールされたWindows Server環境が必要となり、これはLinuxコンテナよりも負荷が高く、コストも高くなります。 インフラストラクチャチームが、ホスティングコストを削減するためにOCRワーカーをLinuxインスタンスで実行できるかどうかを尋ねた場合、Windows.Media.Ocrでは答えは"いいえ"です。

プロジェクトファイル TFM の変更

Windows.Media.Ocrは、プロジェクトファイルにWindows専用のTFMが必要です (net8.0-windows10.0.19041.0など)。 クロスプラットフォーム対応のためにその依存関係を解消するということは、TFMサフィックスを削除することを意味します。 IronOCRは、Windows専用のサフィックスなしでnet9.0をターゲットにしています。 移行時には、プロジェクト内の他の WinRT API 依存関係が Windows TFM を必要としないことを確認してください。他の Windows プラットフォーム機能 (シェル統合、Windows 通知など) は、プラットフォームチェックの背後に抽象化する必要がある場合があります。

非同期から同期への移行

Windows.Media.Ocrは完全に非同期です — Task<OcrResult>にマッピングされます。IronOCRは同期および非同期の両方のパスを提供します。 同期型ocr.Read("file.jpg")は多段のawaitチェーンを直接置き換えます。 OCR呼び出しがバックグラウンドサービスまたはタスクベースのパイプライン内に存在するサーバーアプリケーションの場合、非同期パスも利用可能です。 いずれにしても、6つ以上の非同期ステップから1つの呼び出しへの移行は簡単です。

// Before: Windows.Media.Ocr — 6+ await operations
var file = await StorageFile.GetFileFromPathAsync(imagePath);
using var stream = await file.OpenAsync(FileAccessMode.Read);
var decoder = await BitmapDecoder.CreateAsync(stream);
var bitmap = await decoder.GetSoftwareBitmapAsync();
var engine = OcrEngine.TryCreateFromUserProfileLanguages();
var winResult = await engine.RecognizeAsync(bitmap);
string text = winResult.Text;

// After: IronOCR — 1 call, same result, any platform
string text = new IronTesseract().Read(imagePath).Text;

// Before: Windows.Media.Ocr — 6+ await operations
var file = await StorageFile.GetFileFromPathAsync(imagePath);
using var stream = await file.OpenAsync(FileAccessMode.Read);
var decoder = await BitmapDecoder.CreateAsync(stream);
var bitmap = await decoder.GetSoftwareBitmapAsync();
var engine = OcrEngine.TryCreateFromUserProfileLanguages();
var winResult = await engine.RecognizeAsync(bitmap);
string text = winResult.Text;

// After: IronOCR — 1 call, same result, any platform
string text = new IronTesseract().Read(imagePath).Text;

Imports Windows.Storage
Imports Windows.Graphics.Imaging
Imports Windows.Media.Ocr

' Before: Windows.Media.Ocr — 6+ await operations
Dim file As StorageFile = Await StorageFile.GetFileFromPathAsync(imagePath)
Using stream = Await file.OpenAsync(FileAccessMode.Read)
    Dim decoder As BitmapDecoder = Await BitmapDecoder.CreateAsync(stream)
    Dim bitmap = Await decoder.GetSoftwareBitmapAsync()
    Dim engine = OcrEngine.TryCreateFromUserProfileLanguages()
    Dim winResult = Await engine.RecognizeAsync(bitmap)
    Dim text As String = winResult.Text
End Using

' After: IronOCR — 1 call, same result, any platform
Dim text As String = New IronTesseract().Read(imagePath).Text

言語パックの置き換え

以前ocr.Language = OcrLanguage.Frenchを設定します。 IronOCRの言語カタログには、利用可能な125種類以上のパックがすべて掲載されています。 言語コードはBCP-47タグからOcrLanguage列挙型へ簡単にマッピングされます。

ヌルエンジンのハンドリング削除

Windows.Media.Ocr では、エンジン作成呼び出しのたびに null チェックを行う必要があります。 IronOCRは、設定または初期化の失敗時にnullを返すのではなく、構造化された例外をスローします。 nullチェックのガード句を削除し、必要に応じて標準的な例外処理に置き換えてください。 その結果、よりクリーンな通話サイトが実現し、"利用できない言語がサイレントに表示される"という障害モードも発生しなくなりました。