Özellikler Genel Bakış
Özellikler Genel Bakışı
Bu sayfa, kütüphanenin tanıma API ve bu kılavuzun başka bir yerinde ayrıntılı olarak ele alınan yetenekleri tanıtır. AsposeOcr tüm kütüphane için giriş noktasıdır. AsposeOcr‘un Recognize() yöntemi bir OcrInput kabul eder ve bir OcrOutput döndürür — her görüntü veya PDF sayfası başına bir RecognitionResult listesi.
Tek Görüntü ve PDF Tanıma
OcrInput, bir InputType ile oluşturulur — raster görüntü için InputType.SingleImage, veya PDF belge için InputType.PDF. Dosyalar OcrInput.Add() ile kuyruğa alınır. OcrInput‘i iptal etmek yalnızca içinde tuttuğu kuyruğa alınmış dosya yollarını temizler.
using Aspose.OCR;
var api = new AsposeOcr();
using var input = new OcrInput(InputType.PDF);
input.Add("document.pdf");
OcrOutput output = api.Recognize(input);Tanıma Sonuçları
Her RecognitionResult, RecognitionText (tam tanınan sayfa metni) ve RecognitionLinesResult (her biri TextInLine ve System.Drawing.Rectangle sınırlayıcı kutusuna sahip RecognitionResult.LinesResult listesi) sunar.
foreach (RecognitionResult page in output)
{
Console.WriteLine(page.RecognitionText);
foreach (RecognitionResult.LinesResult line in page.RecognitionLinesResult)
{
Console.WriteLine($"{line.Line}: {line.TextInLine}");
}
}Toplu İşleme
OcrInput aynı giriş türünden birden fazla dosyayı kabul eder. OcrOutput, dosyaların eklendiği sırayı korur ve dosya başına (veya PDF sayfası başına) bir RecognitionResult sağlar.
using var input = new OcrInput(InputType.SingleImage);
input.Add("page-1.jpg");
input.Add("page-2.png");
OcrOutput output = api.Recognize(input);İpuçları ve En İyi Uygulamalar
- Tanıma tamamlandığında
OcrInput‘ı serbest bırakın (veya birusingifadesi içinde sarın) böylece temel kaynaklar serbest bırakılır. - Yalnızca
InputType.SingleImageveInputType.PDFdesteklenir — diğer tüm giriş türleriNotSupportedExceptionhatası verir. - Tanıma yalnızca Latin alfabesi için geçerlidir; dil seçimi parametresi yoktur.
- PDF sayfaları tanımadan önce dahili olarak işlenir, bu yüzden ayrı bir PDF-to-image dönüştürme adımına ihtiyaç yoktur.
Yaygın Sorunlar
| Sorun | Neden | Düzeltme |
|---|---|---|
NotSupportedException Recognize() üzerinde | Bir OcrInput, desteklenmeyen bir InputType ile oluşturuldu. | Yalnızca InputType.SingleImage veya InputType.PDF kullanın. |
FileNotFoundException Recognize() üzerinde | OcrInput.Add() aracılığıyla eklenen bir yol mevcut değil. | Dosya yolunu Add() çağırmadan önce doğrulayın |
Boş RecognitionLinesResult | Bu görüntüde veya sayfada metin satırı tespit edilmedi. | Kaynak görüntünün okunaklı, döndürülmemiş Latin alfabesi metni içerdiğini doğrulayın. |
FAQ
Hangi dilleri Aspose.OCR .NET için FOSS tanıyor?
Latin alfabesi metni. Gömülü tanıma modeli Latin dışı alfabeleri kapsamaz.
İnternet bağlantısı gerekiyor mu?
Hayır. Tüm üç ONNX modeli (algılama, iyileştirme, tanıma) derlemede gömülüdür ve Microsoft.ML.OnnxRuntime aracılığıyla yerel olarak çalıştırılır.
Tek bir çağrıda birden fazla dosyayı tanıyabilir miyim?
Evet — AsposeOcr.Recognize() çağırmadan önce aynı OcrInput‘a birden fazla dosya ekleyin. Döndürülen OcrOutput sıralarını korur.
Bu hangi platformlarda çalışıyor?
Hedefi .NET Standard 2.0, .NET Framework 4.8 ve .NET 8.0+. Görüntü işleme, System.Drawing.Common‘a bağımlı olduğu için Windows gerektirir.
API Reference Özet
| Sınıf/Yöntem | Açıklama |
|---|---|
AsposeOcr.Recognize(OcrInput) | Giriş noktası: metni tanır ve bir OcrOutput döndürür. |
OcrInput.Add(string) | Bir dosya yolunu tanıma için kuyruğa ekler |
InputType | Enum: SingleImage veya PDF |
RecognitionResult.RecognitionText | Tam tanınmış sayfa metni |
RecognitionResult.RecognitionLinesResult | Sınır kutuları ile tanınan satırların listesi |
RecognitionResult.LinesResult.TextInLine | Bir satır için tanınan metin |
RecognitionResult.LinesResult.Line | Bir satır için piksel koordinatlı sınırlama kutusu |