C# CodeProject Eğitiminde OCR: Görsellerden IronOCR ile Metin Çıkarmak

Bir .NET Projesine IronOCR Nasıl Yüklenir?

Bir .NET 10 projesine OCR eklemenin en hızlı yolu NuGet Paket Yöneticisi üzerinden gerçekleşir. Projenizin dizininde bir terminal açın ve .NET CLI komutunu çalıştırın veya Visual Studio içindeki Paket Yöneticisi Konsolu'nu kullanın:

Install-Package IronOcr

Kurulumdan sonra, NuGet paket yöneticisi gerekli tüm derlemeleri indirir ve referansları otomatik olarak bağlar. IronOCR, .NET Framework 4.6.2+, .NET Core 3.1+, ve .NET 5 ile .NET 10'u hedefler, bu nedenle konsol uygulamaları, ASP.NET Core servisleri, WPF uygulamaları ve Azure Fonksiyonları üzerinde çalışır.

Yerel olarak test etmek için bir lisans anahtarı kaydetmeniz gerekmez -- lisans uygulanıncaya kadar çıktıda bir deneme filigranı görünür. Kullandığınız yönergeyi ekleyin ve üretime hazır olduğunuzda anahtarınızı bir kez başlatma sırasında geçirin:

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronOcr

' Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

Fiyatlandırma ve etkinleştirme detayları için IronOCR lisanslama sayfasına bakın.

Bir Görüntü Dosyasından Metin Nasıl Çıkarılır?

Temel OCR iş akışı üç nesneyi içerir: IronTesseract (motor), OcrInput (girdi konteyneri) ve OcrResult (çıktı). Aşağıdaki örnek, bir PNG okur ve tanınan metni konsola yazdırır.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    input.LoadImage("sample-document.png")

    Dim result As OcrResult = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

Taranmış Belgeler ve TIFF Dosyalarını Nasıl İşlersiniz?

Çok sayfalı TIFF dosyaları, belge tarama iş akışlarında yaygındır. IronOCR, büyük bir arşivin yalnızca bir alt kümesine ihtiyacınız olduğunda, hangi karelerin (sayfaların) işleneceğini seçmenize olanak tanıyan LoadImageFrames ile onları ele alır.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

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

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

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

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    Dim pageIndices As Integer() = {0, 1, 2}
    input.LoadImageFrames("scanned-documents.tiff", pageIndices)

    ' Correct skew and remove noise before reading
    input.Deskew()
    input.DeNoise()

    Dim result As OcrResult = ocr.Read(input)

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

OCR için Dil Desteği Nasıl Yapılandırılır?

Varsayılan olarak, IronOCR İngilizce metni okur. Başka dillerde belgeleri işlemek için, eşleşen dil NuGet paketini yükleyin ve IronTesseract örneğine Language özelliğini ayarlayın.

dotnet add package IronOcr.Languages.German, IronOcr.Languages.French, IronOcr.Languages.Japanese

O zaman motoru yapılandırın ve iki dilli belgeler için ikincil bir dil ekleyin:

using IronOcr;
using IronOcr.Languages;

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

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronOcr.Languages;

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

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr
Imports IronOcr.Languages

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

' For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French)

Using input As New OcrInput()
    input.LoadImage("german-invoice.png")

    Dim result As OcrResult = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

IronOCR, her biri ayrı hafif bir NuGet paketi olarak dağıtılan 125'ten fazla dili destekler. Bu, üretim ikili dosyanızı küçük tutar -- uygulamanızın gerçekten ihtiyaç duyduğu dil verileri içerilir. Motor, AddSecondaryLanguage'ı çağırdığınızda tanıma sırasında birincil ve ikincil dil modellerini harmanlar.

OCR Hatalarını Nasıl Yönetir ve Tanınma Sonuçlarını İyileştirirsiniz?

Üretim uygulamalarının, OCR boru hattı etrafında hata yönetimine ihtiyacı vardır. Görüntü kalitesi sorunları, eksik dosyalar veya desteklenmeyen formatlar istisnalara neden olabilir. Çağrıyı bir try/catch bloğuna sarmak size temiz bir kurtarma yolu sağlar.

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

Imports IronOcr

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.English

Try
    Using input As New OcrInput()
        input.LoadImage("document.png")
        input.DeNoise()
        input.Deskew()

        Dim result As OcrResult = ocr.Read(input)

        If result.Text.Length > 0 Then
            Console.WriteLine("Recognised text:")
            Console.WriteLine(result.Text)
        Else
            Console.WriteLine("No text was detected in the image.")
        End If
    End Using
Catch ex As Exception
    Console.WriteLine($"OCR error: {ex.Message}")
End Try

Beklenenden düşük doğruluk olduğunda yardımcı olan birkaç ek ayar:

• ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto -- tek sütunlu, çok sütunlu ve tek kelimelik düzenler arasında tercihi Tesseract'ın otomatik seçmesine izin verir
• ocr.Configuration.ReadBarCodes = false -- yalnızca metin belgelerini işliyorsanız ve daha hızlı işlem istiyorsanız barkod algılamayı devre dışı bırakır
• ocr.Configuration.TesseractVersion = TesseractVersion.Tesseract5 -- kullanılabilen en hızlı motoru kullandığınızdan emin olur

Alanların tahmin edilebilir konumlarda göründüğü yapılandırılmış formlar için, önemli olan alanları okumak için bölge tabanlı OCR kullanın:

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr
Imports IronSoftware.Drawing

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    Dim region As New CropRectangle(x:=50, y:=200, width:=600, height:=100)
    input.LoadImage("form.png", region)

    Dim result As OcrResult = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

Büyük resimlerde tanımayı bir kesme dikdörtgeniyle sınırlandırmak, işlem hızını %90'a kadar azaltır. Bu teknik, fatura numarası çıkartma, form alanı okuma ve kimlik belgesi tarama için uygundur. bölge OCR nasıl yapılır kılavuzunda daha fazla detay mevcuttur.

Tanınan Metinden Aranabilir PDF Nasıl Oluşturulur?

Taranmış görüntü arşivlerini aranabilir PDF dosyalarına dönüştürmek, en yüksek değerli OCR kullanım alanlarından biridir. Ortaya çıkan dosya, PDF görüntüleyicileri, arama motorları ve ekran okuyucuların dizine ekleyebileceği gizli bir metin katmanı gömerek orijinal görsel görünümü korur.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    input.Title = "Quarterly Report Q1 2026"
    input.LoadImage("page1.png")
    input.LoadImage("page2.png")
    input.LoadImage("page3.png")

    Dim result As OcrResult = ocr.Read(input)
    result.SaveAsSearchablePdf("searchable-output.pdf")

    Console.WriteLine("Searchable PDF created.")
    Console.WriteLine($"Pages processed: {result.Pages.Count}")
End Using

Metin Yanında Barkod Nasıl Okunur?

IronOCR, basılı metinle aynı görüntüye gömülü barkodları ve QR kodlarını okuyabilir, ayrı bir barkod kütüphanesi çalıştırma ihtiyacını ortadan kaldırır. Özelliği tek bir yapılandırma özelliğiyle etkinleştirin:

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

Console.WriteLine("Barcodes:");
foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"  {barcode.Format}: {barcode.Value}");
}

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

Console.WriteLine("Barcodes:");
foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"  {barcode.Format}: {barcode.Value}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Desteklenen barkod formatları arasında Code 128, Code 39, EAN-13, EAN-8, UPC-A, UPC-E, PDF417, Data Matrix ve QR Code bulunur. IronOCR barkod okuma kılavuzunda tüm detaylar mevcuttur.

Bu yetenek, lojistik, sağlık ve perakende uygulamalarında özellikle kullanışlıdır, burada gönderi etiketleri, hasta bileklikleri ve ürün etiketleri hem insan tarafından okunabilen metin hem de makine tarafından okunabilen barkodlar taşır.

IronOCR Nasıl Diğer .NET OCR Seçenekleriyle Karşılaştırılır?

.NET için OCR kütüphanelerini değerlendiren geliştiriciler tipik olarak IronOCR, Tesseract.NET ve Google Cloud Vision veya Azure Bilgisayarla Görme gibi bulut hizmetlerini düşünür. Aşağıdaki tablo, temel farkları özetler:

Tesseract, Google tarafından bir açık kaynak projesi olarak sürdürülen Tesseract, hem IronOCR hem de Tesseract.NET'in arka planında gücünü sağlar. IronOCR, NET-idiyomatik paketleme, otomatik model yönetimi ve ham Tesseract bağlantılarının eksik olduğu üretim çıktısı özelliklerini (aranabilir PDF, hOCR dışa aktarımı) ekler. Azure Bilgisayarla Görme en son bulut doğruluğu sağlar, fakat yüksek hacimli ya da çevrimdışı iş akışları için uygun olmayan ağ gecikmesi ve çağrı başına maliyetler ekler.

Belgelerin harici hizmetlere gönderilmesini yasaklayan veri gizliliği düzenlemelerinin olduğu senaryolarda -- sağlık kayıtları, yasal belgeler, finansal beyanlar -- yerinde bir kütüphane olan IronOCR uygun bir seçimdir.

Sonraki Adımlarınız Neler?

Artık herhangi bir .NET 10 uygulamasına OCR eklemek için yapı taşlarına sahipsiniz: NuGet aracılığıyla kurulum, temel görüntü-metni çıkarma, çok sayfalı TIFF işleme, dil yapılandırması, hata yönetimi, bölge tabanlı okuma, barkod algılama ve aranabilir PDF oluşturma.

Daha derine inmek için bu IronOCR kaynaklarını keşfedin:

• IronOCR belge ana sayfası -- tam API referansı ve özellik kılavuzları
• Görüntü filtre kılavuzu -- tüm ön işleme filtreleri için ayrıntılı kılavuz
• Barkod okuma kılavuzu -- Metin yanında QR kodlar ve çizgisel barkodlar
• Bölge OCR nasıl yapılır -- Formlar ve kimlikler için kırpma tabanlı tanıma
• Diller referansı -- 125+ desteklenen dili içeren tam liste
• API referansı -- tüm sınıflar, yöntemler ve özellikler

Lisanslama soruları için veya IronOCR'yi bir üretim ortamında dağıtmak için, IronOCR lisanslama sayfasına gidin. Değerlendirme süreniz boyunca çıktılarda filigranı kaldıran ücretsiz deneme lisansı ve Iron Software'in destek ekibi, herhangi bir kademede teknik sorular için mevcuttur.

Şimdi IronOCR ile başlayın.

Ücretsiz Başlayın