ref: 2985d53b7a06d8a1712493aa899d6ffcfacd9e3b
dir: /sys/src/libscribble/hre_internal.h/
/* * hre_internal.h: Internal Interface for Recognizer. * Author: James Kempf * Created On: Thu Nov 5 10:54:18 1992 * Last Modified By: James Kempf * Last Modified On: Fri Sep 23 13:51:15 1994 * Update Count: 99 * Copyright (c) 1994 by Sun Microsystems Computer Company * All rights reserved. * * Use and copying of this software and preparation of * derivative works based upon this software are permitted. * Any distribution of this software or derivative works * must comply with all applicable United States export control * laws. * * This software is made available as is, and Sun Microsystems * Computer Company makes no warranty about the software, its * performance, or its conformity to any specification */ /*Avoids forward reference problem.*/ /* * Internal view of wordset. The recognition engine uses this view to * maintain information about which recognizer object this wordset * belongs to, which file (in case it needs to be saved), and internal * data structures. */ struct _wordset { char* ws_pathname; /*Path name to word set file.*/ recognizer ws_recognizer; /*To whom it belongs.*/ void* ws_internal; /*Internal data structures.*/ }; /* * Internal view of the recognizer struct. This view is only available * to OEM clients who implement a recognizer shared library. Clients * of the recognizer itself see it as an opaque data type. The struct * contains a function pointer for each function in the client API. */ struct _Recognizer { uint recognizer_magic; char *recognizer_version; rec_info *recognizer_info; void *recognizer_specific; int (*recognizer_load_state)(struct _Recognizer*, char*, char*); int (*recognizer_save_state)(struct _Recognizer*, char*, char*); char* (*recognizer_error)(struct _Recognizer*); wordset (*recognizer_load_dictionary)(struct _Recognizer*, char*, char*); int (*recognizer_save_dictionary)(struct _Recognizer*, char*, char*, wordset); int (*recognizer_free_dictionary)(struct _Recognizer*, wordset); int (*recognizer_add_to_dictionary)(struct _Recognizer*, letterset*, wordset); int (*recognizer_delete_from_dictionary)(struct _Recognizer*, letterset*, wordset); int (*recognizer_set_context)(struct _Recognizer*,rc*); rc* (*recognizer_get_context)(struct _Recognizer*); int (*recognizer_clear)(struct _Recognizer*, bool); int (*recognizer_get_buffer)(struct _Recognizer*, uint*, Stroke**); int (*recognizer_set_buffer)(struct _Recognizer*, uint, Stroke*); int (*recognizer_translate)(struct _Recognizer*, uint, Stroke*, bool, int*, rec_alternative**); rec_fn* (*recognizer_get_extension_functions)(struct _Recognizer*); char** (*recognizer_get_gesture_names)(struct _Recognizer*); xgesture (*recognizer_set_gesture_action)(struct _Recognizer*, char*, xgesture, void*); uint recognizer_end_magic; }; /* * recognizer_internal_initialize - Allocate and initialize the recognizer * object. The recognition shared library has the responsibility for filling * in all the function pointers for the recognition functions. This * function must be defined as a global function within the shared * library, so it can be accessed using dlsym() when the recognizer * shared library is loaded. It returns NULL if an error occured and * sets errno to indicate what. */ typedef recognizer (*recognizer_internal_initialize)(rec_info* ri); /*Function header definition for recognizer internal initializer.*/ #define RECOGNIZER_INITIALIZE(_a) \ recognizer __recognizer_internal_initialize(rec_info* _a) /* * recognizer_internal_finalize - Deallocate and deinitialize the recognizer * object. If the recognizer has allocated any additional storage, it should * be deallocated as well. Returns 0 if successful, -1 if the argument * wasn't a recognizer or wasn't a recognizer handled by this library. */ typedef int (*recognizer_internal_finalize)(recognizer r); #define RECOGNIZER_FINALIZE(_a) \ int __recognizer_internal_finalize(recognizer _a) /* * The following are for creating HRE structures. */ recognizer make_recognizer(rec_info* ri); void delete_recognizer(recognizer rec); RECOGNIZER_FINALIZE(_a); rec_alternative* make_rec_alternative_array(uint size); rec_correlation* make_rec_correlation(char type, uint size, void* trans, rec_confidence conf, uint ps_size); rec_fn* make_rec_fn_array(uint size); void delete_rec_fn_array(rec_fn* rf); gesture* initialize_gesture(gesture* g, char* name, uint nhs, pen_point* hspots, pen_rect bbox, xgesture cback, void* wsinfo); gesture* make_gesture_array(uint size); void delete_gesture_array(uint size,gesture* ga,bool delete_points_p); Stroke* concatenate_Strokes(int nstrokes1, Stroke* strokes1, int nstrokes2, Stroke* strokes2, int* nstrokes3, Stroke** strokes3); rec_alternative* initialize_rec_alternative(rec_alternative* ra, uint); rec_element* initialize_rec_element(rec_element*, char, uint, void*, rec_confidence); /* * Pathnames, etc. */ #define REC_DEFAULT_LOCALE "C" #define RECHOME "RECHOME" #define LANG "LANG"