Installation von LCGI
=====================

Installationsvoraussetzung
--------------------------

Die Graphikbibliothek LCGI setzt voraus, dass man die Pakete

  qt3, qt3-devel usw. aus der Serie xdev (ab SuSE 8.1)

installiert hat. Sollte eines dieser Pakete auf Ihrem System nicht installiert sein,
so müssen Sie diese zuerst installieren, bevor Sie die folgenden Installationsschritte durchführen.
 

Installation
------------

Um die Graphikbibliothek LCGI zu installieren, müssen Sie sich als
    root
anmelden und anschließend in das Directory wechseln, indem sich das
heruntergeladene Archiv lcgi_qt3.tgz befindet.

Nun müssen Sie die folgenden Schritte durchführen:
 
1. Entpacken des Archivs lcgi_qt3.tgz mit
     tar xzvf lcgi_qt3.tgz
 
2. Wechseln in das Directory lcgi
     cd lcgi
 
3. Setzen des Qt-Pfads (evtl.)
     In der Datei install_lcgi müssen sie nur dann den Pfad der
     Variablen QTDIR ändern, wenn sie keine Standardinstallation
     vorgenommen haben.
 
4. Installieren von lcgi
     Sie rufen nur folgendes auf:
         ./install_lcgi

5. Beenden der root-Sitzung mit
      exit
    und Anmelden unter Ihrem Login-Namen.
 
6. Setzen der Variablen QTDIR und Definieren der Funktion in der Datei .bashrc
     Sie haben hier zwei Möglichkeiten:
  
     1. Möglichkeit:
          Tragen Sie in der Datei .bashrc in Ihrem Home-Directory
          die folgenden Zeilen ein:

            export QTDIR=/usr/lib/qt3
            function lcc() {  g++ -pipe -Wall -W -O2 -DNO_DEBUG -I/usr/include/lcgi \
                              -I$QTDIR/include \$* -L$QTDIR/lib -L/usr/X11R6/lib \
                              -lXext -lm -llcgi -lqt -lXext -lX11; }
 
          Wenn Sie keine Standardinstallation vorgenommen haben,
          müssen Sie bei QTDIR= eben den Pfad angeben, in dem sich bei
          Ihnen Qt befindet.

     oder

     2. Möglichkeit (nur bei Standardinstallation):
          Rufen Sie im Directory lcgi das folgende Programm auf:

            ./lcgiconfig
                     
         Dieses Programm trägt automatisch am Ende Ihrer .bashrc die beiden Zeilen
         von der 1. Möglichkeit ein.

7. Schließen Sie dann dieses Fenster und öffnen Sie es erneut,
   denn bei jedem Öffnen eines Terminalfensters wird automatisch der
   Inhalt der Datei .bashrc (im Home-Directory) gelesen.                                     




Benutzung von LCGI
==================

Inkludieren von <graphics.h>
----------------------------
 
Da die Graphikfunktionen in der Headerdatei graphics.h deklariert sind, sollte immer
 
   #include <graphics.h>
 
angegeben werden, wenn man von diesen Funktionen in seinem Programm Gebrauch macht.
 

 
Angabe von main() mit Parametern
--------------------------------
 
Wenn Sie in Ihrem Programm LCGI-Routinen aufrufen, müssen Sie statt
 
   int main(void)
 
immer folgendes
 
   int main( int argc, char *argv[] )
 
angeben.
 
 

Kompilieren und Linken von Graphikprogrammen (auf der Kommandozeile)
--------------------------------------------------------------------
 
Wenn Sie ein Programm erstellt haben, das Routinen aus diesem Kapitel aufruft,
müssen Sie dieses immer mit dem mitgelieferten Kommando lcc statt gcc bzw. cc
kompilieren und linken.
 
Wenn Sie z.B. ein Programm polygon.c entwurfen haben und dieses nun kompilieren wollen,
müssen Sie z.B. folgendes aufrufen:
 
   lcc -o polygon polygon.c
 
Das Kommando lcc bietet die gleichen Optionen an wie das Kommando gcc bzw. cc.                                                                                                    
Rufen Sie danach zum Testen 

    polygon  bzw. 
    ./polygon  (wenn sie als root angemeldet sind)

auf.


Kompilieren und Linken von Graphikprogrammen (mit xwpe)
-------------------------------------------------------
 
Wenn Sie mit der integrierten Environment xwpe arbeiten,
müssen Sie unter dem Menüpunkt

   Options-->Compiler-->C

die folgenden Einträge vornehmen:
 
  Compiler:         g++
  ComPiler-Options: -g -I/usr/include/lcgi -I/usr/lib/qt3/include
  Loader-Options:   -L/usr/lib/qt3/lib -L/usr/lib -L/usr/X11R6/lib -lXext -lm -llcgi -lqt -lXext -lX11
  LAnguage:         C
  File-Postfix:     .c

Hinweis:

Sollten Sie für QTDIR einen anderen Pfad als /usr/lib/qt3 eingestellt haben,
müssen Sie diesen bei den ComPiler- und Loader-Options anstelle von /usr/lib/qt3 angeben.
 
Die so eingestellten Optionen müssen Sie dann über den Menüeintrag

   Options-->Save Options

sichern.