Share via

addStroke 函数 (recapis.h)

  • 项目

向 RecognizerContext 添加墨迹笔划。

语法

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

参数

hrc

识别器上下文的句柄。

pPacketDesc

描述数据包的内容。 说明必须与 pPacket 中数据包的内容匹配。 如果 为 NULL，则此函数使用 GetPreferredPacketDescription 函数。

cbPacket

pPacket 缓冲区的大小（以字节为单位）。

pPacket

包含平板电脑空间坐标的数据包数组。

pXForm

描述可应用于墨迹以将其从平板电脑空间转换为墨迹空间的转换。 识别器可以选择忽略此转换并实现自己的墨迹旋转算法。 这些识别器仍应返回在相对于此转换的点阵数据中计算的属性。

返回值

此函数可以返回其中一个值。

返回代码 说明
S_OK
 成功。
E_POINTER
 其中一个参数是无效的指针。
E_OUTOFMEMORY
 无法分配内存来完成操作。
TPC_E_INVALID_PACKET_DESCRIPTION
 数据包说明不包含数据包被视为有效的必要信息。 例如，它不包括GUID_X或GUID_Y属性。
TPC_E_OUT_OF_ORDER_CALL
 对 方法的调用是无序的。
E_FAIL
 发生了未指定的错误。
E_INVALIDARG
 收到无效参数。

注解

识别器必须返回墨迹空间坐标中的 基线 等属性，而不是平板电脑坐标。

建议识别器限制每个上下文的笔划数和/或给定笔划中允许的点数。 将输入限制为每个上下文 1024 个笔划，每个笔划 32767 个点。

不允许具有零点的笔划。 在这种情况下，应返回E_FAIL。

要求

要求 值
最低受支持的客户端 Windows XP Tablet PC Edition [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 recapis.h
DLL inkobjcore.dll

另请参阅

GetPreferredPacketDescription

PACKET_DESCRIPTION 结构