OCR w Azure vs. IronOCR: Które rozwiązanie do optycznego rozpoznawania znaków najlepiej pasuje do projektów .NET?

Stos asynchroniczny WinRT

Każda podstawowa operacja OCR w Windows.Media.Ocr wymaga przejścia przez wiele warstw interfejsu API WinRT, zanim rozpocznie się rozpoznawanie:

// 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

Sprawdzenie null dla engine nie jest opcjonalne. Jeżeli celowy pakiet językowy nie jest zainstalowany na maszynie działającej z kodem, TryCreateFromLanguage zwraca null i rozpoznanie nie jest możliwe. Nie ma wersji awaryjnej; aplikacja musi wyświetlić użytkownikowi komunikat o błędzie lub zakończyć działanie bez komunikatu.

Szczegółowe porównanie funkcji

Podejście Windows.Media.OCR

Zależność od WinRT pojawia się w pliku projektu, zanim zostanie uruchomiona choćby jedna linijka kodu. TargetFramework musi określać wersję platformy Windows:

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

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

Z tym plikiem TFM projekt nie może być używany z kontenera Linux. ObrazDockeroparty na mcr.microsoft.com/dotnet/aspnet:8.0 — standardowym obrazie bazowymLinuxdla wdrożeń ASP.NET — nie ma runtime WinRT. Próba odniesienia do typów Windows.Media.Ocr w projekcie docelowym net8.0 (bez przyrostka Windows) powoduje błędy kompilacji, a nie błędy czasu wykonania. Ograniczenie to jest egzekwowane w czasie kompilacji.

Gdy pojawiają się wymagania dotyczące OCR w architekturze mikrousług, gdzie moduł OCR działa na systemie Linux, lub w potoku CI/CD, który generuje wielopłatformowe obrazy Docker, Windows.Media.Ocr nie wchodzi w grę — jest eliminowany jeszcze przed pierwszym spike'iem.

Podejście IronOCR

IronOCR obsługuje net6.0, net7.0, net8.0, i net9.0 bez specyficznych dla platform TFM. Ten sam pakiet NuGet i ten sam plik binarny aplikacji działają w systemach Windows,Linuxi macOS. Wdrożenie IronOCR do Docker wymaga jednej linii apt-get dla libgdiplus na bazowym obrazie Linux, nic więcej:

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

Sam kod aplikacji pozostaje niezmieniony w wersjach dla systemów Windows i Linux:

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// Nie 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
// Nie 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 działa na AWS Lambda, Azure Functions w systemie Linux oraz bezpośrednio na serwerach Linux bez konieczności modyfikacji kodu. Cel wdrożenia jest kwestią konfiguracji, a nie ograniczeniem architektonicznym.

Podejście Windows.Media.OCR

OcrEngine.TryCreateFromLanguage zwraca null, gdy żądany język nie jest zainstalowany. TryCreateFromUserProfileLanguages zwraca null, gdy nie istnieje żaden pakiet językowy zdolny do OCR. Obie ścieżki wymagają obsługi wartości null i żadna z nich nie zapewnia płynnego powrotu do normalnego działania — nie ma możliwości zainstalowania języka z kodu ani dołączenia go do aplikacji:

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

Wdrożenie wielojęzycznej aplikacji do przetwarzania dokumentów z wykorzystaniem Windows.Media.OCR wymaga koordynacji instalacji pakietów językowych Windows na wszystkich komputerach w środowisku docelowym. Na serwerze współdzielonym lub komputerze użytkownika zarządzanym przez zasady grupy nie leży to w gestii programisty.

Podejście IronOCR

IronOCR dostarcza modele językowe jako dedykowane pakiety NuGet, które są wdrażane wraz z plikiem binarnym aplikacji. Dane językowe są przenoszone wraz z artefaktem kompilacji, a nie wraz z konfiguracją systemu operacyjnego. Wsparcie dla 125+ języków jest operacją 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)

Pełny katalog języków obejmuje łacinę, CJK, arabski, hebrajski, dewanagari, cyrylicę oraz zestawy specjalistyczne, w tym notację matematyczną. Każdy pakiet językowy jest powiązany z wersją pakietu IronOCR, dzięki czemu model językowy w środowisku produkcyjnym odpowiada modelowi testowanemu lokalnie.

Podejście Windows.Media.OCR

API akceptuje SoftwareBitmap i zwraca tekst. Nie można konfigurować jakości obrazu między tymi dwoma punktami. Deweloperzy, którzy potrzebują poprawić dokładność na suboptymalnym wejściu, muszą samodzielnie zaimplementować przetwarzanie wstępne używając API Windows Imaging Component przed skonstruowaniem SoftwareBitmap. Jest to oddzielna baza kodu, która wymaga własnej konserwacji i pozostaje specyficzna dla systemu Windows z tego samego powodu, co samo API OCR:

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

W przypadku standardowych, wyraźnych skanów dokumentów (kontrolowane środowisko skanowania, stałe oświetlenie, co najmniej 300 DPI, prawidłowa orientacja) ograniczenie to jest do pokonania. W przypadku potoków przetwarzania dokumentów, które odbierają obrazy z aparatów w telefonach komórkowych, skanerów płaskich z automatycznym podawaniem i przesunięciem, dokumentów faksowanych lub materiałów fotokopiowanych, oznacza to albo zbudowanie warstwy przetwarzania wstępnego od podstaw, albo pogodzenie się z obniżeniem dokładności.

Podejście IronOCR

Klasa OcrInputIronOCR zapewnia pipeline przetwarzania wstępnego z indywidualnymi metodami filtra, które stosują się w kolejności. Filtry korekcji jakości obrazu eliminują najczęstsze czynniki obniżające dokładność podczas przetwarzania dokumentów produkcyjnych:

// 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

W przypadku powszechnego przypadku,IronOCR stosuje automatyczne przetwarzanie wstępne, gdy wywołuje Read bezpośrednio na ścieżce pliku — silnik wykrywa problemy z jakością i koryguje je bez konieczności ręcznej konfiguracji filtra. Samouczek filtrów obrazu obejmuje pełen zestaw filtrów w tym Sharpen, Dilate, Erode, Invert, i ToGrayScale dla specjalnych scenariuszy. Filtry korekcji kolorów i korekcji orientacji rozszerzają możliwości przetwarzania dokumentów o niestandardowych profilach kolorów lub obróconych o wiele kątów.

Podejście Windows.Media.OCR

W API nie ma ścieżki do pliku PDF. Aby przeprowadzić OCR zeskanowanego PDF za pomocą Windows.Media.Ocr, programista musi: wyrenderować każdą stronę do SoftwareBitmap używając oddzielnej biblioteki renderowania PDF (żadna z nich nie jest wbudowana w Windows), iterować przez strony, wywoływać RecognizeAsync dla każdej strony i ręcznie sklejać wyniki. Sama biblioteka renderująca wiąże się z dodatkowymi kwestiami dotyczącymi licencji i wdrażania. Kod Windows.Media.OCR stanowi niewielką część całej implementacji:

// 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

Sam etap zewnętrznego renderowania plików PDF powoduje powstanie zależności, wymaga osobnej nauki obsługi i stanowi dodatkowe źródło błędów w rozwiązaniu, które początkowo miało być "bezpłatne i wbudowane".

Podejście IronOCR

IronOCR odczytuje pliki PDF w sposób natywny. Bez zewnętrznego renderera, bez etapu rasteryzacji, bez ręcznego składania stron. Ta sama metoda IronTesseract.Read, która akceptuje ścieżki obrazu, akceptuje także ścieżki PDF. OCR plików PDF w .NET to jedna linijka:

// 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 z funkcją wyszukiwania 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 z funkcją wyszukiwania 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 z funkcją wyszukiwania output: make a scanned PDF text-searchable
Dim ocrResult = New IronTesseract().Read("scanned-archive.pdf")
ocrResult.SaveAsSearchablePdf("searchable-output.pdf")

Funkcja przeszukiwalnego pliku PDF osadza warstwę tekstową na oryginalnym zeskanowanym obrazie, tworząc plik PDF, który zachowuje wierność wizualną, a jednocześnie umożliwia wyszukiwanie pełnotekstowe oraz kopiowanie i wklejanie. Jest to powszechny wymóg w przypadku systemów zarządzania dokumentami i archiwów zgodności. Windows.Media.OCR nie może wygenerować tego wyniku na żadnym poziomie swojego API.

Aplikacja wykracza poza środowisko Windows Desktop

Najczęstszym czynnikiem wywołującym jest zmiana wymagań, która wprowadza cel wdrożenia inny niż Windows. Narzędzie desktopowe, które początkowo funkcjonowało jako wewnętrzne narzędzie systemu Windows, zostaje przekształcone w usługę internetową, mikrousługę opartą na Dockerze lub funkcję w chmurze. W momencie, gdy to nastąpi, Windows.Media.OCR staje się przeszkodą. Komponent OCR wymaga całkowitego przepisania, ponieważ API nie istnieje na platformie docelowej — nie ma portu, nie ma shimu kompatybilności ani flagi kompilacji warunkowej, która rozwiązałaby ten problem. Zespoły, które zaplanowały wszystko z wyprzedzeniem dzięki IronOCR, nie muszą zajmować się tym przepisywaniem.

Wymagania językowe przekraczają zainstalowane pakiety

Procesy przetwarzania dokumentów często rozszerzają zakres działania. System stworzony do przetwarzania faktur w języku angielskim musi teraz obsługiwać dokumenty w języku francuskim, niemiećkim, arabskim lub japońskim. W przypadku Windows.Media.OCR obsługa tych języków wymaga koordynacji instalacji pakietów językowych systemu operacyjnego we wszystkich miejscach wdrożenia — na komputerach programistów, maszynach wirtualnych do testów, serwerach produkcyjnych oraz wszelkich kontenerach w środowisku. W środowiskach zarządzanych przez zasady grupy lub w maszynach wirtualnych w chmurze o minimalnym obciążeniu systemu operacyjnego taka koordynacja jest niepraktyczna. Pakiety językowe IronOCR oparte na NuGet są wdrażane wraz z aplikacją i nie wymagają koordynacji z systemem operacyjnym.

Przetwarzanie plików PDF dodano do zakresu

Gdy pierwotnym wymaganiem było "OCR obrazów ze skanera płaskiego", sprawdza się Windows.Media.Ocr. Gdy wymagania rozszerzają się o "przetwarzanie zaległości zeskanowanych plików PDF w naszym archiwum", do stosu dołącza druga biblioteka. Ta biblioteka stanowi dodatkową zależność, dodatkowy aspekt licencyjny oraz dodatkowy obszar potencjalnych awarii. Zespoły, które potrzebują zarówno OCR obrazów, jak i OCR plików PDF w ramach ujednoliconego API, przekonują się, że IronOCR od samego początku eliminuje konieczność stosowania architektury opartej na dwóch bibliotekach.

Spadek dokładności przy danych wejściowych z rzeczywistych źródeł

Kontrolowane środowiska skanowania zapewniają czyste obrazy. Dane wejściowe pochodzące ze świata rzeczywistego — zdjęcia wykonane telefonami komórkowymi, lekko przekrzywione skany z płaskiego skanera, starsze dokumenty otrzymane faksem, materiały fotokopiowane — powodują pogorszenie dokładności, którego nie da się naprawić w ramach Windows.Media.OCR. Kiedy zaczynają napływać skargi klientów dotyczące brakującego tekstu, zespoły odkrywają, że pominięty etap przetwarzania wstępnego stał się konieczny. Modernizacja przetwarzania wstępnego przy użyciu interfejsów API Windows Imaging wymaga znacznego nakładu pracy programistycznej i sprawia, że rozwiązanie jest dostępne wyłącznie w systemie Windows. Potok przetwarzania wstępnego IronOCR już istnieje.

Pojawia się pytanie o wdrożenie serwera

Dokumentacja Windows.Media.OCR wyraźnie pozycjonuje API jako przeznaczone dla aplikacji klienckich. Uruchomienie go w kontekście serwera — aplikacji ASP.NET przetwarzającej dokumenty przesłane przez użytkowników, usługi Windows korzystającej z kolejki dokumentów — wymaga środowiskaWindows Serverz zainstalowanym Desktop Experience, które jest cięższym i droższym profilem maszyny wirtualnej niż kontener Linux. Gdy zespół ds. infrastruktury zapyta, czy moduł OCR może działać na instancji systemuLinuxw celu obniżenia kosztów hostingu, odpowiedź w przypadku Windows.Media.OCR brzmi: nie.

Plik projektu Zmiana TFM

Windows.Media.Ocr wymaga specyficznego dla Windows TFM w pliku projektu (net8.0-windows10.0.19041.0 lub podobny). Usunięcie tej zależności w celu obsługi platform wielopłatformowych oznacza usunięcie przyrostka TFM.IronOCR obsługuje net6.0, net8.0, i net9.0 bez specyficznych dla Windows przyrostków. Podczas migracji należy upewnić się, że żadne inne zależności API WinRT w projekcie nie wymagają biblioteki Windows TFM — inne funkcje platformy Windows (integracja z powłoką, powiadomienia systemu Windows itp.) mogą wymagać abstrakcji za pomocą sprawdzania platformy.

Migracja z trybu asynchronicznego do synchronicznego

Windows.Media.Ocr jest w pełni asynchroniczny — RecognizeAsync zwraca IAsyncOperation<OcrResult>, który mapuje do Task<OcrResult> przez interoperacyjność WinRT.IronOCR zapewnia zarówno synchroniczne, jak i asynchroniczne ścieżki. Synchroniczne ocr.Read("file.jpg") bezpośrednio zastępuje wieloetapowy łańcuch await. W przypadku aplikacji serwerowych, w których wywołanie OCR znajduje się w usłudze działającej w tle lub w potoku opartym na zadaniach, dostępna jest również ścieżka asynchroniczna. Tak czy inaczej, przejście od ponad 6 asynchronicznych kroków do jednego wywołania jest proste:

// 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

Zastąpienie pakietu językowego

Dla każdego języka wcześniej rozwiązawanego przez OcrEngine.TryCreateFromLanguage(new Windows.Globalization.Language("fr-FR")), zainstaluj odpowiadający pakiet językowy IronOCR i ustaw ocr.Language = OcrLanguage.French. Katalog języków IronOCR zawiera listę wszystkich ponad 125 dostępnych pakietów. Kody językowe mapują się bezpośrednio z tagów BCP-47 do enumeracji OcrLanguage.

Usunięcie obsługi silnika Null

Windows.Media.OCR wymaga sprawdzania wartości null przy każdym wywołaniu tworzenia silnika.IronOCR zgłasza ustrukturyzowane wyjątki zamiast zwracać wartość null w przypadku niepowodzeń konfiguracji lub inicjalizacji. Należy usunąć klauzule zabezpieczające przed wartością null i w razie potrzeby zastąpić je standardową obsługą wyjątków. W rezultacie otrzymujemy bardziej przejrzystą stronę wywołania, pozbawioną błędu typu "język niedostępny w tle".