Reply to comment

Damit ihr die in den Kursen enthaltenen Beispiele direkt selbst ausprobieren könnt, benötigt ihr eine Eclipse-Installation mit einem Projekt in dem JOGL eingebunden ist.

Das Zielverzeichnis

Überlegt euch einen Ordner in dem ihr alles speichern möchtet das zu den Programmierkursen gehört - ich empfehle einen Ordner im Heimatverzeichnis. Für Windows XP zum Beispiel C:/Dokumente und Einstellungen/BENUTZERNAME/Eigene Dateien/kurse_3dcoding. Oder für Vista C:/Benutzer/BENUTZERNAME/kurse_3dcoding.

In der folgenden Installationsanleitung benutze ich den Platzhalter DIR für dieses Verzeichnis - immer wenn im folgenden Text also DIR vorkommt, müsst ihr dafür euer gewähltes Verzeichnis einsetzen!

Installation der Komponenten

1. Falls ihr noch kein Java 6 auf dem Rechner haben solltet, dann ladet euch das als erstes herunter und installiert es. Das Paket das wir brauchen ist das JDK 6 Update 13 with JavaFX SDK - es genügt wenn der Name so ähnlich klingt (hauptsache Java 6 und SDK kommen im Namen vor). Die Installation sollte problemlos und schnell ablaufen. Sobald Java fertig installiert ist, geht es weiter mit Eclipse.
2. Ladet euch Eclipse herunter - wählt die Variante Eclipse IDE for Java Developers (85 MB) aus und stellt sicher, dass ihr die richtige Version für euer Betriebssystem herunterladet.
3. Entpackt das Eclipse-Archiv in das Verzeichnis DIR. Ihr erhaltet dann den Ordner DIR/eclipse. Falls ihr das Archiv anders ausgepackt habt und noch andere Ordner zwischen DIR und eclipse liegen, dann verschiebt einfach den eclipse-Ordner direkt nach DIR und löscht die dann leeren Ordner.
4. Startet eclipse indem ihr die eclipse.exe aufruft. Nach einer Weile werdet ihr nach dem Ort des Workspaces gefragt - gebt hier dann DIR/workspace an (nicht vergessen: DIR durch EUER ausgesuchtes Verzeichnis ersetzen)
   Die Auswahl eines Workspaces
5. Eclipse müsste nun starten und euch den Startbildschirm zeigen
   Das Hauptfenster von Eclipse
6. Ladet euch JOGL herunter - und zwar sowohl die jogl-1.1.1-docs.zip also auch die für euer Betriebssystem passende zip-Datei. Für ein 32bit Windows XP ist das z.B. die jogl-1.1.1-windows-i586.zip. Legt beide Dateien unter dem Ordner DIR/jogl ab.

Konfiguration von Eclipse

Die folgenden Schritte erzeugen ein neues Java-Projekt in Eclipse und konfigurieren es so, dass JOGL aktiviert ist.

1. Erzeugt in Eclipse ein neues Projekt indem ihr mit der rechten Maustaste in den Package Explorer klickt und dann New / Java Project auswählt.
   Erzeugen eines neuen Java-Projekts in EclipseIn das Fenster tragt ihr dann einen Namen für das Projekt ein (z.B. "Spieleprogrammierung_01") und drückt auf Finish.
   Der Dialog zum Erzeugen eines neuen Projekts
2. Das Projekt ist nun erstellt, aber noch leer und unterstützt auch noch kein JOGL. Damit JOGL verfügbar wird, erzeugt zunächst das Verzeichnis lib aus Eclipse heraus: Klickt mit der rechten Maustaste auf den obersten Punkt im Package Explorer (dies ist der Projektknoten, dessen Namen ihr ihm gegeben habt). Wählt dann New / Folder aus und gebt dort "lib" ein. Nach Finish ist der Ordner erstellt. Der Ordner befindet sich nun unter DIR/workspace/PROJEKTNAME/lib
3. In diesen Ordner müssen nun alle Dateien aus dem lib-Ordner des heruntergeladenen jogl-zip-Archivs kopiert werden. Für Windows sind das die folgenden Dateien:
   • gluegen-rt.dll
   • gluegen-rt.jar
   • jogl.dll
   • jogl.jar
   • jogl_awt.dll
   • jogl_cg.dll

   Der lib-Ordner mit den hineinkopierten JOGL-Libraries

4. Damit Eclipse diese neuen Dateien auch erkennt, drückt einmal F5 in eclipse nachdem ihr den Projektknoten mit der linken Maustaste angeklickt habt.
5. Für beide jar-Dateien muss nun jeweils mit der rechten Maustaste das Kontextmenü aufgerufen werden und dann Build Path / Add to Build Path ausgewählt werden. Dadurch werden die JAR-Dateien in den Suchpfad aufgenommen und Eclipse weiss nun wo es nach den JOGL Klassen suchen muss.
6. Da die JOGL-Klassen ja nur eine Schicht zwischen Java und dem OpenGL-Treiber des Betriebssystems darstellen, benötigt JOGL noch betriebssystemabhängige Funktionen die in den .dll-Dateien enthalten sind (für Linux in den .so-Dateien). Damit diese zur Laufzeit auch gefunden werden muss deren Ort noch bekannt gemacht werden.
7. Ruft das Kontextmenü für das Projekt auf und wählt dort den letzten Punkt unten: Properties.
8. Die Eigenschaften eines ProjektsIn diesem Fenster muss links Java Build Path ausgewählt werden und rechts die Registerkarte Libraries. Klappt dort den Eintrag für "jogl.jar" auf.

Verknüpfen der nativen Bibliotheken

1. Doppelklickt auf Native library location und wählt dort über den Button Workspace... den Ordner lib eures Projekts aus. Anschließend mit OK den Dialog schließen.

Einbinden der JavaDocs für JOGL

1. Doppelklickt auf Javadoc Location und wählt dann Javadoc in Archive und External File aus. Mittels dem Button Browse... könnt ihr dann die Datei jogl-1.1.1-docs.zip auswählen. In das Eingabefeld Path within archive gebt ihr den Ordner an der in der jogl-1.1.1-docs.zip Datei auf der obersten Ebene enthalten ist. In der Version die zur Zeit dieses Artikel aktuell ist, ist das der Ordner "jogl-1.1.1-docs".
   Damit zeigt euch Eclipse von nun an beim Programmieren die Dokumentation zu den einzelnen Methoden direkt beim Eingeben an.
2. Ich empfehle euch dringend nun das automatische Vervollständigen abzuschalten. Die GL-Klasse enthält viele Methoden so dass ihr jedesmal, wenn ihr "gl." schreibt, eine Wartezeit von ca. 5-10 Sekunden einkalkulieren dürft bevor die Liste der für das gl-Objekt verfügbaren Methoden erscheint. Probiert es ruhig eine Weile aus wenn ihr möchtet.

   Zum Abschalten geht ihr in das Hauptmenü von Eclipse und wählt dort Window / Preferences aus. In dem Dialog klappt ihr Java / Editor / Content Assist aus entfernt dort den Haken:
   Automatischen Code Assist abschalten
   Ihr müsst ab jetzt im Editor den Kontext-Assistenten zum Vervollständigen immer mit Strg+SPACE aufrufen wenn ihr ihn benötigt.

Zusammenfassung

Ihr solltet nun einen Ordner DIR haben, den ihr euch selbst ausgesucht habt und der folgendes beinhaltet:

Testen der Installation

Um auszuprobieren ob alles richtig gelaufen ist, kopiert die Datei InstallTest.java in den Ordner src eures Workspaces und aktualisiert diesen in Eclipse wieder mit F5 damit Eclipse die Datei auch findet.
Das Programm startet ihr über das Kontextmenü:
Starten der Test Applikation
Und wenn alles richtig gelaufen ist, dann solltet ihr einen sich drehenden Teekessel sehen:
Erfolgreich laufende Test Applikation

Ihr seid jetzt startklar für die Spieleprogrammierkurse und ich hoffe ihr werdet viel Freude und Erfolg damit haben! Sollte an dieser Anleitung etwas nicht korrekt sein oder ihr auf ein Problem stossen, so schreibt mir einfach. Meine eMail-Adresse findet ihr im Impressum!