Recognition: Advanced Topics

Using Advanced Topics in Recognition

// store the dictionary data
dictData := {data:theObj};
mySoup:AddXmit(dictData, nil);

Restoring Dictionary Data From a Soup

10

To use the dictionary, your application needs to retrieve the dictionary data object
from the soup and use the global function

SetDictionaryData

to install the

data in an empty dictionary. This is typically done in the application part's

InstallScript

function or in the

ViewSetupFormScript

method of the

view that uses the custom dictionary, as shown in the following code example:

// make new blank dictionary
mySpecialDictionary := NewDictionary('custom);
// get the dictionary data from the soup
// structure of query depends on how you store data
dataCursor:=

:Query(

);

// how you get entry depends on how you store data
myBinaryData := dataCursor:entry();
// put data in dictionary
SetDictionaryData(mySpecialDictionary, myBinaryData);

Note that RAM-based dictionaries are lost when the system resets. However, the
system calls your application part's

InstallScript

function after a reset. This

function can determine whether the dictionary exists and recreate it if necessary.
Because this function is also called when a card with your application on it is
inserted, as well as when the application is installed initially, it provides an ideal
place from which to install your custom dictionary.

Using Your RAM-Based Custom Dictionary

10

Take the following steps to make your RAM-based dictionary available to each
view that is to use it for recognition:

1. Set the view's

vCustomDictionaries

flag.

2. Create a

dictionaries

slot. You can create this slot in the view itself or in its

recConfig

frame.

3. Place your dictionary's identifier in the

dictionaries

slot.

To enable the use of custom dictionaries, you must set the

vCustomDictionaries

flag for the view that is to use the custom dictionary. This flag indicates that the
view has access to a slot named

dictionaries

that specifies dictionaries to be

used for recognition. The dictionaries specified in this slot are used in conjunction
with any other dictionaries that may be specified for this view's use.