Aspose.OCR FOSS for .NET — Pemecahan Masalah
Halaman ini mencantumkan kesalahan dan keterbatasan yang paling mungkin muncul saat mengintegrasikan Aspose.OCR FOSS untuk .NET, dengan penyebab sebenarnya di balik masing-masing.
Pengecualian yang Dilempar oleh Recognize()
AsposeOcr.Recognize() memvalidasi inputnya sebelum model apa pun dijalankan. Setiap pemeriksaan di bawah ini gagal dalam urutan berikut:
| Exception | Penyebab | Perbaikan |
|---|---|---|
ArgumentNullException | OcrInput yang diteruskan ke Recognize() adalah null | Selalu buat OcrInput sebelum memanggil Recognize() |
NotSupportedException | OcrInput dibangun dengan InputType selain SingleImage atau PDF | Hanya InputType.SingleImage dan InputType.PDF yang valid |
FileNotFoundException | Jalur yang ditambahkan melalui OcrInput.Add() tidak ada di disk | Validasi setiap jalur sebelum memanggil Add() — file yang hilang menyebabkan seluruh pemanggilan gagal, bukan hanya file tersebut |
Pengakuan Tidak Mengembalikan Teks
Jika RecognitionResult.RecognitionText kosong dan RecognitionLinesResult tidak memiliki entri, detektor tidak menemukan wilayah baris teks dalam gambar. Ini diharapkan — bukan bug — untuk:
- Gambar tanpa teks yang dapat dibaca, atau teks yang terlalu kecil, diputar, atau kontras rendah sehingga detektor tidak dapat mengenali sebagai wilayah
- Skrip Non-Latin: model pengenalan yang tertanam hanya mencakup teks beraksara Latin dan karakter diakritiknya
- Gambar di mana wilayah yang terdeteksi disaring keluar selama pasca-pemrosesan (skor probabilitas teks sangat rendah)
Tidak ada skor kepercayaan yang ditampilkan untuk membedakan “tidak ada yang terdeteksi” dari “terdeteksi tetapi tidak pasti” — lihat Ruang Lingkup dan Batasan.
Pengakuan Berjalan Namun Hasil Terlihat Salah
- Teks yang diputar atau miring. Tidak ada deskewing atau koreksi rotasi otomatis. Putar terlebih dahulu gambar sumber sebelum memanggil
Recognize(). - Tata letak tabel atau formulir terlihat berantakan. Detektor hanya mengembalikan persegi panjang garis yang sejajar sumbu — ia tidak memiliki konsep kolom, tabel, atau urutan membaca selain posisi garis. Merekonstruksi tata letak adalah tanggung jawab pemanggil.
- Posisi teks PDF tampak bergeser. Halaman PDF selalu dirender pada 150 DPI secara internal; koordinat persegi panjang dalam
RecognitionResult.LinesResult.Lineada dalam ruang piksel gambar yang dirender tersebut, bukan ruang poin PDF.
Masalah Platform dan Build
PlatformNotSupportedExceptionatau serupa pada waktu berjalan di Linux/macOS. Pemrosesan gambar bergantung padaSystem.Drawing.Common, yang hanya tersedia untuk Windows pada .NET 6 dan versi selanjutnya. Jalur pemrosesan gambar perpustakaan ini hanya berjalan di Windows.- Pembangunan gagal menargetkan
net9.0/net10.0. Membangun target tersebut memerlukan SDK .NET 10 — lihat Cara Membuat dari Sumber. - Mixing
InputType.SingleImageandInputType.PDFdalam satuOcrInput. Tidak didukung — lihat Cara Memproses Beberapa Gambar Secara Batch.
