Kivy - Multistroke 手势

Kivy 中的 MultiStroke 手势是一组多个 Gesture 对象。Gesture 构成由"touch_down"和"touch_up"事件之间的触摸点列表构成的单个笔划。MultiStrokeGesture 是此类笔划的集合。

"kivy.multistroke"模块实现了 Protractor 手势识别算法。此模块中定义的两个重要类是 MultistrokeGesture 和 Recognizer。

MultiStrokeGesture 类维护一组笔划并生成单笔划（即 UnistrokeTemplate）排列，用于稍后评估针对此手势的候选对象。

借助以下语法可获得 MultriStroke 对象 −

from kivy.vector import Vector
from kivy.multistroke import MultistrokeGesture

gesture = MultistrokeGesture('my_gesture', strokes=[
   [Vector(x1, y1), Vector(x2, y2), ...... ], # stroke 1
   [Vector(), Vector(), Vector(), Vector() ] # stroke 2
   #, [stroke 3], [stroke 4], ...
])

即使所有笔画都组合成一个列表（单笔画），您仍应单独指定笔画，并将 stroke_sensitive 属性设置为 True。

Recognizer 存储 MultistrokeGesture 对象列表。它是类似于 GestureDatabase 的搜索/数据库 API。它维护一个列表，并允许您在其中搜索用户输入的手势。

Recognizer 数据库是 UnistrokeTemplate 对象的容器，并实现堆置换算法以自动生成所有可能的笔画顺序。

Candidate 类的对象表示一组用户输入的单笔画路径。此对象通过调用 Recognizer.recognize() 自动实例化。

from kivy.vector import Vector
from kivy.multistroke import Recognizer

gdb = Recognizer()
gdb.recognize([
   [Vector(x1, y1), Vector(x2, y2)],
   [Vector(x3, y3), Vector(x4, y4)]])

Recognizer 对象能够生成这些事件 −

• on_search_start − 使用此 Recognizer 开始新搜索时触发。

• on_search_complete − 无论出于何种原因，正在运行的搜索结束时触发。

这些事件可以映射到回调，以跟踪 Recognizer.recognize() 方法完成的搜索操作的进度。

gdb.bind(on_search_start=search_start)
gdb.bind(on_search_complete=search_stop)

回调方法的示例如下 −

def search_start(gdb, pt):
   print("A search is starting with {} tasks".format(pt.tasks))
   
def search_stop(gdb, pt):
   best = pt.best
   print("Search ended {}. Best is {} (score {}, distance {})".format(
      pt.status, best['name'], best['score'], best['dist'] ))

最后，"kivy.multistroke"模块还提供了一个 ProgressTracker 类。它表示正在进行（或已完成）的搜索操作。

跟踪器对象在调用 Recognizer.recognize() 方法时自动实例化并返回。results 属性是一个随着识别操作的进展而更新的字典。

progress = gdb.recognize([
   [Vector(x1, y1), Vector(x2, y2)],
   [Vector(x3, y3), Vector(x4, y4)]])
   
progress.bind(on_progress=my_other_callback)
print(progress.progress)      # = 0
print(result.progress)        # = 1

您可以使用 export_gesture() 函数将多笔划手势保存到文件中。

• export_gesture(filename=None) − 它将 MultistrokeGesture 对象列表导出为 base64 编码的字符串，可以使用 parse_gesture() 函数将其解码为 Python 列表。也可以使用 Recognizer.import_gesture() 将其直接导入数据库。如果指定了 filename，则输出将写入磁盘。

• import_gesture(data=None,filename=None) − import_gesture() 函数将手势带入 Recognizer 数据库。使用此函数导入由 export_gesture() 格式化的手势列表。必须指定数据或文件名参数。此方法接受可选的 Recognizer.filter() 参数，如果未指定，则导入指定数据中的所有手势。