Función AddStroke (recapis.h)

Agrega un trazo de lápiz a RecognizerContext.

Sintaxis

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

Parámetros

hrc

Identificador del contexto del reconocedor.

pPacketDesc

Describe el contenido de los paquetes. La descripción debe coincidir con el contenido de los paquetes en pPacket. Si es NULL, esta función usa la función GetPreferredPacketDescription .

cbPacket

Tamaño, en bytes, del búfer de pPacket .

pPacket

Matriz de paquetes que contienen coordenadas de espacio de tableta.

pXForm

Describe la transformación que se puede aplicar a la entrada de lápiz para transformarla de espacio de tableta en espacio de tinta. Un reconocedor puede optar por omitir esta transformación e implementar sus propios algoritmos de rotación de entrada de lápiz. Estos reconocedores deben seguir devolviendo propiedades calculadas en los datos de red en relación con esta transformación.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Uno de los parámetros es un puntero no válido.
E_OUTOFMEMORY	No se puede asignar memoria para completar la operación.
TPC_E_INVALID_PACKET_DESCRIPTION	La descripción del paquete no contiene la información necesaria para que el paquete se considere válido. Por ejemplo, no incluye una propiedad GUID_X o GUID_Y.
TPC_E_OUT_OF_ORDER_CALL	La llamada al método se realizó sin orden.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Se recibió un argumento no válido.

Comentarios

El reconocedor debe devolver propiedades como Línea base en coordenadas de espacio de tinta en lugar de coordenadas de tableta.

Se recomienda que el reconocedor coloque un límite en el número de trazos por contexto o los puntos permitidos en un trazo determinado. Limite la entrada a 1024 trazos por contexto y 32767 puntos por trazo.

No se permiten trazos con cero puntos. Debe devolver E_FAIL en tal caso.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	recapis.h
Archivo DLL	inkobjcore.dll

Consulte también

GetPreferredPacketDescription

Estructura de PACKET_DESCRIPTION