Función AddStroke (recapis.h)

  • Artículo

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