Man Linux: Main Page and Category List


       gicOpen, gicClose - Open and close a recognizer


       #include <ggi/gic.h>

       gic_handle_t gicOpen(const char *recognizers,...);
       int gicClose(gic_handle_t hand);


       gicOpen  opens  a  recognizer.  This  function  is given the name of an
       recognizer driver to load. If  only  NULL  is  specified,  the  default
       recognizer target is opened.

       The  optional  arguments  are a NULL-terminated list of pointers, which
       are used to give additional information to the targets.  Currently only
       the  first pointer is specified: void * argptr, a pointer to a library-
       specific struct. It is used to pass  parameters  that  are  not  easily
       transferable in textual form.

       Parameters  which  can  be  represented  in  text  format  are  usually
       transfered    in    the    input    parameter,    in    the     format:

       gicClose  releases  and  destroys an open recognizer and its associated
       internal control structures. This will put back input streams to  their
       default modes, etc.


       gicOpen   returns  the  opened  recognizer  or  NULL  for  error.   The
       gic_handle_t type is opaque to the programmer  and  can  only  be  used
       through GIC functions.

       gicClose  returns GGI_OK (== 0) for OK, otherwise an gii-error(3) code.