高级识别示例

项目
06/13/2023

高级识别示例演示用于手写识别的 Microsoft 平板电脑自动化应用程序编程接口 (API) 的高级功能。

它包括以下功能：

枚举已安装的识别器
使用特定语言创建识别器上下文
使用识别器对象
设置识别事实和单词列表
使用指南提高识别质量
动态背景识别
手势识别

使用的接口包括： IInkRecognizer、 IInkRecoContext、 IInkRecognitionResult、 IInkRecognitionGuide、 IInkWordList、 IInkGesture、 IInkCollector、 IInkDisp、 IInkRenderer、 IInkDrawingAttributes、 IInkStrokes 和 IInkStroke。

墨迹和项目标头

首先，包括平板电脑自动化接口的标头。这些随平板电脑电脑平台 SDK 一起安装。 TpcError.h 文件包含平板电脑 API 错误代码定义。

#include <msinkaut.h>
#include <msinkaut_i.c>
#include <TpcError.h>

EventSinks.h 文件定义 IInkEventsImpl 和 IInkRecognitionEventsImpl 接口，并设置 RecognitionWithAlternates、 Stroke 和 Gesture 事件。

#include "EventSinks.h"

ChildWnds.h 文件包含类 CInkInputWnd 和 CRecoOutputWnd 的定义，这些类派生自 ATL 的 CWindowImpl，用于创建示例的子窗口。

#include "ChildWnds.h"

AdvReco.h 文件声明 CAdvRecoApp 类，该类是此示例的应用程序窗口类。

#include "AdvReco.h"

初始化应用程序窗口

窗口的 Run 方法设置 CAdvRecoApp 对象，加载窗口的菜单和图标，为默认识别器创建 InkRecognizerContext 对象，并启动窗口的消息循环。

窗口的 OnCreate 方法处理 WM_CREATE 事件并创建子窗口。 InkCollector 对象连接到墨迹收集器的事件源，并在输入窗口中启用墨迹输入。然后，它将创建 InkRecognizerGuide 对象，并使用墨迹收集器的 Renderer 属性将识别引导框矩形转换为墨迹空间。最后， OnCreate 方法创建 InkWordList 对象。

处理墨迹收集器事件

窗口的 OnStroke 方法处理墨迹收集器的 Stroke 事件。新的 IInkStrokeDisp 对象将添加到墨迹收集器的 Ink 属性的 InkStrokes 中。

窗口的 OnGesture 方法处理墨迹收集器的手势事件。 OnGesture 方法首先使用最高置信度手势标识手势，并检查窗口是否支持此特定手势。如果支持手势，则手势的边界框将失效，因为手势将从笔划集合中删除。如果不支持手势，则 取消手势 事件，这会导致墨迹收集器引发 Stroke 事件。最后，更新结果窗口。

处理识别器上下文事件

窗口的 OnRecognitionWithAlternates 方法处理识别器上下文的 RecognitionWithAlternates 事件。 OnRecognitionWithAlternates 方法在结果窗口中显示识别结果。

窗口的 OnRecognizer 方法处理“识别器”菜单上的命令。如果选择了 Default 命令，则 InkRecognizers 的 GetDefaultRecognizer 方法用于检索默认识别器;否则，将检索所选识别器。然后，创建并使用识别器上下文，并更新菜单和状态栏。

窗口的 OnFactoidWordlist 方法处理 Factoid 菜单上的“使用 Wordlist”命令。识别器上下文的 Strokes 属性设置为 NULL 以重置识别器上下文。如果“使用 Wordlist”选项处于关闭状态，则识别器上下文的 WordList 属性设置为 NULL;否则，识别器上下文的 WordList 属性设置为在 OnCreate 方法中创建的 InkWordList。最后，将墨迹收集器的 InkStroke 重新附加到识别器上下文，调用识别器上下文的 BackgroundRecognizeWithAlternates 方法，并更新菜单。

窗口的 OnFactoid 方法处理 Factoid 菜单上的 factoid 命令。它首先将识别器上下文的 Strokes 属性设置为 NULL，将识别器上下文的 Factoid 属性设置为所选 factoid，并将墨迹收集器的 InkStroke 重新分配给识别器上下文。如果识别器上下文支持 Factoid 对象，则会调用识别器上下文的 BackgroundRecognizeWithAlternates 方法;否则，将显示错误消息。最后，更新菜单和状态栏。

窗口的 OnGuide 方法处理 “指南 ”菜单上的命令。如果识别器上下文支持参考线选项， OnGuide 方法将识别器上下文的 Strokes 属性设置为 NULL，将识别器上下文的 Guide 属性设置为所选参考线设置，将墨迹收集器的 InkStroke 重新分配给识别器上下文，并调用识别器上下文的 BackgroundRecognizeWithAlternates 方法。否则，将显示错误消息。最后，更新输入窗口、菜单和状态栏。

窗口的 OnMode 方法处理“ 模式 ”菜单上的命令。它会禁用墨迹收集器、更新墨迹收集器的 CollectionMode 属性、更新菜单以及显示或隐藏手势列表。最后，启用墨迹收集器。

窗口的 OnRecognize 方法处理墨迹菜单上的 “识别 ”命令。它调用识别器上下文的 EndInkInput 方法，防止墨迹添加到识别器上下文。这有时是必要的，因为并非所有识别器都支持部分识别。然后，它会调用识别器上下文的 Recognize 方法，并将结果传递给窗口的 OnRecognitionWithAlternates 方法。最后，将墨迹收集器的 InkStroke 重新分配到识别器上下文。

窗口的 OnClear 方法处理“墨迹”菜单上的“清除”命令。它从墨迹收集器的 Ink 属性中删除笔划，释放旧的笔划集合，并为墨迹收集器的 Ink 属性创建一个新笔划集合，并将新的笔划集合附加到识别器上下文。

窗口的 OnExit 方法处理 Ink 菜单上的 Exit 命令，并引发 WM_CLOSE 事件。

帮助器方法

窗口的 LoadMenu 方法从窗口的 Run 方法调用，并将支持的识别器列表和受支持的事实列表添加到菜单中。首先，它检索 InkRecognizer。然后，它会循环访问可用的识别器，并仅选择在语言属性中具有语言列表的识别器，并将其添加到 “识别器 ”菜单。最后，它会使用定义为全局常量的 factoid 列表填充 Factoid 菜单。

当用户选择新的 识别器 时，将从窗口的 OnRecognizer 方法调用窗口的 UseRecognizer 方法。它创建识别器上下文，将旧上下文与识别器事件接收器分离，清除并释放旧上下文，并将新上下文附加到识别器事件接收器。

然后， UseRecognizer 方法检查识别 器的功能属性 ，该属性返回 InkRecognizerCapabilities 值。如果识别器支持行输入，则会启用“指南”菜单上的“行”命令。如果识别器支持装箱输入，则会启用 Box 命令。如果识别器不支持免费输入，则禁用 None 命令。如果当前指南选择不受支持，则会更新识别器上下文和菜单的 Guide 属性。

然后， UseRecognizer 方法尝试设置识别器上下文的 WordList 和 Factoid 属性。如果识别器不支持任一设置，则使用默认值并更新菜单。

最后，UseRecognizer 方法将墨迹收集器的 InkDisp 对象的 Strokes 属性附加到识别器上下文，将输出窗口的字体更改为识别器语言支持的字体，重置输出窗口，并通过调用识别器上下文的 BackgroundRecognizeWithAlternates 方法更新识别结果。

窗口的 GetGestureName 方法从窗口的 OnGesture 方法调用。它会搜索手势并返回手势名称的索引，该名称存储在 AdvReco.rc 文件的字符串表中。

Share via