Özellikler Genel Bakış

Ö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 bir using ifadesi içinde sarın) böylece temel kaynaklar serbest bırakılır.
  • Yalnızca InputType.SingleImage ve InputType.PDF desteklenir — diğer tüm giriş türleri NotSupportedException hatası 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

SorunNedenDüzeltme
NotSupportedException Recognize() üzerindeBir OcrInput, desteklenmeyen bir InputType ile oluşturuldu.Yalnızca InputType.SingleImage veya InputType.PDF kullanın.
FileNotFoundException Recognize() üzerindeOcrInput.Add() aracılığıyla eklenen bir yol mevcut değil.Dosya yolunu Add() çağırmadan önce doğrulayın
Boş RecognitionLinesResultBu 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öntemAçı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
InputTypeEnum: SingleImage veya PDF
RecognitionResult.RecognitionTextTam tanınmış sayfa metni
RecognitionResult.RecognitionLinesResultSınır kutuları ile tanınan satırların listesi
RecognitionResult.LinesResult.TextInLineBir satır için tanınan metin
RecognitionResult.LinesResult.LineBir satır için piksel koordinatlı sınırlama kutusu

Ayrıca Bakınız

 Türkçe