Functions | |
void | Queue_Special_Event (const char *type, const char *param) |
void Queue_Special_Event | ( | const char * | type, | |
const char * | param | |||
) |
Allows your program to insert an arbitrary kind of event into the HOOPS event queue.
type | - The "type" of the special event. It's suggested that this consist of an indication of the source of the event (e.g., "MyProgram"), a colon, and an indication of what hap pened or is needed (e.g., "MyProgram: help!"). | |
param | - A string of additional information that goes with this type of special event. If there is none, just specify a blank or null string for this. |
Most HOOPS programs will not need to make use of Special Events. Most of those that do use them will be content to allow the HOOPS display drivers to generate and queue them, and will just look at the results. For those remaining few (ambitious) programs, Queue_Special_Event() lets them have a go at doing event queueing themselves.
Type and param can actually be any arbitrary string you please. The only requirement is that the event-processing loop in your program be able to figure out what's going on.
Type and param are both case-sensitive.