LIBGLADE ======== Author: James Henstridge <firstname.lastname@example.org> This library allows you to load glade interface files in a program at runtime. It doesn't require GLADE to be used, but GLADE is by far the easiest way to create the interface files. For an idea of how to use the library, see test-libglade.c and glade/glade-xml.h. To compile, you will need the libxml2 package (aka the gnome-xml module in CVS) which can be found on the GNOME FTP site or its mirrors. If you want GNOME support, you will also need the gnome-libs package installed. LIBGLADE INTERNALS ================== If you are interested in how libglade works, here is a small description: When glade_xml_new is called, the XML file is loaded using libxml. Libglade uses the SAX interface because it is faster and allows me to store the data in a more compact representation. The data in the XML file is cached, so that if you load the interface again, the file does not need to be reparsed. If the file has changed though, it will be reparsed. Now glade_xml_build_widget is called for all the toplevel widgets in the interface (or if the second argument to glade_xml_new was non NULL, the widget it refers to is treated as the toplevel). For each of these widgets, they are created by a function specific to the widget type, and then glade_xml_build_widget is called for each child widget, which is then packed into its parent. This is done recursively, so the whole interface is constructed. New widget types are added to the widget class hash with the glade_register_widgets function. For an example, see the end of glade-gtk.c. The automatic signal connection system uses the introspective capabilities of dynamic linking. By openning a handle on NULL, we can get at all the global symbols (global functions, global variables) in the executable, and the libraries it is linked against. This is used to find the address of a signal handler from its name, so that gtk_signal_connect can be called automatically for you. Of course, there are other ways of connecting the signals if your platform doesn't support this feature.