Fungsi AddStroke (recapis.h)

Menambahkan goresan tinta ke RecognizerContext.

Sintaks

HRESULT AddStroke(
  HRECOCONTEXT             hrc,
  const PACKET_DESCRIPTION *pPacketDesc,
  ULONG                    cbPacket,
  const BYTE               *pPacket,
  const XFORM              *pXForm
);

Parameter

hrc

Handel ke konteks recognizer.

pPacketDesc

Menjelaskan isi paket. Deskripsi harus cocok dengan konten paket dalam pPacket. Jika NULL, fungsi ini menggunakan fungsi GetPreferredPacketDescription .

cbPacket

Ukuran, dalam byte, dari buffer pPacket .

pPacket

Array paket yang berisi koordinat ruang tablet.

pXForm

Menjelaskan transformasi yang dapat diterapkan ke tinta untuk mengubahnya dari ruang tablet menjadi ruang tinta. Pengenal dapat memilih untuk mengabaikan transformasi ini dan mengimplementasikan algoritma rotasi tinta mereka sendiri. Pengenal ini masih harus mengembalikan properti yang dihitung dalam data kisi relatif terhadap transformasi ini.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Salah satu parameter adalah penunjuk yang tidak valid.
E_OUTOFMEMORY	Tidak dapat mengalokasikan memori untuk menyelesaikan operasi.
TPC_E_INVALID_PACKET_DESCRIPTION	Deskripsi paket tidak berisi informasi yang diperlukan agar paket dianggap valid. Misalnya, ini tidak menyertakan properti GUID_X atau GUID_Y.
TPC_E_OUT_OF_ORDER_CALL	Panggilan ke metode ini dibuat tidak berurutan.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG	Argumen yang tidak valid diterima.

Keterangan

Pengenal harus mengembalikan properti seperti Garis Besar dalam koordinat ruang tinta daripada koordinat tablet.

Disarankan agar pengenal Anda membatasi jumlah goresan per konteks dan/atau titik yang diizinkan dalam stroke tertentu. Batasi input hingga 1024 goresan per konteks dan 32767 poin per goresan.

Goresan dengan titik nol tidak diperbolehkan. Anda harus mengembalikan E_FAIL dalam kasus seperti itu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	recapis.h
DLL	inkobjcore.dll

Lihat juga

GetPreferredPacketDescription

Struktur PACKET_DESCRIPTION