OCR API Microsoft Azure Vision ile IronOCR: Hangisi Belge Görüntülerini Daha İyi İşler?

Ön İşleme Boşluğu

Ön işleme gereksinimi, atlayabileceğiniz bir yapılandırma seçeneği değildir. Bu, üretim doğruluğu ile gerçek dünya belgelerinde kullanılamaz çıktı arasındaki farktır. Bu wrapper için image-preprocessing-tesseract.cs kaynak dosyası tam el kitabı işlem hatlarını belgeliyor:

// Tesseract requires every one of these steps to be written manually
public static string ExtractWithPreprocessing(string imagePath)
{
    using (var original = new Bitmap(imagePath))
    {
        // Step 2: Convert to grayscale (~25 lines)
        using (var grayscale = ConvertToGrayscale(original))
        {
            // Step 3: Apply contrast enhancement (~15 lines)
            using (var enhanced = EnhanceContrast(grayscale))
            {
                // Step 4: Binarize — convert to black and white (~15 lines)
                using (var binarized = Binarize(enhanced, 128))
                {
                    // Step 5: Remove noise (~25 lines)
                    using (var denoised = RemoveNoise(binarized))
                    {
                        // Step 6: Deskew if rotated (~50 lines, simplified)
                        using (var deskewed = Deskew(denoised))
                        {
                            // Step 7: Scale to 300 DPI (~20 lines)
                            using (var scaled = ScaleToDpi(deskewed, 300))
                            {
                                return RunTesseract(scaled);  // Save to temp file, load Pix, process
                            }
                        }
                    }
                }
            }
        }
    }
}

// Tesseract requires every one of these steps to be written manually
public static string ExtractWithPreprocessing(string imagePath)
{
    using (var original = new Bitmap(imagePath))
    {
        // Step 2: Convert to grayscale (~25 lines)
        using (var grayscale = ConvertToGrayscale(original))
        {
            // Step 3: Apply contrast enhancement (~15 lines)
            using (var enhanced = EnhanceContrast(grayscale))
            {
                // Step 4: Binarize — convert to black and white (~15 lines)
                using (var binarized = Binarize(enhanced, 128))
                {
                    // Step 5: Remove noise (~25 lines)
                    using (var denoised = RemoveNoise(binarized))
                    {
                        // Step 6: Deskew if rotated (~50 lines, simplified)
                        using (var deskewed = Deskew(denoised))
                        {
                            // Step 7: Scale to 300 DPI (~20 lines)
                            using (var scaled = ScaleToDpi(deskewed, 300))
                            {
                                return RunTesseract(scaled);  // Save to temp file, load Pix, process
                            }
                        }
                    }
                }
            }
        }
    }
}

Imports System.Drawing

Public Class ImageProcessor
    ' Tesseract requires every one of these steps to be written manually
    Public Shared Function ExtractWithPreprocessing(imagePath As String) As String
        Using original As New Bitmap(imagePath)
            ' Step 2: Convert to grayscale (~25 lines)
            Using grayscale As Bitmap = ConvertToGrayscale(original)
                ' Step 3: Apply contrast enhancement (~15 lines)
                Using enhanced As Bitmap = EnhanceContrast(grayscale)
                    ' Step 4: Binarize — convert to black and white (~15 lines)
                    Using binarized As Bitmap = Binarize(enhanced, 128)
                        ' Step 5: Remove noise (~25 lines)
                        Using denoised As Bitmap = RemoveNoise(binarized)
                            ' Step 6: Deskew if rotated (~50 lines, simplified)
                            Using deskewed As Bitmap = Deskew(denoised)
                                ' Step 7: Scale to 300 DPI (~20 lines)
                                Using scaled As Bitmap = ScaleToDpi(deskewed, 300)
                                    Return RunTesseract(scaled)  ' Save to temp file, load Pix, process
                                End Using
                            End Using
                        End Using
                    End Using
                End Using
            End Using
        End Using
    End Function

    ' Placeholder methods for conversion
    Private Shared Function ConvertToGrayscale(original As Bitmap) As Bitmap
        ' Implementation here
        Return Nothing
    End Function

    Private Shared Function EnhanceContrast(grayscale As Bitmap) As Bitmap
        ' Implementation here
        Return Nothing
    End Function

    Private Shared Function Binarize(enhanced As Bitmap, threshold As Integer) As Bitmap
        ' Implementation here
        Return Nothing
    End Function

    Private Shared Function RemoveNoise(binarized As Bitmap) As Bitmap
        ' Implementation here
        Return Nothing
    End Function

    Private Shared Function Deskew(denoised As Bitmap) As Bitmap
        ' Implementation here
        Return Nothing
    End Function

    Private Shared Function ScaleToDpi(deskewed As Bitmap, dpi As Integer) As Bitmap
        ' Implementation here
        Return Nothing
    End Function

    Private Shared Function RunTesseract(scaled As Bitmap) As String
        ' Implementation here
        Return Nothing
    End Function
End Class

O iç içe using yapısı önemsiz değil — her adım gerçek bir uygulamadır: gri tonlama için bir renk matrisi, kontrast için piksel döngüsü, binarizasyon için başka bir piksel döngüsü, gürültü için bir medyan filtre ve düzeltme için bir Hough dönüşümü yedeği. image-preprocessing-tesseract.cs kaynağı doğrudan belirtir: 'Basitleştirilmiş düzeltme — gerçek uygulama Hough dönüşümü gerektirir. Bu genellikle OpenCV veya benzeri bir kütüphane gerektirir.'

Toplam: tek bir kelime okunmadan önce yaklaşık 180 satır. Aynı dosyadaki doğruluk tablosu yatırımı neden gerekli gösterir — Tesseract ön işlem olmadan 5 derecelik sapma belgesi üzerinde %60-70 doğruluk üretir, uygun şekilde ön işlenmiş giriş %90+ ulaşır.

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

Tesseract Yaklaşımı

image-preprocessing-tesseract.cs'de gösterilen tam ön işleme hattı, System.Drawing.Common (yalnızca Windows) ya da ImageSharp gibi ek bir platformlar arası kütüphaneyi gerektirir. Yalnızca düzeltme uygulaması basitleştirilmiş olduğunu belirtir — üretim düzeyindeki bir kayma algılama algoritması, genellikle OpenCvSharp4'ün ek bir bağımlılık olarak dahil edilmesini gerektiren bir Hough hattı dönüşümü gerektirir.

// image-preprocessing-tesseract.cs — the actual implementation pattern
private static Bitmap ConvertToGrayscale(Bitmap original)
{
    var result = new Bitmap(original.Width, original.Height);
    using (var graphics = Graphics.FromImage(result))
    {
        var colorMatrix = new ColorMatrix(new float[][]
        {
            new float[] { 0.299f, 0.299f, 0.299f, 0, 0 },
            new float[] { 0.587f, 0.587f, 0.587f, 0, 0 },
            new float[] { 0.114f, 0.114f, 0.114f, 0, 0 },
            new float[] { 0, 0, 0, 1, 0 },
            new float[] { 0, 0, 0, 0, 1 }
        });
        using (var attributes = new ImageAttributes())
        {
            attributes.SetColorMatrix(colorMatrix);
            graphics.DrawImage(original,
                new Rectangle(0, 0, original.Width, original.Height),
                0, 0, original.Width, original.Height,
                GraphicsUnit.Pixel, attributes);
        }
    }
    return result;
}

private static Bitmap EnhanceContrast(Bitmap image)
{
    var result = new Bitmap(image.Width, image.Height);
    float contrast = 1.5f;
    for (int y = 0; y < image.Height; y++)
    {
        for (int x = 0; x < image.Width; x++)
        {
            var pixel = image.GetPixel(x, y);
            int r = Clamp((int)((pixel.R - 128) * contrast + 128));
            int g = Clamp((int)((pixel.G - 128) * contrast + 128));
            int b = Clamp((int)((pixel.B - 128) * contrast + 128));
            result.SetPixel(x, y, Color.FromArgb(r, g, b));
        }
    }
    return result;
}

private static Bitmap RemoveNoise(Bitmap image)
{
    var result = new Bitmap(image.Width, image.Height);
    int kernelSize = 3;
    int radius = kernelSize / 2;
    for (int y = radius; y < image.Height - radius; y++)
    {
        for (int x = radius; x < image.Width - radius; x++)
        {
            var pixels = new List<int>();
            for (int ky = -radius; ky <= radius; ky++)
                for (int kx = -radius; kx <= radius; kx++)
                    pixels.Add(image.GetPixel(x + kx, y + ky).R);
            pixels.Sort();
            int median = pixels[pixels.Count / 2];
            result.SetPixel(x, y, Color.FromArgb(median, median, median));
        }
    }
    return result;
}

// After all preprocessing, save to temp file — Tesseract requires a file path
private static string RunTesseract(Bitmap preprocessed)
{
    string tempPath = Path.GetTempFileName() + ".png";
    try
    {
        preprocessed.Save(tempPath, ImageFormat.Png);
        using (var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default))
        using (var img = Pix.LoadFromFile(tempPath))
        using (var page = engine.Process(img))
            return page.GetText();
    }
    finally
    {
        if (File.Exists(tempPath)) File.Delete(tempPath);
    }
}

// image-preprocessing-tesseract.cs — the actual implementation pattern
private static Bitmap ConvertToGrayscale(Bitmap original)
{
    var result = new Bitmap(original.Width, original.Height);
    using (var graphics = Graphics.FromImage(result))
    {
        var colorMatrix = new ColorMatrix(new float[][]
        {
            new float[] { 0.299f, 0.299f, 0.299f, 0, 0 },
            new float[] { 0.587f, 0.587f, 0.587f, 0, 0 },
            new float[] { 0.114f, 0.114f, 0.114f, 0, 0 },
            new float[] { 0, 0, 0, 1, 0 },
            new float[] { 0, 0, 0, 0, 1 }
        });
        using (var attributes = new ImageAttributes())
        {
            attributes.SetColorMatrix(colorMatrix);
            graphics.DrawImage(original,
                new Rectangle(0, 0, original.Width, original.Height),
                0, 0, original.Width, original.Height,
                GraphicsUnit.Pixel, attributes);
        }
    }
    return result;
}

private static Bitmap EnhanceContrast(Bitmap image)
{
    var result = new Bitmap(image.Width, image.Height);
    float contrast = 1.5f;
    for (int y = 0; y < image.Height; y++)
    {
        for (int x = 0; x < image.Width; x++)
        {
            var pixel = image.GetPixel(x, y);
            int r = Clamp((int)((pixel.R - 128) * contrast + 128));
            int g = Clamp((int)((pixel.G - 128) * contrast + 128));
            int b = Clamp((int)((pixel.B - 128) * contrast + 128));
            result.SetPixel(x, y, Color.FromArgb(r, g, b));
        }
    }
    return result;
}

private static Bitmap RemoveNoise(Bitmap image)
{
    var result = new Bitmap(image.Width, image.Height);
    int kernelSize = 3;
    int radius = kernelSize / 2;
    for (int y = radius; y < image.Height - radius; y++)
    {
        for (int x = radius; x < image.Width - radius; x++)
        {
            var pixels = new List<int>();
            for (int ky = -radius; ky <= radius; ky++)
                for (int kx = -radius; kx <= radius; kx++)
                    pixels.Add(image.GetPixel(x + kx, y + ky).R);
            pixels.Sort();
            int median = pixels[pixels.Count / 2];
            result.SetPixel(x, y, Color.FromArgb(median, median, median));
        }
    }
    return result;
}

// After all preprocessing, save to temp file — Tesseract requires a file path
private static string RunTesseract(Bitmap preprocessed)
{
    string tempPath = Path.GetTempFileName() + ".png";
    try
    {
        preprocessed.Save(tempPath, ImageFormat.Png);
        using (var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default))
        using (var img = Pix.LoadFromFile(tempPath))
        using (var page = engine.Process(img))
            return page.GetText();
    }
    finally
    {
        if (File.Exists(tempPath)) File.Delete(tempPath);
    }
}

Imports System.Drawing
Imports System.Drawing.Imaging
Imports Tesseract
Imports System.IO

' image-preprocessing-tesseract.vb — the actual implementation pattern
Private Shared Function ConvertToGrayscale(original As Bitmap) As Bitmap
    Dim result As New Bitmap(original.Width, original.Height)
    Using graphics As Graphics = Graphics.FromImage(result)
        Dim colorMatrix As New ColorMatrix(New Single()() {
            New Single() {0.299F, 0.299F, 0.299F, 0, 0},
            New Single() {0.587F, 0.587F, 0.587F, 0, 0},
            New Single() {0.114F, 0.114F, 0.114F, 0, 0},
            New Single() {0, 0, 0, 1, 0},
            New Single() {0, 0, 0, 0, 1}
        })
        Using attributes As New ImageAttributes()
            attributes.SetColorMatrix(colorMatrix)
            graphics.DrawImage(original, New Rectangle(0, 0, original.Width, original.Height), 0, 0, original.Width, original.Height, GraphicsUnit.Pixel, attributes)
        End Using
    End Using
    Return result
End Function

Private Shared Function EnhanceContrast(image As Bitmap) As Bitmap
    Dim result As New Bitmap(image.Width, image.Height)
    Dim contrast As Single = 1.5F
    For y As Integer = 0 To image.Height - 1
        For x As Integer = 0 To image.Width - 1
            Dim pixel As Color = image.GetPixel(x, y)
            Dim r As Integer = Clamp(CInt((pixel.R - 128) * contrast + 128))
            Dim g As Integer = Clamp(CInt((pixel.G - 128) * contrast + 128))
            Dim b As Integer = Clamp(CInt((pixel.B - 128) * contrast + 128))
            result.SetPixel(x, y, Color.FromArgb(r, g, b))
        Next
    Next
    Return result
End Function

Private Shared Function RemoveNoise(image As Bitmap) As Bitmap
    Dim result As New Bitmap(image.Width, image.Height)
    Dim kernelSize As Integer = 3
    Dim radius As Integer = kernelSize \ 2
    For y As Integer = radius To image.Height - radius - 1
        For x As Integer = radius To image.Width - radius - 1
            Dim pixels As New List(Of Integer)()
            For ky As Integer = -radius To radius
                For kx As Integer = -radius To radius
                    pixels.Add(image.GetPixel(x + kx, y + ky).R)
                Next
            Next
            pixels.Sort()
            Dim median As Integer = pixels(pixels.Count \ 2)
            result.SetPixel(x, y, Color.FromArgb(median, median, median))
        Next
    Next
    Return result
End Function

' After all preprocessing, save to temp file — Tesseract requires a file path
Private Shared Function RunTesseract(preprocessed As Bitmap) As String
    Dim tempPath As String = Path.GetTempFileName() & ".png"
    Try
        preprocessed.Save(tempPath, ImageFormat.Png)
        Using engine As New TesseractEngine(TessDataPath, "eng", EngineMode.Default)
            Using img As Pix = Pix.LoadFromFile(tempPath)
                Using page As Page = engine.Process(img)
                    Return page.GetText()
                End Using
            End Using
        End Using
    Finally
        If File.Exists(tempPath) Then File.Delete(tempPath)
    End Try
End Function

Private Shared Function Clamp(value As Integer) As Integer
    Return Math.Max(0, Math.Min(255, value))
End Function

Private Const TessDataPath As String = "path_to_tessdata" ' Define the path to tessdata directory

Bu, kaynak dosyalardan gerçek kod — kurgulanmış bir en kötü durum değil. Kontrast ve gürültü gidermek için piksel-tekrar yaklaşımı her piksel üzerinde O(n²) işletir. Geçici dosya kaydetme ve yükleme isteğe bağlı değildir; Pix.LoadFromFile disk üzerinde bir dosya yolu gerektirir. Günde 1.000 taranmış belge işleyen bir uygulama için bu, OCR zamanına ek olarak ölçülebilir yük bindirir.

IronOCR Yaklaşımı

IronOCR'daki aynı ön işleme, OcrInput üzerinde bir dizi yöntem çağrısından oluşur.

// dotnet add package IronOcr
using IronOcr;

using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();           // Detects and corrects skew angle automatically
input.DeNoise();          // Removes scanner artifacts and specks
input.Contrast();         // Enhances contrast for character separation
input.Binarize();         // Converts to black and white with adaptive threshold
input.EnhanceResolution(300);  // Scales to 300 DPI for optimal recognition

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

// dotnet add package IronOcr
using IronOcr;

using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();           // Detects and corrects skew angle automatically
input.DeNoise();          // Removes scanner artifacts and specks
input.Contrast();         // Enhances contrast for character separation
input.Binarize();         // Converts to black and white with adaptive threshold
input.EnhanceResolution(300);  // Scales to 300 DPI for optimal recognition

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

Imports IronOcr

Dim input As New OcrInput()
input.LoadImage("low-quality-scan.jpg")

input.Deskew()           ' Detects and corrects skew angle automatically
input.DeNoise()          ' Removes scanner artifacts and specks
input.Contrast()         ' Enhances contrast for character separation
input.Binarize()         ' Converts to black and white with adaptive threshold
input.EnhanceResolution(300)  ' Scales to 300 DPI for optimal recognition

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

Geçici dosya yok. Piksel yinelemesi yok. System.Drawing.Common veya OpenCvSharp4 bağımlılığı yok. görüntü kalitesi düzeltme kılavuzu ve görüntü yönlendirme düzeltme kılavuzu tam filtre kataloğunu içerir — 15'ten fazla mevcuttur. görüntü filtreleri örneği, düşük kaliteli tarama hattını baştan sona gösterir.

Çoğu gerçek dünya belgesi için, varsayılan okuma, hiçbir açık filtre çağrısı olmadan akıllı otomatik ön işlem uygular:

// Automatic preprocessing applied internally — no explicit filter calls needed
var text = new IronTesseract().Read("scanned-invoice.jpg").Text;

// Automatic preprocessing applied internally — no explicit filter calls needed
var text = new IronTesseract().Read("scanned-invoice.jpg").Text;

Imports IronTesseract

' Automatic preprocessing applied internally — no explicit filter calls needed
Dim text As String = New IronTesseract().Read("scanned-invoice.jpg").Text

Temiz, yüksek DPI'lı girdide bu bir maliyet getirmez. 72 DPI'lık bir telefon fotoğrafında, motor ölçeklendirir, geliştirir ve metni tanımaya başlamadan önce normalleştirir.

Tesseract Yaklaşımı

pdf-ocr-processing-tesseract.cs dosyası, üç ayrı PDF render kütüphanesi seçeneğini — PdfiumViewer, PDFtoImage ve Docnet.Core — her biri farklı bağımlılık zincirleri ve takaslarla belgeler. Bu dosyadaki PdfiumViewer örneği temsili:

// Tesseract PDF processing — from pdf-ocr-processing-tesseract.cs
// Requires: PdfiumViewer NuGet + pdfium native DLL deployed to application directory
// NuGet: PdfiumViewer, PdfiumViewer.Native.x64

using PdfiumViewer;

public static string ExtractFromPdfWithPdfium(string pdfPath)
{
    var results = new List<string>();

    using (var document = PdfDocument.Load(pdfPath))
    {
        using (var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default))
        {
            for (int pageIndex = 0; pageIndex < document.PageCount; pageIndex++)
            {
                // Render page to image at 300 DPI
                using (var pageImage = document.Render(pageIndex, 300, 300,
                    PdfRenderFlags.CorrectFromDpi))
                {
                    // Tesseract requires a file path — must write to disk first
                    string tempPath = Path.GetTempFileName() + ".png";
                    try
                    {
                        pageImage.Save(tempPath);
                        using (var img = Pix.LoadFromFile(tempPath))
                        using (var page = engine.Process(img))
                            results.Add(page.GetText());
                    }
                    finally
                    {
                        File.Delete(tempPath);  // Must clean up or disk fills
                    }
                }
            }
        }
    }

    return string.Join("\n\n--- Page Break ---\n\n", results);
}

// Tesseract PDF processing — from pdf-ocr-processing-tesseract.cs
// Requires: PdfiumViewer NuGet + pdfium native DLL deployed to application directory
// NuGet: PdfiumViewer, PdfiumViewer.Native.x64

using PdfiumViewer;

public static string ExtractFromPdfWithPdfium(string pdfPath)
{
    var results = new List<string>();

    using (var document = PdfDocument.Load(pdfPath))
    {
        using (var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default))
        {
            for (int pageIndex = 0; pageIndex < document.PageCount; pageIndex++)
            {
                // Render page to image at 300 DPI
                using (var pageImage = document.Render(pageIndex, 300, 300,
                    PdfRenderFlags.CorrectFromDpi))
                {
                    // Tesseract requires a file path — must write to disk first
                    string tempPath = Path.GetTempFileName() + ".png";
                    try
                    {
                        pageImage.Save(tempPath);
                        using (var img = Pix.LoadFromFile(tempPath))
                        using (var page = engine.Process(img))
                            results.Add(page.GetText());
                    }
                    finally
                    {
                        File.Delete(tempPath);  // Must clean up or disk fills
                    }
                }
            }
        }
    }

    return string.Join("\n\n--- Page Break ---\n\n", results);
}

Imports PdfiumViewer
Imports Tesseract

Public Shared Function ExtractFromPdfWithPdfium(pdfPath As String) As String
    Dim results As New List(Of String)()

    Using document = PdfDocument.Load(pdfPath)
        Using engine = New TesseractEngine(TessDataPath, "eng", EngineMode.Default)
            For pageIndex As Integer = 0 To document.PageCount - 1
                ' Render page to image at 300 DPI
                Using pageImage = document.Render(pageIndex, 300, 300, PdfRenderFlags.CorrectFromDpi)
                    ' Tesseract requires a file path — must write to disk first
                    Dim tempPath As String = Path.GetTempFileName() & ".png"
                    Try
                        pageImage.Save(tempPath)
                        Using img = Pix.LoadFromFile(tempPath)
                            Using page = engine.Process(img)
                                results.Add(page.GetText())
                            End Using
                        End Using
                    Finally
                        File.Delete(tempPath)  ' Must clean up or disk fills
                    End Try
                End Using
            Next
        End Using
    End Using

    Return String.Join(vbCrLf & vbCrLf & "--- Page Break ---" & vbCrLf & vbCrLf, results)
End Function

pdf-ocr-processing-tesseract.cs kaynağı doğrudan bağımlılık zincirini belirtir: 'Tesseract: Apache 2.0, PdfiumViewer: BSD, iText: AGPL veya ticari, GhostScript: AGPL veya ticari.' Bu son öğe, kurumsal bağlamlarda önemlidir — GhostScript'in AGPL lisansı, uygulamanızın açık kaynak olmasını gerektirir, eğer bir ticari GhostScript lisansı satın almazsanız.

Parola korumalı PDF'ler bir başka katman ekler. Aynı dosyadaki PasswordProtectedPdf sınıfı, 'Şifreleme desteği olan bir PDF kütüphanesi gerektirir (iText, PDFSharp).' yorumu ile NotImplementedException fırlatır. Tesseract PDF'leri şifre çözemez.' Yani parola koruması, kendi lisanslama değerlendirmeleri ile dördüncü bir bağımlılık anlamına gelir.

IronOCR Yaklaşımı

IronOCR, taranmış PDF'ler, dijital metin PDF'leri, karışık içerikli PDF'ler ve parola korumalı PDF'ler dahil olmak üzere PDF'leri doğal olarak okur:

// dotnet add package IronOcr
using IronOcr;

// Scanned PDF — direct load, no rendering library required
var result = new IronTesseract().Read("scanned-contract.pdf");
Console.WriteLine(result.Text);

// Password-protected PDF — one additional parameter
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var protectedResult = new IronTesseract().Read(input);

// Specific page range from a 200-page document
using var rangeInput = new OcrInput();
rangeInput.LoadPdfPages("large-report.pdf", 1, 10);
var rangeResult = new IronTesseract().Read(rangeInput);

// Create searchable PDF with embedded text layer
var searchable = new IronTesseract().Read("scanned-invoice.pdf");
searchable.SaveAsSearchablePdf("searchable-invoice.pdf");

// dotnet add package IronOcr
using IronOcr;

// Scanned PDF — direct load, no rendering library required
var result = new IronTesseract().Read("scanned-contract.pdf");
Console.WriteLine(result.Text);

// Password-protected PDF — one additional parameter
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var protectedResult = new IronTesseract().Read(input);

// Specific page range from a 200-page document
using var rangeInput = new OcrInput();
rangeInput.LoadPdfPages("large-report.pdf", 1, 10);
var rangeResult = new IronTesseract().Read(rangeInput);

// Create searchable PDF with embedded text layer
var searchable = new IronTesseract().Read("scanned-invoice.pdf");
searchable.SaveAsSearchablePdf("searchable-invoice.pdf");

Imports IronOcr

' Scanned PDF — direct load, no rendering library required
Dim result = New IronTesseract().Read("scanned-contract.pdf")
Console.WriteLine(result.Text)

' Password-protected PDF — one additional parameter
Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")
    Dim protectedResult = New IronTesseract().Read(input)
End Using

' Specific page range from a 200-page document
Using rangeInput As New OcrInput()
    rangeInput.LoadPdfPages("large-report.pdf", 1, 10)
    Dim rangeResult = New IronTesseract().Read(rangeInput)
End Using

' Create searchable PDF with embedded text layer
Dim searchable = New IronTesseract().Read("scanned-invoice.pdf")
searchable.SaveAsSearchablePdf("searchable-invoice.pdf")

PDF oluşturma kütüphanesi yok. Geçici dosya yok. AGPL lisans değerlendirmeleri yok. PDF giriş nasıl yapılır kılavuzu, tüm PDF giriş varyasyonlarını kapsar. aranabilir PDF nasıl yapılır metin katmanı çıktısını açıklar. Belge işleme boru hatları oluşturan ekipler için, PDF OCR kullanım sayfası, üretim mimarisi kalıplarını sağlar.

Ön işleme yöntemleri PDF girdisinde aynen çalışır, taranmış PDF'lerde hiçbir ara dönüştürme adımı olmadan aynı input.Deskew(), input.DeNoise(), input.EnhanceResolution() çağrılarına izin verir.

Tesseract Yaklaşımı

multi-language-tesseract.cs dosyası, dil dosyalarının boyutlarını ve yönetim sürecini belgeliyor:

// Must exist before initialization:
// ./tessdata/eng.traineddata   (~15 MB)
// ./tessdata/fra.traineddata   (~15 MB)
// ./tessdata/deu.traineddata   (~15 MB)
// ./tessdata/chi_sim.traineddata  (~45 MB)
// ./tessdata/jpn.traineddata   (~40 MB)
// 10 languages = 200-300 MB to download and manage

public string SafeMultiLanguageOcr(string imagePath, string[] languages)
{
    // Check presence before attempting — runtime failures are worse
    foreach (var lang in languages)
    {
        if (!File.Exists(Path.Combine(TessDataPath, $"{lang}.traineddata")))
        {
            throw new FileNotFoundException(
                $"Missing {lang}.traineddata in {TessDataPath}. " +
                "Download from https://github.com/tesseract-ocr/tessdata");
        }
    }

    var langString = string.Join("+", languages);  // e.g., "eng+fra+deu"
    using var engine = new TesseractEngine(TessDataPath, langString, EngineMode.Default);
    using var img = Pix.LoadFromFile(imagePath);
    using var page = engine.Process(img);
    return page.GetText();
}

// Must exist before initialization:
// ./tessdata/eng.traineddata   (~15 MB)
// ./tessdata/fra.traineddata   (~15 MB)
// ./tessdata/deu.traineddata   (~15 MB)
// ./tessdata/chi_sim.traineddata  (~45 MB)
// ./tessdata/jpn.traineddata   (~40 MB)
// 10 languages = 200-300 MB to download and manage

public string SafeMultiLanguageOcr(string imagePath, string[] languages)
{
    // Check presence before attempting — runtime failures are worse
    foreach (var lang in languages)
    {
        if (!File.Exists(Path.Combine(TessDataPath, $"{lang}.traineddata")))
        {
            throw new FileNotFoundException(
                $"Missing {lang}.traineddata in {TessDataPath}. " +
                "Download from https://github.com/tesseract-ocr/tessdata");
        }
    }

    var langString = string.Join("+", languages);  // e.g., "eng+fra+deu"
    using var engine = new TesseractEngine(TessDataPath, langString, EngineMode.Default);
    using var img = Pix.LoadFromFile(imagePath);
    using var page = engine.Process(img);
    return page.GetText();
}

Imports System.IO
Imports Tesseract

Public Function SafeMultiLanguageOcr(imagePath As String, languages As String()) As String
    ' Check presence before attempting — runtime failures are worse
    For Each lang In languages
        If Not File.Exists(Path.Combine(TessDataPath, $"{lang}.traineddata")) Then
            Throw New FileNotFoundException(
                $"Missing {lang}.traineddata in {TessDataPath}. " &
                "Download from https://github.com/tesseract-ocr/tessdata")
        End If
    Next

    Dim langString = String.Join("+", languages)  ' e.g., "eng+fra+deu"
    Using engine As New TesseractEngine(TessDataPath, langString, EngineMode.Default)
        Using img As Pix = Pix.LoadFromFile(imagePath)
            Using page As Page = engine.Process(img)
                Return page.GetText()
            End Using
        End Using
    End Using
End Function

Koruyucu dosya varlık kontrolü paranoya değildir — eksik bir .traineddata dosyası, eksik dosyanın hangisi olduğunu her zaman net olarak belirtmeyen bir mesajla TesseractException: Failed to initialise tesseract engine fırlatır. basic-text-extraction-tesseract.cs kaynağı, yaygın çalışma zamanı istisnalarını belgeliyor: Eksik Leptonica ikili dosyaları için System.DllNotFoundException, eksik tessdata için TesseractException, 32/64-bit uyumsuzlukları için BadImageFormatException.

Docker dağıtımlarında, tessdata dosyaları konteyner görüntüsüne kopyalanmalıdır. Üç dil için her biri 15 MB artı best modelleri her bir 50-100 MB olacak şekilde, konteyner görüntüleri birkaç yüz megabayt şişer. CI/CD boru hatları bu indirmeleri ya önceden önbelleğe almalı ya da önbellek soğukken yavaş derleme sürelerini kabul etmelidir.

IronOCR Yaklaşımı

IronOCR'de dil desteği bir NuGet paketi referansıdır:

// Install once: dotnet add package IronOcr.Languages.French
// Install once: dotnet add package IronOcr.Languages.German
using IronOcr;

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

var result = ocr.Read("multilingual-document.jpg");

// Install once: dotnet add package IronOcr.Languages.French
// Install once: dotnet add package IronOcr.Languages.German
using IronOcr;

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

var result = ocr.Read("multilingual-document.jpg");

Imports IronOcr

' Install once: dotnet add package IronOcr.Languages.French
' Install once: dotnet add package IronOcr.Languages.German

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.French
ocr.AddSecondaryLanguage(OcrLanguage.German)

Dim result = ocr.Read("multilingual-document.jpg")

Dil verileri NuGet paketine yerleştirilmiştir. Oluşturulacak klasör yok, yapılandırılacak yol yok, GitHub'dan indirilecek ve doğrulanacak dosya yok. Docker'a bir dil eklemek, .csproj'a bir PackageReference satırı eklemek anlamına gelir. Çoklu diller nasıl yapılır kılavuzu 125'ten fazla dil kataloğunu kapsar ve çok dilli blog yazısı, üretim çok dilli boru hatlarını CJK karakter setleri dahil gösterir.

Önişleme Dönüm Noktası Geldiğinde

Her Tesseract projesi, temiz test görüntüleri ile başlar. Örnek faturalar, net taranmış belgeler, ilk okumada çalışan 300 DPI'da PNG dosyaları. Önişleme sorusu ertelenir. Sonra ilk üretim partisi gelir: 150 DPI'da fakslanmış satın alma siparişleri, 3 derece eğimle taranmış sözleşmeler, floresan ışık altında çekilmiş fişlerin fotoğrafları. Doğruluk %60-70 seviyelerine düşer. Takım şimdi ertelenmiş olan önişleme boru hattını uygulamak zorunda kalır, gri tonlamaya dönüştürme ve kontrast iyileştirmenin yönetilebilir olduğunu, ancak uyumun bir Hough dönüşümü gerektirdiğini ve gürültüsüzleştirme için bir medyan filtre gerektiğini ve bunların hiçbirinin iki saatlik iş olmadığını keşfeder. Bu kilometre taşında olan ekipler — ön işleme borcu bir sprint birikimi öğesi haline geldiğinde — IronOCR'u sık sık değerlendirir çünkü lisans maliyeti, onlar için kiralanmadıkları görüntü işleme işinin iki geliştiricinin haftasına göre daha ucuzdur.

PDF Gereksinimi Belirdiğinde

Belge işleme uygulamaları neredeyse her zaman sonunda PDF desteğine ihtiyaç duyar. İlk yanıt genellikle 'PdfiumViewer ekle' olur — bu, iyi belgelenmiştir ve birçok durumda iyi çalışır. Sorunlar üretimde ortaya çıkar: yerel pdfium.dll uygulama dizininde doğru bit boyutunda mevcut olmalı, konteyner görüntüleri Dockerfile'larda açık COPY adımları gerektirir,Linuxdağıtımları ilgili .so dosyasını gerektirir ve şifre korumalı PDF'ler için kendi lisansına sahip ayrı bir şifre çözme kütüphanesi gereklidir. Tesseract yerel kütüphaneleri, Leptonica ve pdfium — dört ortamda (Windows, Linux, Docker, CI) — üç ayrı bağımlılık zincirini yöneten ekipler tek bir paket alternatifi değerlendirmenin değerli hale geldiği bir bakım eşiğine ulaşır.

Ölçekte Paralel İşleme

500 faturayı işleyen bir toplu OCR işi paralellikten yararlanır. charlesw sarmalayıcı ile güvenli paralel işleme deseni, her iş parçacığı için bir motor örneği oluşturur ve her biri 40-100 MB dil modeli verisi yükler. Sekiz iş parçacığında, belgeler yüklenmeden önce bu, 320-800 MB motor belleğidir. OCR hizmetlerini profilleyen ekipler ve bellek baskısının belge içeriği yerine motor başlatma sırasında yoğunlaştığını bulanlar, IronOCR'nin iş parçacığı güvenli tek örnek modeli doğrudan kök nedeni çözdüğünü görürler. çok iş parçacıklı örnek deseni gösterir.

Dağıtım Ortamları Çoğalıyor

Windows'ta başlayan bir proje, bulut dağıtımı için birLinuxkonteyner ekler. Dockerfile artık yerel kütüphane kurulum adımlarına ihtiyaç duyar, tessdata dosyaları konteyner içine kopyalanmalı ve tessdata yol ortam değişkeni doğru ayarlanmalıdır. Sonra birmacOSgeliştirici ekibe katılır. Sonra biri AWS Lambda'ya dağıtım yapmak ister. Her platform sessizce başarısız olabilen başka bir yapılandırma yüzeyi ekler - üretim konteynerında çalışma zamanı eksik olan yerel bir kütüphane, biraz daha yüksek bir NuGet paketi maliyetinden daha kötü bir sonuçtur. IronOCR Dockerdağıtım kılavuzu karşıtlığı gösterir: sistem paketleri yok, tessdata kopyalama adımı yok, ortam değişkeni yok.

Tesseract Versiyon Paritesi Önemlidir

Tesseract 5.x, belirli belge türlerinde ölçülebilir olan LSTM doğruluğunda iyileştirmeler getirmiştir. charlesw sarmalayıcı Tesseract 4.1.1'i hedefler. OCR doğruluğunun zor belgelerde bir ürün kalitesi metriği olduğu ekipler için, versiyon farkı gerçek bir değerlendirme konusudur — özellikle alternatif, mevcut motor sürümünü takip eden ticari olarak sürdürülen bir paket olduğunda.

Tessdata Klasörünün Kaldırılması

IronOCR'ye geçtikten sonraki ilk temizlik adımı, tessdata klasörünü silmek ve proje dosyasından ilgili <Content Include="tessdata\**"> öğelerini kaldırmaktır. Sabit kodlanmış yol doğrulama kodu — Directory.Exists(TessDataPath) güvencesi basic-text-extraction-tesseract.cs 'da mevcut — da ortadan kalkar. using Tesseract; ad alanı referansları ve TesseractEngine, Pix ve Page tip referanslarının tümü, using IronOcr;, IronTesseract, OcrInput ve OcrResult ile değiştirilmelidir.

PDF Kütüphanesinin Kaldırılması

Yalnızca Tesseract PDF işleme desteği için eklenen herhangi bir PDF işleme kütüphanesi — PdfiumViewer, PDFtoImage, Docnet.Core — kaldırılabilir. Bu paketlerin gerektirdiği yerel ikili bağımlılıklar (pdfium.dll, GhostScript ikili dosyaları) da ortadan kalkar. Dockerfile COPY ve apt-get bu bağımlılıklar için satırlara artık ihtiyaç yok. IronOCR PDF giriş kılavuzu, bu kütüphanelerin ele aldığı her PDF giriş varyasyonunu, sayfa aralığı seçimini ve şifreyle korunmuş belgeler dahil ele alır. Tüm render-sonrası-OCR bloğu — tipik olarak üç kütüphaneyi kapsayan 50-80 satır — input.LoadPdf(path) ardından tek bir Read() çağrısına kadar küçülür.

Önişleme Kodunun Değiştirilmesi

Mevcut ön işleme yöntemleri — ConvertToGrayscale, EnhanceContrast, Binarize, RemoveNoise, Deskew, ScaleToDpi — doğrudan IronOCR filtre yöntemleriyle eşleşir. Geçici dosya kaydet-ve-yükle düzeni tamamen ortadan kalkar. Renk özgül dönüşümler için görüntü renk düzeltme kılavuzuna ve çözünürlük yönetimi için DPI ayarları kılavuzuna başvurun.

İş Parçacığı Modeli Değişikliği

Kod, her iş parçacığı için bir TesseractEngine oluşturduğu Parallel.ForEach döngüsünde — bir IronTesseract oluşturup tüm iş parçacıkları arasında paylaşmaya dönüştürülür. Bu bir doğruluk değişikliği, yalnızca bir yeniden düzenleme değil: eski düzen, iş parçacığı güvenli olmayan bir API etrafında savunmacı programlama idi; yeni düzen, iş parçacığı güvenli bir API'nin amaçlanan kullanımıdır. Her iş parçacığı başına motor başlatma yükü — iş parçacığı başına 40-100 MB dil modeli verisi — değişiklikle birlikte ortadan kalkar çünkü IronOCR, motor örneği başına tam model durumu yüklemek yerine paylaşılan bir iç havuz tutar.