.TH "gicOpen" 3 "2006-12-30" "libgiigic-1.1.x" GGI
.SH NAME
\fBgicOpen\fR, \fBgicClose\fR : Open and close a recognizer
.SH SYNOPSIS
.nb
.nf
#include <ggi/gic.h>

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

.SH DESCRIPTION
\fBgicOpen\fR opens a recognizer. This function is given the name of an
recognizer driver to load. If only \fBNULL\fR is specified, the default
recognizer target is opened.

The optional arguments are a \fBNULL\fR-terminated list of pointers, which
are used to give additional information to the targets.  Currently
only the first pointer is specified: \fBvoid *\fR \fIargptr\fR, 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 \fIinput\fR parameter, in the format:
\f(CWlibrary_name:arguments\fR

\fBgicClose\fR releases and destroys an open recognizer and its associated
internal control structures. This will put back input streams to their
default modes, etc.
.SH RETURN VALUE
\fBgicOpen\fR returns the opened recognizer or \fBNULL\fR for error.
The \fBgic_handle_t\fR type is opaque to the programmer and can
only be used through GIC functions.

\fBgicClose\fR returns \fBGGI_OK\fR (== 0) for OK, otherwise an \f(CWgii-error(3)\fR code.
.SH SEE ALSO
\f(CWgicInit(3)\fR