Função AddStroke (recapis.h)

Adiciona um traço de tinta ao RecognizerContext.

Sintaxe

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

Parâmetros

hrc

O identificador para o contexto do reconhecedor.

pPacketDesc

Descreve o conteúdo dos pacotes. A descrição deve corresponder ao conteúdo dos pacotes no pPacket. Se FOR NULL, essa função usará a função GetPreferredPacketDescription .

cbPacket

Tamanho, em bytes, do buffer pPacket .

pPacket

Matriz de pacotes que contêm coordenadas de espaço em tablet.

pXForm

Descreve a transformação que pode ser aplicada à tinta para transformá-la do espaço em tablet em espaço à tinta. Um reconhecedor pode optar por ignorar essa transformação e implementar seus próprios algoritmos de rotação de tinta. Esses reconhecedores ainda devem retornar propriedades calculadas nos dados de rede em relação a essa transformação.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	Um dos parâmetros é um ponteiro inválido.
E_OUTOFMEMORY	Não é possível alocar memória para concluir a operação.
TPC_E_INVALID_PACKET_DESCRIPTION	A descrição do pacote não contém as informações necessárias para que o pacote seja considerado válido. Por exemplo, ele não inclui uma propriedade GUID_X ou GUID_Y.
TPC_E_OUT_OF_ORDER_CALL	A chamada para o método foi feita fora de ordem.
E_FAIL	Ocorreu um erro não especificado.
E_INVALIDARG	Um argumento inválido foi recebido.

Comentários

O reconhecedor deve retornar propriedades como Linha de Base em coordenadas de espaço à tinta em vez de coordenadas de tablet.

É recomendável que o reconhecedor coloque um limite no número de traços por contexto e/ou nos pontos permitidos em um determinado traço. Limite a entrada para 1024 traços por contexto e 32767 pontos por traço.

Traços com zero pontos não são permitidos. Você deve retornar E_FAIL nesse caso.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	recapis.h
DLL	inkobjcore.dll

Confira também

GetPreferredPacketDescription

Estrutura PACKET_DESCRIPTION