@database RefMan @master Hard:Source/RefMan/RefMan.guide @$VER: 1.0 @author "Holger Voss" @(c) "" @wordwrap @index HeddleyAutoIndex @remark Created with Heddley v1.1 (c) Edd Dumbill 1994 @node "Main" "RefMan" @{b}@{u}RefMan V1.0@{ub}@{uu} von Holger Voß im Januar 1995 @{b}Einleitende Bemerkungen@{ub} @{" Einleitung    " link "Einleitung" 0} Was soll das? @{" Merkmale      " link "Merkmale" 0} Besondere Merkmale von RefMan @{" Urheberrecht  " link "Copyright" 0} Rechtliches @{b}Bedienung der Software@{ub} @{" System        " link "System" 0} Benötigte Hard- und Software @{" Installation  " link "Installation" 0} Installation des Programms @{" Programmstart " link "Programmstart" 0} Start des Programms @{" Hilfesystem   " link "Hilfesystem" 0} Das Online-Hilfesystem @{" Philosophie   " link "Philosophie" 0} Programm-Philosophie @{" Projekt       " link "GR_projekt" 0} Projekte laden und sichern @{" Konstruieren  " link "GR_konstruieren" 0} Ansteuerung von Construct @{" Berechnen     " link "GR_berechnen" 0} Ansteuerung von Beams und Scan @{" Anzeigen      " link "GR_anzeigen" 0} Konvertieren und Anzeigen @{b}Sonstiges@{ub} @{" Reflections   " link "Reflections" 0} Urheberrecht zu Reflections @{" MUI, -Builder " link "MUI" 0} MagicUserInterface, MUI-Builder @{" Autor         " link "Autor" 0} Der fleissige Programmierer... @endnode @node "Einleitung" "Was soll das?" @{b}@{u}Was soll das?@{ub}@{uu} Als Reflectionsbenutzer haben Sie sich vielleicht auch schon (mehr als) einmal über den Manager geärgert, der weder fontsensitiv ist, noch sich Ihre Standarteinstellungen merkt. RefMan ist ein Ersatz für den Original Manager, der diese Unzulänglichkeiten behebt, und noch einige zusätzliche Merkmale bereit hält. @endnode @node "Merkmale" "Besondere Merkmale" @{b}@{u}Besondere Merkmale@{ub}@{uu} Einige Merkmale heben RefMan gegenüber dem Original Manager hervor: + @{" MUI " link "MUI" 0}- Benutzeroberfläche mit allen Vorteilen + Es lassen sich die Parameter für beliebig viele Projekte sichern + Beliebiges Konvertierungsprogramm möglich (z.B. beams_to_iff24, Show_2.5) + Beliebiges Anzeigeprogramm möglich (z.B Multiview, RetinaDisplay, ...), dadurch bessere Unterstützung von Grafikkarten + Problemsensitive Hilfefunktion Einige Punkte sind in dieser Version noch nicht implementiert: - Keine Anbindung des Animators - Keine Anzeige, wie weit eine Berechnung fortgeschritten ist. @endnode @node "Copyright" "Urheberrecht" @{b}@{u}Urheberrecht@{ub}@{uu} Das Urheberrecht für diese Software liegt bei ihren Entwicklern. Das bedeutet: Sie dürfen Programm(e) und Dokumentation NICHT ÄNDERN. Insbesondere dürfen Die die Dokumentation oder diesen Text NICHT ENTFERNEN. Sie dürfen diese Software und alle ihre Teile NICHT für irgend einen anderen Zweck als den in dieser Dokumentation beschriebenen benutzen. Sie dürfen KEINEN TEIL dieses Paketes dekompilieren. @{b}Verteilung@{ub} Dieses Paket ist frei verteilbar. Das bedeutet: Sie dürfen diese Software weiterverteilen, solange diese Punkte erfüllt sind: Jede Weitergabe muß alle Dateien in diesem Archiv umfassen, ohne irgendwelche Änderungen. Sie dürfen KEINE Dateien zu diesem Archiv hinzufügen. Dieses Paket darf frei weitergegeben werden über Mailboxen, InterNet/Use-Net, Software-Bibliotheken wie die von Fred Fish und Aminet CD-ROM's und andere ähnliche elektronische Kanäle. Disketten-Magazine und Dienstleister, die Zusatzgebühren für Dateiübertragung erheben, dürfen es NICHT ohne schriftliche Erlaubnis der Entwickler verteilen! @{b}Haftungsausschluß@{ub} Durch die Benutzung dieses Produktes akzeptieren Sie die VOLLE Verantwortung für alle Schäden, die durch seine Benutzung oder das Unvermögen seiner Benutzung auftreten können. Die Entwickler dieser Software können NICHT verantwortlich gemacht werden. WICHTIG: Der Autor gibt KEINE Garantie für die Qualität und die Nützlichkeit dieses Produktes! @{b}Gegenleistung@{ub} "Frei verteilbar" bedeutet nur, daß Sie nicht für das Kopieren oder die Weitergabe dieser Software bezahlen müssen Dieses Programm ist Freeware - Sie dürfen diese Software KOSTENLOS benutzen. @endnode @node "System" "Benötigte Hard- und Software" @{b}@{u}Benötigte Hard- und Software@{ub}@{uu} Um RefMan zu starten, bzw. sinnvoll anzuwenden benötigen Sie die folgende Ausstattung: + Irgendeinen Amiga mit Betriebssystem 2.0 oder höher, um die @{"Online-Hilfe" link "Hilfesystem" 0} zu benutzen, ist OS 3.0 oder höher und AmigaGuide oder Multiview erforderlich. + Das @{"MagicUserInterface" link "MUI" 0} (MUI) muß installiert sein. + Die ixemul.library, die PD ist, und beim GNU C Kompiler zu finden ist (Aminet, ...). + Und natürlich @{"Reflections" link "Reflections" 0} ! @endnode @node "Installation" "Installation" @{b}@{u}Installation@{ub}@{uu} Ziehen Sie einfach die gesamte RefMan-Schublade in das gewünschte Verzeichnis. In der RefMan-Schublade befindet sich ein Verzeichnis "Prefs", welches immer vorhanden sein sollte. Wie bei allen @{"MUI" link "MUI" 0}-Anwendugen kann die Größe und Position der Fenster der Benutzeroberfläche mit Hilfe des MUI-Voreinstellers dauerhaft gesichert werden. @endnode @node "Programmstart" "Starten des Programms" @{b}@{u}Starten des Programms@{ub}@{uu} RefMan kann von der Workbench durch einen Doppelklick auf das Piktogramm gestartet werden. Der Aufruf vom CLI ist ebenfalls möglich und bietet den Vorteil, daß der @{"Konvertierer" link "GR_anzeigen" 0} und das @{"Anzeigeprogramm" link "GR_anzeigen" 0} eventuelle Fehlermeldungen in das CLI ausgeben können. Der Aufruf lautet: RefMan Die Datei wird im RefMan-Verzeichnis in "Prefs" gesucht, diese könnte beispielsweise "RefMan.prefs" heißen. @endnode @node "Hilfesystem" "Das Online-Hilfesystem" @{b}@{u}Das Onile-Hilfesystem von RefMan@{ub}@{uu} RefMan bietet ab der Bertiebssystemversion 3.0 eine problemorientierte Hilfe, welche durch Druck auf die -Taste aktiviert wird. Je nachdem welcher Bereich der Programmoberfläche zuletzt aktiv war, wird die passende Stelle dieser Dokumentation mit Hilfe von AmigaGuide bzw. MultiView angezeigt. @endnode @node "Philosophie" "Programm-Philosophie" @{b}@{u}Programm-Philosophie@{ub}@{uu} Um Reflections mit Hilfe von RefMan besonders effektiv zu bedienen, sollte man so vorgehen: + Nach dem Start einen @{"Projekt" link "GR_projekt" 0}-Namen vergeben + Alle Einstellungen in den Bereichen @{"Konstruieren" link "GR_konstruieren" 0}, @{"Berechnen" link "GR_berechnen" 0} und @{"Anzeigen" link "GR_anzeigen" 0} nach Wunsch vornehmen + Die Projekt-Datei sichern Folgende Punkte werden wohl iterativ durchlaufen: + `Construct' anklicken + `Scan' bzw. `Beams' anklicken + `Konvertieren' anklicken + (falls Automatisch anzeigen deaktiviert) `Anzeigen' anklicken Wie bei allen @{"MUI" link "MUI" 0}-Anwendugen kann die Größe und Position der Fenster der Benutzeroberfläche mit Hilfe des MUI-Voreinstellers dauerhaft gesichert werden. @endnode @node "GR_projekt" "Projekt" @{b}@{u}Projekt@{ub}@{uu} Hier lassen sich die Einstellungen für das aktuelle Projekt laden und sichern. Der gewünschte Dateiname wird mit Hilfe des TextGadgets festgelegt, um eine neue Datei zu benutzen, muß noch `@{b}Laden@{ub}' oder `@{b}Sichern@{ub}' betätigt werden. Die Voreinstellugen werden im Verzeichnis "Prefs", welches sich im RefMan Verzeichnis befinden sollte, gesichert. Der Dateiname sollte auf ".prefs" enden. Die Standarteinstellungen "RefMan.prefs" sehen so aus (Die Kommentare dürfen in der der Datei nicht auftauchen, sie dienen hier nur dem Verständnis): 0 ;Farben: 4 1 ;Screen: Workbench 10000 ;Punkte: 10000 5000 ;Objekte: 5000 0 ;Bildgröße: 80x60 1 ;Schatten: mit 2 ;RayTiefe: 2 0 ;AntiAlias: ohne 1 ;Modus: 1 REF:REFLECTIONS/SZENEN ;Szene REF:REFLECTIONS/SZENEN ;Kamera REF:REFLECTIONS/BILD ;Bild für die Berechnung REF:Reflections/Bild ;Bild für den Anzeiger REF:Reflections/Show2_5 ;Konverter Programm SYS:Utilities/MultiView ;Anzeige Programm 1 ;Bild übernehmen: an 1 ;Automatisch anzeigen: an CONSTRUCT ;Construct Screen Titel C O N S T R U C T ;Construct Window Titel REF:REFLECTIONS/Construct ;Programm Construct mit Pfad REF:REFLECTIONS/Grid ;Programm Grid mit Pfad REF:REFLECTIONS/Scan ;Programm Scan mit Pfad REF:REFLECTIONS/Beams ;Programm Beams mit Pfad Alle Einstellungen der Gadgets werden beim Sichern eines Projektes automatisch gespeichert, auch die aktuellen Einstellungen der Programme mit den Pfaden, sowie Screen- und Fenstertitel von Construct. Letztere sind für die @{"Reflections" link "Reflections" 0} Version 2.5 passend. Läßt sich Construct mittels RefMan nicht starten, oder wird Construct durch mehrfaches Betätigen des Schalters `@{b}Construct@{ub}' mehrfach gestartet, anstatt nach vorn geholt zu werden, so ist es nötig den Screen- und Fenstertitel selbst festzustellen und von Hand in die Projekt-Datei einzutragen. Dies kann mit Hilfe eines Systemmonitors wie XOper oder Scout geschehen. Ist eine solche Änderung nicht notwendig, sollte man die Projekt-Datei von Hand nur verändern, wenn man weiß was man da tut! @endnode @node "GR_konstruieren" "Konstruieren" @{b}@{u}Konstruieren@{ub}@{uu} Hier kann das Programm Construct kontrolliert werden. @{b}Farben@{ub}: Anzahl der Farben, die Contruct verwendet. Bei Screen = Custom : 4, 8, oder 16. Bei Screen = Workbench : Richtet sich nach den Einstellungen der Workbench. @{b}Screen@{ub}: Gibt an, wo Construct seinen Bildschirm öffnet. @{b}Punkte@{ub}: Maximale Anzahl von Punkten einer Szene, die mit Construct bearbeitet werden soll. @{b}Objekte@{ub}: Maximale Anzahl von Objekten einer Szene, die mit Construct bearbeitet werden soll. @{b}Construct@{ub}: Hier kann das Programm Construct gestartet werden. Läuft es bereits, so bringt ein erneutes Klicken auf `Construct' den Screen von Construct nach vorne. Damit dies funktioniert, muß unbedingt der richtige (eventuell von der Programmversion abhängige) Fenstertitel von Construct in der aktuellen @{"".prefs"-Datei" link "GR_projekt" 0} stehen. Das Programm wird asynchron gestarted, daß heißt, Sie können nach dem Start mit RefMan weiterarbeiten (z.B. ein Bild berechnen oder konvertieren). @endnode @node "GR_berechnen" "Berechnen" @{b}@{u}Berechnen@{ub}@{uu} Hier können alle Parameter, die zur Berechnung eines Bildes wichtig sind eingestellt werden. Benennung und Inhalt der einzelnen Gadgets ähnelt der des Original Managers. @{b}Szene@{ub}: Zu berechnende Szene @{b}Kamera@{ub}: Kamera- und Lichteinstellungen @{b}Bild@{ub}: Ausgabedatei von Beams bzw. Scan @{b}Größe@{ub}: Größe des Bildes Mögliche Werte: 80 x 60 160 x 120 320 x 240 320 x 256 400 x 300 640 x 512 800 x 600 1024 x 768 @{b}Tiefe@{ub}: Rekursionstiefe des Raytracingverfahrens Mögliche Werte: >= 0 @{b}Antialias@{ub}: Kantenglättung Mögliche Werte: ohne (kein Antialias) leicht (bei großer Farbdifferenz) mittel (bei Materialsprung feiner) normal (immer bei Farbdifferenz) maximal (auch bei Texturen) @{b}Schatten@{ub}: Berechnung von Schatten Mögliche Werte: ohne mit @{b}Modus@{ub}: Nur jedes -te Pixel berechnen Mögliche Werte: 0, 1 (jedes Pixel wird berechnet) 2, 3, ... @{b}Beams@{ub} und @{b}Scan@{ub}: Die Berechnung wird durch Betätigen eines dieser Schalter gestartet. Die Programme werden asynchron gestarted, daß heißt, Sie können nach dem Start mit RefMan weiterarbeiten (z.B. ein Bild konvertieren, Construct starten). Die Priorität der Prozesse wird auf -2 festgelegt. @endnode @node "GR_anzeigen" "Anzeigen" @{b}@{u}Anzeigen@{ub}@{uu} Hier kann eine Beams-Datei umgerechnet und angezeigt werden. @{b}Bild@{ub}: Zu bearbeitende Beams-Datei @{b}Konverter@{ub}: Konvertierprogramm für Beams-Dateien (z.B.: beams_to_iff24 oder Show_2.5) RefMan erzeugt für das konvertierte Bild einen Namen, der sich aus dem Namen der Beams-Datei und der Endung ".iff" zusammensetzt. Daher gibt es mit Show Porbleme, Show_2.5 sollte jedoch funktionieren. @{b}Anzeiger@{ub}: Bild Anzeigeprogramm (z.B.: MultiView oder RetinaDisplay) RefMan ruft das eingestellte Programm mit dem Bildnamen (inkl. der Endung ".iff") als Argument auf. @{b}Bild übernehmen@{ub}: Automatisch das Bild aus dem Bereich "@{"Berechnen" link "GR_berechnen" 0}" übernehmen @{b}automatisch anzeigen@{ub}: Nach der Konvertierung der Beams-Datei das Bild sofort mit Hilfe des eingestellten Anzeigeprogramms darstellen @{b}Konvertieren@{ub}: Durch Betätigen dieses Schalters wird das Konvertieren gestartet. Dabei wird der oben eingestellte Konverter verwendet.Ist "@{b}automatisch anzeigen@{ub}" gewählt, so wird nach der Konvertierung der Beams-Datei das Bild sofort mit Hilfe des eingestellten Anzeigeprogramms dargestellt. @{b}Anzeigen@{ub}: Durch Betätigen dieses Schalters wird ein bereits Konvertiertes Bild mit Hilfe des eingestellten Anzeigeprogramms dargestellt. @endnode @node "Reflections" "Über Reflections" @{b}@{u}Über Reflections@{ub}@{uu} Das Programmpaket Reflections ist ein urheberrechtlich geschütztes Produkt der M&T Software Partner International GmbH Hans-Pinsel-Str. 9b 8013 Haar bei München @endnode @node "MUI" "Über MUI und MUI-Builder" @{b}@{u}Über MUI und MUI-Builder@{ub}@{uu} This application uses MUI - MagicUserInterface (c) Copyright 1993/94 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY Die Benutzerschnittstelle wurde mit Hilfe von MUI-Builder, dem exzellenten Tool von Eric Totel entworfen. @endnode @node "Autor" "Autor" @{b}@{u}Autor@{ub}@{uu} Wenn Sie Fragen oder Verbesserungsvorschläge zu RefMan haben, oder falls Sie Fehler in der Software feststellen, so schreiben Sie bitte an die unten aufgeführte Adresse. Teilen Sie mir bitte Ihre Meinung zu RefMan mit, Kritik ist immer erwünscht. Bei entsprechender Resonanz wird dieses Produkt mit SICHERHEIT weiterentwickelt. Adresse des Autors: Holger Voß Mühlenweg 32 37136 Seeburg-Bernshausen Deutschland EMail: holger@umpds2.gwdg.de @endnode @node HeddleyAutoIndex "Index" @remark Index auto-generated by Heddley @{b}@{u}Index@{uu}@{ub} @{".prefs-Datei " link "GR_projekt" 0} @{" Anzeigen      " link "GR_anzeigen" 0} @{" Autor         " link "Autor" 0} @{" Berechnen     " link "GR_berechnen" 0} @{" Einleitung    " link "Einleitung" 0} @{" Hilfesystem   " link "Hilfesystem" 0} @{" Installation  " link "Installation" 0} @{" Konstruieren  " link "GR_konstruieren" 0} @{" Konvertieren " link "GR_anzeigen" 0} @{" Merkmale      " link "Merkmale" 0} @{" MUI  " link "MUI" 0} @{" MUI-Builder  " link "MUI" 0} @{" Online-Hilfe " link "Hilfesystem" 0} @{" Programmstart " link "Programmstart" 0} @{" Projekt       " link "GR_projekt" 0} @{" Reflections   " link "Reflections" 0} @{" System        " link "System" 0} @{" Urheberrecht  " link "Copyright" 0} @endnode