home *** CD-ROM | disk | FTP | other *** search
/ Taifun Collection / Taifun_Collection_Vol_1.iso / richter / 8429 / 8429.mhs / RICHTER.DTP / POVSHEL / POVSHELL.DOC < prev    next >
Text File  |  1993-06-22  |  16KB  |  372 lines
  1.  
  2.  
  3.  
  4.  
  5.                ╔══════════════════════════════════════════╗
  6.                ║                                          ║
  7.                ║          POV-Shell  Version 1.0          ║
  8.                ║                                          ║
  9.                ║                   von                    ║
  10.                ║                                          ║
  11.                ║             André Kinnigkeit             ║
  12.                ║              (c) Juni 1993               ║
  13.                ║                                          ║
  14.                ╚═══════════ Shareware-Version ════════════╝
  15.  
  16.  
  17.  
  18.  
  19. 1. Was soll POV-Shell?
  20.  
  21. Raytracing erfreut sich immer größerer Beliebtheit, und der wohl am meisten
  22. verbreitete    Raytracer    ist   POV   Ray.   Er   besticht   durch   hohe
  23. Leistungsfähigkeit  und seinen günstigen  Preis (POV Ray wird  als Freeware
  24. vertrieben).
  25. Nachteil  dieses (und anderer) Raytracer ist deren Steuerung über Kommando-
  26. zeilenparameter.  Daher  wird  mit  POV  Ray das englischsprachige POV Menu
  27. geliefert.  Ein  deutschsprachiges  Pendant  dazu soll POV-Shell sein. Doch
  28. dessen  nicht  genug.  POV-Shell  ist  eine  grafische Oberfläche mit Maus-
  29. steuerung,  verfügt  über  10  frei vom Nutzer konfigurierbare Schalter für
  30. Utilities  und  beinhaltet  eine Referenzübersicht über die Schlüsselwörter
  31. von POV Ray.
  32.  
  33.  
  34.  
  35. 2. Allgemeines
  36.  
  37. POV-Shell  arbeitet  mit Eingabefeldern, Checkboxen und Schaltern. Schalter
  38. werden  durch  Anklicken  mit  der linken Maustaste betätigt. Eingabefelder
  39. werden  durch Anklicken mit der linken Maustaste aktiviert. Darauf wird die
  40. Kontrolle  an  die Tastatur übergeben und man kann die Eingabe tätigen oder
  41. mit  der <ESC>-Taste das Eingabefeld wieder verlassen. Einige Eingabefelder
  42. kontrollieren  die  Eingaben auf Gültigkeit. Wenn Sie also nach Beenden der
  43. Eingabe  durch  die <ENTER>-Taste nicht den Mauszeiger wiedererhalten, dann
  44. war  die Eingabe ungültig. Checkboxen werden durch Anklicken mit der linken
  45. Maustaste aktiviert und deaktiviert. POV-Shell verfügt über eine eingebaute
  46. Hilfefunktion.  Sie  können  so  ziemlich  jedes  Bildschirmelement mit der
  47. rechten  Maustaste anklicken und so Hilfe zu diesem Element anfordern. Alle
  48. sich öffnenden Pop-up-Fenster lassen sich entweder (wenn vorhanden) mit der
  49. <Abbrechen>-Taste oder mit der rechten Maustaste verlassen.
  50.  
  51.  
  52.  
  53. 3. Systemanforderungen
  54.  
  55. POV-Shell  dürfte  auf jedem IBM-kompatiblen PC, auf dem POV Ray 1.0 läuft,
  56. funktionieren. Eine (S)VGA-Karte und eine MS-kompatible Maus sind zwingende
  57. Voraussetzungen  für  POV-Shell.  Es  wird  weder  XMS-  noch  EMS-Speicher
  58. verwendet,  der  konventionelle  Speicher  möchte aber schon möglichst frei
  59. sein.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. POV-Shell 1.0               Shareware-Version                       Seite 2
  70. ───────────────────────────────────────────────────────────────────────────
  71.  
  72. 4. Weitere wichtige Voraussetzungen
  73.  
  74. POV-Shell   setzt  die  von  POV  Menu  vorgeschlagene  Verzeichnisstruktur
  75. zwingend  voraus,  d.h. die Scriptdateien (*.pov) müssen in einem Unterver-
  76. zeichnis  namens SCENES und die Bilddateien (*.tga) in einem Unterverzeich-
  77. nis  namens  IMAGES  vom  POV  Ray-Programmverzeichnis  zu finden sein. Das
  78. Verzeichnis mit den für die Berechnung benötigten Dateien (*.inc, *.gif,..)
  79. kann in POV-Shell individuell festgelegt werden. Der Verzeichnisbaum sollte
  80. also so aussehen:
  81.                           ─ POVRAY
  82.                                │
  83.                                ├─ IMAGES
  84.                                ├─ INCLUDE
  85.                                ├─ SCENES
  86.                                └─ UTILS (evtl.)
  87.  
  88. Folgende Dateien sind für POV-Shell nötig und sollten im POV Ray-Programm-
  89. verzeichnis zu finden sein:
  90.     SHELL.EXE      die Programmdatei
  91.     SHELL.HLP      die POV-Shell-Hilfen
  92.     SHELL.OPT      die gespeicherten Optionsgruppen
  93.     SHELL.SCH      die Belegung der 10 freien Schalter
  94.     SHELL.REF      die POV Ray-Referenz
  95.     SHELL.CFG      die Einstellungen der letzten POV-Shellsitzung
  96.     POVSHELL.BAT   die Startdatei für POV-Shell
  97.     TEMP.BAT       bildet mit POVSHELL.BAT das rekursive Batchsystem
  98.     INSTALL.DOC    Installations- und Startanleitung
  99.     POVSHELL.DOC   diese Dokumentation
  100.     POVSHELL.REG   Registrierungsformular
  101.  
  102.  
  103.  
  104. 5. Die Benutzung von POV-Shell
  105.  
  106. 5.1. Die Eingabefelder
  107.  
  108. POV  Ray  erwartet ein Scriptfile, in dem die Eigenschaften der Objekte der
  109. zu  berechnenden Szene beschrieben werden. Dies ist ein normales ASCII-File
  110. mit  der  Endung  ".pov". (Andere Endungen sind theoretisch möglich, werden
  111. von POV-Shell aber nicht erkannt.)
  112. Der  Name  dieser  Datei  muß  (ohne  Endung !!!) in dem Eingabefeld SCRIPT
  113. angegeben werden.
  114. In der Shareware-Version von POV-Shell müssen Sie diesen Dateinamen im Kopf
  115. haben, in der Vollversion kann er aus einem Dateifenster ausgewählt werden.
  116.  
  117. Das  berechnete  Bild  wird von POV Ray im 24-Bit-Targa-Format gespeichert.
  118. Der  Name  dieser Bilddatei muß im Eingabefeld BILD festgelegt werden. Hier
  119. gilt  die gleiche Bemerkung bezüglich des Unterschiedes zwischen Shareware-
  120. und  Vollversion  wie  bei  SCRIPT. Besonders in  der  Sharewareversion ist
  121. darauf  zu  achten,  daß  man keine Bildnamen doppelt verwendet. Es erfolgt
  122. durch POV-Shell keine Prüfung, ob die angegebene Datei bereits existiert.
  123. Der Bildname  wird  standardmäßig auf  den Namen  der Scriptdatei  gesetzt.
  124.  
  125. Das  dritte  Eingabefeld legt den Suchpfad für include- und gif-Files fest.
  126. Es  muß  ein  gültiger Pfadbezeichner angegeben werden, POV-Shell überprüft
  127. nicht, ob dieser Pfad wirklich existiert.
  128.  
  129. Die  folgenden  Eingabefelder überprüfen Ihre Eingaben auf Gültigkeit. Ihre
  130. Wertebereiche sind hinter den Eingabefeldern jeweils angegeben.
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. POV-Shell 1.0               Shareware-Version                       Seite 3
  139. ───────────────────────────────────────────────────────────────────────────
  140.  
  141. Da  wären  zunächst  die  Eingabefelder für die Bildbreite und -höhe. Diese
  142. Parameter  bestimmen  die  Auflösung  des Bildes. Es folgen die Angaben zur
  143. Start-  und  Endzeile  für  die  Berechnung.  Über  diese  Parameter können
  144. Bildausschnitte berechnet werden. Da man meist ganze Bilder berechnet, wird
  145. die Endzeile bei Veränderung der Bildhöhe entsprechend mit verändert.
  146.  
  147. POV Ray gestattet die Einrichtung eines Ausgabepuffers, dieser wird mittels
  148. des  nächsten  Eingabefeldes  realisiert.  Wird  kein  Puffer  (Eingabe  0)
  149. vereinbart,  so  wird  im  Falle  der  Ausgabedateierzeugung  jede einzelne
  150. Bildzeile  unmittelbar  nach  ihrer  Berechnung  abgespeichert.  Ein Puffer
  151. verhindert diese häufigen Disk-Zugriffe.
  152.  
  153. Das  vorletzte  Eingabefeld  regelt  die  Benutzung von Anti-Aliasing. Beim
  154. Anti-Aliasing  werden  mehr  Lichtstrahlen  als  gewöhnlich  in  die  Szene
  155. geschossen und dann über diese gemittelt. Ergebnis ist ein "weicheres" Bild
  156. (und eine längere Rechenzeit).
  157.  
  158. Letztes  Eingabefeld ist die Angabe der Qualität (des Umfanges) der Berech-
  159. nung. Die Werte haben folgende Bedeutung:
  160.     0,1  nur Farben außerhalb der texture-Blöcke der Scriptdatei werden
  161.          berücksichtigt
  162.     2,3  die Attribute ambient und diffuse werden berücksichtigt
  163.     4,5  die Schatten werden berechnet
  164.     6,7  die Oberflächenmuster (Texturen) werden berücksichtigt
  165.     8,9  die Szene wird in jeder Einzelheit berechnet
  166.  
  167.  
  168. 5.2. Die Checkboxen
  169.  
  170. Unterhalb der Eingabefelder sind die Checkboxen angeordnet.
  171.  
  172. Ist die oberste Box aktiviert, so erstellt POV Ray eine Bilddatei der Szene
  173. im  Targa-Format.  Bleibt diese Box inaktiv, so erfolgt die Berechnung ohne
  174. jegliche Abspeicherung.
  175.  
  176. Die   zweite  Checkbox  regelt  die  Darstellung  des  Bildes  während  der
  177. Berechnung.  Ist  sie  aktiv,  so kann man am Bildschirm die Bildentstehung
  178. verfolgen,   ist  sie  inaktiv,  so  zeigt  POV  Ray  das  Bild  nicht  an.
  179. Voraussetzung  für die Anzeige ist, daß in der Datei POVRAY.DEF der Eintrag
  180. +d??  vorhanden ist. (Alle anderen Einträge in dieser Datei können gelöscht
  181. werden,  da  die  von  POV-Shell  übergebenen  Werte  eine höhere Priorität
  182. haben.)  Die  Fragezeichen  müssen  durch Werte für Grafikkarte und Palette
  183. ersetzt  werden,  die von Ihrer Hardware abhängen. Wird nur +d eingetragen,
  184. so  nimmt  POV  Ray  eine  normale  VGA-Karte  an  und  arbeitet  mit  eine
  185. Standardfarbpalette.  Die  gültigen  Werte für diese d-Option werden in der
  186. Datei IBMPC.DOC des Raytracers erläutert.
  187.  
  188. Es  folgt  eine Checkbox, mit der festgelegt werden kann, ob der Rechenvor-
  189. gang  durch  einen Tastendruck abgebrochen werden kann. Diese Option sollte
  190. immer  aktiv  sein  (es sei denn, Sie haben kleine Kinder, die zu gerne auf
  191. der  Tastatur  Klavier  spielen).  Durch  diese Option ist es möglich, kom-
  192. plexere  Bilder  zu  berechnen  ohne tagelang auf den Rechner verzichten zu
  193. müssen. Man läßt POV Ray einfach arbeiten, während man selbst ißt, schläft,
  194. arbeitet...
  195. Im  Falle  eines  Abbruchs  wird ein eingerichteter Ausgabepuffer natürlich
  196. noch abgespeichert.
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206. POV-Shell 1.0               Shareware-Version                       Seite 4
  207. ───────────────────────────────────────────────────────────────────────────
  208.  
  209. Die  vierte  Checkbox  bewirkt,  so  sie  aktiviert wurde, daß POV Ray nach
  210. getaner  Arbeit  auf  einen Tastendruck wartet. So können Sie in aller Ruhe
  211. das fertige Bild bzw. die angezeigte Statistik ansehen.
  212.  
  213. Die  fünfte  Checkbox  erlaubt die Weiterberechnung eines Bildes, daß zuvor
  214. durch  Benutzung  der  dritten Checkbox abgebrochen wurde. POV Ray sucht in
  215. der  unter  BILD angegeben Datei das Ende und setzt seine Arbeit dort fort.
  216. Es  ist  darauf zu achten, daß die Werte für Bildhöhe und -breite sowie für
  217. Qualität,  Anti-Aliasing  usw.  die  gleichen sind wie bei der anfänglichen
  218. Berechnung des Bildes.
  219.  
  220. Die  letzte  Checkbox bewirkt bei ihrer Aktivierung die Anzeige des Zeilen-
  221. status  während  der Berechnung, d.h. POV Ray zeigt an, in welcher Zeile er
  222. gerade  arbeitet  und  wieviel  Zeilen bis zum Ende des Bildes zu berechnen
  223. sind.
  224. Diese  Option  darf  nicht  gleichzeitig mit der Anzeige des Bildes gewählt
  225. werden !
  226.  
  227.  
  228. 5.3. Die Schalter
  229.  
  230. 5.3.1. Optionen speichern
  231.  
  232. POV-Shell  erlaubt  die Speicherung von 10 Optionsgruppen. Denkbar ist bei-
  233. spielsweise ein Option QUICKVIEW 160x100 o.ä.
  234. Nach Betätigung des Schalters öffnet sich ein Dialogfeld, in dem eine Liste
  235. der  bereits  gespeicherten  Optionsgruppen  angezeigt wird. Mit der linken
  236. Maustaste  wählt man nun eins der 10 Felder aus, gibt einen Namen für diese
  237. Gruppe ein und bestätigt mit <ENTER>. Daraufhin werden alle Optionen, außer
  238. SCRIPT,  BILD  und  SUCHPFAD, so wie sie gerade eingestellt waren abgespei-
  239. chert.  Mittels  <ESC>  kann  ein fälschlicherweise aktiviertes Eingabefeld
  240. verlassen und mittels rechter Maustaste das Fenster geschlossen werden.
  241.  
  242.  
  243. 5.3.2. Optionen laden
  244.  
  245. Mit  diesem  Schalter  können  zuvor  gespeicherte  Optionsgruppen  geladen
  246. werden.  Durch  Anklicken  mit  der  linken Maustaste wählt man in dem sich
  247. öffnenden  Dialogfeld  die  gewünschte Optionsgruppe aus, diese wird sofort
  248. geladen.  Durch  Druck  auf die rechte Maustaste kann das Fenster ohne Wahl
  249. einer Gruppe geschlossen werden.
  250.  
  251.  
  252. 5.3.3. Schalter-Setup
  253.  
  254. Nach  Aktivierung  dieses  Schalters  können  die  10 frei konfigurierbaren
  255. Schalter mit Programmen belegt werden.
  256. Das geht folgendermaßen:
  257. <SCHALTER-SETUP>  drücken  und den zu belegenden Schalter wählen. Daraufhin
  258. öffnet  sich ein Fenster, in dem die Schalterbeschriftung, der Programmname
  259. mit  Endung  (und  Pfadangabe, falls sich das Programm nicht in einem Path-
  260. Verzeichnis befindet) und an das Programm zu übergebene Optionen eingegeben
  261. werden können. POV-Shell überprüft weder Pfad- noch Dateingaben !
  262. Als Optionen stehen Ihnen neben den Optionen Ihres Programms die Schlüssel-
  263. wörter  SCRIPT  und  BILD  zur  Verfügung.  Diese werden bei einem späteren
  264. Aufruf des Schalters durch die dann eingestellten Dateinamen für SCRIPT und
  265. BILD ersetzt. Dabei wird der Pfad und die Endung ergänzt.
  266. Achtung: Jedes Vorkommen der Zeichenfolgen SCRIPT und BILD in der Optionen-
  267.          Zeichenkette  wird ersetzt! Eine  Pfadangabe wie "c:\bilder" kann
  268.          also nicht verwandt werden.
  269. Die  Konfigurierung wird mit <OK> abgeschlossen  oder mit <Abbrechen> abge-
  270. brochen.
  271.  
  272.  
  273.  
  274. POV-Shell 1.0               Shareware-Version                       Seite 5
  275. ───────────────────────────────────────────────────────────────────────────
  276.  
  277.  
  278. 5.3.4. POV Ray-Hilfe
  279.  
  280. Hinter diesem Schalter verbirgt sich praktisch die deutsche Übersetzung der
  281. mit  POV  Ray gelieferten Datei QUICKREF.DOC. Hier werden die 69 Schlüssel-
  282. wörter von POV Ray erläutert.
  283. Nach Anwahl des Schalters öffnet sich ein Fenster mit einer Liste dieser 69
  284. Wörter.  Durch  Anklicken  mit der linken Maustaste wählt man einen Begriff
  285. aus und es erscheint die entsprechende Hilfe.
  286. Mit der rechten Maustaste schließt man sowohl das Hilfefenster als auch das
  287. Fenster mit der Wortliste.
  288.  
  289.  
  290. 5.3.5. Start mit akt.Optionen
  291.  
  292. Durch  Anwahl  dieses  Schalters  wird  POV  Ray gestartet. Ihm werden alle
  293. Eintragungen, also SCRIPT, BILD, SUCHPFAD und sämtliche Optionen übergeben.
  294. Sobald  POV Ray fertig ist oder abgebrochen wurde meldet sich POV-Shell mit
  295. den zuletzt aktiven Einstellungen wieder.
  296.  
  297.  
  298. 5.3.6. Die freien Schalter
  299.  
  300. POV-Shell stellt 10 frei konfigurierbare Schalter zur Verfügung. Bei Anwahl
  301. eines  durch  SCHALTER-SETUP belegten Schalters wird die mit ihm verbundene
  302. Aktion  ausgeführt.  Ist  dem  Schalter  noch  kein Programm zugeordnet, so
  303. passiert gar nichts.
  304.  
  305.  
  306. 5.3.7. Programmende
  307.  
  308. Tja, alles hat einmal ein Ende !
  309.  
  310.  
  311.  
  312. 6. Copyright und Garantieausschluß
  313.  
  314. POV-Shell  wird  als Shareware angeboten und ist somit urheberrechtlich ge-
  315. schützte   Software.   Jegliche  Manipulationen  am  Programm  oder  seiner
  316. Dokumentation  sowie  das  Kopieren der Vollversion (außer zum Zwecke einer
  317. Sicherheitskopie) sind untersagt.
  318. Die Weitergabe der Shareware-Version ist ausdrücklich erwünscht !
  319.  
  320. POV-Shell  wurde  gewissenhaft  mit  Turbo Pascal 6.0 programmiert und aus-
  321. giebig  getestet.  Dennoch  kann  keinerlei  Garantie  für das einwandfreie
  322. Funktionieren des Programms auf Ihrem System gegeben werden. Ebenso erfolgt
  323. keine  Haftung  für Schäden, die durch dieses Programm entstehen (falls das
  324. Programm als Ursache überhaupt nachgewiesen werden kann) !
  325.  
  326.  
  327. 7. Registrierung
  328.  
  329. Sie  erhalten  die Shareware-Version von POV-Shell für einen Zeitraum von 4
  330. Wochen  zum Testen. Sollten Sie Gefallen an dem Programm finden und es über
  331. diesen  Zeitraum  hinaus  benutzen möchten, sind Sie verpflichtet, sich bei
  332. mir  als  Nutzer  registrieren zu lassen. Sie erhalten dann die Vollversion
  333. von POV-Shell in der jeweils neuesten Fassung.
  334. Als  Lohn  für die vielen Programmierstunden sehe ich eine Registriergebühr
  335. von  15  DM  +  5 DM Versandkostenpauschale als durchaus gerechtfertigt an.
  336. Dieser  Betrag kann bar oder als Verrechnungsscheck beigelegt oder aber auf
  337. mein  Konto  überwiesen  werden  (Kopie  des  Einzahlungsbelegs  beilegen).
  338. Ebenfalls ist eine Bestellung der Vollversion auf Rechnung möglich.
  339.  
  340. Zur Registrierung können Sie das vorgefertigte Formular mit
  341. "print povshell.reg" ausdrucken.
  342.  
  343. POV-Shell 1.0               Shareware-Version                       Seite 6
  344. ───────────────────────────────────────────────────────────────────────────
  345.  
  346.  
  347. 8. Schlußbemerkungen
  348.  
  349. Sofern  Sie  Hinweise,  Wünsche oder Probleme in bezug auf POV-Shell haben,
  350. bitte  ich Sie, mir diese mitzuteilen. Ein großer Vorteil der Shareware ist
  351. bekanntlich die Nähe des Programmierers zum Nutzer. Es hängt auch von Ihnen
  352. ab, ob und in welche Richtung dieses Programm weiterentwickelt wird.
  353.  
  354. Ich wünsche Ihnen viel Spaß beim Raytracen mit POV Ray und seiner deutschen
  355. Oberfläche POV-Shell !
  356.  
  357.  
  358.  
  359. 9. Adresse und Bankverbindung
  360.  
  361. André Kinnigkeit                         Deutsche Bank Neuruppin
  362. Fr.-Engels-Str. 24                       Bankleitzahl: 120 700 00
  363. 16816 Neuruppin                          Kontonummer : 3552965
  364.  
  365. Tel.: 03391/3064
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372. Neuruppin, den 20.06.1993                                 André Kinnigkeit