OCR C# GitHub: IronOCR ile Metin Tanıma

Hangi Kurulum Yöntemini Kullanmalısınız?

IronOCR'u, NuGet Paket Yöneticisi üzerinden yükleyerek başlayın:

Install-Package IronOcr

NuGet ile yükleyin

PM >  Install-Package IronOcr

NuGet'te hızlı kurulum için https://www.nuget.org/packages/IronOcr'i kontrol edin. 10 milyonun üzerinde indirme ile, C# ile PDF geliştirmeyi dönüştürüyor. DLL veya Windows yükleyici'yi de indirebilirsiniz.

Gelişmiş kurulum senaryoları için, NuGet paketleri kılavuzuna başvurun. Belirli platformlara dağıtım yapıyorsanız, Windows, Linux, macOS veya Docker konteynerleri için kılavuzları inceleyin.

Örnek Kodları Nerede Bulabilirsiniz?

IronOCR, örnekler ve öğreticiler içeren resmi GitHub depolarını sürdürür. IronOCR Örnekleri deposu, gerçek dünya uygulamaları sunarken, Görüntüden Metin ders deposu pratik kullanımlar gösterir, böylece klonlayabilir ve değiştirebilirsiniz.

Bu depolar, barkod okuma, çoklu dil desteği ve PDF işleme ile OCR'ı sergiler. IronOCR, NuGet üzerinde sık paketler yayınladığından, her zaman en son sabit sürümlere erişiminiz olacaktır.

Hangi Proje Yapısını Kullanmalısınız?

MyOcrProject/
├── src/
│   └── OcrProcessor.cs
├── images/
│   └── sample-invoice.jpg
├── .gitignore
├── README.md
└── MyOcrProject.csproj

Bu yapı, JPG, PNG, TIFF ve BMP dahil çeşitli giriş formatlarını destekler. Çok sayfalı TIFF veya GIF dosyalarını işlemek için IronOCR otomatik olarak çalışır.

images/ klasörü örnek dosyaları düzenli tutar ve katkıda bulunanların kök dizini karıştırmadan test resimleri eklemesini kolaylaştırır. src/ klasörünü yapılandırma dosyalarından ayrı tutmak, projeyi bir bakışta okunabilir kılar. Projenin ne yaptığını, hangi lisans anahtarı değişkenini ayarlayacağınızı ve örneği nasıl çalıştıracağınızı açıklayan bir README.md ekleyin.

OCR İşleme Kodunu Nasıl Uygularsınız?

Aşağıdaki örnek, IronOCR'un görüntü ön işleme, metin çıkarma ve barkod algılama dahil ana özelliklerini gösteren eksiksiz bir OCR işleyicisini gösterir:

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
ocr.Language = OcrLanguage.English;

using var input = new OcrInput();
input.LoadImage("images/sample-invoice.jpg");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(225);

var result = ocr.Read(input);

Console.WriteLine($"Confidence: {result.Confidence}%");
Console.WriteLine($"Text Found:\n{result.Text}");

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

result.SaveAsSearchablePdf("output.pdf");

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
ocr.Language = OcrLanguage.English;

using var input = new OcrInput();
input.LoadImage("images/sample-invoice.jpg");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(225);

var result = ocr.Read(input);

Console.WriteLine($"Confidence: {result.Confidence}%");
Console.WriteLine($"Text Found:\n{result.Text}");

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

result.SaveAsSearchablePdf("output.pdf");

Imports IronOcr

Dim ocr As New IronTesseract()
ocr.Configuration.ReadBarCodes = True
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto
ocr.Language = OcrLanguage.English

Using input As New OcrInput()
    input.LoadImage("images/sample-invoice.jpg")
    input.Deskew()
    input.DeNoise()
    input.EnhanceResolution(225)

    Dim result = ocr.Read(input)

    Console.WriteLine($"Confidence: {result.Confidence}%")
    Console.WriteLine($"Text Found:{Environment.NewLine}{result.Text}")

    For Each barcode In result.Barcodes
        Console.WriteLine($"Barcode: {barcode.Value} ({barcode.Format})")
    Next

    result.SaveAsSearchablePdf("output.pdf")
End Using

Bu örnek, IronOCR'un birkaç yeteneğini sergiliyor. Yapıcı, barkod okumanın etkinleştirildiği ve otomatik sayfa segmentasyonunun ayarlandığı OCR motorunu yapılandırır. Ön işleme hattı, masaüstü eğriliği (rotasyon düzeltmesi), gürültü azaltma (artefaktları kaldırma) ve çözünürlük artırma işlemlerini gösterir.

İşlemeden sonra, motor, güvenilirlik puanlarıyla birlikte İngilizce metin çıkarır, barkodları tanımlar ve aranabilir bir PDF oluşturur. Kod, örneği kısa ve okunabilir tutarak .NET 10 için üst düzey ifadeler kullanılarak yazılmıştır.

Gelişmiş senaryolar için daha iyi veri aktarı567 mı için asenkron işleme kullanabilir veya uzun süreli işlemler için ilerleme takibi uygulayabilirsiniz. OcrResult sınıfı, metin konumları, kelime koordinatları ve paragraf yapısı dahil ayrıntılı çıktı sağlar -- size düz bir metin dizisinden çok daha fazlasını sunar.

Geliştiriciler, IronOCR'yi Çince, İspanyolca veya Fransızca dahil diğer dilleri okumak için de yapılandırabilirler, bu da onu çok dilli GitHub projeleri için güçlü bir seçenek haline getirir. Ek dil paketleri yüklemeyle ilgili referanslar için, 125 uluslararası dil kılavuzuna başvurun.

.gitignore Dosyanıza Ne Eklemelisiniz?

.gitignore dosyanıza çalışma zamanı artefaktlarını, test çıktılarını ve gizli yapılandırmanın taahhüt edilmesini önleyecek girdiler ekleyin:

# IronOCR runtime files
runtimes/
# Test images and outputs
*.pdf
test-images/
output/
# License keys
appsettings.*.json

runtimes/ klasörünü kaynak kontrolünün dışında tutmak özellikle önemlidir çünkü IronOCR, derleme zamanında platforma özgü ikili dosyalar indirir. Bunları eklemek, deponuzu şişirecek ve platform çatışmaları yaratacaktır. Doğru uygulama için lisans anahtarı yönetimi hakkında daha fazla bilgi edinin.

IronOCR'u Diğer OCR Çözümlerinden Farklı Yapan Nedir?

IronOCR, her taramadan ne kadar detay çıkardığınızı hassas bir şekilde kontrol etmenize olanak tanıyan, tekil kelimeleri, satırları ve tam paragrafları tanıyacak kadar esnektir. Kütüphane, plaka, pasaport, el yazısı metin, ekran görüntüsü ve taranan belgeler gibi uzmanlaşmış belgelerde başarılıdır.

Ticari lisans, kamu depoları için yasal netlik sağlar. IronOCR'un ticari uygulamalara dahil edilmesine açıkça izin verilmektedir. Yerleşik görsel ön işleme filtreleri zorlayıcı görüntüler için optimum ayarları otomatik olarak bulan Gelişmiş seçenekler, renk düzeltmesi, kalite artırma ve Bir Filtre Sihirbazı gibi ileri düzey seçenekler içerir.

Tek-DLL Mimarisi Neden Önemlidir?

IronOCR'un tek-DLL mimarisi, katkıda bulunanlarının deponuzu klonlayıp hemen geliştirmeye başlamalarını sağlar, diğer OCR çözümlerini bozan yerel bağımlılıklar veya platforma özgü yapılandırmalarla uğraşmazlar. Bu sadeliktir, ham Tesseract yerine IronOCR seçme sebeplerinden biridir.

Kurulum deneyimini karşılaştırdığınızda, ham bir Tesseract uygulaması tipik olarak yerel ikili dosyaların ayrı ayrı yüklenmesini, PATH değişkenlerinin yapılandırılmasını ve tessdata dil dosyalarının manuel olarak yönetilmesini gerektirir. IronOCR, tüm bunları dahili olarak ele alır, bu nedenle projenizin README dosyası uygulama mantığınıza odaklanmaya devam edebilir, ortam kurulum talimatlarına değil.

Kütüphane, Tesseract 5'i çok sayıda performans iyileştirmesi ve özel iş parçacığı kodu yazmadan paralel olarak birden çok belge işlemenizi sağlayan çoklu iş parçacığı desteği ile içerir.

Git'te Büyük Dosyaları Nasıl Yönetirsiniz?

Depo boyutunu yönetilebilir tutmak için Git LFS kullanın:

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes
git commit -m "Track large image files with Git LFS"

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes
git commit -m "Track large image files with Git LFS"

Bu özellikle yüksek çözünürlüklü görüntüler veya çok sayfalı TIFF dosyaları ile çalışırken önemlidir. Düşük kaliteli taramalar için, IronOCR'un ön işlemesi, bunları taahhüt etmeden önce elle düzenlemenize gerek kalmadan sonuçları önemli ölçüde iyileştirebilir.

Test belgelerini deponuzda saklarken, içerikle duyarlı bilgileri içerip içermediklerini değerlendirın. Gerçek faturaları veya kimlik belgelerini hatta özel depoların içinde bile taahhüt etmekten ziyade, sentetik test görüntüleri programatik olarak oluşturmaktır daha iyidir.

Lisans Anahtarlarını ve Belgeleri Nasıl Yönetmelisiniz?

IronOCR lisans anahtarlarını ortam değişkenleri veya .NET kullanıcı sırlarını kullanarak saklayın. Onları doğrudan herhangi bir dalda, hatta özel olanlarda bile taahhüt etmeyin. Doğru uygulama için lisans anahtarı kılavuzuna başvurun. ASP.NET uygulamaları için lisansları web.config dosyasında da yapılandırabilirsiniz.

Desteklenen görüntü formatlarını ve beklenen doğruluk seviyelerini README dosyanızda dokümante edin. test-data/ klasöründe örnek resimler ekleyin, böylece katkıda bulunanlar, klonladıktan hemen sonra OCR işlevselliğini doğrulayabilirler. Yeni katkıda bulunanların ilk çalışmasında engellenmemeleri için, lisans anahtarını ortam değişkeni aracılığıyla nasıl ayarlayacaklarına dair kısa bir bölüm ekleyin.

Çapraz platform geliştirme için, IronOCR Linux kurulum kılavuzuna veya macOS kurulum talimatlarına başvurun. Mobil geliştiriciler IronOCR belgelerinde mevcut olan Android ve iOS kılavuzlarını kontrol etmelidir.

Windows üzerinde OCR Neden Çalışmıyor?

Yaygın kurulum sorunları Windows üzerinde eksik Visual C++ Redistributables içerir. IronOCR 2019 sürümünü gerektirir. Detaylı rehberlik için Visual C++ Redistributable sorun giderme kılavuzuna bakın. Linux dağıtımları için, libgdiplus'un yüklü olması gerektiğini unutmayın.

Metin tanımanın düşük olduğunu düşünüyorsanız, görüntülerinizin en az 200 DPI olduğundan emin olun. Daha fazla bilgi için DPI ayarları kılavuzuna başvurun. C# OCR topluluğu Stack Overflow 'da yaygın GitHub proje sorunları için yararlı çözümler sunar.

Özellikle konfigürasyon sorunları için IronOCR yardımcı fiil aracını kullanarak problemleri teşhis edin ve genel sorun giderme kılavuzunda adım adım teşhis için kullanın.

Ek Destek Nereden Alabilirsiniz?

Ayrıntılı sorun giderme için, IronOCR sorun giderme kılavuzuna danışın. IronOCR destek ekibi, GitHub barındırılan OCR uygulamalarda çalışan lisanslı kullanıcılara hızlı yardım sağlar. Ürün değişiklik kütüğü 'nu en son güncellemeler için kontrol edin.