AddStroke, fonction (recapis.h)

Article
03/04/2024

Ajoute un trait d’encre au RecognizerContext.

Syntaxe

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

Paramètres

hrc

Handle du contexte de l’outil de reconnaissance.

pPacketDesc

Décrit le contenu des paquets. La description doit correspondre au contenu des paquets dans pPacket. Si la valeur est NULL, cette fonction utilise la fonction GetPreferredPacketDescription .

cbPacket

Taille, en octets, de la mémoire tampon pPacket .

pPacket

Tableau de paquets qui contiennent des coordonnées d’espace de tablette.

pXForm

Décrit la transformation qui peut être appliquée à l’encre pour la transformer de l’espace tablette en espace d’entrée manuscrite. Un module de reconnaissance peut choisir d’ignorer cette transformation et d’implémenter ses propres algorithmes de rotation d’encre. Ces éléments de reconnaissance doivent toujours retourner les propriétés calculées dans les données de treillis relatives à cette transformation.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_POINTER	L’un des paramètres est un pointeur non valide.
E_OUTOFMEMORY	Impossible d’allouer de la mémoire pour terminer l’opération.
TPC_E_INVALID_PACKET_DESCRIPTION	La description du paquet ne contient pas les informations nécessaires pour que le paquet soit considéré comme valide. Par exemple, il n’inclut pas de propriété GUID_X ou GUID_Y.
TPC_E_OUT_OF_ORDER_CALL	L’appel à la méthode a été effectué dans le désordre.
E_FAIL	Une erreur non spécifiée s'est produite.
E_INVALIDARG	Un argument non valide a été reçu.

Remarques

Le module de reconnaissance doit retourner des propriétés telles que la ligne de base dans les coordonnées d’espace d’entrée manuscrite plutôt que dans les coordonnées de tablette.

Il est recommandé que votre module de reconnaissance place une limite au nombre de traits par contexte et/ou aux points autorisés dans un trait donné. Limitez l’entrée à 1 024 traits par contexte et à 32767 points par trait.

Les traits avec zéro point ne sont pas autorisés. Vous devez retourner E_FAIL dans ce cas.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	recapis.h
DLL	inkobjcore.dll

Voir aussi

GetPreferredPacketDescription

PACKET_DESCRIPTION Structure

Partager via