GUIHooks

This subdirectory is defined by the guihooksdir keyword in the /etc/ccursim.conf file and contains source and libraries for the functions that be called remotely by HMI displays.

Libraries must be in the lib subdirectory and must be created as Linux shared (.so) libraries. Sources should be in a separate subdirectory src where they can be compiled.

The GUIHooks directory also contains a text file that defines the GUI callable functions provided by the core SimWB. The file is called simwbfunctionlist.txt and is automatically generated.

When creating your own libraries of GUI callable functions, the list must be placed in the guifunctionlist.txt file and must be in the same format as simwbfunctionlist.txt.

An entry in the file is as follows:

function=functionName(argument list)

Where functioName is the name of the function in the library and the argument list is a standard ā€˜Cā€™ function arguments list. The only arguments supported at the time being are:

int

float

double

short

char * (character string)

A GUI callable function should always return an int where a return value less than zero indicates an error.