DGL Benchmark - Java Jogl Referenzimplementierung

Abkrzung: 'DGL Benchmark JJR'


1. Verwendung
2. Wie schreibe ich eigene Benchmarks?
3. Abhngigkeiten von Fremdbibliotheken

----------------------------------------------------------------

1. Verwendung
=============

Vorraussetzung
--------------
Vorrausgesetzt wird mindestens Java in der Version 1.5

Um zu prfen welche Java Version vorhanden ist, kann in der Komandozeile "java -version" ausgefhrt werden.

Ist der Befehl "java" unbekannt, oder die Version kleiner als 1.5, muss eine aktuellere Version installiert werden.
Java Laufzeitumgebungen knnen kostenlos von http://www.java.com heruntergeladen werden.

Zum Zeitpunkt des erscheinens dieses Programs war "Java 6 Update 17" (1.6.0_17) aktuell.


Windows
-------
Den DGL Benchmark startet man durch Aufruf der beiligenden "startDglBenchmark.bat".

Linux
-----
Den DGL Benchmark startet man durch Aufruf der beiligenden "startDglBenchmark.sh".

Mac
---
Den DGL Benchmark startet man durch Aufruf der beiligenden ".............".


2. Wie schreibe ich eigene Benchmarks?
======================================
Im Ordner "/spec" findet man das Package "com.delphigl.benchmark.benchmarks"

Dieses enthlt 

1. IDGLBenchmark.java
---------------------
Jeder Benchmark der von der 'DGL Benchmark JJR' genutzt werden soll, muss dieses Interface implementieren.
Weitere Infos bietet die Spezifikation des DGL Benchmarks. (http://wiki.delphigl.com/index.php/DGL_Benchmark)

2. StdShadingBenchmark.java und BeginEndBenchmark.java
------------------------------------------------------
Diese beiden Benchmarks knnen als Vorlage fr eigene Benchmarks genutzt werden.
Sie sind ebenfalls als jar Files im "/benchmarks" Ordner verfgbar.


Nachdem man eigene Benchmarks implementiert hat, exportiert man diese als JAR (idealerweise eine Benchmarkklasse pro jar).
Die JAR Files werden dann in den "/benchmarks" Ordner kopiert.

Als (fast) letzter Schritt mssen die vollstndigen Klassennamen der neuen Benchmarkklassen noch in jeweils eine Zeile der "benchmark.conf" im Hauptordner (neben den Startscripten) eingetragen werden.

Bei Java 1.6 sollte jetzt bereits der neue Benchmark laufen.
Da aber Java 1.5 auch untersttzt werden soll muss noch ein File angepasst werden.
Da Java 1.5 nicht alle Jars in einem Ordner dem Klassenpfad hinzufgen kann (sowie Java 1.6) muss in der Datei "classpath.txt" noch eine zustzliche Zeile mit dem Pfad des neuen Benchmark-Jars hinterlegt werden.


Danach sollte der 'DGL Benchmark JJR' die neuen Benchmarks auch unter Java 1.5 mit ausfhren.



3. Abhngigkeiten von Fremdbibliotheken
=======================================
Zur Anzeige wird die "Java OpenGL Library" (JOGL) genutzt. Die Version 1.1.1 liegt dem Benchmark bei.

Fr das XML Handling (schreiben der Ausgabe) wird die Apache XMLBeans Library verwendet. Die ntigen JARs liegen im Ordner "/xmlBeans".