IronOCR vs AWS Textract: Girişimler İçin OCR Çözümleri

Resim Kimliği Yaşam Döngüsü

GdPicture'ın tanımlayıcı mimari özelliği tamsayı resim kimliği yönetimidir. Herhangi bir görüntünün yüklenmesi, GdPicture çalışma zamanında bellek tahsis eder ve bir int tutamacı döndürür. Bu tamsayıyı, sonraki tüm çağrılarda referans olarak kullanırsınız. İşiniz bittiğinde, o tamsayı ile ReleaseGdPictureImage çağırırsınız. Eğer yapmazsanız, süreç bitene kadar bellek serbest bırakılmaz.

using GdPicture14;

// Every image load returns an integer handle
int imageId = _imaging.CreateGdPictureImageFromFile(imagePath);

if (imageId == 0)
{
    throw new Exception($"Failed to load image: {_imaging.GetStat()}");
}

try
{
    _ocr.SetImage(imageId);
    _ocr.Language = "eng";

    string resultId = _ocr.RunOCR();

    if (string.IsNullOrEmpty(resultId))
    {
        throw new Exception($"OCR failed: {_ocr.GetStat()}");
    }

    return _ocr.GetOCRResultText(resultId);
}
finally
{
    // CRITICAL: omitting this line causes a memory leak
    _imaging.ReleaseGdPictureImage(imageId);
}

using GdPicture14;

// Every image load returns an integer handle
int imageId = _imaging.CreateGdPictureImageFromFile(imagePath);

if (imageId == 0)
{
    throw new Exception($"Failed to load image: {_imaging.GetStat()}");
}

try
{
    _ocr.SetImage(imageId);
    _ocr.Language = "eng";

    string resultId = _ocr.RunOCR();

    if (string.IsNullOrEmpty(resultId))
    {
        throw new Exception($"OCR failed: {_ocr.GetStat()}");
    }

    return _ocr.GetOCRResultText(resultId);
}
finally
{
    // CRITICAL: omitting this line causes a memory leak
    _imaging.ReleaseGdPictureImage(imageId);
}

Imports GdPicture14

' Every image load returns an integer handle
Dim imageId As Integer = _imaging.CreateGdPictureImageFromFile(imagePath)

If imageId = 0 Then
    Throw New Exception($"Failed to load image: {_imaging.GetStat()}")
End If

Try
    _ocr.SetImage(imageId)
    _ocr.Language = "eng"

    Dim resultId As String = _ocr.RunOCR()

    If String.IsNullOrEmpty(resultId) Then
        Throw New Exception($"OCR failed: {_ocr.GetStat()}")
    End If

    Return _ocr.GetOCRResultText(resultId)
Finally
    ' CRITICAL: omitting this line causes a memory leak
    _imaging.ReleaseGdPictureImage(imageId)
End Try

Çok sayfalı PDF'leri işlerken, her işlenmiş sayfa ayrı bir resim kimliği üretir. 200 DPI'da 100 sayfalık bir belge, temizlik eksik kalırsa 1–5 GB bellek tahsis edebilir. Doğru desen, tüm ID'leri toplayıp bir finally blokta serbest bırakmayı gerektirir — ancak bu disiplin tamamen geliştiricinin sorumluluğundadır.

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

GdPicture Yaklaşımı

GdPicture içindeki her görüntü, çalışma zamanı tarafından yönetilen bir havuzda, tamsayı bir tanıtıcı olarak mevcuttur. Tanıtıcıyı bir görüntüyü yükleyerek edinir, o tam sayı ile OCR ve diğer işlemleri yapar, ardından işiniz bittiğinde bırakırsınız. Desen doğru ve açık şekilde izlendiğinde doğrudur. Sorun, hata yapmanın kolay olmasıdır ve sonucu sınırsız bellek büyümesidir.

PDF OCR iş akışı, riski en açık şekilde gösterir. pdf.RenderPageToGdPictureImage() çağrısının her biri bellekte yeni bir raster görüntü tahsis eder ve yeni bir tamsayı ID'si döndürür. 100 sayfalık bir belge, 100 ayrı tahsis yaratır. Bir ReleaseGdPictureImage çağrısını kaçırın ve süreç biriken sızan bellek ile sonuçlanır:

using GdPicture14;

public string ExtractTextFromPdf(string pdfPath)
{
    var text = new StringBuilder();

    using var pdf = new GdPicturePDF();

    GdPictureStatus status = pdf.LoadFromFile(pdfPath, false);
    if (status != GdPictureStatus.OK)
        throw new Exception($"Failed to load PDF: {status}");

    int pageCount = pdf.GetPageCount();

    for (int i = 1; i <= pageCount; i++)
    {
        pdf.SelectPage(i);

        // Each page render = new memory allocation + new integer ID
        int imageId = pdf.RenderPageToGdPictureImage(200, false);

        if (imageId == 0) continue;

        try
        {
            _ocr.SetImage(imageId);
            _ocr.Language = "eng";
            string resultId = _ocr.RunOCR();

            if (!string.IsNullOrEmpty(resultId))
                text.AppendLine(_ocr.GetOCRResultText(resultId));
        }
        finally
        {
            // Without this: ~10–50MB leaked per page
            _imaging.ReleaseGdPictureImage(imageId);
        }
    }

    return text.ToString();
}

using GdPicture14;

public string ExtractTextFromPdf(string pdfPath)
{
    var text = new StringBuilder();

    using var pdf = new GdPicturePDF();

    GdPictureStatus status = pdf.LoadFromFile(pdfPath, false);
    if (status != GdPictureStatus.OK)
        throw new Exception($"Failed to load PDF: {status}");

    int pageCount = pdf.GetPageCount();

    for (int i = 1; i <= pageCount; i++)
    {
        pdf.SelectPage(i);

        // Each page render = new memory allocation + new integer ID
        int imageId = pdf.RenderPageToGdPictureImage(200, false);

        if (imageId == 0) continue;

        try
        {
            _ocr.SetImage(imageId);
            _ocr.Language = "eng";
            string resultId = _ocr.RunOCR();

            if (!string.IsNullOrEmpty(resultId))
                text.AppendLine(_ocr.GetOCRResultText(resultId));
        }
        finally
        {
            // Without this: ~10–50MB leaked per page
            _imaging.ReleaseGdPictureImage(imageId);
        }
    }

    return text.ToString();
}

Imports GdPicture14
Imports System.Text

Public Function ExtractTextFromPdf(ByVal pdfPath As String) As String
    Dim text As New StringBuilder()

    Using pdf As New GdPicturePDF()
        Dim status As GdPictureStatus = pdf.LoadFromFile(pdfPath, False)
        If status <> GdPictureStatus.OK Then
            Throw New Exception($"Failed to load PDF: {status}")
        End If

        Dim pageCount As Integer = pdf.GetPageCount()

        For i As Integer = 1 To pageCount
            pdf.SelectPage(i)

            ' Each page render = new memory allocation + new integer ID
            Dim imageId As Integer = pdf.RenderPageToGdPictureImage(200, False)

            If imageId = 0 Then Continue For

            Try
                _ocr.SetImage(imageId)
                _ocr.Language = "eng"
                Dim resultId As String = _ocr.RunOCR()

                If Not String.IsNullOrEmpty(resultId) Then
                    text.AppendLine(_ocr.GetOCRResultText(resultId))
                End If
            Finally
                ' Without this: ~10–50MB leaked per page
                _imaging.ReleaseGdPictureImage(imageId)
            End Try
        Next
    End Using

    Return text.ToString()
End Function

Birden çok PDF üzerinde toplu işleme bu durumu daha da artırır. Her for döngüsünün belgeleri, bakıcıları bir List<int> içinde ID'leri toplamaya ve hepsini finally içinde serbest bırakmaya teşvik eden bir not taşımalıdır. Bu, altyapı işi, OCR işi değil.

IronOCR Yaklaşımı

OcrInput standart bir IDisposable'dir. Bir using ifadesi, yöntem normalde döner veya hata fırlatırsa temizliği garanti eder. Takip edilecek tam sayı ID'leri, başlatılacak ayrı bir görüntüleme bileşeni ve PDF sayfaları için harici DPI işleme adımı yoktur.

using IronOcr;

public string ExtractTextFromPdf(string pdfPath)
{
    // LoadPdf handles page rendering internally
    using var input = new OcrInput();
    input.LoadPdf(pdfPath);

    var result = new IronTesseract().Read(input);

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

    return result.Text;
    // using block exits — all internal resources released automatically
}

using IronOcr;

public string ExtractTextFromPdf(string pdfPath)
{
    // LoadPdf handles page rendering internally
    using var input = new OcrInput();
    input.LoadPdf(pdfPath);

    var result = new IronTesseract().Read(input);

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

    return result.Text;
    // using block exits — all internal resources released automatically
}

Imports IronOcr

Public Function ExtractTextFromPdf(pdfPath As String) As String
    ' LoadPdf handles page rendering internally
    Using input As New OcrInput()
        input.LoadPdf(pdfPath)

        Dim result = New IronTesseract().Read(input)

        For Each page In result.Pages
            Console.WriteLine($"Page {page.PageNumber}: {page.Text}")
        Next

        Return result.Text
        ' using block exits — all internal resources released automatically
    End Using
End Function

Parola korumalı PDF'ler için, parametre, ek durum kontrolü gerektiren ayrı bir aşırı yükleme yerine bir adlandırılmış argümandır:

using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");

var result = new IronTesseract().Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");

var result = new IronTesseract().Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")

    Dim result = New IronTesseract().Read(input)
    result.SaveAsSearchablePdf("searchable-output.pdf")
End Using

IronOCR PDF giriş rehberi, sayfa aralığı seçimi dahil ek seçenekleri kapsar. Entity Framework, HttpClient ve akış işlemleri boyunca IDisposable desenlerine aşina olan ekipler için, OcrInput yeni bir zihinsel model gerektirmez.

GdPicture Yaklaşımı

Düşük kaliteli taranmış bir PDF'nin tam iş akışı — yükleme, ön işleme, her sayfada OCR yapma, serbest bırakma — üç bileşen sınıfını kapsar ve her adımda dikkatli bir durum kontrolü gerektirir:

using GdPicture14;

public void CreateSearchablePdf(string inputPdf, string outputPdf)
{
    using var pdf = new GdPicturePDF();

    GdPictureStatus status = pdf.LoadFromFile(inputPdf, false);
    if (status != GdPictureStatus.OK)
        throw new Exception($"Load failed: {status}");

    int pageCount = pdf.GetPageCount();

    for (int i = 1; i <= pageCount; i++)
    {
        pdf.SelectPage(i);

        // OcrPage adds text layer to each page
        // Requires: OCR plugin + PDF plugin + resource folder path
        GdPictureStatus ocrStatus = pdf.OcrPage(
            "eng",
            @"C:\GdPicture\Resources\OCR",  //Harici kaynak klasörürequired
            "",
            200
        );

        if (ocrStatus != GdPictureStatus.OK)
            Console.WriteLine($"Warning: Page {i} OCR failed: {ocrStatus}");
    }

    pdf.SaveToFile(outputPdf, true);
}

using GdPicture14;

public void CreateSearchablePdf(string inputPdf, string outputPdf)
{
    using var pdf = new GdPicturePDF();

    GdPictureStatus status = pdf.LoadFromFile(inputPdf, false);
    if (status != GdPictureStatus.OK)
        throw new Exception($"Load failed: {status}");

    int pageCount = pdf.GetPageCount();

    for (int i = 1; i <= pageCount; i++)
    {
        pdf.SelectPage(i);

        // OcrPage adds text layer to each page
        // Requires: OCR plugin + PDF plugin + resource folder path
        GdPictureStatus ocrStatus = pdf.OcrPage(
            "eng",
            @"C:\GdPicture\Resources\OCR",  //Harici kaynak klasörürequired
            "",
            200
        );

        if (ocrStatus != GdPictureStatus.OK)
            Console.WriteLine($"Warning: Page {i} OCR failed: {ocrStatus}");
    }

    pdf.SaveToFile(outputPdf, true);
}

Imports GdPicture14

Public Sub CreateSearchablePdf(inputPdf As String, outputPdf As String)
    Using pdf As New GdPicturePDF()

        Dim status As GdPictureStatus = pdf.LoadFromFile(inputPdf, False)
        If status <> GdPictureStatus.OK Then
            Throw New Exception($"Load failed: {status}")
        End If

        Dim pageCount As Integer = pdf.GetPageCount()

        For i As Integer = 1 To pageCount
            pdf.SelectPage(i)

            ' OcrPage adds text layer to each page
            ' Requires: OCR plugin + PDF plugin + resource folder path
            Dim ocrStatus As GdPictureStatus = pdf.OcrPage(
                "eng",
                "C:\GdPicture\Resources\OCR",  ' Harici kaynak klasörü required
                "",
                200
            )

            If ocrStatus <> GdPictureStatus.OK Then
                Console.WriteLine($"Warning: Page {i} OCR failed: {ocrStatus}")
            End If
        Next

        pdf.SaveToFile(outputPdf, True)
    End Using
End Sub

ResourceFolder yolu isteğe bağlı değildir. Bu yol, çalışma zamanında .traineddata dil dosyalarını içeren bir dizine çözümlenmelidir. Bu yol geliştirme makinesinde çalışır, ardından hizmet hesabı C:\GdPicture\Resources\OCR göremediğinde veya uygulama Linux'a dağıtıldığında veyaDockergörüntüleri bu dizin yapısını içermediğinde üretimde çalışmaz. Bu hataların hata ayıklaması, genellikle kök sebep hakkında çok az şey söyleyen genel GdPictureStatus hata kodlarını takip etmek anlamına gelir.

IronOCR Yaklaşımı

IronOCR'deki eşdeğer iş akışı — eğim düzeltme ve gürültü giderme için ön işlem dahil — beş satırdır:

using IronOcr;

public void CreateSearchablePdf(string inputPdf, string outputPdf)
{
    var ocr = new IronTesseract();

    using var input = new OcrInput();
    input.LoadPdf(inputPdf);
    input.Deskew();   //Hayırseparate plugin required
    input.DeNoise();

    var result = ocr.Read(input);
    result.SaveAsSearchablePdf(outputPdf);
}

using IronOcr;

public void CreateSearchablePdf(string inputPdf, string outputPdf)
{
    var ocr = new IronTesseract();

    using var input = new OcrInput();
    input.LoadPdf(inputPdf);
    input.Deskew();   //Hayırseparate plugin required
    input.DeNoise();

    var result = ocr.Read(input);
    result.SaveAsSearchablePdf(outputPdf);
}

Imports IronOcr

Public Sub CreateSearchablePdf(inputPdf As String, outputPdf As String)
    Dim ocr As New IronTesseract()

    Using input As New OcrInput()
        input.LoadPdf(inputPdf)
        input.Deskew() 'Hayırseparate plugin required
        input.DeNoise()

        Dim result = ocr.Read(input)
        result.SaveAsSearchablePdf(outputPdf)
    End Using
End Sub

İngilizce dil desteği NuGet paketine gömülüdür. Ek diller, bir dosya sistemi yolundaki .traineddata dosyaları yerine NuGet paketleri (IronOcr.Languages.French) olarak yüklenir. Görüntü kalitesi düzeltme kılavuzu ve görüntü yönlendirme düzeltme kılavuzu OcrInput üzerinde mevcut olan tüm ön işleme seçeneklerini kapsar.

Güven farkındalığına sahip işleme için — örneğin bir veritabanına yazmadan önce bir eşik altındaki sonuçları filtreleme — sonuç nesnesi güveni doğrudan açığa çıkarır:

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

// Per-word confidence for fine-grained filtering
var highConfidenceWords = result.Words
    .Where(w => w.Confidence > 85)
    .Select(w => w.Text);

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

// Per-word confidence for fine-grained filtering
var highConfidenceWords = result.Words
    .Where(w => w.Confidence > 85)
    .Select(w => w.Text);

Imports System
Imports System.Linq

Dim result = (New IronTesseract()).Read("scanned.jpg")
Console.WriteLine($"Confidence: {result.Confidence}%")

' Per-word confidence for fine-grained filtering
Dim highConfidenceWords = result.Words _
    .Where(Function(w) w.Confidence > 85) _
    .Select(Function(w) w.Text)

GdPicture aynı verilere ulaşmak için üç iç içe döngü — bloklar, satırlar, kelimeler — gerektirir ve her seviyede indeks tabanlı yöntem çağrıları (GetOCRResultBlockLineWordConfidence(resultId, b, l, w)) kullanılır. güven puanları nasıl yapılır yaygın kullanım senaryoları için yapılandırılmış erişim modelini gösterir.

GdPicture Yaklaşımı

GdPicture, resultId dizgesini RunOCR()'den döndürür ve tüm sonuç verileri o ID üzerinden GdPictureOCR örneği üzerindeki yöntem çağrıları aracılığıyla sorgulanır. Kelime başına güvene ulaşmak, üç iç içe seviyeyi yinelemeyi gerektirir:

using GdPicture14;

public List<(string word, float confidence)> GetWordConfidences(int imageId)
{
    var words = new List<(string, float)>();

    _ocr.SetImage(imageId);
    _ocr.Language = "eng";
    string resultId = _ocr.RunOCR();

    int blockCount = _ocr.GetOCRResultBlockCount(resultId);

    for (int b = 0; b < blockCount; b++)
    {
        int lineCount = _ocr.GetOCRResultBlockLineCount(resultId, b);

        for (int l = 0; l < lineCount; l++)
        {
            int wordCount = _ocr.GetOCRResultBlockLineWordCount(resultId, b, l);

            for (int w = 0; w < wordCount; w++)
            {
                string word = _ocr.GetOCRResultBlockLineWordText(resultId, b, l, w);
                float conf = _ocr.GetOCRResultBlockLineWordConfidence(resultId, b, l, w);
                words.Add((word, conf));
            }
        }
    }

    return words;
}

using GdPicture14;

public List<(string word, float confidence)> GetWordConfidences(int imageId)
{
    var words = new List<(string, float)>();

    _ocr.SetImage(imageId);
    _ocr.Language = "eng";
    string resultId = _ocr.RunOCR();

    int blockCount = _ocr.GetOCRResultBlockCount(resultId);

    for (int b = 0; b < blockCount; b++)
    {
        int lineCount = _ocr.GetOCRResultBlockLineCount(resultId, b);

        for (int l = 0; l < lineCount; l++)
        {
            int wordCount = _ocr.GetOCRResultBlockLineWordCount(resultId, b, l);

            for (int w = 0; w < wordCount; w++)
            {
                string word = _ocr.GetOCRResultBlockLineWordText(resultId, b, l, w);
                float conf = _ocr.GetOCRResultBlockLineWordConfidence(resultId, b, l, w);
                words.Add((word, conf));
            }
        }
    }

    return words;
}

Imports GdPicture14

Public Function GetWordConfidences(imageId As Integer) As List(Of (word As String, confidence As Single))
    Dim words As New List(Of (String, Single))()

    _ocr.SetImage(imageId)
    _ocr.Language = "eng"
    Dim resultId As String = _ocr.RunOCR()

    Dim blockCount As Integer = _ocr.GetOCRResultBlockCount(resultId)

    For b As Integer = 0 To blockCount - 1
        Dim lineCount As Integer = _ocr.GetOCRResultBlockLineCount(resultId, b)

        For l As Integer = 0 To lineCount - 1
            Dim wordCount As Integer = _ocr.GetOCRResultBlockLineWordCount(resultId, b, l)

            For w As Integer = 0 To wordCount - 1
                Dim word As String = _ocr.GetOCRResultBlockLineWordText(resultId, b, l, w)
                Dim conf As Single = _ocr.GetOCRResultBlockLineWordConfidence(resultId, b, l, w)
                words.Add((word, conf))
            Next
        Next
    Next

    Return words
End Function

Bu yanlış değil — veri erişilebilir. Ancak, kelime düzeyinde verilere ihtiyaç duyan her proje için sonuç yapısına üç boyutlu bir indeks yerleştirmeyi anlamayı ve sürdürmeyi gerektirir.

IronOCR Yaklaşımı

OcrResult, .Words'u yazılmış bir koleksiyon olarak sunar. LINQ, doğrudan ona karşı çalışır:

using IronOcr;

var result = new IronTesseract().Read("invoice.jpg");

// All words with position and confidence
foreach (var word in result.Words)
{
    Console.WriteLine($"'{word.Text}' at ({word.X},{word.Y}) — {word.Confidence:P0}");
}

// Lines, paragraphs, and pages follow the same pattern
foreach (var line in result.Lines)
    Console.WriteLine(line.Text);

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

using IronOcr;

var result = new IronTesseract().Read("invoice.jpg");

// All words with position and confidence
foreach (var word in result.Words)
{
    Console.WriteLine($"'{word.Text}' at ({word.X},{word.Y}) — {word.Confidence:P0}");
}

// Lines, paragraphs, and pages follow the same pattern
foreach (var line in result.Lines)
    Console.WriteLine(line.Text);

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

Imports IronOcr

Dim result = New IronTesseract().Read("invoice.jpg")

' All words with position and confidence
For Each word In result.Words
    Console.WriteLine($"'{word.Text}' at ({word.X},{word.Y}) — {word.Confidence:P0}")
Next

' Lines, paragraphs, and pages follow the same pattern
For Each line In result.Lines
    Console.WriteLine(line.Text)
Next

For Each page In result.Pages
    Console.WriteLine($"Page {page.PageNumber}: {page.Text.Length} characters")
Next

Bölge tabanlı OCR — bir belgenin tanımlanmış bir dikdörtgeninden metin çıkarımı — benzer şekilde doğrudandır:

var region = new CropRectangle(0, 0, 600, 100); // header area

using var input = new OcrInput();
input.LoadImage("invoice.jpg", region);

var headerText = new IronTesseract().Read(input).Text;

var region = new CropRectangle(0, 0, 600, 100); // header area

using var input = new OcrInput();
input.LoadImage("invoice.jpg", region);

var headerText = new IronTesseract().Read(input).Text;

Imports IronOcr

Dim region As New CropRectangle(0, 0, 600, 100) ' header area

Using input As New OcrInput()
    input.LoadImage("invoice.jpg", region)

    Dim headerText As String = New IronTesseract().Read(input).Text
End Using

sonuçları okuma rehberi ve bir görüntünün bölgesel OCR rehberi, bu desenlerin çok sayfalı belgelere ve yapılandırılmış alan çıkarımı iş akışlarına nasıl genişletildiğini gösterir.

Tek Gereklilik OCR

Belgeleri alma hatları kuran ekipler — taranmış faturaları, tıbbi formları işleyen, sözleşme metnini çıkaran — genellikle GdPicture'i LEADTOOLS ve Kofax yanında kurumsal yazılım dizinlerinde göründüğü için değerlendirirler. Eklenti bağımlılık tablosu netleştiğinde, resim değişir. PDF Giriş gerekiyorsa PDF Eklentisi isteğe bağlı değildir. Ön işleme gerekiyorsa Belge Görüntüleme Eklentisi isteğe bağlı değildir.Hizalamadüzeltmesi ile taranmış PDF'lerden OCR yapması gereken bir ekip, önemli Profesyonel giriş maliyeti ile üç eklenti lisansı ile sonuçlanır. Gereksinim metin çıkarımı olduğunda ve GdPicture özellik listesinde bunun ötesinde hiçbir şey gerekmediğinde, bu fiyatlandırma saf bir üstlenilen yükü temsil eder.IronOCR$2,999 Professional, aynı iş akışını kapsar — görüntü girişi, PDF girişi, ön işleme, aranabilir PDF çıktısı — tek bir paketten, karar almanız gereken eklentisiz.

Üretimde Bellek Sızıntısı Olayları

Tam sayı ID yaşam döngüsü, yüksek verimli belge işleme hizmetlerinde bir üretim olayı olmaya hazır. Yük altında yüklenmiş PDF'leri işleyen bir web API uç noktası, görüntü serbest bırakma çağrısının ulaşılmadığı bir kod yolu olacaktır — bir hata dalında erken dönüş, temizlik bloğundan önce gönderilmemiş bir istisna veya sadece desene aşina olmayan yeni bir geliştirici, bir tam sayı görüntü tanıtıcısını parametre olarak alan ve serbest bırakmayı unutan bir yardımcı yöntem ekler. Bellek artar, hizmet yavaşlar ve kök sebep yığın dökümünde belirgin değildir. Bu olaylardan birini çözen ekipler, çalışma zamanının temizlik işlemelerini yönettiği bir model isteyebilir. IronOCR'de, standart eşya bırakma deseni, her çağrı noktasında geliştirici disiplini yerine derleyici tarafından uygulanan yapısal temizliktir.

Sürüm Yükseltme Sürtüşmesi

GdPicture, ana sürüm numarasını ad alanında gömülü tutar. 14. versiyondan 15. versiyona bir yükseltme, GdPicture sınıflarına referans yapan her kaynak dosyasında o ad alanı direktifini güncellemeyi gerektirir. OCR, PDF işleme ve görüntü işleme, düzinelerce hizmet ve yardımcı sınıfta yayılmış büyük bir uygulamada, bu azımsanmayacak bir göç görevidir — ve işlevsel fayda sağlamaz. Microsoft.EntityFrameworkCore'dan Newtonsoft.Json'a kadar her modern .NET kütüphanesi, versiyon duyarsız ad alanları kullanır ve sürüm yönetimini NuGet paket sürüm numarasına göre yönetir.IronOCR bu geleneği takip eder: aynı ad alanı ithalatı versiyon 1'den güncel sürüme kadar geçerlidir.

Mikro hizmet ve Konteyner Dağıtımı

GdPicture OCR, belirli bir yolun çalışma zamanında mevcut olan dil veri dosyalarını içeren harici bir kaynak klasörü gerektirir. Konteynere bağımlı bir dağıtımda, bu, o dosyalarıDockergörüntüsüne gömmek, bir hacmi montajlamak veya onları indiren bir başlangıç ​​betiği yapılandırmak anlamına gelir. Tipik sonuç, gerekli olmayan birkaç yüz megabayt daha büyük birDockergörüntüsü, gözden kaçırılan bir dağıtım kontrol listesi maddesi ve hacim monte edilmediğinde temiz konteyner yeniden başlatmalarda üretim hatalarıdır. IronOCR, İngilizce desteğini paketin içine paketler; ek diller, derleme çıktısının bir parçası olan NuGet paketleri olarak kurulur. Konteyner, ihtiyaç duyulanları geri yükleme adımından alır ve yapılandırılacak yollar yoktur. Docker dağıtım rehberi ve Linux dağıtım rehberi, her hedef ortam için özel yapılandırmayı kapsar.

Belge Görüntüleme Uzmanlığı Olmayan Geliştirme Ekipleri

GdPicture'nin yüzey alanı, bir zorunluluk olarak büyüktür — tam bir belge görüntüleme platformunu kaplar. OCR mikservisini sürdürmek için bir ekibe katılan bir geliştirici için, görüntüleme bileşenini, OCR bileşenini, PDF bileşenini, tam sayı ID yaşam döngüsünü, durum dönüş kodu işlemeyi ve kaynak klasör konfigürasyonunu anlamak, başlangıçta zorlayıcı bir yatırımdır. IronOCR'nin OCR için yüzey alanı üç sınıftır: motor, giriş kabı ve sonuç nesnesi. Bu, kullanım durumlarının %90'ı için tüm zihinsel modeldir. Yeni bir geliştiriciyi işe almak, onları IronTesseract ayarlama'ya yönlendirmek, çok modüllü bir SDK rehberine değil.

Bileşen Başlatmayı Değiştirme

GdPicture, dört adımlı bir başlatma dizisi gerektirir: LicenseManager üzerinden lisans anahtarını kaydedin, GdPictureImaging başlatın, GdPictureOCR başlatın ve kaynak klasör yolunu ayarlayın.IronOCR bunu, Program.cs veya Startup.cs ait tek bir özellik atamasına indirir:

// Remove
LicenseManager lm = new LicenseManager();
lm.RegisterKEY("GDPICTURE-LICENSE-KEY");
_imaging = new GdPictureImaging();
_ocr = new GdPictureOCR();
_ocr.ResourceFolder = @"C:\GdPicture\Resources\OCR";

// Replace with
IronOcr.License.LicenseKey = "IRONOCR-LICENSE-KEY";
// IronTesseract instances are instantiated per-use or as a singleton

// Remove
LicenseManager lm = new LicenseManager();
lm.RegisterKEY("GDPICTURE-LICENSE-KEY");
_imaging = new GdPictureImaging();
_ocr = new GdPictureOCR();
_ocr.ResourceFolder = @"C:\GdPicture\Resources\OCR";

// Replace with
IronOcr.License.LicenseKey = "IRONOCR-LICENSE-KEY";
// IronTesseract instances are instantiated per-use or as a singleton

' Remove
Dim lm As New LicenseManager()
lm.RegisterKEY("GDPICTURE-LICENSE-KEY")
_imaging = New GdPictureImaging()
_ocr = New GdPictureOCR()
_ocr.ResourceFolder = "C:\GdPicture\Resources\OCR"

' Replace with
IronOcr.License.LicenseKey = "IRONOCR-LICENSE-KEY"
' IronTesseract instances are instantiated per-use or as a singleton

Görüntü ID Takibinin Ortadan Kaldırılması

Her CreateGdPictureImageFromFile çağrısı ve her RenderPageToGdPictureImage çağrısının mevcut kod tabanında bir yerlerde karşılık gelen bir ReleaseGdPictureImage çağrısı vardır.IronOCR içinde bu temizlik çağrıları tamamen kaldırılmıştır — OcrInput görüntünün yok edilmeyi halleder. Geçiş mekaniğidir: her int imageId = ...'i bulun, eşleşen ReleaseGdPictureImage(imageId)'i bulun, yükleme kodunu using var input = new OcrInput()'a sarın ve GdPicture yöntem çağrılarınıIronOCR eşdeğerleriyle değiştirin.

// Remove
int imageId = _imaging.CreateGdPictureImageFromFile(path);
if (imageId == 0) throw new Exception(_imaging.GetStat().ToString());
_ocr.SetImage(imageId);
_ocr.Language = "eng";
string resultId = _ocr.RunOCR();
if (string.IsNullOrEmpty(resultId)) throw new Exception(_ocr.GetStat().ToString());
string text = _ocr.GetOCRResultText(resultId);
_imaging.ReleaseGdPictureImage(imageId);

// Replace with
using var input = new OcrInput();
input.LoadImage(path);
var result = new IronTesseract().Read(input);
string text = result.Text;

// Remove
int imageId = _imaging.CreateGdPictureImageFromFile(path);
if (imageId == 0) throw new Exception(_imaging.GetStat().ToString());
_ocr.SetImage(imageId);
_ocr.Language = "eng";
string resultId = _ocr.RunOCR();
if (string.IsNullOrEmpty(resultId)) throw new Exception(_ocr.GetStat().ToString());
string text = _ocr.GetOCRResultText(resultId);
_imaging.ReleaseGdPictureImage(imageId);

// Replace with
using var input = new OcrInput();
input.LoadImage(path);
var result = new IronTesseract().Read(input);
string text = result.Text;

Imports System

' Remove
Dim imageId As Integer = _imaging.CreateGdPictureImageFromFile(path)
If imageId = 0 Then Throw New Exception(_imaging.GetStat().ToString())
_ocr.SetImage(imageId)
_ocr.Language = "eng"
Dim resultId As String = _ocr.RunOCR()
If String.IsNullOrEmpty(resultId) Then Throw New Exception(_ocr.GetStat().ToString())
Dim text As String = _ocr.GetOCRResultText(resultId)
_imaging.ReleaseGdPictureImage(imageId)

' Replace with
Using input As New OcrInput()
    input.LoadImage(path)
    Dim result = New IronTesseract().Read(input)
    Dim text As String = result.Text
End Using

Hata İşlemeyi Uyarlama

GdPicture, her önemli işlemden sonra kontrol edilen GdPictureStatus dönüş kodlarını kullanır. IronOCR, standart .NET istisnalarını fırlatır. Geçiş, if (status != GdPictureStatus.OK) korumalarını, OCR'ye özgü hatalar için IronOcr.Exceptions.OcrException işleyen try/catch blokları ve giriş hataları için standart IOException ve FileNotFoundException ile değiştirir. görüntülerden metin okuma öğreticisi, yaygın senaryolar için hata işleme desenlerini kapsar.

Dil Paketi Dağıtımı

GdPicture dil dosyaları, bir dosya sistemi klasöründeki .traineddata dosyalarıdır.IronOCR dil paketleri, NuGet paketleridir. Göç, kaynak klasörünü dağıtım manifestosundan kaldırır ve her gerekli dil için NuGet paket referansları ekler:

# Remove filesystem dependency for each language
# Add NuGet package instead
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.ChineseSimplified

# Remove filesystem dependency for each language
# Add NuGet package instead
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.ChineseSimplified

Birden fazla dil kılavuzu, hem birincil hem de ikincil dillerin IronTesseract örneğinde belirtildiği çok dilli belgeler için yapılandırmayı kapsar.