table of contents
other versions
- wheezy 1:1.0.2-4.1
giiOpen(3) | GGI | giiOpen(3) |
NAME¶
giiOpen, giiJoinInputs, giiSplitInputs, giiClose - Open, join, split and close inputsSYNOPSIS¶
#include <ggi/gii.h> gii_input_t giiOpen(const char * input, ...); gii_input_t giiJoinInputs(gii_input_t inp, gii_input_t inp2); int giiSplitInputs(gii_input_t inp, gii_input_t *newhand, uint32_t origin, uint32_t flags); int giiClose(gii_input_t inp);
DESCRIPTION¶
giiOpen opens an input. This function is given the name of an input driver to load. Passing NULL here results in an auto-select mechanism, which currently means examining the contents of GII_INPUT.Important: If you want to handle input
while also using LibGGI, using LibGII functions such as giiOpen is
almost certainly not what you want. Use LibGGI functions such as
ggiEventRead(3) with the LibGGI visual instead.
RETURN VALUE¶
giiOpen and giiJoinInputs return the opened or joined input, or NULL for error. The gii_input_t type is opaque to the programmer and can only be used through GII functions.EXAMPLES¶
GII input management:gii_input_t inp, inp2, inp3; /* Initialize the GII library. This must be called before any other * GII function. */ if (giiInit() != 0) exit(1); /* Open the nulldevice for testing ... */ if ((inp=giiOpen("input-null",NULL)) == NULL) { giiExit(); exit(1); } /* Open stdin for testing ... */ if ((inp2=giiOpen("input-stdin",NULL)) == NULL) { giiExit(); exit(1); } /* Open evdev for testing ... */ if ((inp3=giiOpen("input-linux-evdev",NULL)) == NULL) { giiExit(); exit(1); } /* Now join them. Note the usage of _i_n_p_=_giiJoin(inp,inp2); * This is the recommended way to do this. */ inp=giiJoinInputs(inp,inp2); /* Note that this mends inp2 into inp. That is you may not call giiClose(inp2) - this happens together with giiClose(inp) ! */ /* Join another */ inp=giiJoinInputs(inp,inp3); /* ... do the real work here ... */ /* Split one of them back out of the join. */ res = ggiSplitInputs(inp, &inp2, GII_EV_ORIGIN_NONE, 0); if (res == 1) { gii_input_t tmp; tmp = imp2; imp2 = imp1; imp1 = tmp; } else if (res < 0) fprintf(stderr, "Failed to split inputs\n"); /* Close the single input */ giiClose(inp2); /* Close the joined input */ giiClose(inp); /* Now close down LibGII. */ giiExit();
SEE ALSO¶
giiInit(3)2006-12-30 | libgii-1.0.x |