|
StdGUI − Standard GUI Library for C Programmers |
|
#include <stdgui.h> |
|
The StdGUI Library is a framework for writing GUI programs in Standard C. The goal of StdGUI is to make it as easy to write a GUI program in Standard C as it is to write command line/text processing programs. The StdGUI framework provides the programmer with a full set of data types and functions to implement GUI-based programs. Each GUI program consists of a main function and one or more CALLBACK functions which implement the programs behavior. The main function initializes the GUI system, gives names to any callback functions, and creates any initial WINDOWs the program requires. The main function also sets PROPERTIES on the program’s context and windows before, finally, calling the main event loop. The main event loop will handle user events and call the program’s callback functions as necessary. The callback functions will use the drawing routines to draw geometric shapes, IMAGEs, PICTUREs, FONTs and COLORs in GRAPHICs belonging to the program’s windows. The program can also make use of various GUI WIDGETs to interact with the user. The StdGUI framework allows the programmer to use sensible default behaviors (such as automatically ending the event loop when the last window is closed or automatically showing a window when a new window is created) and combine related operations (callback and property definition can be combined with GUI initialization and property definition can be combined with window creation). This makes basic programs much simpler to write than in other GUI frameworks. This manual page is just a place-holder for real documentation that will, eventually, be written. |
|
DISPLAY |
|
The name of the X11 display (only on X11 targeted versions of the library) |
|
GUI_SYS_FONT |
|
The name of the system font (used for menus, buttons, labels, etc.), the font is specified in a custom format: size:style:family |
|
GUI_APP_FONT |
|
The name of the application font (use for application stuff), again, the font is specified in a custom format: size:style:family |
|
GUI_SYS_WIDGETS |
|
The directory containing the base widget set for this installation of stdgui. Different widget directories can be used to get different appearances and behaviors for the user interface of stdgui programs. The default system widgets directory, if none is specified, is /usr/local/lib/stdgui/widgets |
|
GUI_USR_WIDGETS |
|
The directory containing auxiliary, user selected, widgets. If no user widget directory is specified, there is no default. |
|
Application Widgets |
|
The application may have it’s own set of widgets, in addition to the system and user widgets. The location of these widgets are not specified in an environment variable and there is no default location. Instead, when the GUI system is initialized, the application should attach a property to the context, named GUI_APP_WIDGETS whose value is the path to the application widgets directory. |
|
StdGUI is a work in progress (and in a very early stage of development) so there are likely to be lots of bugs, most of which I don’t know about. I try, however, to squash the bugs as I become aware of them, so if you find something that doesn’t seem to work correctly, drop me an email and I’ll see what I can do. |
|
stdgui-callback(3), stdgui-color(3), stdgui-startup(3), stdgui-drawing(3), stdgui-events(3), stdgui-font(3), stdgui-graphic(3), stdgui-image(3), stdgui-picture(3), stdgui-property(3), stdgui-utils(3) stdgui-widget(3), stdgui-window(3) |
|
Jeffrey Dutky |