OCR C# GitHub: IronOCR ile Metin Tanıma

[13] IronOCR, C# GitHub projelerinde OCR entegrasyonunu tek bir DLL çözümü ile 99.8% doğrulukla, yerleşik ön işleme ve 125+ dil desteği ile basitleştirir ve ham Tesseract uygulamalarının gerektirdiği karmaşık yapılandırmayı ortadan kaldırır.

Şimdi IronOCR ile başlayın.

Ücretsiz Başlayın

[14] GitHub üzerinde OCR seçeneklerini keşfeden bir C# geliştiricisiyseniz, muhtemelen sadece koda ihtiyaçınız yoktur. [15] Kutu dışından çalışan, çalıştırılabilir örneklerle gelen ve arkasında aktif bir topluluk bulunan bir kütüphane istersiniz. [16] Güvenilir entegrasyon ve sağlam sürüm kontrolü, doğruluk kadar önemlidir. [17] Bu kılavuz, IronOCR'yi GitHub projelerinize nasıl ekleyeceğinizi, böylece resimlerde ve PDF'lerde metin tanımayı güvenle yapabileceğinizi anlatır.

[18] Amacınız düz metin çıkarmak, yapılandırılmış kelime ve satırları çekmek veya arşivlemek için aranabilir PDF'ler oluşturmak olsun, IronOCR size yardımcı olur. [19] Kütüphane, 125+ dilde çok dilli OCR'a kadar her şeyi destekler.

[20] ## IronOCR ve GitHub ile Başlamanın Yolları

[21] IronOCR, GitHub tabanlı geliştirme iş akışlarına doğal olarak uyan bir .NET OCR çözümüdür. [22] Karmaşık yapılandırma gerektiren ham Tesseract uygulamalarının aksine, IronOCR birkaç dakika içinde çalışmanızı sağlayan bir iyileştirilmiş API sunar.

[23] Optik karakter tanımaya yeni başlayanlar için, IronOCR'un dokümantasyonu, temel metin çıkarımından gelişmiş görüntü işleme kadar her şeyi kapsar. [24] Kütüphane, aksi takdirde önemli ölçüde manuel ayarlama gerektirecek görüntü filtreleri ve OCR optimizasyon teknikleri için yerleşik destek içerir.

[25] Geliştiricilerin IronOCR'u GitHub projeleri için tercih etmelerinin bir nedeni de öngörülebilirliktir. [26] Bir katkıda bulunan kişinin deponuzu klonlayıp projenizi çalıştırdığında, OCR motoru kendi bilgisayarında aynı şekilde davranmalıdır. IronOCR'un kendi içinde barındırılan mimarisi, depodaki platforma özgü yerel ikili dosyaları sabitlemeden bunu mümkün kılar.

[27] ### Hangi Yükleme Yöntemini Kullanmalı?

[28] IronOCR'yi NuGet Paket Yöneticisi aracılığıyla yükleyerek başlayın:

Install-Package IronOcr

NuGet ile Yükle

PM >  Install-Package IronOcr

IronOCR üzerine NuGet için hızlı bir kurulum kontrol edin. 10 milyondan fazla indirme ile C# ile PDF geliştirmesini dönüştürüyor. DLL veya Windows yükleyicisini de indirebilirsiniz.

[30] İleri düzey yükleme senaryoları için NuGet paketleri kılavuzuna danışın. [31] Belirli platformlara dağıtım yapıyorsanız, Windows, Linux, macOS veya Docker konteynerleri için kılavuzları inceleyin.

[32] ### Örnek Kod Nerede Bulunur?

[33] IronOCR, örnekler ve öğreticiler içeren resmi GitHub depolarını sürdürmektedir. [34] IronOCR Örnekleri deposu, gerçek dünya uygulamalarını sağlar, Görüntüden Metin eğitimi deposu ise klonlanıp değiştirilebilecek pratik kullanım durumlarını sergiler.

[35] Bu depolar, barkod okuma, çok dilli destek ve PDF işleme ile OCR'ı sergiler. [36] IronOCR, NuGet üzerinde sık sık paket yayınladığı için her zaman en son kararlı sürümlere erişiminiz olacaktır.

[38] ## GitHub'da İlk OCR Projenizi Nasıl Oluşturursunuz?

[39] GitHub'da paylaşmaya uygun bir OCR uygulaması oluşturmak, katkıda bulunan kişilerin hemen gezinebileceği tutarlı bir yapı gerektirir. [40] Visual Studio'da (veya tercih ettiğiniz IDE'de), OCR geliştirme için yerleşik kuralları takip eden yeni bir konsol uygulaması oluşturun.

[41] ### Hangi Proje Yapısını Kullanmalısınız?

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

[42] Bu yapı, JPG, PNG, TIFF ve BMP dahil olmak üzere çeşitli giriş formatlarını destekler. Çok sayfalı TIFF'ler veya GIF dosyalarını işlerken, IronOCR bunları otomatik olarak ele alır.

images/ klasörü örnek dosyaları düzenleyerek katılımcıların test görüntülerini ana dizini düzensizleştirmeden eklemesini kolaylaştırır. src/ klasörünü yapılandırma dosyalarından ayrı tutmak, projeyi bir bakışta okumayı kolaylaştırır. Projenin ne yaptığını, ayarlanacak lisans anahtar değişkenini ve örneğin nasıl çalıştırılacağını açıklayan bir README.md ekleyin.

[46] ### OCR İşleme Kodunu Nasıl Uygularsınız?

[47] Aşağıdaki örnek, IronOCR'un ana özelliklerini içeren bir OCR işlemcisini gösterir, bunlar arasında görüntü ön işleme, metin çıkarımı ve barkod tespiti bulunur:

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

[48] Bu örnek, IronOCR'un birkaç yeteneğini sergiler. [49] Yapıcı, barkod okuma etkinleştirilmiş ve otomatik sayfa segmentasyonu ile OCR motorunu yapılandırır. [50] Ön işleme hattı, döndürmeyi düzeltme (deskewing), gürültüyü giderme (denoising) ve çözünürlük iyileştirme işlemlerini gösterir.

[51] İşleme sonrasında, motor İngilizce metinleri güven skorlarıyla çıkarır, barkodları tanımlar ve aranabilir bir PDF oluşturur. [52] Kod, .NET 10 için üst düzey ifadeler kullanılarak yazılmıştır, örneği kısa ve okunabilir tutar.

[53] Gelişmiş senaryolar için, daha iyi verim sağlamak amacıyla 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 olmak üzere detaylı çıktı sağlar -- size düz bir metin dizesinden çok daha fazlasını verir.

[55] Geliştiriciler, IronOCR'u Çince, İspanyolca veya Fransızca gibi diğer dilleri okuyacak şekilde yapılandırabilir, bu da onu çok dilli GitHub projeleri için güçlü bir seçenek haline getirir. [56] Ek dil paketlerinin yüklenmesi ile ilgili referanslar için, 125 uluslararası dil kılavuzuna başvurun.

[58] ### .gitignore Dosyanıza Neleri Eklemelisiniz?

[59] .gitignore dosyanız için, çalıştırma eserlerini, test çıktıları ve gizli yapılandırma dosyalarının taahhüt edilmesini önleyen girdi ekleyin:

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

runtimes/ klasörünü kaynak kontrolünden ayrı tutmak özellikle önemlidir çünkü IronOCR, derleme sırasında platforma özgü ikili dosyalar indirir. Bunları yüklemek dağıtım dizininizi şişirip platform çatışmaları yaratır. [61] Doğru uygulama için lisans anahtarı yönetimini öğrenin.

[62] ## Neden GitHub Projeleriniz için IronOCR'yi Seçmelisiniz?

[63] IronOCR, GitHub üzerinde sürdürülmesi gereken OCR projeleri için geliştiricilere belirgin avantajlar sunar. [64] Kütüphane, kutu dışından, el ile eğitim veya depoları karmaşaya sokan karmaşık yapılandırma dosyaları gerektirmeden %99,8 doğruluk elde eder. [65] 125+ dil desteği ile, GitHub projeniz uluslararası kullanıcılar için değişiklik gerektirmeden hizmet verebilir.

[66] Uyumluluk özellikleri, Windows, Linux, macOS ve Azure gibi bulut platformları ile AWS arasında çapraz platform dağıtımını garanti eder. [67] Farklı işletim sistemlerinde çalışabilecek katkıda bulunanların bulunduğu açık kaynak ve ekip projeleri için bu çapraz platform hikayesi kritiktir.

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

[69] IronOCR, her taramadan ne kadar detay çıkaracağınız üzerine size hassas kontrol sağlayarak, bireysel kelimeleri, satırları ve tüm paragrafları tanıyacak kadar esnek bir yapıya sahiptir. [70] Kütüphane, plakalar, pasaportlar, el yazısı metinler, ekran görüntüleri ve taranmış belgeler gibi özel belge türlerinde başarılıdır.

[71] Ticari lisans, kamu depoları için yasal netlik sağlar. [72] IronOCR'yi ticari uygulamalara dahil etmenize açıkça izin verilmiştir. [73] Yerleşik görüntü ön işleme filtreleri, renk düzeltme, kalite iyileştirme ve zorlu görüntüler için otomatik olarak en iyi ayarları bulan bir Filtre Sihirbazı gibi gelişmiş seçenekler içerir.

[74] ### Tek DLL Mimarisinin Önemi Nedir?

[75] IronOCR'un tek DLL mimarisi, katkıda bulunan kişilerin deponuzu klonlayıp anında geliştirmeye başlamasını sağlar, diğer OCR çözümlerinin karşılaştığı yerel bağımlılıklar veya platforma özgü yapılandırmalarla boğuşmalarını gerektirmez. [76] Bu basitlik, geliştiricilerin ham Tesseract yerine IronOCR'yi tercih etme nedenidir.

[77] Kurulum deneyimini karşılaştırdığınızda, bir ham Tesseract uygulaması genellikle yerel ikili dosyaların ayrı olarak yüklenmesini, PATH değişkenlerinin yapılandırılmasını ve tessdata dil dosyalarının elle yönetilmesini gerektirir. [78] IronOCR tüm bunları dahili olarak halleder, bu da projenizin README'sinin çevre ayarlama talimatları yerine uygulama mantığınıza odaklanmasına olanak tanır.

[79] Kütüphane, Tesseract 5'i içerir ve çoklu iş parçacığı desteği ile birlikte performans iyileştirmeleri, birden fazla belgenin paralel olarak işlenmesine olanak tanır, özel iş parçacığı kodu yazmanıza gerek kalmadan.

[80] ## OCR Projeleri için Sürüm Kontrolü En İyi Uygulamaları Nelerdir?

[81] GitHub üzerinde OCR projelerini yönetmek, tipik yazılım projelerinin karşılaşmadığı birkaç zorlukla karşılaşmanıza neden olur. [82] Test görüntüleri genellikle büyük ikili dosyalardır, lisans anahtarları hiçbir zaman taahhütlerde görülmemelidir ve ön işleme yapılandırmaları ortamlara göre önemli ölçüde değişebilir.

[83] Bunları erkenden ele almak, ekip ile çalışırken veya katkıda bulunanlardan gelen çekme isteklerini kabul ederken daha az sürprizle karşılaşmanız anlamına gelir. [84] Aşağıdaki uygulamalar, OCR projenizi zamanla temiz ve sürdürülebilir tutar.

[85] ### Git'te Büyük Dosyalar Nasıl Ele Alınır?

[86] Depo boyutunuzu yönetilebilir tutmak için büyük test görüntüleri 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"

[87] Bu, özellikle yüksek çözünürlüklü görüntüler veya çok sayfalı TIFF dosyaları ile çalışırken önemlidir. [88] Düşük kaliteli taramalar için, IronOCR'un ön işleme aşaması, onları taahhüt etmeden önce test görüntülerini elle düzenlemeniz gerekmeksizin sonuçları önemli ölçüde iyileştirebilir.

[89] Test belgeleri deponuzda saklarken, hassas bilgiler içerip içermediklerini göz önünde bulundurun. [90] Gerçek faturaları veya kimlik belgelerini, hatta özel depolarda dahi, taahhüt etmektense, sentetik test görüntülerini programlı olarak üretmek daha iyidir.

[91] ### Lisans Anahtarlarını ve Dokümantasyonu Nasıl Yönetmelisiniz?

[92] IronOCR lisans anahtarlarını ortam değişkenleri veya .NET kullanıcı sırları kullanarak saklayın. [93] Bunları herhangi bir şubeye, hatta özel olanlara bile doğrudan taahhüt etmeyin. [94] Doğru uygulama için lisans anahtarı kılavuzunu izleyin. [95] ASP.NET uygulamaları için web.config içinde lisansları da yapılandırabilirsiniz.

[96] README'nizde desteklenen görüntü formatlarını ve beklenen doğruluk seviyelerini belgeleyin. Katkı sağlayıcıların klonlamadan hemen sonra OCR işlevselliğini doğrulayabilmeleri için örnek görüntüleri bir test-data/ klasörüne dahil edin. [98] Yeni katkıda bulunanların ilk çalıştırmalarında engellenmemesi için, lisans anahtarını ortam değişkeni aracılığıyla nasıl ayarlayacaklarına dair kısa bir bölüm ekleyin.

[99] Çapraz platform geliştirme için, IronOCR Linux kurulum kılavuzuna veya macOS kurulum talimatlarına bakın. [100] Mobil geliştiriciler, IronOCR dokümantasyonunda bulunan Android ve iOS kılavuzlarını kontrol etmelidirler.