
Q-GGI - GGI interface for the Q programming language
===== = === ========= === === = =========== ========

GGI, the General Graphics Interface, is a graphics library which aims to
provide a reliable, stable and fast graphics system that works everywhere. It
is a great framework for developing portable graphics applications. See
http://www.ggi-project.org/ for more information. This module provides an
interface to GGI for the Q programming language. Only the basic operations of
libggi are supported at this time; future releases will probably add the more
advanced features and extensions when these parts of GGI become stable. But
the module is already quite usable for doing raster graphics on a wide variety
of systems and output devices. Experimental support for simple alpha blending
as well as advanced text rendering via FreeType2 is now also available.

The module requires that you have libggi (version 2.0 or later) and libgii
(version 0.8 or later) installed. For the additional font support you also
need version 2 of the FreeType library (http://www.freetype.org/).

Since the GGI project at SourceForge (http://sourceforge.net/projects/ggi/)
only provides source tarballs at this time, and GGI is not yet included in the
major Linux distributions, we provide some RPMs for the required libraries on
the Q homepage. The Windows Qpad package already includes all necessary
support files. NOTE: To make the module work on Windows, please check that the
appropriate default visual type is set with the GGI_DISPLAY enviroment
variable (i.e.: set GGI_DISPLAY=directx) and that the GGI_CONFDIR variable
points to the <Qpad install dir>/ggi/etc/ggi directory. (All this should be
taken care of automagically when the Qpad package is installed. However, if
you install Qpad in an unusual location, you still have to edit the .root
lines in the ggi/etc/ggi/*.conf files accordingly.)

Please see ggi.q for a description of the functions provided by this module.
For more in-depth information about GGI please refer to the corresponding
manual pages. A few sample scripts are also provided; you can find these, once
installed, in the <q-prefix>/share/q/examples/ggi directory.

Acknowledgements
----------------

Special thanks are due to GGI project admin Christoph Egger who spent a lot of
time helping me to sort out bugs in GGI's DirectX driver.


Enjoy! :)

Dec 22 2003
Albert Graef
ag@muwiinfa.geschichte.uni-mainz.de, Dr.Graef@t-online.de
http://www.musikwissenschaft.uni-mainz.de/~ag
