                                    JML_PSHL
                        eine Shell fr den POV-Raytracer

Einleitung:

Wie immer. Man sucht ein Programm, findet nichts entsprechendes (jedenfalls 
nichts, was einem gefllt) und schreibt den Kram dann selbst.

So auch hier.

Da es bestimmt schon ne Menge Shells fr den POV gibt, warum dann noch eine?

Antworten

- Mir gefllt sie besser

- Es knnen alle Optionen des POV gewhlt werden (mit drei Ausnahmen)

- Unter MTOS/Mag!X wird POV im Fenster gestartet und man kann gleich aus der 
  Shell heraus den POV mit einer weiteren Berechnung starten. Zum Schlu verlt 
  man die Shell und der/die POV(s) arbeiten weiter.



Installation:

Leider gibt's beim POV eine Einschrnkung der Kommandozeile auf 125 Zeichen. 
Unter Mag!X und MTOS sowieso (Fr 'Spezis': Die ARGV Unterttzung klappt nicht. 
Uter NTOS und Mag!X wird POV mittels shel_write gestartet; da gibt's eh kein 
ARGV).

Durch dies Beschrnkung kann man dem POV keine langen Parameter bergeben und 
somit mu eine Umgebung fr den POV wie folgt aufgebaut sein:


Man kann JML_PSHL irgendwohin kopieren (am besten in ein Verzeichnis POV oder 
so). In diesem Verzeichnis kann man sich verschieden Ordner fr folgende Files 
anlegen:

            Die Szenen           (*.POV)
            Die Includes         (*.INC)
            Die Graphiken        (*.GIF, *.IFF)
            Die fertigen Bilder  (*.TGA, *.RAW)
            Den Raystracer selbst

letzteres habe ich nur so eingebaut; Wer verschiedene Versionen benutzt findet 
das eventuell praktischer. Im Normalfall wird POV.TTP aber im selben Directory 
stehen wie JML_PSHL.


Nun geht's ans Einstellen. Beim ersten Start der Shell wird wahrscheinlich die 
Meldung kommen, da der SCENE-Pfad ungltig ist. Das liegt daran, da JML_PSHL 
keine *.POV Files finden konnte.

Alle Einstellungen geschehen im Men unter Parameter

Die Meneintrge sind:


    Optionen...      O

    GRAPHICS Pfad... G
    INCLUDE Pfad...  I
    SCENE Pfad...    S
    Ausgabepfad...   A

    POV finden...    P
    Editor finden... E

    UserPRGs...      U
    laden            ^L
    speichern        ^S

Unter Optinonen erscheint eine Dialogbox, die alle Einstellungen beherrbergt, 
die man als Voreinstellung fr die meisten Bilder nimmt. 

Das im Dialog keine der beliebten Checkboxen oder PopUps vorkommen ist 
nostalgisch begrndet. Ich habe mich zum Teil an 'alte' ATARI Standards 
gehalten.

Was kann man nun einstellen?

-   Status ausgeben     An/Aus
    Option  V
    Status des Bildes whrend des Rechnens ausgeben

-   Abbruch mit Taste   An/Aus
    Option X
    Abbruch der Berechnung mit Tastendruck

-   Ausgabeformat       TGA/RAW
    Option F
    Kein Kommentar

-   Puffergre         Wert/Aus
    Option B
    Die Gre des Puffers fr Berechnungen. Man kann in der linken Box die 
    Puffergre angeben oder die Option abschalten. Dann gilt die minimale Gre 
    des POV. Der Wert ist editierbar.

-   "smoothing"         Wert/Aus
    Option A
    Hier wird das Anti-aliasing ausgeschaltet oder der Wert in der linken Box 
    bernommen. Der Wert ist editierbar.

-   Auflsung
    Optionen W und H
    Die Gre des ferigen Bildes.

-   Qualitt
    Option Q
    Die Qualitt, in der das Bild berechnet wird.


Die genaue Bedeutung der Parameter ist der Doku des POV zu entnehmen.


Menpunkte xxxx Pfad...

Hier erscheint der Fileselektor und man whlt die Pfad aus, in denen die Files 
zum POV liegen. 

Wichtig!!!! Die Szenen (*.POV) werden immer im SCENE-Pfad gesucht, die Bilder 
werden immer in den Ausgabepfad geschrieben!!!

Die beiden anderen Pfade dienen nur zur besseren Gliederung. Wo die einzelnen 
Files (Includes, Pictures...) wirklich liegen ist egal. Dem POV werden (ber 
Option L) die GRAPHICS/INCLUDE/SCENE Pfad bergeben.


Menpunkt POV finden...

Wie der Name schon sagt. Hier wird angegeben wo der der POV liegt.


Menpunkt Editor finden...

Hier kann man einen Editor angeben, um 'mal schnell' in einem SCENE-File was
zu ndern.

Dieser Editor kann brigens stehen wo er will. Hier gibt's keine Beschrnkung 
des Pfads.

Menpunkt UserPRGs...

Ganz neu ist die Mglichkeit, bis zu drei Programm zu installieren.
Diese Programme kann man aus der Menleiste heraus (unter Exec) starten.

Unter UserPRGs whlt man zuerst mittels der RADIOBUTTONS ganz oben, ob
man nun Programm 1, 2 oder 3 angeben mchte.

Darunter steht der Pfad des Programms. Diese Zeile ist rein informativ.
Darunter steht der Name des Programms. Klickt man ihn an, erscheint der
Fileselector, und man kann nun ein UserProgramm auswhlen.

Zum guten Schlu kann man noch eine Kommandozeile definieren, die man dem
Programm bergeben mchte. Dies Kommandozeile darf Platzhalter enthlaten.

- An Stelle von #Q erscheint der Pfad und Name des gewhlten POV-Files
- #Z bergibt Pfad und Name des berechneten Bildes, das im 'berechne'Dialog
  steht.
- #F startet den Fileselector und fgt das ausgewhlte File in die
  Kommandozeile ein.

Selbstverstndlich kann die Platzhalter auch vermischen.

Anwendungen dafr gibt es viele. Ein Beispiel:

POV-Ray hat ein File WATERBOW.POV berechnet und als WATERBOW.TGA
gespeichert.

Als UserPRG #1 sei GEM-View angewhlt. Die Kommandozeile lautet: #Z

Startet man nun GEMVIEW.PRG aus Exec so wird GEM-View das File
WATERBOW.TGA aus dem Output-Ordner anzeigen.



Menpunkte laden/speichern

Man sichert die Einstellungen bzw. ld sie wieder ein, falls man mal was 
gendert hat.




Das war's dann auch schon. Die Shell ist konfiguriert und bereit zum loslegen.



Und wie? Nun, man kann jetzt ein SCENE-File ffnen. Im Men Datei/ffnen 
erscheint eine Auswahlbox der SCENE-Files. Dieses File wird dann fr 
Berechnungen verwendet. Die Auswahlbox meldet sich auch bei jedem Start des POV, 
so da man sofort ein File ausgewhlt hat.

Das soeben gewhlte File kann man nun zum Editor schicken (Datei/editieren) oder 
berechnen lassen (Datei/berechnen)

Im letzten Fall gelangt man (mal wieder) in eine Dialogbox.

Ganz oben steht die Eingabedatei (die man vor kurzem ausgewhlt hat). Wenn man 
die ndern will, klickt man einfach in das Feld und der Auswahldialog erscheint.

Darunter steht das Ausgabefile. Das Feld ist editierbar und man kann so den 
Namen des Files ndern. Nur den Namen, nicht den Typ!!! (Also ndern von *.TGA 
nach *.RAW bewirkt nicht automatisch, da nun ein RAW-File geschrieben wird).

Fr den Fall, da das Bild mal nicht mit der Standardauflsung berechnet werden 
soll, kann man diese unter Auflsung ndern. 

Wer nur einen Ausschnitt des Bildes haben will, bitte sehr, Man kann Die Anfangs 
und Endzeile angeben. Sobald die Endzeile grer ist, als die Auflsung zulsst, 
wird die max. Auflsung berechnet. Im Normalfall sind die Einstellungen 0 bzw. 
9999 also genau richtig, um das ganze Bild berechnen zu lassen.


Fr den Fall, da die Qualitt des Bildes mal nicht dem Standard aus 
Parameter/Optionen entsprechen soll, kann man sie hier durch anklicken ndern.


Unten steht dann noch

Weiterrechnen An/Aus

Steht das auf An, kann man ein bestehendes, unterbrochenes Bild weiterrechnen 
lassen. Das ist Option C des POV.

Am Ende des Dialogs finden sich noch drei Buttons

Abbruch   Logo. Was wohl

sowie  Rechne und...

-Weiter  Der POV wird aufgerufen. Nach dess Ende kehrt man in die Shell
         zurck; unter MTOS/Mag!X kommt man gleich zurck und kann
         weiterarbeiten.

-Ende    Der POV wird aufgerufen, die Shell verlassen.


So, das war's dann auch schon zur Doku.

Was wre noch zu sagen? Ach ja. Die drei Ausnahmen!

JML_PSHL erlaubt folgende Parameter nicht:

-f, +fd  weil's irgendwie keinen Sinn gibt.
+p       macht im Zusammenhang mit dieser Shell auch keinen Sinn
+d       Hlt nur auf und wird dem Original eh nicht gerecht



Ansonsten viel Spa mit der Shell. Die Benutzung ist kostenlos, die Weitergabe 
erwnscht.

Spenden werden jedoch jederzeit angenommen.

John McLoud
Taunussparkasse   BLZ 512 500 00
Kto # 9 45 02 97


Bugreports und hnliches an:

John McLoud
Mozartstrae 1a
65439 Flrsheim am Main

E-Mail an John Mcloud@WI2 im Mausnet

Dank an:

Michael Ruge       Test FALCON/MTOS
Dirk Haun          Test TT/Mag!X
Rainer Rosin       Dem Mann kann man nie genug danken
das POV-Team
Norbert Marschallak
