ggiOpen(3) GGI ggiOpen(3)NAME
ggiOpen, ggiClose : Open and close a visual
SYNOPSIS
#include <ggi/ggi.h>
ggi_visual_t ggiOpen(const char *display, ...);
int ggiClose(ggi_visual_t vis);
DESCRIPTION
ggiOpen opens a visual. The visual is specified as a display string,
followed by NULL. If only NULL is specified, the default display tar‐
get is opened, which means first examining GGI_DISPLAY, then invoking
display-auto(7). The other arguments are for internal purposes only,
such as argptr, used to pass driver-specific, non-textual information
to the driver.
ggiClose releases and destroys an open visual. This will close X win‐
dows, return consoles to text-mode, etc.
RETURN VALUE
ggiOpen returns the opened visual or NULL for error. The ggi_visual_t
is opaque to the programmer and should only be used through GGI func‐
tions.
ggiClose returns 0 for OK, otherwise a ggi-error(3) code.
EXAMPLES
Open and closing default visual:
ggi_visual_t vis = ggiOpen(NULL);
if(vis==NULL) {
ggiPanic("Couldn't open default visual!\n");
}
/* do stuff */
ggiClose(vis);
Open and closing a memory visual:
ggi_visual_t memvis = ggiOpen("display-memory", NULL);
if(memvis==NULL) {
return -1;
}
/* do stuff */
ggiClose(memvis);
SEE ALSOdisplay-auto(7), ggiInit(3), libggi(7)libggi-2.2.x 2006-12-30 ggiOpen(3)