A DigitalInkRecognition
client to perform recognition on digital ink.
Digital ink is the vector representation of what a user has written. It is composed of a
sequence of strokes, each being a sequence of touch points (coordinates and timestamp). See
Ink
for details.
A DigitalInkRecognizer
is created via
DigitalInkRecognition.getClient(DigitalInkRecognizerOptions)
.
Example:
DigitalInkRecognizer recognizer = DigitalInkRecognition.getClient(options);
This class can be used from any thread.
Public Method Summary
abstract void |
close()
Frees all resources used by the recognizer.
|
abstract Task<RecognitionResult> | |
abstract Task<RecognitionResult> |
recognize(Ink ink,
RecognitionContext
context)
Performs a recognition of the input ink using a recognition context.
|
Inherited Method Summary
Public Methods
public abstract void close ()
Frees all resources used by the recognizer. Calling any other method after this one will result in an error.
public abstract Task<RecognitionResult> recognize (Ink ink)
Performs a recognition of the input ink using the default recognition context.
Using the default recognition context may lead to sub-optimal recognition accuracy.
Parameters
ink | Input to be recognized |
---|
Returns
- A list of recognition candidates. If nothing can be recognized, this list will be empty.
public abstract Task<RecognitionResult> recognize (Ink ink, RecognitionContext context)
Performs a recognition of the input ink using a recognition context.
A recognition context contains information about the size of the writing area, and the characters that have already been entered. This helps disambiguate certain cases.
Example usage: a previous recognition has yielded the string "hello", that has been inserted in a text field. The user then handwrites "world". Send the present method the ink showing "world", and "hello" as a string in `context`. The recognizer will most likely return the string " world" with a leading space separating the two words.
See RecognitionContext
for details.
Parameters
ink | Input to be recognized |
---|---|
context | See RecognitionContext
for details. |
Returns
- A list of recognition candidates. If nothing can be recognized, this list will be empty.