.NET'de Aspose.OCR FOSS Core API ile nasıl çalışılır

Aspose.OCR FOSS for .NET, raster görüntüler ve PDF belgelerindeki metni küçük bir core API aracılığıyla tanır: AsposeOcr, OcrInput, OcrOutput ve RecognitionResult. Bu kılavuz, paketin kurulumu ve bu core API’nin uçtan uca kullanımıyla ilgili adımları gösterir.

Adım Adım Kılavuz

Adım 1: Paketi Kur

dotnet add package Aspose.OCR.FOSS

Adım 2: Ad Alanını İçe Aktar

Aspose.OCR ad alanını, AsposeOcr, OcrInput veya RecognitionResult çağıran herhangi bir kaynak dosyasına ekleyin:

using Aspose.OCR;

Bu tek ad alanı AsposeOcr, OcrInput, OcrOutput, InputType ve RecognitionResult öğelerini sunar.

Adım 3: Bir OcrInput oluşturun ve bir Görüntüyü Tanıyın

Bir AsposeOcr oluşturun, InputType.SingleImage ile bir OcrInput oluşturun, OcrInput.Add() ile bir dosyayı kuyruğa ekleyin ve AsposeOcr.Recognize() çağırın.

var api = new AsposeOcr();
using var input = new OcrInput(InputType.SingleImage);
input.Add("scan.png");
RecognitionResult result = api.Recognize(input)[0];
Console.WriteLine(result.RecognitionText);

Adım 4: Tek Tek Satırları ve Sınır Kutularını Okuyun

RecognitionLinesResult içindeki her RecognitionResult.LinesResult girişi bir satırın metnini (TextInLine) ve piksel koordinatlı sınırlama kutusunu (Line) tutar.

foreach (RecognitionResult.LinesResult line in result.RecognitionLinesResult)
{
    System.Drawing.Rectangle bounds = line.Line;
    Console.WriteLine($"x={bounds.X}, y={bounds.Y}: {line.TextInLine}");
}

Adım 5: Çok Sayfalı bir PDF’i Tanıyın

InputType.PDF için, AsposeOcr.Recognize() kaynak sırasına göre sayfa başına bir RecognitionResult döndürür.

using var pdfInput = new OcrInput(InputType.PDF);
pdfInput.Add("document.pdf");
OcrOutput output = api.Recognize(pdfInput);

foreach (RecognitionResult page in output)
{
    Console.WriteLine(page.RecognitionText);
}

Yaygın Sorunlar ve Çözümler

NotSupportedException çağırırken Recognize(). Bu OcrInput giriş türü … dışındaki bir giriş türüyle oluşturuldu InputType.SingleImage or InputType.PDF. Yalnızca bu iki giriş türü desteklenir.

FileNotFoundException çağırırken Recognize(). Şu yol aracılığıyla eklenen OcrInput.Add() diskte mevcut değil. Çağırmadan önce yolu doğrulayın Add().

ArgumentNullException çağırırken Recognize(). null bir … yerine geçirildi OcrInput örnek. Her zaman bir … oluşturun OcrInput ilk.

Empty RecognitionLinesResult. Hiç metin satırı algılanmadı — kaynak görüntünün okunaklı, döndürülmemiş Latin alfabesi metni içerdiğini doğrulayın.

Sıkça Sorulan Sorular

OcrOutput dosya sırasını korur mu?

Evet. OcrOutput, RecognitionResult listesi olup, her görüntü (veya PDF sayfası) başına bir tane, dosyaların OcrInput.Add() aracılığıyla eklenme sırasına göre sıralanmıştır.

OcrInput öğesini bertaraf etmem gerekiyor mu?

Evet — OcrInput, IDisposable uygular. Tanıma tamamlandığında bir using ifadesi kullanın veya Dispose() öğesini açıkça çağırın.

Aynı OcrInput içinde hem görüntüleri hem de PDF’leri işleyebilir miyim?

Hayır — her OcrInput, tek bir InputType (SingleImage veya PDF) ile oluşturulur ve yalnızca o türdeki dosyaları kabul eder.