Document Planetarium Dokumentation Planetarium FRIENDWARE-Version 2.50 ======================= 1. FEATURES ======== - Hohe Konfigurierbarkeit durch ASCII-Dateien - Bilder für Teleskop-Modus werden automatisch erkannt und eingebunden - Steuerung über `Tastatur', `DropDownMenü's und `Gadgets' - Diaschau-Modus - Double-Buffered-Display! ( -> `BEKANNTE FEHLER:' ) - Multitaskingfreundlich; während das Programm auf Eingaben wartet, wird sein Task auf 'waiting' gesetzt. - speichert seine `Standardeinstellungen' am Ende einer Sitzung, sodaß sie beim nächsten Start sofort wieder zur Verfügung stehen - kann jederzeit während des Programmlaufes in `andere Sprachen' umgeschaltet werden - es werden jetzt auch ausgewählte Messier- bzw. NGC-Objekte angezeigt 2. Anmerkungen =========== Diese Simulation beruht auf dem von H.Hinkelmann geschriebenen Programm für den C64, das im Mai 1985 im C64 Magazin, Verlag Markt und Technik, veröffentlicht wurde. Ich habe es bei der Übertragung auf den Amiga gründlich überarbeitet, sowohl was den Programmierstil als auch die Effizienz der Routinen angeht, wobei ich ausgiebig Gebrauch von der Benutzeroberfläche dieses Computers gemacht habe. Außerdem fügte ich etliche Funktionen und Sternpositionen hinzu, sodaß vom ursprünglichen Programm kaum etwas übrig ist, weshalb ich als Autor zeichne. Inzwischen ist "Planetarium" recht gut getestet und ich habe sehr viel Zeit in die Weiterentwicklung gesteckt. Die neue Version gebe ich als FRIENDWARE frei, d.h. ich erwarte, daß jeder, der dieses Programm benutzt, mir einen (hoffentlich) freundlichen Gruß zu- kommen und sich registrieren läßt. (-> `Copyright' ) Eine Registrierung führt dazu, daß bei einer neuen Version automatisch eine Benachrichtigung durch mich erfolgt. Diese Version kann dann gegen eine Unkostenbeteiligung (Diskette, Porto) bei mir bezogen werden. Geld- oder Sachspenden (neuere SF-Romane, CD's, Autos, Häuser...) werden zwar nicht erwartet, aber durchaus dankend angenommen; ich revanchiere mich dann mit einer Diskette mit weiterem Material (Bilder, Sourcecode..) ------------------------------------------------------------------------------- FÜR ETWAIGE SCHÄDEN, DIE DURCH MEIN PROGRAMM AN HARDWARE, SOFTWARE, TUPPERWARE, GEISTIGER GESUNDHEIT U.S.W. ENTSTEHEN, ÜBERNEHME ICH AUSDRÜCKLICH KEINE VERANTWORTUNG!!! ------------------------------------------------------------------------------- Das `Copyright' bleibt beim `Autor' © Rolf Kühr =============================================== Das Programm wurde ursprünglich auf einem normalen Amiga 2000 mit 1 Megabyte RAM unter Kickstart 1.3 entwickelt, läuft aber inzwischen auf einem A 2000 mit 2630 Turbokarte, 1MB Chipram, 6MB Fastram unter Kickstart 2.x trotz des Unkens der GFA-Basic Gegner problemlos, obgleich einige Programm- teile gnadenlos von den Libraryroutinen Gebrauch machen. (-> `BEKANNTE FEHLER:') Viel Spaß beim Ausprobieren! 3. Inhalt des Programmpaketes ========================== drei Archivdateien: ~~~~ 3.1. 2 Bildarchive ~~~~~~~~~~~~~ TELE1.LHA enthält die Grafiken für den Teleskop-Modus und die Diaschau für Disketteninstallation TELE2.LHA enthält zusätzliche Grafiken 3.2. Archiv mit Programm- und Systemdateien ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PLAN.LHA enthält die Dateien - Planetarium_2.50 das eigentliche Programm - Planetarium_2.50.info Programmicon - Planetarium.c Kompilierte Version (ohne double- buffering für AGA und langsame Amigas) - Planetarium.c.info Programmicon - Planetarium.guide.info Texticon - Planetarium.guide deutsch/englische Anleitung - about.eng ASCII-Datei für Info (englisch) - about.fra ASCII-Datei für Info (französisch) - about.ger ASCII-Datei für Info (deutsch) - const.eng ASCII-Datei für Sternbildnamen - const.fra ASCII-Datei für Sternbildnamen - const.ger ASCII-Datei für Sternbildnamen - defstrings.eng ASCII-Datei mit allen vom Programm benötigten Strings - defstrings.fra s.o. französische Version - defstrings.fer s.o. deutsche Version - preset.data ASCII-Datei für Voreinstellungen - planet.data ASCII-Datei mit Planetendaten - starneu.data ASCII-Datei mit Sterndaten - gfabasro Run-only-Interpreter sowie 3.3. Hilfsprogramme/Dateien ~~~~~~~~~~~~~~~~~~~~~~ - MuchMore Textanzeigeprogramm - BITTE_LESEN.info Texticon - BITTE_LESEN Installationshilfe deutsch - READ_ME_FIRST.info Texticon - READ_ME_FIRST Installationshilfe englisch - Installer Commodores utility - Install-Planetarium einfaches Installerskript - Install-Planetarium.info Skripticon - AmigaGuide Commodore utility - libs Library-Schublade - amigaguide.library - tools Schublade für Hilfsprogramme - LhA (De-)Archivierungsprogramm - LhaPatterns Hilfsprogramm 4. Überblick ========= PLANETARIUM zeichnet eine Sternkarte von Horizont zu Horizont (360 Grad Rundumsicht), wie sie etwa aus Atlanten bekannt ist, für jeden Ort der Erde und jeden sinnvollen Zeitpunkt (es rechnet mit dem Julianischen Kalender). +----------------------------------------------------------------------+ | Gestartet wird mit der Systemzeit, wobei angenommen wird, | | daß sich der Computer in der Zeitzone des 1. voreingestellten Ortes | | befindet. Ist das nicht der Fall, empfiehlt es sich, in der Datei | | preset.data eine entsprechende Korrektur vorzunehmen!!! | +----------------------------------------------------------------------+ Zeit und Datum können durch Anwahl des entsprechenden Menupunktes oder Gadgets geändert werden. Eine recht große Anzahl von Sternen bis etwa zur 3.Größenklasse wird angezeigt und durch einige schwächere ergänzt, wo es für die Darstellung des Sternbildes nötig ist. Hinzugekommen sind einige Galaxien, offene und kugelförmige Sternhaufen sowie ein paar bekanntere Nebel. In der Regel sind diese Objekte unter ihrer Messiernummer (z.B. M43) oder NGC-Nummer eingetragen. Die Größenklassen bzw. scheinbaren Helligkeiten werden in Grautöne übersetzt dargestellt, Planeten sind rot markiert. PLANETARIUM wendet sich in erster Linie an den astronomischen Einsteiger: Man kann sich mit seiner Hilfe am Firmament orientieren, indem man mit dem Mauszeiger auf einen Stern oder Planeten deutet und die linke Maustaste betätigt: Ein Kreis wird um das Objekt gezeichnet, sein Name und der des Sternbildes werden angezeigt, während die zu der Konstellation gehörenden Sterne blinken, solange die Maustaste gedrückt bleibt. Sucht man einen bestimmten Stern, Sternbild oder Planeten, braucht man nur "Look for names" im `DropDownMenü' anzuwählen und den Namen oder einen Teil davon einzugeben; die Anzeige erfolgt wie oben beschrieben. Das gleiche gilt auch für die anderen astronomischen Objekte. Gibt man beispielsweise "Galax" ein, so werden alle dem Programm bekannten und zur Beobachtungs- zeit sichtbaren Spiralnebel blinkend dargestellt. Galaxien, Kugelhaufen, offene Sternhaufen und Nebel werden also vom Programm wie Sternbilder be- handelt. Das hat den Vorteil, daß man so einen Eindruck von der Verteilung der jeweiligen Objekte am Firmament bekommt. Außerdem kann Planetarium die Bewegung von Himmelsobjekten simulieren. Wenn man den Planetariummodus anwählt ( `Gadgets' `DropDownMenü') und ein Intervall von 24h wählt, läßt sich die Bewegung von Planeten, Sonne und Mond vor dem Fixsternhimmel gut beobachten. Die zur Beobachtungszeit herrschende Mondphase wird ständig angezeigt. 5. Die Funktionen im Einzelnen =========================== Die analogen deutschen Bezeichnungen dürften sich von selbst erklären! 5.1. DropDownMenü ~~~~~~~~~~~~ 5.1.1. - Programm -------- - weiter Der Bildschirm wird neu aufgebaut und die Zeit aktualisiert - beenden das Programm wird verlassen - über... blendet Versionsnummer, meine Adresse und einen Copy- right/Sharewarevermerk, sowie einige Programmdaten ein 5.1.2. - Parameter ändern ---------------- - Position Die Koordinaten eines beliebigen Punktes auf der Erde können eingegeben werden - Datum/Zeit Eingabe der Beobachtungszeit (Ortszeit) - Voreingestellte Orte Die in der ASCII-Datei preset.data erfaßten Orte können direkt in einem weiteren Untermenü angewählt werden - Systemzeit Die Beobachtungszeit wird auf die Systemzeit zurückgesetzt 5.1.3. - Modus ----- - Sternkarte Sternkartenmodus (statisch) - Planetarium Planetariummodus (dynamisch) -> nach einer wählbaren Verzögerung (delay) wird die Zeit um einen beliebigen Betrag erhöht (interval). Sonderfunktionen werden gesperrt! - Teleskop Teleskopmodus -> Einblenden der Bilder von angeklickten Himmelsobjekten, sofern diese im Subdirectory /tele oder dem Volume tele: gespeichert sind 5.1.4. - Auflösung --------- - 640*502 wählt die Auflösung des Bildschirms - 640*251 ------------------------------------------------------------------------------ ACHTUNG!! Sollte Ihr Amiga nur über 512 K verfügen, empfiehlt es sich, sofort nach dem Verschwinden des Einschaltbildes aus dem Resolution-Menu die geringere Auflösung (640*240) zu wählen; das Programm startet danach automatisch. Beim regulären Verlassen des Programms wird die Konfiguration automatisch abgespeichert! ------------------------------------------------------------------------------ 5.1.5. - Suche nach ---------- - Namen sucht nach dem Stern oder Sternbild mit einem spezi- fischen deutschen oder lateinischem Namen; die Namen können in der Datei star.data editiert werden (An- passung an andere Sprachen) 5.1.6. - Ausgabe ------- - hardcopy ändert die Bildschirmfarben auf schwarz-weiß und druckt den Bildschirm mit dem Prefs-Treiber der Workbench aus - Namen in Karte Nach dem Anwählen dieser Option wird unter jedem angeklickten Objekt zentriert dessen Name ausgegeben oder wieder gelöscht 5.1.7. - Sprache ------- - Deutsch wählt innerhalb des laufenden Programms die entsprechenden Sprachdateien an - Englisch und schaltet sofort in diese Sprachen um ! - Französisch 5.2. Gadgets ~~~~~~~ Im rechten unteren Quadranten des Bildes stehen sechs Icons, die die Programm- steuerung vereinfachen, und ein QUIT- Gadget zur Verfügung: erste Reihe: ------------ - Uhr Setzen der Beobachtungszeit - Weltkugel Setzen der Beobachtungsposition - Drucker Bildschirmhardcopy zweite Reihe: ------------- - Lupe Teleskopmodus an/aus - Projektor Diaschau; alle Bilder, die im Subdirectory /tele oder dem Volume tele: vorhanden sind, werden angezeigt. Dabei schaltet ein Klick der linken Maustaste zum nächsten Bild weiter, die rechte Maustaste beendet die Diaschau. ---> Bilder müssen im ACBM-Format vorliegen <-- ---> und ihre Namen müssen auf .pic enden ! <-- - Planetarium Planetariummodus an/aus dritte Reihe ------------ - QUIT Programm beenden und Einstellungen sichern Ein Klick auf das Close-Gadget des Fensters beendet ebenfalls das Programm. 5.3. Tastatur ~~~~~~~~ Die Tastaturabkürzungen findet man neben den Optionen in den Dropdownmenüs. 5.4. Andere Sprachen ~~~~~~~~~~~~~~~ Die Strings für die `DropDownMenü's und alle Programm-Meldungen sind in den Dateien defstrings.xxx enthalten und können mit einem beliebigen Editor ver- ändert werden. Dabei ist unbedingt darauf zu achten - daß keine Satzzeichen ( , ; ! - ) gelöscht werden ------- - daß die Länge der Strings nicht zu stark verändert wird (ausprobieren) Ich bitte darum, mir etwaige weitere Übersetzungen zuzusenden. 6. Standardeinstellungen ===================== Wird das Programm normal verlassen, so werden die Einstellungen für Ort, Auflösung, Sprache u.s.w. im Verzeichnis S: in der Datei plan.prefs abgespeichert. Beim nächsten Programmstart wird Planetarium sofort ent- sprechend konfiguriert. 7. BEKANNTE FEHLER: ================ - Im Planetariummodus sollten die Maustasten nicht zu lange ge- drückt gehalten werden - Auf AGA-Amigas sind die Farben der geladenen ACBM-Files etwas merkwürdig - Läuft mit einigen Commodities nicht zusammen (Screenblanker, MultiCX), zumindest nicht im Planetariummodus) Leider ist durch die systemnahe Programmierung die Kompilierung des Programms mit gepuffertem Bildaufbau zur Zeit nicht möglich, weshalb die nun beigefügte schnelle Compilerversion ohne Double-Buffering arbeitet. Ich empfehle den Einsatz dieser Version auf den AGA-Typen oder langsamen Rechnern, da die Menge der dargestellten astronomischen Objekte sich nahezu verdoppelt hat. Sollte unter den geneigten Usern ein GFA_Basic oder Assembler Experte sein, der mir beim debuggen helfen kann, wäre ich sehr dankbar!!! (->`Autor') Der Fehler scheint bei der Speicheranforderung zu liegen. Vielleicht kann man das Kompilat disassemblieren um nachzusehen, welchen Müll der Compiler da fabriziert. 8. Copyright ========= ACHTUNG ======= Das Programmpaket darf nur unverändert und vollständig weitergegeben wer- den! =========================== Eventuelle Modifikationen (die natürlich jeder für sich vornehmen darf) bitte ich mir zuzusenden, damit ich sie gegebenenfalls in die nächste Version mit aufnehmen kann. Es darf IN KEINER WEISE KOMMERZIELL GENUTZT, d.h. verkauft oder sonstwie gewinnbringend eingesetzt werden; die Verbreitung in PD-Serien ist ausdrücklich gestattet, sofern die Kosten für eine Diskette und eine even- tuelle Kopiergebühr insgesamt 10,- DM nicht überschreiten!! Das Copyright verbleibt beim Autor! ------------------------------------------------------------------------- 9. Entwicklungsgeschichte: ======================= bis Version 0.98 nichts Erwähnenswertes Version 0,98i (nicht veröffentlicht) ============= Einige Fehler beseitigt und einige Voreinstellungen für bekannte oder interessante Orte (Wünnenberg??) eingebaut. Die MedRes-Auflösung funktioniert jetzt richtig und bei einigen kritischen Koordinaten (Pole) tritt kein GURU mehr auf. Ein Freund bat mich um eine englische Version, also habe ich alles so gut es ging übersetzt - sogar die Variablennamen und Unterprogrammbezeich- nungen, damit jeder das Programm leichter nachvollziehen kann (Version 0.98i bedeutet "international", haha). Version 0.99i (nicht veröffentlicht) ============= Wo möglich, wurden Floatingpoint- durch Integervariablen ersetzt, was der Ausführungsgeschwindigkeit zu Gute kam! Version 1.0i ============ Ich habe die trigonometrischen Funktionen überprüft und auf die schnellen GFA-Routinen zurückgegriffen, wo Geschwindigkeit wichtiger als Genauigkeit war. Das hat sich ausgezahlt! Die compilierte Version braucht nur noch knapp drei Sekunden, um den Sternenhimmel komplett zu berechnen und zu zeichnen. Ich habe dieser Version die Nummer 1.0 gegeben, da auch nach längerem Gebrauch keine Fehler auftraten. Version 1.01i (nicht veröffentlicht) ============= Ich habe die Palette überarbeitet, um die scheinbare Helligkeit der Sterne richtig darstellen zu können. Eine Bitplane mehr würde die Ausführung des Programms um die Hälfte verzögern! Version 1.02i (nicht veröffentlicht) ============= Einen kleinen Fehler in der Blinkroutine behoben. Version 1.1i ============ Ich habe die Berechnung der Mondphasen eingebaut und eine Routine, die Sternnamen in die Karte einträgt, wenn der Stern angeklickt wird. Version 1.11i (nicht veröffentlicht) ============= Statt eines weißen Kreises wird nun ein Bild des Mondes für die Darstel- lung der Mondphasen benutzt. Version 1.12i ============= Der Mond wird nun auch bei geringer Auflösung korrekt gezeigt. Version 1.13i ============= Die Abbildungen des Mondes sind nun in den Sourcecode integriert (Inline) und brauchen nicht mehr nachgeladen zu werden. Durch die Benutzung der neuesten Version des Interpreters/Compilers (Version 3.52), treten einige kleinere Bugs nicht mehr auf. Version 1.15i bis 1.85i (nicht veröffentlicht) ======================= Programmsteuerung über BooleanGadgets eingebaut, um die Bedienung komfortabler zu gestalten. Die Konfiguration des Programms, besonders die Eingabe anderer Default-Orte ist jetzt durch Änderungen in den entsprechenden ASCII-Dateien für jeden leicht möglich. Version 2.0 =========== Der Bildaufbau erfolgt jetzt verdeckt (Double Buffered Display). Dadurch werden Bewegungen bei Animationen besser erkennbar. Das Programm rotiert bei Untätigkeit nicht mehr in Warteschleifen, da sein Task bis zum Auftreten eines Ereignisses angehalten wird. Version 2.01 ============ Die Presets wurden erweitert und einige kleine bugs bei der Gadgetsteuerung beseitigt. Version 2.02 (22.01.1994) ============ Ich habe sämtliche Strings für die Menüs und Programm-Meldungen ausgelagert, um eine Anpassung des Programms an andere Sprachen zu erleichtern und liefere eine englische, deutsche und französische Fassung mit. Version 2.03 (21.4.1994) ============ Ich habe den Code etwas gesäubert und die Kurzanleitung, die zu Beginn je- des Programmlaufes ausgegeben wird, ausgelagert, um auch sie editierbar zu machen. Englische Version der star.data zugefügt. Version 2.04 (23.4.1994) ============ Die Korrektur der Systemzeit->Weltzeit Umrechnung war längst überfällig. Arbeitet jetzt bei allen geographischen Lagen korrekt! Version 2.50 (22.6.95) ============ Nach langer Zeit ein etwas größeres Update! Weitere kleine bugs wurden be- seitigt. Das Umschalten in eine andere Sprache ist zu jeder Zeit möglich. Die Struktur der Sterndatei wurde komplett überarbeitet, aktualisiert und erweitert. Übersetzte Sternbildnamen werden jetzt aus einer eigenen Datei eingelesen (spart Platz). Die Gadgetsteuerung funktioniert nun auch in der geringeren Auflösung. Mond und Sonne werden in der Karte durch Bilder und nicht mehr durch einfache Kreise dargestellt. Dem Programmpaket wurde eine kompilierte Version ohne DoubleBuffering zugefügt, die auch auf neuen Amigas lauffähig sein sollte. Am Ende eines Programmlaufes werden die Einstellungen gesichert, sodaß sie beim Neustart sofort wieder zur Verfügung stehen. 10. Autor ===== Rolf Kühr Am Südhang 21 D 33181 Wünnenberg Tel.: 02953/8701 Inzwischen bin ich auch über das Zerberus-Netz zu erreichen: Sokrates@MF.ZER