Ikhtisar Fitur
Ikhtisar Fitur
Halaman ini memperkenalkan API pengenalan perpustakaan dan kapabilitas yang dibahas secara mendalam di bagian lain panduan ini. AsposeOcr adalah titik masuk untuk seluruh perpustakaan. Metode Recognize()-nya menerima OcrInput dan mengembalikan OcrOutput — sebuah daftar RecognitionResult, satu per gambar atau halaman PDF.
Pengenalan Gambar Tunggal dan PDF
OcrInput dibangun dengan InputType — InputType.SingleImage untuk gambar raster, atau InputType.PDF untuk dokumen PDF. File dimasukkan ke antrean dengan OcrInput.Add(). Membuang OcrInput hanya menghapus jalur file yang berada dalam antrean.
using Aspose.OCR;
var api = new AsposeOcr();
using var input = new OcrInput(InputType.PDF);
input.Add("document.pdf");
OcrOutput output = api.Recognize(input);Hasil Pengenalan
Setiap RecognitionResult menampilkan RecognitionText (teks halaman lengkap yang dikenali) dan RecognitionLinesResult (daftar RecognitionResult.LinesResult, masing-masing dengan TextInLine dan kotak pembatas System.Drawing.Rectangle dalam Line).
foreach (RecognitionResult page in output)
{
Console.WriteLine(page.RecognitionText);
foreach (RecognitionResult.LinesResult line in page.RecognitionLinesResult)
{
Console.WriteLine($"{line.Line}: {line.TextInLine}");
}
}Pemrosesan Batch
OcrInput menerima lebih dari satu file dengan tipe masukan yang sama. OcrOutput mempertahankan urutan file yang ditambahkan, dengan satu RecognitionResult per file (atau per halaman PDF).
using var input = new OcrInput(InputType.SingleImage);
input.Add("page-1.jpg");
input.Add("page-2.png");
OcrOutput output = api.Recognize(input);Tips dan Praktik Terbaik
- Hapus
OcrInput(atau bungkus dalam pernyataanusing) setelah pengenalan selesai untuk melepaskan sumber daya yang mendasarinya. - Hanya
InputType.SingleImagedanInputType.PDFyang didukung — tipe masukan lain akan menyebabkanNotSupportedException. - Pengenalan hanya untuk skrip Latin; tidak ada parameter pemilihan bahasa.
- Halaman PDF dirender secara internal sebelum pengenalan, sehingga tidak diperlukan langkah konversi PDF-ke-gambar terpisah.
Masalah Umum
| Masalah | Penyebab | Perbaikan |
|---|---|---|
NotSupportedException pada Recognize() | Sebuah OcrInput dibangun dengan InputType yang tidak didukung | Gunakan hanya InputType.SingleImage atau InputType.PDF |
FileNotFoundException pada Recognize() | Jalur yang ditambahkan melalui OcrInput.Add() tidak ada | Verifikasi jalur file sebelum memanggil Add() |
Kosong RecognitionLinesResult | Tidak ada baris teks yang terdeteksi dalam gambar atau halaman tersebut | Pastikan gambar sumber berisi teks beraksara Latin yang dapat dibaca dan tidak diputar |
FAQ
Bahasa apa yang dikenali oleh Aspose.OCR FOSS untuk .NET?
Teks beraksara Latin. Model pengenalan yang disematkan tidak mencakup aksara non-Latin.
Apakah itu memerlukan koneksi internet?
Tidak. Semua tiga model ONNX (deteksi, penyempurnaan, pengenalan) disematkan dalam assembly dan dijalankan secara lokal melalui Microsoft.ML.OnnxRuntime.
Apakah saya dapat mengenali beberapa file dalam satu panggilan?
Ya — tambahkan beberapa file ke OcrInput yang sama sebelum memanggil AsposeOcr.Recognize(). OcrOutput yang dikembalikan mempertahankan urutannya.
Platform apa yang dapat menjalankan ini?
Ini menargetkan .NET Standard 2.0, .NET Framework 4.8, dan .NET 8.0+. Pemrosesan gambar memerlukan Windows, karena bergantung pada System.Drawing.Common.
API Reference Ringkasan
| Kelas/Metode | Deskripsi |
|---|---|
AsposeOcr.Recognize(OcrInput) | Titik masuk: mengenali teks dan mengembalikan sebuah OcrOutput |
OcrInput.Add(string) | Mengantri jalur berkas untuk pengenalan |
InputType | Enum: SingleImage atau PDF |
RecognitionResult.RecognitionText | Teks halaman yang dikenali secara lengkap |
RecognitionResult.RecognitionLinesResult | Daftar baris yang dikenali beserta kotak pembatas |
RecognitionResult.LinesResult.TextInLine | Teks yang dikenali untuk satu baris |
RecognitionResult.LinesResult.Line | Kotak pembatas berkoordinat piksel untuk satu baris |