Pengenalan Tinta

Tidak semua aplikasi memerlukan penggunaan pengenalan, tetapi karena sebagian besar aplikasi dirancang dengan teks sebagai jenis data utamanya, kemampuan untuk mengonversi tinta menjadi teks sangat berharga. Anda dapat menggunakan fitur pengenalan API platform PC Tablet untuk mengkueri informasi tentang mesin pengenalan yang tersedia, seperti bahasa apa yang mereka kenali. Anda kemudian dapat mengirim koleksi Strokes dari objek Tinta ke mesin pengenalan dan memintanya mengembalikan objek RecognitionResult .

Objek RecognizerContext

Objek RecognizerContext adalah instansiasi pengenal yang diberikan. Objek RecognizerContext memungkinkan Anda mengenali koleksi stroke tertentu secara sinkron atau asinkron. Saat mengenali secara asinkron, objek RecognizerContext mengembalikan objek RecognitionResult dalam panggilan balik peristiwa ke aplikasi.

Objek Recognizer dan Recognizer

SATU PC Tablet mungkin memiliki satu atau beberapa pengenal yang tersedia. Anda dapat mengkueri koleksi pengenal untuk menentukan pengenal mana yang akan digunakan. Recognizer menyediakan informasi spesifik tentang kemampuannya seperti bahasa yang dapat dikenali dan produsen.

Untuk menentukan apakah setidaknya satu pengenal diinstal, buat instans objek InkRecognizerContext seperti yang ditunjukkan pada contoh kode C++ dan C# berikut. Jika recognizer tidak ada, panggilan ke CoCreateInstance ini gagal.

CComPtr<IInkRecognizerContext> g_pIInkRecoContext;
hr = CoCreateInstance(CLSID_InkRecognizerContext, 
      NULL, CLSCTX_INPROC_SERVER,
      IID_IInkRecognizerContext, 
(void **) &g_pIInkRecoContext);
if (FAILED(hr)) 
{
      ::MessageBox(NULL, TEXT("No recognizers installed.\nExiting."), 
      gc_szAppName, MB_ICONERROR);
      return -1;
}

try
{
  Recognizers recos = new Recognizers();//Check for recognizer.
  Recognizer defReco = recos.GetDefaultRecognizer();
  recoContext = defReco.CreateRecognizerContext();
}
catch
{
  MessageBox.Show("No recognizers installed.");
}

Objek RecognitionResult dan RecognitionAlternate

Hasil pengenalan dikembalikan dalam objek RecognitionResult . Hasilnya berisi string hasil terbaik di properti TopString , serta kumpulan hasil alternatif dalam koleksi RecognitionAlternates . Objek RecognitionResult dapat dipertahankan dengan koleksi Strokes asli dari mana objek tersebut dihasilkan.

Struktur RecognizerGuide

Panduan pengenal dapat terdiri dari baris dan kolom, dan memberi pengenal konteks yang lebih baik untuk melakukan pengenalan. Misalnya, Anda dapat menggambar garis horizontal di layar pengguna, hampir seperti selembar kertas yang diserahkan, yang menunjukkan di mana tulisan tangan harus terjadi (jenis panduan ini hanya akan terdiri dari baris, dan tanpa kolom). Jika pengguna menulis di baris, alih-alih beberapa ruang arbitrer, akurasi pengenalan akan meningkat.

Ilustrasi berikut menunjukkan struktur RecognizerGuide dengan dua baris untuk input.

Ilustrasi berikut menunjukkan struktur RecognizerGuide dengan empat kolom dan tiga baris.

Untuk informasi selengkapnya tentang menggunakan struktur RecognizerGuide , lihat topik referensi RecognizerGuide .