
33-10
Device Drivers
Programmer’s Manual
void
ResetRecEngine
(void)
Description
This function resets the handwriting recognition engine to its default state.
This function should call a reset function (if any) provided by the handwriting
recognition engine. In some cases, ResetRecEngine() may perform the same
functions as InitRecEngine() (Section 33.5.2 - Handwriting Recognition Engine
Initialization).
This function is called once when initializing the character input pad during the
call of OpenInputPad().
33.5.2
Handwriting Recognition Engine Initialization
Syntax
void
InitRecEngine
(void)
Description
This function initializes or installs the handwriting recognition engine.
This function should call an initialization function (if any) provided by the
handwriting recognition engine and set up data structures required by the
engine for the recognition process.
This function is called once at PPSM initialization time.
33.5.3
Process One Stroke of Handwriting Input Data
Syntax
void
ProcessStroke
(U16 numPoints, P_POINT strokeData, U32 inputAreaId)
Description
This function processes one stroke of handwriting input data collected by the
system.
Based on the input parameters, this function should convert the handwriting
data for one stroke of input (if necessary) into the format being acceptable by
the corresponding handwriting recognition engine. The reformatted stroke data
should then be sent to the handwriting recognition engine (by calling a function
provided in the handwriting recognition engine) for pre-processing or
optimization before the actual handwriting recognition is initiated.
This function is called for every stroke of data collected.
Personal Portable System Manager
Programmer’s Manual
Device Drivers
33-11
Parameter
33.5.4
Initiate Character Recognition for the Handwriting Input
Syntax
void
RecognizeInput
Description
This function performs the character recognition of the handwriting input.
This function should call a character recognition function provided in the
handwriting recognition engine which initiates the recognition of the pre-
processed stroke data collected so far. The character recognition function is
expected to return to the driver function the number of character candidates
being recognized, and the character codes for these candidates.
This function is called if the pen points to other character input box or there is
an input time-out.
Return Value
Note:
Since PPSM does not include a specific handwriting
recognition engine, the driver functions mentioned above are
default to perform no operation.
Font Driver (font.c)
This driver is required for providing a common API in PPSM for font look-up while
supporting multiple font technologies and libraries supplied by various third party
vendors.
The font driver consists of a data structure and two functions.
Name
Description
numPoints
strokeData
inputAreaId
Name
Description
numCandidates
candidates
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.