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

.NET Projesinde IronOCR Nasıl Kurulur?

.NET 10 projesine OCR eklemenin en hızlı yolu, NuGet Paket Yöneticisi aracılığıyladır. Proje dizininizde bir terminal açın ve dotnet CLI komutunu çalıştırın, ya da Visual Studio içindeki Paket Yönetici Konsolu'nu kullanın:

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

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

Yerel olarak test yapmak için bir lisans anahtarı kaydetmenize gerek yok -- bir lisans uygulanana kadar çıktı üzerinde bir deneme filigranı görünür. using direktifini ekleyin ve üretime hazır olduğunuzda, başlangıçta anahtarınızı bir kez girin:

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"

IronOCR lisans sayfasını fiyatlandırma ve etkinleştirme detayları için görün.

Resim Dosyasından Metin Nasıl Çıkartılır?

Ana OCR iş akışı, üç nesneyi içerir: IronTesseract (motor), OcrInput (giriş 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 İşlenir?

Çok sayfalı TIFF dosyaları, belge tarama iş akışlarında yaygındır. IronOCR, onları LoadImageFrames ile işler, bu da hangi karelerin (sayfaların) işleneceğini tam olarak seçmenize olanak tanır -- büyük bir arşivden sadece bir alt küme gerektiğinde yararlıdı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 metin okur. Diğer dillerdeki belgeleri işlemek için eşleşen dil NuGet paketini yükleyin ve IronTesseract örneğinde Language özelliğini ayarlayın.

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

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

Ardından motoru yapılandırın ve iki dilli belgeler için bir ikincil 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çı olan dil verileri dahil edilir. Motor, AddSecondaryLanguage çağırdığınızda tanıma sırasında birincil ve ikincil dil modellerini harmanlar.

OCR Hataları Nasıl Yönetilir ve Tanıma Sonuçları Nasıl İyileştirilir?

Üretim uygulamaları OCR boru hattının etrafında hata yönetimine ihtiyaç duyar. Görüntü kalitesi sorunları, eksik dosyalar veya desteklenmeyen formatlar istisnalara neden olabilir. Aramayı bir try/catch bloğuna sarmlamak 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 -- Tesseract'ın otomatik olarak tek sütunlu, çok sütunlu ve tek kelime düzenleri arasında seçim yapmasına olanak tanır
• ocr.Configuration.ReadBarCodes = false -- yalnızca metin belgeleri işliyorsanız ve daha hızlı işlem istiyorsanız barkod algılamasını devre dışı bırakır
• ocr.Configuration.TesseractVersion = TesseractVersion.Tesseract5 -- mevcut en hızlı motorun kullanıldığından emin olur

Alanların tahmin edilebilir konumlarda göründüğü yapılandırılmış formlar için, sadece önemli bölgeleri 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

Tanımayı bir kırpma dikdörtgeni ile sınırlamak, büyük görüntülerde işlem süresini yüzde 90'a kadar azaltır. Bu teknik, fatura numarası çıkarımı, form alanı okuma ve kimlik belgesi tarama için iyi uyarlanmıştır. Bölge OCR nasıl yapılır rehberinde daha fazla detay var.

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

Taranmış resim arşivlerini aranabilir PDF dosyalarına dönüştürmek, en yüksek değerli OCR kullanım durumlarından biridir. Elde edilen dosya, orijinal görsel görünümü korurken, PDF görüntüleyiciler, arama motorları ve ekran okuyucuların endeksleyebileceği görünmez bir metin katmanını gömer.

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

Barkodları Metinle Birlikte Nasıl Okursunuz?

IronOCR, matbu metinle aynı görüntüde gömülü olan barkodları ve QR kodlarını okuyabilir, ayrı bir barkod kütüphanesi çalıştırma gerekliliğini ortadan kaldırır. Tek bir yapılandırma özelliği ile özelliği 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 rehberinde tam detaylar mevcuttur.

Bu yetenek, hem insan tarafından okunabilir metin hem de makine tarafından okunabilir barkodlar taşıyan nakliye etiketleri, hasta bileklikleri ve ürün etiketleri barındıran lojistik, sağlıksızlık ve perakende uygulamalarında özellikle kullanışlıdır.

IronOCR'u Diğer .NET OCR Seçenekleriyle Nasıl Karşılaştırırsınız?

.NET için OCR kütüphanelerini değerlendiren geliştiriciler genellikle IronOCR, Tesseract.NET ve Google Cloud Vision veya Azure Computer Vision gibi bulut hizmetlerini dikkate alır. Aşağıdaki tablo, önemli farkları özetlemektedir:

Tesseract, Google tarafından açık kaynaklı bir proje olarak korunurken, IronOCR ve Tesseract.NET'e güç verir. IronOCR, .NET'e özgü paketleme, otomatik model yönetimi ve arama motoru PDF, hOCR dışa aktarma gibi ham Tesseract sarmalayıcılarının eksik olduğu üretim çıktı özelliklerini ekler. Azure Computer Vision, en son bulut doğruluğunu sağlar, ancak ağ gecikmesi ve yüksek hacimli veya çevrimdışı iş akışları için uygun olmayan çağrı başına maliyetler getirir.

Veri gizliliği düzenlemelerinin belgelerin harici hizmetlere gönderilmesini yasakladığı senaryolar için - sağlık kayıtları, yasal belgeler, finansal tablolar - IronOCR gibi bir yerleşik kütüphane uygun seçimdir.

Sıradaki Adımlarınız Neler?

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

Derinlemesine dalmak için, bu IronOCR kaynaklarını keşfedin:

• IronOCR dokümantasyon ana sayfası -- tam API referansı ve özellik kılavuzları
• Görüntü filtresi eğitimi -- tüm ön işleme filtrelerine yönelik ayrıntılı kılavuz
• Barkod okuma kılavuzu -- metinle birlikte QR kodları ve doğrusal barkodlar
• Bölge OCR nasıl yapılır -- form ve kimlikler için kırpma tabanlı tanıma
• Diller referansı -- desteklenen 125+ dilin tam listesi
• API referansı -- tüm sınıflar, yöntemler ve özellikler

Lisanslama soruları için veya IronOCR'yi bir üretim ortamına dağıtmak için IronOCR lisans sayfasını ziyaret edin. Bir ücretsiz deneme lisansı değerlendirme döneminizde çıktı su işaretlerini kaldırır ve Iron Software'in destek ekibi herhangi bir katmanda teknik sorular için hazırdır.

Şimdi IronOCR ile başlayın.

Ücretsiz Başlayın