KRay Help

Inhalt

• Einführung
• Installation
• Benutzerführung
• Bugs
• ToDo
• Authoren

---

Einführung

KRay ist ein kleines raytracing Programm für das KDE Projekt. KRay erzeugt Bilder einer einfachen Szene, bestehend aus Himmel, einem Boden, der Hölle, und zwei Kugeln, einer großen und einer kleinen. Für jedes Objekt der Szene können verschiedene Oberflächen gewählt werden. Dabei stehen Texturen (Marmor, Himmel, Hölle) und reflektierende Oberflächen wie Spiegel, Messing, Glas und Wasser zur Verfügung.

KRay basiert auf einem Programm von Josef Pöpsel and Ute Clausen welches in c't 1/93 veröffentlich wurde.

Installation

Die Installation von KRay folgt dem selben Schema wie die anderen KDE und GNU Pakete. Nachdem man die Quellen entpackt hat wechselt man ind das Hauptverzeichnis von KRay und tippt:

• ./configure
• make
• su -c"make install"

Normalerweise braucht man für die Installation Systemadministrationsrechte, daher der su Befehl. Um KRay compilieren zu können braucht man folgende Bibliotheken:

• qt, kdecore and kdeui

Using KRay

Nach dem Start zeigt KRay den Hauptdialog. Im Hauptdialog können die Bildgröße und die Oberflächen für die einzelnen Objekte der Szene eingestellte werden. Nach Beendigung der Einstellungen kann durch Drücken des Knopfes "Generate" oder durch Auswahl des Menupunktes "Generate Picture" aus dem File-Menu ein neues Bild erstellt werden.

Die Menuleiste

Das Menu von KRay ist selbsterklärend, weil es bisher nur minimale Einstellungen erlaubt. Weitere Möglichkeiten werden im Laufe der Programmentwicklung sicherlich hinzukommen.

Wahl der Bildgröße

Bei der Wahl der Bildgröße empfielt es sich das Seitenverhältnis von 4:3 beizubehalten, da die Szene darauf abgestimmt ist. Allerdings können Sie auch frei experimentieren. Beachten Sie, daß größere Bilder auch eine längere Rechenzeit brauchen (Ach ?). Auf meinem Pentim 133 System mit Linux brauch KRay etwa 2 Minuten um ein 400x300 Pixel großes Bild zu rendern.

Wahl der Oberflächen

KRay erlaubt es, verschiedene Oberflächen für die Objekte der Szene zu wählen. Die Oberflächen unterscheiden sich in Farbe, Reflexion und Durchsichtigkeit. Da der Himmel oder die Hölle nicht reflektierend oder durchsichtig sein dürfen, ist die Auswahl für diese beiden Objekte beschränkter als für die anderen. Die Oberfläche der Hölle ist nur sichtbar, wenn eine durchsichtige Oberfläche (Wasser oder Glas) für den Boden gewählt wird.

Bugs

Zur Zeit sind mir keine Bugs bekannt, aber allzuviel wurde das Programm auch noch nicht getestet ;-)

Bitte schicken Sie Bug-Reports an den Author

ToDo

• Möglichkeiten zum Zoomen und Abspeichern von Bildern
• Optionen zum verändern der Szene, der Lichtverhältnisse, etc.
• Code Optimierung
• Strukturierung und Dokumentation des Codes.

Authors

KRay wurde geschrieben vonTorsten Reuß .

---

Diese Hilfe wurde geschrieben vonTorsten Reuß

Installation

Installation of KRay has not been implemented yet. Once I've created the autoconf stuff, it will be very easy. Just do

• ./configure
• make
• make install

and everything will work fine. Nevertheless the following is needed:

• the corelibs kdecore, kdeui, kfm and qt

Using KRay

After starting KRay it will show the Main Dialog. Here you can chose the size of the picture you want to create as well as the surfaces for the different objects in the scene. Once you've done that, you can press the "Generate" Button or chose "Generate Picture" from the File-Menu and a new picture will be created.

The menubar

The contents of the menubar are rather self explanatory, because it contains only a minimum set of options. Further options will be added in future versions.

Chosing the picture size

For chosing the size of the picture I recomment retaining the 4:3 ratio, since it gives the best effects. You are however welcome to experiment ;-). Note that generating a bigger picture will take more time (you didn't expect that, did you ?) Generating a 400 by 300 pixel picture takes about 90 seconds on my Pentium 133 running Linux.

Chosing surfaces

The program offers different surfaces for the objects, which differ in color, reflection, and transition. Since the sky and the hell cannot be reflecting or tranient, the selection of surfaces for these objects is more limited than for the other objects. Note that the surface of the "Hell" can only be seen, when a transient surface (i.e. water or glass) is chosen for the ground.

Bugs

No Bugs known, but I haven't been testing too much ;-)

Please report bugs to the Authors

ToDo

• Multiple Window Support ala KView
• Zooming & Saving Pictures
• Process handling to have Program react while generating

Authors

KRay is written by Torsten Reuß .

This help file is written by Torsten Reuß