diff options
| -rw-r--r-- | docs/README.GGI | 182 |
1 files changed, 18 insertions, 164 deletions
diff --git a/docs/README.GGI b/docs/README.GGI index e28d047732c..ddb67725f1a 100644 --- a/docs/README.GGI +++ b/docs/README.GGI @@ -1,172 +1,26 @@ - LibGGI driver for Mesa-3.0 - by Uwe Maurer ([email protected]) +GGIMesa for LibGGI 2.x +Requirements: +------------- +LibGGI 2.0 or greater -Introduction -============ -[from libggi.txt by Steve Cheng and Hartmut Niemann] +Installation: +------------- +To install GGIMesa, follow the instructions in INSTALL.GNU. If you +wish to install GGIGLUT as well, first install GGIMesa and then run - "LibGGI, the dynamic GGI (General Graphics Interface) library is a - flexible drawing library. +make +make install (must be root) - It provides an opaque interface to the display's acceleration - functions. It was originally intended to allow user programs to - interface with KGI, the kernel side of the GGI code, but other display - types can be easily used by loading the appropriate "display target" - (e.g. X, memory). +in ggi/ggiglut. - LibGGI consists of a main library (libggi.so) and a multitude of - dynamic drivers. The library then loads the necessary "drivers" for - the requested mode, taking hints from the graphics device if - necessary. LibGGI can also load extension libraries, e.g. to provide - enhanced 2D and 3D functions. +Notes: +------ - It has been designed after having a look at several existing - libraries, and so far we have found porting to be quite simple from - and to most of them." +* Set the environment variables GGIMESA_DEBUG and/or GGIGLUT_DEBUG +to 255 to see lots of debugging output. ----------------------------------------------------------------------------- - - More information about the GGI project and LibGGI can be - obtained from the GGI website: - - www.ggi-project.org - ----------------------------------------------------------------------------- - -Installation -============ - - - Install LibGGI - - - Unpack the Mesa archives - - - In the Mesa directory type: - - make linux-ggi - su - make linux-ggi-install - exit - - - Now you can try some demos. - If they don't work, you can set the GGIMESA_DEBUG - variable to 255 and you will see some information from the - LibGGI-driver. - - export GGIMESA_DEBUG=255 - - -GLUT -==== - - You can change these default values in ggi/ggiglut.c: - #define WIDTH 640 - #define HEIGHT 400 - #define GRAPHTYPE_RGB GT_16BIT - #define GRAPHTYPE_INDEX GT_8BIT - - Options: - -bpp x Set graphic mode with x bits per pixel - -size x y Screen (or window) is x*y pixels - - Example: - demos/gears -size 320 200 -bpp 24 - -Updates -======= - - You can find the latest LibGGI-driver and ggiglut on my - homepage: - - http://home.t-online.de/home/uwe_maurer/ggimesa.htm - - - -Uwe Maurer - [email protected] - - LibGGI driver for Mesa-3.0 - by Uwe Maurer ([email protected]) - - -Introduction -============ -[from libggi.txt by Steve Cheng and Hartmut Niemann] - - "LibGGI, the dynamic GGI (General Graphics Interface) library is a - flexible drawing library. - - It provides an opaque interface to the display's acceleration - functions. It was originally intended to allow user programs to - interface with KGI, the kernel side of the GGI code, but other display - types can be easily used by loading the appropriate "display target" - (e.g. X, memory). - - LibGGI consists of a main library (libggi.so) and a multitude of - dynamic drivers. The library then loads the necessary "drivers" for - the requested mode, taking hints from the graphics device if - necessary. LibGGI can also load extension libraries, e.g. to provide - enhanced 2D and 3D functions. - - It has been designed after having a look at several existing - libraries, and so far we have found porting to be quite simple from - and to most of them." - ----------------------------------------------------------------------------- - - More information about the GGI project and LibGGI can be - obtained from the GGI website: - - www.ggi-project.org - ----------------------------------------------------------------------------- - -Installation -============ - - - Install LibGGI - - - Unpack the Mesa archives - - - In the Mesa directory type: - - make linux-ggi - su - make linux-ggi-install - exit - - - Now you can try some demos. - If they don't work, you can set the GGIMESA_DEBUG - variable to 255 and you will see some information from the - LibGGI-driver. - - export GGIMESA_DEBUG=255 - - -GLUT -==== - - You can change these default values in ggi/ggiglut.c: - #define WIDTH 640 - #define HEIGHT 400 - #define GRAPHTYPE_RGB GT_16BIT - #define GRAPHTYPE_INDEX GT_8BIT - - Options: - -bpp x Set graphic mode with x bits per pixel - -size x y Screen (or window) is x*y pixels - - Example: - demos/gears -size 320 200 -bpp 24 - -Updates -======= - - You can find the latest LibGGI-driver and ggiglut on my - homepage: - - http://home.t-online.de/home/uwe_maurer/ggimesa.htm - - - -Uwe Maurer - [email protected] +* GGIGLUT contains support for all of the GLUT 3.6 API except for the +high-level primitive drawing functions, but many of the functions (in +particular the menu drawing functions) are just stubs. |