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 pernyataan using) setelah pengenalan selesai untuk melepaskan sumber daya yang mendasarinya.
  • Hanya InputType.SingleImage dan InputType.PDF yang didukung — tipe masukan lain akan menyebabkan NotSupportedException.
  • 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

MasalahPenyebabPerbaikan
NotSupportedException pada Recognize()Sebuah OcrInput dibangun dengan InputType yang tidak didukungGunakan hanya InputType.SingleImage atau InputType.PDF
FileNotFoundException pada Recognize()Jalur yang ditambahkan melalui OcrInput.Add() tidak adaVerifikasi jalur file sebelum memanggil Add()
Kosong RecognitionLinesResultTidak ada baris teks yang terdeteksi dalam gambar atau halaman tersebutPastikan 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/MetodeDeskripsi
AsposeOcr.Recognize(OcrInput)Titik masuk: mengenali teks dan mengembalikan sebuah OcrOutput
OcrInput.Add(string)Mengantri jalur berkas untuk pengenalan
InputTypeEnum: SingleImage atau PDF
RecognitionResult.RecognitionTextTeks halaman yang dikenali secara lengkap
RecognitionResult.RecognitionLinesResultDaftar baris yang dikenali beserta kotak pembatas
RecognitionResult.LinesResult.TextInLineTeks yang dikenali untuk satu baris
RecognitionResult.LinesResult.LineKotak pembatas berkoordinat piksel untuk satu baris

Lihat Juga

 Bahasa Indonesia