home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / prima_24 / prima.txt < prev   
Text File  |  1993-11-12  |  12KB  |  360 lines
  1.                                 P.R.I.M.A.
  2.             Pov Rays Interaktives Mausgesteuertes Auswahlprogramm
  3.  
  4.                       eine Shell für den POV-Raytracer
  5.  
  6. Einleitung:
  7.  
  8. Wie immer. Man sucht ein Programm, findet nichts entsprechendes (jedenfalls 
  9. nichts, was einem gefällt) und schreibt den Kram dann selbst.
  10.  
  11. So auch hier.
  12.  
  13. Da es bestimmt schon ne Menge Shells für den POV gibt, warum dann noch eine?
  14.  
  15. Antworten:
  16.  
  17. - Mir gefällt sie besser
  18.  
  19. - Es können alle Optionen des POV gewählt werden (mit zwei Ausnahmen)
  20.  
  21. - Unter MTOS/Mag!X wird POV im Fenster gestartet und man kann gleich aus der 
  22.   Shell heraus den POV mit einer weiteren Berechnung starten. Zum Schluß verläßt 
  23.   man die Shell und der/die POV(s) arbeiten weiter.
  24.  
  25. - Unter SingleTOS kann man die Ausgabe des POV in ein Fenster umgelenken.
  26.  
  27. - Man kann bis zu drei externe Programme 'als Anwendung anmelden' und
  28.   ihnen recht flexibel Parameter übergeben.
  29.  
  30. - Die Shell kann mehrere Szene-Files nacheinander berechnen lassen. Gut
  31.   für Nachtsessions, wenn die User schlafen und die Computer schuften
  32.   müssen.
  33.  
  34. - Bereits angefangene Berechnungen können ohne Parametereinstellung 
  35.   weitergeführt werden.
  36.  
  37. - PRIMA kommt auch mit POV 2.0 zurecht.
  38.  
  39. Installation:
  40.  
  41. Einfach PRIMA irgendwohin kopieren. Das war's.
  42.  
  43. Nun geht's ans Einstellen!
  44.  
  45. Alle Einstellungen geschehen im Menü unter Parameter.
  46.  
  47. Die Menüeinträge sind:
  48.  
  49.  
  50.     Optionen...      ◆O
  51.  
  52.     Pfade...         ◆I
  53.  
  54.     POV finden...    ◆P
  55.     Editor finden... ◆E
  56.  
  57.     UserPRGs...      ◆U
  58.  
  59.     laden            ^L
  60.     speichern        ^S
  61.  
  62. Unter Optinonen erscheint eine Dialogbox, die alle Einstellungen beherrbergt, 
  63. die man als Voreinstellung für die meisten Bilder nimmt. 
  64.  
  65. Das im Dialog keine der beliebten Checkboxen oder PopUps vorkommen ist 
  66. nostalgisch begründet. Ich habe mich zum Teil an 'alte' ATARI Standards 
  67. gehalten.
  68.  
  69. Es gibt zwei Arten von Radioboxen.
  70.  
  71. An/Aus      Man kann die Option nur Aktivieren/Deaktivieren
  72.  
  73. Wert/Aus  In der linken Box stellt man den gewünschten Wert ein. Aktiv ist er 
  74.           aber nur, wenn die Box auch selektiert ist. Mit der rechten Box 
  75.           schaltet man die Option ab.
  76.  
  77. Was kann man nun einstellen?
  78.  
  79. Zum einen, die Parameter für den POV natürlich. Ich verzichte hier auf eine 
  80. genaue Erklärung, da die Doku des POV ausführlich genug ist.
  81.  
  82. Zum anderen Paramter für die Shell.
  83.  
  84. Ich habe versucht, hier die Parameter unterzubringe, die man selten verändert, 
  85. bzw. die man gerne als Voreinstellung benutzt.
  86.  
  87.  
  88. -   Puffergröße         Wert/Aus
  89.     Option B
  90.  
  91. -   Symboltabelle        Wert/Aus
  92.     Option MS (ab POV 2.0)
  93.  
  94. -   'bounding slabs'    Wert/Aus
  95.     Option MB (ab POV 2.0)
  96.     
  97. -   'anti aliasing'     Wert/Aus
  98.     Option A
  99.  
  100. -    'jittering'            Wert/Aus
  101.     Option J
  102.  
  103. -    n*n Strahlen        Wert/Aus
  104.     Option    R (ab POV 2.0)
  105.  
  106. -    P.O.V. Version        1.0/2.0
  107.     Gibt an, ob man mit POV 1.0 oder POV 2.0 arbeitet. Das ist wichtig, da es 
  108.     zu heftigen Problemen kommt, wenn man POV 2.0 nur die 1.0 Parameter 
  109.     übergibt, und umgekehrt!
  110.  
  111. -    Pause nach POV
  112.     Enstpricht der Optiopn P des POV. Es handelt sich aber um eine interne 
  113.     Funktion der Shell, da, zumindest bei mir, der POV nicht immer Rücksicht 
  114.     auf die Option nimmt.
  115.     
  116. -    Aufllösung
  117.     Optionen W und H
  118.     Man gibt an, welche Auflösung als Voreinstellung verwendet wird, da man 
  119.     sehr oft mit einer bestimmten Auflösung rechnen lassen will. Es nervt 
  120.     halt, das immer erst wieder eingeben zu müssen.    
  121.  
  122. -   Qualität
  123.     Option Q
  124.     Auch 'nur' als Voreinstellung gedacht.
  125.     
  126. -   Status ausgeben     An/Aus
  127.     Option  V
  128.  
  129. -    Ausgabe in Fenster    An/Aus
  130.     Lenkt die Ausgabe des POV in ein Fenster um. Sieht einfach hübscher aus. 
  131.     Funktioniert nicht unter MultiTOS/Mag!X (warum wohl).
  132.     
  133. -   Abbruch mit Taste   An/Aus
  134.     Option X
  135.  
  136. -   Ausgabeformat       TGA/RAW
  137.     Option F
  138.  
  139.  
  140. Nun zum nächsten.
  141.  
  142. Pfade...
  143.  
  144. Es erscheint eine Dialogbox. Es gibt Felder für fünf verschiedene Pfade:
  145.  
  146. -    SCENE Pfad   1.0    hier sind die Szenen für POV 1.0
  147. -    SCENE Pfad   2.0    hier sind die Szenen für POV 2.0
  148. -    INCLUDE    Pfad 1.0    hier sind die Includes für POV 1.0
  149. -    INCLUDE Pfad 2.0    hier sind die Includes für POV 2.0
  150. -    Ausgabepfad         hierhin kommen die berechneten Bilder
  151.  
  152. Es werden die aktuellen Pfade dargestellt. Klickt man einen Pfad an, kann man 
  153. über die Fileselctbox den gewünschten Pfad einstellen.
  154.  
  155. Wer POV 1.0 benutzt braucht für die 2.0 Pfade nichts anzugeben.
  156. POV 2.0 User müseen ihre Szenen und Includes schon nach 1.0 und 2.0 trennen, 
  157. da die Files nicht voll kompatibel sind.
  158.  
  159.  
  160.  
  161. Menüpunkt POV finden...
  162.  
  163. Wie der Name schon sagt. Hier wird angegeben wo der der POV liegt.
  164.  
  165.  
  166. Menüpunkt Editor finden...
  167.  
  168. Hier kann man einen Editor angeben, um 'mal schnell' in einem SCENE-File was
  169. zu ändern.
  170.  
  171.  
  172. Menüpunkt UserPRGs...
  173.  
  174. Ganz neu ist die Möglichkeit, bis zu drei Programme zu installieren.
  175. Diese Programme kann man aus der Menüleiste heraus (unter Exec) starten.
  176.  
  177. Unter UserPRGs wählt man zuerst mittels der RADIOBUTTONS ganz oben, ob
  178. man nun Programm 1, 2 oder 3 angeben möchte.
  179.  
  180. Darunter steht der Pfad des Programms. Diese Zeile ist rein informativ.
  181. Darunter steht der Name des Programms. Klickt man ihn an, erscheint der
  182. Fileselector, und man kann nun ein UserProgramm auswählen.
  183.  
  184. Zum guten Schluß kann man noch eine Kommandozeile definieren, die man dem
  185. Programm übergeben möchte. Dies Kommandozeile darf Platzhalter enthlaten.
  186.  
  187. - An Stelle von #Q erscheint der Pfad und Name des gewählten POV-Files
  188.  
  189. - #Z übergibt Pfad und Name des berechneten Bildes, das im 'berechne'Dialog
  190.   steht.
  191.  
  192. - #F startet den Fileselector und fügt das ausgewählte File in die
  193.   Kommandozeile ein.
  194.  
  195. - #X steht für den Filenamen ohne Extension.
  196.  
  197.  
  198. Selbstverständlich kann man die Platzhalter auch vermischen und /oder
  199. etwas davor/dahinter schreiben.
  200.  
  201. Anwendungen dafür gibt es viele. Ein Beispiel:
  202.  
  203. POV-Ray hat ein File WATERBOW.POV berechnet und als WATERBOW.TGA
  204. gespeichert.
  205.  
  206. Als UserPRG #1 sei GEM-View angewählt. Die Kommandozeile lautet: #Z
  207.  
  208. Startet man nun GEMVIEW.PRG aus Exec so wird GEM-View das File
  209. WATERBOW.TGA aus dem Output-Ordner anzeigen.
  210.  
  211. Wäre die Kommandozeile #X.GIF würde GEMVIEW WATERBOW.GIF übergeben.
  212.  
  213.  
  214. Menüpunkte laden/speichern
  215.  
  216. Man sichert die Einstellungen bzw. läd sie wieder ein, falls man mal was 
  217. geändert hat.
  218.  
  219.  
  220.  
  221.  
  222. Das war's dann auch schon. Die Shell ist konfiguriert und bereit zum loslegen.
  223.  
  224.  
  225.  
  226. Und wie? Nun, man kann jetzt ein SCENE-File öffnen. Im Menü Datei/öffnen 
  227. erscheint der bekannte Fileselektor. Voreingestellt ist der SCENE-Pfad. 
  228.  
  229. Das soeben gewählte File kann man nun zum Editor schicken (Datei/editieren) oder 
  230. berechnen lassen (Datei/berechnen)
  231.  
  232. Im letzten Fall gelangt man (mal wieder) in eine Dialogbox.
  233.  
  234. Ganz oben steht die Eingabedatei (die man vor kurzem ausgewählt hat). Wenn man 
  235. die ändern will, klickt man einfach in das Feld und der Auswahldialog erscheint.
  236.  
  237. Daneben steht das Ausgabefile. Das Feld ist editierbar und man kann so den 
  238. Namen des Files ändern. Nur den Namen, nicht den Typ!!! (Also ändern von *.TGA 
  239. nach *.RAW bewirkt nicht automatisch, daß nun ein RAW-File geschrieben wird).
  240.  
  241. Unter Auflösung und Qualität stehen die Werte, die man unter Parameter 
  242. angegeben hat. Da man diese Werte aber nicht imm erso haben möchte, kann man 
  243. sie hier mal schnell' ändern, ohen das man immer in den Otionen Dialog muß.
  244.  
  245. Wer nur einen Ausschnitt des Bildes haben will, bitte sehr, Man kann Die Anfangs 
  246. und Endzeile angeben. Sobald die Endzeile größer ist, als die Auflösung zulässt, 
  247. wird die max. Auflösung berechnet. Im Normalfall sind die Einstellungen 0 bzw. 
  248. 9999 also genau richtig, um das ganze Bild berechnen zu lassen.
  249.  
  250. Mit POV 2.0 kann man auch Anfangs und End- Spalte angeben.
  251.  
  252. Ebenfalls für POV 2.0 steht noch die Einstellung der 'clock' zur Verfügung.
  253.  
  254. POV 2.0 User finden noch einen Kompatibilitätsbutton, um zwischen 1.0 und 2.0 
  255. umzuschalten. Es werden dann automatisch der richtige INCLUDE Pfad übergeben.
  256.  
  257. Weiterrechnen An/Aus schaltet die Option C ein oder aus.
  258.  
  259.  
  260. Am Ende des Dialogs finden sich noch vier Buttons
  261.  
  262. OK     Die Box wird verlassen; nix passiert.
  263.  
  264. sowie  Rechne und...
  265.  
  266. -Weiter  Der POV wird aufgerufen. Nach dess Ende kehrt man in die Shell
  267.          zurück; unter MTOS/Mag!X kommt man gleich zurück und kann
  268.          weiterarbeiten.
  269.  
  270. -Ende    Der POV wird aufgerufen, die Shell verlassen.
  271.          Unter SingleTOS läuft der POV nicht im Fenster, da die Shell
  272.          beendet wurde, und das Fenster nicht mehr schließen könnte.
  273.  
  274.  
  275. und  Liste  aufnehmen.
  276.  
  277. Klickt man ihn an, werden die Einstellungen in der Dialogbox in eine
  278. Warteschlange übernommen, die dann für den MultiPOV verwendet wird.
  279.  
  280. Die Liste darf bis zu zwölf Einträge umfassen.
  281.  
  282. Im Hauptmenü unter    Multi...   kann man sich diese Liste ansehen, alle
  283. oder einzelne Einträge löschen und natürlich die Liste aktivieren.
  284.  
  285. Sollte sich ein POV File doppelt in der Liste befinden, sind auf jeden
  286. Fall irgendwelche Parameter anders. Um dem auf den Grund zu gehen, erhält
  287. man durch Doppelklick auf einen Eintrag ein paar Infos.
  288.  
  289. Ist man sich nun sicher, daß die Liste so OK ist, klick man auf OK und
  290. die Shell startet POV nacheinander mit den Files. Auch unter MTOS/Mag!X
  291. werden die Files nacheinander bearbeitet. Paralelles Arbeiten mit anderen
  292. Applikationen ist natürlich möglich.
  293.  
  294. Möchte man  MultiPOV abbrechen kommt's drauf an, ob man unter 'normalem'
  295. TOS oder Multitasking arbeitet. Im letzteren Fall wurd von der Shell ein
  296. Fenster geöffnet. Im Fenster steht, welches File gerade berechnet wird.
  297. Klickt man den Closer des Fensters an, wird der MultiPOV abgebrochen; die
  298. gerade laufende Berechnung wird aber forgteführt. Möchte man die auch
  299. abbrechen, geht das ganz normal durch Tastendruck.
  300.  
  301. Unter 'normalem' TOS muß man zuerst die gerade laufende Berechnung
  302. abbrechen (Taste!). Dann hat man zehn Sekunden Zeit, den MultiPOV zu
  303. beenden. Diese zehn Sekunden werden immer zwischen zwei Berechnungen im
  304. MultiPOV eingeschoben.
  305.  
  306.  
  307. Und weiter geht's in der Menüleiste:
  308.  
  309. Ganz neu ist der Eintrag 'Angefangenes'
  310. Ruft man diesen Punkt auf, erscheint der Fileselektor. Nun kann man unter 
  311. Files auswählen, die man schonmal angefangen hat, aber die Berechnung abbrach. 
  312. Einfach ein File wählen und ab geht's; ohne Vorher irgendwelche Parameter 
  313. eingestellt zu haben. Es werden die Parameter genommen, mit denen das Bild 
  314. gerendert wurde. Egal was man gerade aktuell eingestellt hat.
  315.  
  316.  
  317. Zum Schluß hätten wir dann noch die Menüpunkte unter Exec. Hier startet man 
  318. die drei Userprogramme. Außerdem ist es möglich mit Programm starten ein 
  319. beliebiges Programm ausführen zu lassen.
  320.  
  321.  
  322. So, das war's dann auch schon zur Doku.
  323.  
  324. Was wäre noch zu sagen? Ach ja. Die drei Ausnahmen!
  325.  
  326. PRIMA erlaubt folgende Parameter nicht:
  327.  
  328. -f, +fd  weil's irgendwie keinen Sinn gibt.
  329. +d       Hält nur auf und wird dem Original eh nicht gerecht
  330.  
  331.  
  332.  
  333. Ansonsten viel Spaß mit der Shell. Die Benutzung ist kostenlos, die Weitergabe 
  334. erwünscht.
  335.  
  336. Spenden werden jedoch jederzeit angenommen.
  337.  
  338. John McLoud
  339. Taunussparkasse   BLZ 512 500 00
  340. Kto # 9 45 02 97
  341.  
  342.  
  343. Bugreports und ähnliches an:
  344.  
  345. John McLoud
  346. Mozartstraße 1a
  347. 65439 Flörsheim am Main
  348.  
  349. E-Mail an John Mcloud@WI2 im Mausnet
  350.  
  351. Dank an:
  352.  
  353. Michael Ruge          für den Test FALCON/MTOS
  354. Dirk Haun             für den Test TT/Mag!X
  355. Reiner Rosin          Dem Mann kann man nie genug danken
  356. das POV-Team          warum wohl
  357. Norbert Marschallak   für die Portierung des POV auf ATARI ST
  358. Walter Vieser         weil...
  359.  
  360.