Azure'de OCR vs. IronOCR: Hangi Optik Karakter Tanıma Çözümü .NET Projeleri İçin En İyisidir?

WinRT Asenkron Yığını

Windows.Media.Ocr ile her temel OCR işlemi, tanıma başlamadan önce WinRT API yüzeyinin birden çok katmanında gezinmeyi gerektirir:

// 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 üzerinde null kontrolü isteğe bağlı değildir. Kodu çalıştıran makinede hedef dil paketi yüklü değilse, TryCreateFromLanguage null döndürüyor ve tanıma imkansız oluyor. Geri dönüş yoktur; uygulama kullanıcıya bir hata yüzeye çıkarmalı veya sessizce başarısız olmalıdır.

Ayrıntılı Özellik Karşılaştırması

Windows.Media.Ocr Yaklaşımı

WinRT bağımlılığı, tek bir kod satırı çalışmadan önce proje dosyasında belirir. TargetFramework bir Windows platformu versiyonunu belirtmelidir:

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

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

O TFM ile proje birLinuxkonteynerinden kullanılamaz. ASP.NET dağıtımları için standartLinuxtabanlı görüntüsü olan mcr.microsoft.com/dotnet/aspnet:8.0'a dayanan birDockergörüntüsü, WinRT çalışma zamanına sahip değildir. Windows.Media.Ocr türlerini, Windows eklemesi olmayan net8.0'i hedefleyen bir projede referans alma girişimi derleme hatalarına yol açar, çalışma zamanı hatalarına değil. Kilitlenme, derleme zamanında uygulanır.

OCR gereksinimleri, bir mikro hizmetler mimarisi içinde Linux'ta çalışan OCR çalışanı veya çapraz platformDockergörüntüleri üreten bir CI/CD hattı içinde ortaya çıktığında, Windows.Media.Ocr değerlendirilmesi bir seçenek değildir — ilk tepe öncesinde elenir.

IronOCR Yaklaşımı

IronOCR, platforma özgü TFMs olmadan net6.0, net7.0, net8.0 ve net9.0'yi hedef alır. Aynı NuGet paketi ve aynı uygulama ikili dosyası, Windows,Linuxve macOS'ta çalışır. IronOCR'yi Docker'a dağıtmak içinLinuxtabanlı bir görüntü üzerinde apt-get satırına ihtiyaç vardır, başka bir şeye değil:

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

Uygulama kodu, Windows veLinuxdağıtımları arasında değişmez:

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
//Hayırplatform 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
//Hayırplatform 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, Azure Functions on Linux üzerinde çalışır ve Linux sunucular direkt kod değişikliği olmadan. Dağıtım hedefi bir yapılandırma endişesidir, mimari bir kısıtlama değil.

Windows.Media.Ocr Yaklaşımı

İstenen dil yüklü değilse, OcrEngine.TryCreateFromLanguage null döndürür. Hiçbir OCR-destekli dil paketi yoksa, TryCreateFromUserProfileLanguages null döndürür. Her iki yolun da null işlemi gereklidir ve hiçbiri zarif bir kurtarma yolu sunmaz — koddan bir dil yüklemek veya uygulama ile birini paketlemek için bir yol yoktur:

// 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 ile çok dilli bir belge işleme uygulamasını dağıtmak, dağıtım hedefindeki her makine arasında Windows dil paketi kurulumunu koordine etmeyi gerektirir. Grup Politikası tarafından yönetilen bir paylaşılan sunucuda veya minimal OS ayak izine sahip bulut VM'lerinde bu, geliştiricinin kontrolünde değildir.

IronOCR Yaklaşımı

IronOCR, dil modellerini uygulama ikili dosyası ile birlikte dağıtılan özel NuGet paketleri olarak gönderir. Dil verileri, yapım eseri ile birlikte gider, OS yapılandırmasıyla değil. 125'ten fazla dil desteği bir dotnet add package işlemidir.

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)

tam dil kataloğu, Latin, CJK, Arapça, İbranice, Devanagari, Kiril alfabesi ve matematiksel notasyon dahil olmak üzere özel setleri kapsar. Her dil paketi,IronOCR paketi sürümüyle sabitlenir, böylece üretim üzerindeki dil modeli, yerel olarak test edilen modelle eşleşir.

Windows.Media.Ocr Yaklaşımı

API bir SoftwareBitmap kabul eder ve metin döndürür. Bu iki nokta arasında görüntü kalitesiyle ne olduğu yapılandırılamaz. Sub-optimal girdide doğruluğu artırması gereken geliştiriciler, SoftwareBitmap'i oluşturmadan önce, Windows Imaging Component API'larını kullanarak elle ön işleme uygulamalıdır. Bu, kendi bakım yüküne sahip ayrı bir kod tabanıdır ve OCR API'sinin kendisinin aynı nedeni için Windows'a özgü olarak kalır:

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

Standart, temiz belge taramaları için (kontrollü tarama ortamı, tutarlı aydınlatma, minimum 300 DPI, doğru yönlendirme), bu sınırlama yönetilebilir. Mobil telefon kameralarından, otomatik besleme yanlış hizalı flatbed tarayıcılardan, fakslanmış belgelerden veya fotokopi materyallerinden görüntüler alan belge işleme hatları için, bu ya sıfırdan bir ön işleme tabakası oluşturmayı ya da doğruluk bozulmasını kabul etmeyi ifade eder.

IronOCR Yaklaşımı

IronOCR'nin OcrInput sınıfı, sırayla uygulanan bireysel filtre yöntemleri içeren bir ön işleme hattı sağlar. Görüntü kalitesi düzeltme filtreleri, üretim belge işleme sırasında en yaygın doğruluk problemlerini ele alır:

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

Yaygın durumlar için,IronOCR doğrudan bir dosya yolu üzerinde Read çağrıldığında otomatik ön işleme uygular — motor kalite sorunlarını algılar ve açık filtre yapılandırması olmadan bunları düzeltir. Görüntü filtreleri öğreticisi tüm filtre setini kapsar ve Sharpen, Dilate, Erode, Invert ve özelleşmiş senaryolar için ToGrayScale içerir. Renk düzeltme filtreleri ve döndürme düzeltmesi, standart olmayan renk profilleri veya çok açılı döndürme olan belgeler için hattı daha da genişletir.

Windows.Media.Ocr Yaklaşımı

API içerisinde bir PDF yolu yoktur. Windows.Media.Ocr ile taranmış bir PDF'yi OCR ile işlemek için, geliştirici her sayfayı ayrı bir PDF işleme kütüphanesi (Windows'un içine dahil olmayan bir kütüphane) kullanarak bir SoftwareBitmap'ye işlemek, sayfalarda döngü yapmak, her sayfa için RecognizeAsync çağrısı yapmak ve sonuçları elle birleştirmek zorundadır. O işleme kütüphanesinin kendisi, ek lisanslama ve dağıtım hususları taşır. Windows.Media.Ocr kodu, toplam uygulamanın daha küçük bir parçasıdır:

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

Dış PDF işleme adımı, 'ücretsiz ve yerleşik' bir çözüm olarak başlayan bir çözüm için bağımlılık, ayrı bir öğrenme eğrisi ve ek bir hata yüzeyini tek başına ekler.

IronOCR Yaklaşımı

IronOCR, PDF'leri yerel olarak okur. Dış işleyici yok, rasterizasyon adımı yok, elle sayfa birleştirme yok. Aynı IronTesseract.Read yöntemi, görüntü yollarını kabul ettiği gibi PDF yollarını da kabul eder. .NET'te PDF OCR, tek bir satırdır:

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

// Aranabilir PDFoutput: 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);

// Aranabilir PDFoutput: 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

' Aranabilir PDFoutput: make a scanned PDF text-searchable
Dim ocrResult = New IronTesseract().Read("scanned-archive.pdf")
ocrResult.SaveAsSearchablePdf("searchable-output.pdf")

Aranabilir PDF özelliği, orijinal taranan görüntünün üzerine bir metin katmanı yerleştirerek, görsel sadakati korurken tam metin arama ve kopyala-yapıştır imkanı sağlayan bir PDF üretir. Bu, belge yönetim sistemleri ve uyumlu arşivler için yaygın bir gerekliliktir. Windows.Media.Ocr, API katmanının herhangi birinde bu çıktıyı üretemez.

Uygulama Windows Masaüstünü Aşıyor

En yaygın tetikleyici, bir Windows olmayan dağıtım hedefi getiren bir gereksinim değişikliğidir. Bir iç Windows aracı olarak hayatına başlayan bir masaüstü yardımcı programı, bir web hizmetine,Dockertabanlı bir mikro hizmetine veya bir bulut işlevine terfi eder. Bu gerçekleştiği an, Windows.Media.Ocr bir engelleyici haline gelir. OCR bileşeni, hedef platformda var olmadığından, tamamen yeniden yazılması gerektirir — bir aktarım yok, bir uyumlaştırma katmanı yok ve sorunu gideren bir koşullu derleme bayrağı yoktur.IronOCR ile önceden planlayan ekipler bu yeniden yazım ile karşılaşmaz.

Dil Gereksinimleri Yüklenen Paketleri Aşıyor

Belge işleme hatları genellikle kapsamını genişletir. İngilizce faturaları işlemek için inşa edilmiş bir sistem, Fransızca, Almanca, Arapça veya Japonca belgeleri işleme gereklilik alır. Windows.Media.Ocr ile bu dilleri desteklemek, her dağıtım hedefinin OS dil paketi kurulumunu koordine etmeyi gerektirir — geliştirici makineleri, test VM'leri, üretim sunucuları ve karışık ordular. Grup Politikası tarafından yönetilen ortamlarda veya minimal OS izine sahip bulut VM'lerinde bu koordinasyon uygulanabilir değildir. IronOCR'nin NuGet tabanlı dil paketleri, uygulama ile birlikte dağıtılır ve herhangi bir OS koordinasyonu gerektirmez.

PDF İşlem Eyhatları Kapsama Alınıyor

Orijinal gereklilik 'düz yatak tarayıcıdan görüntüleri OCR yapmak' olduğunda, Windows.Media.Ocr çalışır. Gereklilik 'arşivimizdeki taranmış PDF'lerin geçmişini de işleyin' olarak genişlediğinde, ikinci bir kütüphane yığına gelir. O kütüphane ek bir bağımlılıktır, ek bir lisanslama hususu ve ek bir hata yüzeyidir. Hem görüntü OCR hem de PDF OCR ihtiyacı olan takımlar, en başından iki kütüphaneli mimariyi ortadan kaldıran IronOCR'yi buluyor.

Gerçek Dünya Girdisinde Doğruluk Azalıyor

Kontrollü tarama ortamları temiz görüntüler üretir. Gerçek dünya girdisi — mobil telefonlarla çekilmiş fotoğraflar, hafif eğik düz yatak taranması, daha eski fakslanmış belgeler, fotokopiler — Windows.Media.Ocr'nin içinde çözüm olmayan doğruluk azaltımı üretir. Kaçırılan metinle ilgili müşteri şikayetleri geldiğinde, ekipler, atladıkları ön işleme adımının artık gerekli olduğunu keşfederler. Windows Imaging API'lerini kullanarak retrofitting hazırlık, çözümü Windows'a özgü tutan önemli bir geliştirme çabasıdır. IronOCR'nin ön işleme hattı zaten oradadır.

Sunucu Dağıtım Sorusu Ortaya Çıkıyor

Windows.Media.Ocr belgeleri API'yi istemci uygulamaları için açıkça yerleştirir. Bir sunucu bağlamında çalıştırmak — bir kullanıcının yüklediği belgeleri işleyen bir ASP.NET uygulaması, bir belge kuyruğunu tüketen bir Windows Hizmeti — Masaüstü Deneyimi yüklü birWindows Serverortamı gerektirir, bu da birLinuxkonteynerine göre daha ağır ve daha pahalı bir VM profili. Altyapı ekibi, OCR işçisinin ana maliyetini azaltmak için birLinuxörneğinde çalışabilirse diye sorduğunda, Windows.Media.Ocr ile cevap hayırdır.

Proje Dosyası TFM Değişikliği

Windows.Media.Ocr, proje dosyasında (net8.0-windows10.0.19041.0 veya benzeri) Windows'a özgü bir TFM gerektirir. Çapraz platform hedeflerini desteklemek için bu bağımlılığı kaldırmak, TFM ekini kaldırmayı gerektirir. IronOCR, Windows'a özgü ekler olmadan net6.0, net8.0 ve net9.0'yi hedef alır. Taşınırken, projedeki başka bir WinRT API bağımlılığının Windows TFM'ye gereksinim duymadığını ve diğer Windows platform özelliklerinin (kabuk entegrasyonu, Windows bildirimleri vb.) platform kontrolörlerine arkasından soyutlanması gerektiğini doğrulayın.

İsenkronize'den Senkronize Göç

Windows.Media.Ocr tamamen asenkron — RecognizeAsync, WinRT ara yüzü aracılığıyla Task<OcrResult> ile eşleşen IAsyncOperation<OcrResult> döndürür.IronOCR hem senkron hem de asenkron yollar sağlar. Senkron ocr.Read("file.jpg") doğrudan çok adımlı await zincirini değiştirir. Arka plan hizmeti veya Görev tabanlı bir hattan içinde OCR çağrısının oturduğu sunucu uygulamaları için, asenkron yol da mevcuttur. Her iki şekilde de, 6+ asenkron adımdan 1 çağrıya geçiş basitse:

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

Dil Paketi İkamesi

Daha önce OcrEngine.TryCreateFromLanguage(new Windows.Globalization.Language("fr-FR")) üzerinden çözülmüş olan her dil için, ilgili IronOCR dil paketini yükleyin ve ocr.Language = OcrLanguage.French ayarlayın. IronOCR dil kataloğu, mevcut 125+ paketleri listeler. Dil kodları, BCP-47 etiketlerinden OcrLanguage enumuna doğrudan eşlemektedir.

Null Motor İşleme Çıkarma

Windows.Media.Ocr, her motor oluşturma çağrısını null kontrol etmeyi gerektirir. IronOCR, yapılandırma veya başlatma hatalarında null döndürmek yerine yapılandırılmış istisnalar oluşturur. Null kontrolü koruma deyimlerini kaldırın ve gerekli yerlerde standart istisna işleme ile değiştirin. Sonuç, "sessizce kullanılabilir olmayan dil" hata modu olmayan daha temiz bir çağrı noktasıdır.