Readme for CGUI
A C Graphical User Interface [add on to Allegro] by Christer Sandberg
Email: christer.sandberg@mdh.se
Homepage: http://www.idt.mdh.se/~csg/cgui/
The CGUI Readme File
Version 1.6.9
CGUI is a Graphical User Interface library. It contains functions that you
can use to create windows with buttons, lists, edit boxes etc. Read the
documentation (you find it in the docs directory of cgui) for details. The
docs will be built in several formats when you build the library (see below)
CGUI compiles on the following platforms: DOS/DJGPP, Linux, Cygwin
Windows/Mingw32, and Windows/MSVC.
You need to have compiled and installed Allegro before building CGUI.
You need at least version 4.0 of Allegro, and it has been tested up to version 4.0.3.
There are also other requirements like correctly installed compilers etc. but these are
already fulfilled if you succeded in making Allegro and running some of its graphical
examples (no additional requirements are needed).
You can find Allegro at:
http://alleg.sourceforge.net/
Installation goes in the following simple steps, and should be familiar since it is
exactly the same way as you used when installing Allegro:
That's it! You may also want to perform some of the optional steps:
-
You can compile a debugging library by typing "make DEBUGMODE=1". To
compile both the usual and the debug library in one step, type "make all".
-
To use the debugging library with your program, replace cgui with cguid in the
library specification to the build procedure of your program.
-
If you use Rhide and want to read the CGUI documentation with the Rhide online help
system, go to the "Help / Syntax help / Files to search" menu, and add
"cgui" after the existing "libc" entry (separated by a space).
-
If you use the default build there will be built and installed a dynamic
library. If you want statically linked libraries under Unix or Windows as
well as the default dynamically linked libraries (dll under Windows, .so
under Unix), set the environment variable "STATICLINK=1", and repeat the
"make install" and if you want a debug build "make install DEBUGMODE=1".
These static libraries require the statically linked version of Allegro.
If you use the static library your own program using it will contain
everything, but the executable file will be larger. If you use the
dynamic library your program will be quite small, but on the other hand
you also need to append both the dynamic CGUI library and the dynamic
library of Allegro when you distribute yur program to other people.
Read the documentation (e.g. cgui.html) section Usage about how to build
your own program using CGUI.
Run some of the examples and look at the code to get hints how to use CGUI.
Read the documentation to learn more and to see details how it works.
Email:
Homepage:
http://www.idt.mdh.se/~csg/cgui
Telephone: