home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 518.lha / Aequipot_v1.06 / Aequipot.anl.pp / Aequipot.anl
Text File  |  1991-06-09  |  8KB  |  178 lines
  1. --------------------------- Aequipot V1.06 --------------------------------
  2.  
  3. Aequipot ist Copyright 1990, 1991 von Jürgen Matern.
  4. Dies ist ein Programm, das mehrfarbige Grafiken mit einem bestimmten
  5. Algorithmus berechnet.
  6.  
  7. -------------------------- HINTERGRUND ------------------------------------
  8.  
  9. Der Algorithmus beschreibt ein Problem der Elektrostatik. Eine elektrische
  10. Ladung baut um sich ein elektrisches Feld auf. Dieses Feld verhält sich
  11. nichtlinear. Bei einer Ladung kann dieses Feld noch gezeichnet werden, bei
  12. mehreren Ladungen ist dies kaum noch möglich. Auf eine Probeladung in
  13. diesem Überlagerungsfeld wirken Kräfte. Linien, auf denen eine Probeladung
  14. bewegt werden kann, ohne Arbeit am System zu verrichten, werden als
  15. Äquipotentiallinien bezeichnet (im dreidimensionalen sind dies
  16. Äquipotentialflächen). Eine Probeladung hat ein bestimmtes Potential
  17. gegenüber den betrachteten Ladungen. Bereiche gleichen Potentials werden
  18. vom Programm mit gleicher Farbe gekennzeichnet. Direkt an den Ladungen wird
  19. nichts gezeichnet, da dort das Potential gegen Unedlich strebt. Das
  20. Programm macht nur quantitative Aussagen.
  21.  
  22. --------------------------- FEATURES --------------------------------------
  23.  
  24. * bis zu zwanzig Ladungen
  25. * LoRes- und HiRes-Auflösung möglich
  26. * optimierter Rechenalgorithmus, um Zeit zu sparen
  27. * Übersichtsfunktion, um einen schnellen Einblick in die Grafik zu gewinnen
  28. * arbeitet mit 32, oder 16 Farben, je nach Modus
  29. * Parameterübergabe vom CLI aus
  30. * bei Start von der Workbench werden die Parameter erfragt
  31. * Reperaturfunktion, falls der optimierte Algorithmus Fehler macht
  32.  
  33. --------------------------- BENUTZUNG -------------------------------------
  34.  
  35. Es existieren zwei verschiedene Versionen, die PAL- und die NTSC-Version.
  36. Sie sind durch verschiedene Namen gekennzeichnet (AequipotP und AequipotN).
  37. Das Programm kann von der Workbench oder vom CLI aus gestartet werden.
  38. Wird das Programm von der Workbench aus gestartet werden die beiden
  39. benötigten Parameter nacheinander vom Programm erfragt.
  40. Wird das Programm aus dem CLI heraus gestartet müßen dabei zwei Parameter
  41. übergeben werden. Der erste Parameter gibt die Bildschirmauflösung an, der
  42. zweite, die Berechnungsmethode. Werden keine, oder falsche  Parameter
  43. übergeben, wird folgende Kurzerklärung ausgegeben:
  44.  
  45.      Usage: AEQUIPOT ScreenMode RenderingMode
  46.             Where ScreenMode is h(igh) or l(ow)
  47.             and RenderingMode is s(low) or f(ast).
  48.  
  49. (Benutzung: AEQUIPOT SchirmModus RechenModus
  50.             Wobei SchirmModus h(=hoch) oder l(=niedrig)
  51.             und RechenModus s(=langsam) oder f(=schnell) sein kann.)
  52.  
  53. Nach dem Start des Programms wird der entsprechende Schirm geöffnet. Hier
  54. können jetzt mit der Maus Ladungen gesetzt werden. Das Setzen einer Ladung
  55. erfolgt nach Druck auf die linke Maustaste. Sollen keine Ladungen mehr
  56. gesetzt werden muß die rechte Maustaste gedrückt werden. Maximal können
  57. 20 Ladungen gesetzt werden. Bei der zwanzigsten Ladung wird automatisch
  58. in den Eingabemodus gesprungen. Jetzt werden nacheinander die einzelnen
  59. Koordinaten der Ladungen angegeben. Es können jetzt positive oder negative
  60. Ladungen eingegeben werden. Es empfehlen sich Ladungswerte zwischen -15 und
  61. 15. Positive Ladungen müssen ohne Vorzeichen eingegeben werden, da das
  62. Programm sonst abbricht (das ist leider eine Eigenheit von PCQ und kann
  63. nicht abgefangen werden, das bedeutet auch, daß in einem solchen Fall noch
  64. ein geöffneter Schirm im Hintergrund liegt der z.B. mit ARTM
  65. entfernt werden kann). Nach Eingabe aller Ladungen wird die Grafik
  66. berechnet. Der Berechnungsvorgang wird mit Druck auf die rechte Maustaste
  67. beendet. Mit Druck auf die linke Maustaste kann die Titelleiste ein- und
  68. ausgeschaltet werden.
  69. Wurde der Berechnungsmodus f(=schnell) gewählt wird am Ende der Berechnung
  70. gefragt, ob die gleiche Grafik im Modus s berechnet werden soll. Wird <OK>
  71. gewählt, werden alle Koordinaten und Ladungen beibehalten und die Grafik
  72. wird nochmal berechnet. Wird <Cancel> gewählt, wird der Requester
  73. ausgeblendet (dann siehe unten).
  74. Wurde eine Berechnung im Modus s beendet, so wird gefragt, ob eine Reperatur
  75. durchgeführt werden soll. Dies ist nötig, falls der optimierte Algorithmus
  76. einen Fehler gemacht hat (probieren sie z.B. eine Ladung mit den
  77. Koordinaten (73/120) und der Ladung 1 im Berechnungsmodus s und Schirmmodus
  78. l; dann wird klar, was ein Fehler ist). Wird jetzt <OK> gewählt wird mit
  79. der Maus der Bereich ausgewählt, der nochmal berechnet werden soll. Am
  80. oberen linken Eckpunkt wird der linke Mausknopf gedrückt und wieder
  81. losgelassen. Am rechten unteren Eckpunkt wird wieder der linke Mausknopf
  82. gedrückt. Auf dem Bildschirm ist jetzt ein Rechteck zu sehen. Soll dieses
  83. Rechteck neu berechnet werden genügt ein Druck auf den rechten Mausknopf,
  84. soll doch ein anderes Rechteck gewählt werden muß wieder der linke
  85. Mausknopf gedrückt werden u.s.w. Wurde <Cancel> gewählt, so wird nur der
  86. Requester ausgeblendet.
  87. Das Programm wartet jetzt auf den rechten Mausknopf. Mit links kann der
  88. Titel aus- oder eingeblendet werden (z.B. zum speichern). Wurde der rechte
  89. Mausknopf gedrückt, so wird der Screen geschlossen und die Grafik ist 
  90. verloren. Um Bilder zu speichern muß ein Programm wie z.B. Pixmate oder ein
  91. anderes verwendet werden, da ich noch keine Speicherroutine implementiert
  92. habe.
  93.  
  94. ----------------------- BEKANNTE FEHLER -----------------------------------
  95.  
  96. * Die NTSC-Version des Programms berechnet im 'Slow'-Modus einen PAL-Schirm
  97.   (ich weiß aber noch nicht, wie ich das ändern soll). Das Ergebnis ist
  98.   zwar richtig, es wird aber unnötig gerechnet.
  99. * Das Programm arbeitet nicht mit MEMGUARD III.a zusammen!
  100.   Das Problem tritt auf, seitdem ich die Funktion IntToStr() benutze.
  101.  
  102. ----------------- WAS NOCH SO KOMMT (hoffe ich) ---------------------------
  103.  
  104. * Steuerung über Menüs
  105. * Speicherfunktion
  106. * Ladungseingabe im Grafik-Schirm
  107. * Entfernung der Fehler
  108.  
  109. ------------------------- AUTOR AND COPYRIGHT -----------------------------
  110.  
  111. Aequipot wurde von Jürgen Matern unter Benutzung des PD-Pascal-Compilers
  112. PCQ V1.1c geschrieben (vielen Dank an Patrick Quaid dafür, daß er diesen
  113. Compiler entwickelt hat). Die ausführbaren Programme, die Quellcodes, die
  114. Icons und die Dokumentationen sind alle:
  115.  
  116.    Copyright © 1990, 1991 by Jürgen Matern.
  117.  
  118. Ich erlaube hiermit, daß dieses Programmpaket frei verbreitet werden darf,
  119. solange alle Files des Pakets unverändert weitergegeben werden.
  120.  
  121. Die Files des Pakets sind:
  122. - AequipotP      (das ausführbare Programm/PAL Version)
  123. - AequipotP.p    (der Quellcode/PAL Version)
  124. - AequipotP.info (das Icon von AequipotP)
  125. - AequipotN      (das ausführbare Programm/NTSC Version)
  126. - AequipotN.p    (der Quellcode/NTSC Version)
  127. - AequipotN.info (das Icon von AequipotN)
  128. - Aequipot.anl   (dieses File hier)
  129. - Aequipot.doc   (die englische Dokumentation)
  130.  
  131. Kommentare, Fehler, GELD (wer will), Postkarten, oder alles andere an
  132. folgende Adresse:
  133.  
  134.       Jürgen Matern              
  135.       Max-Wieland-Straße 13      
  136.       Herrlingen                 
  137.       W-7906 Blaustein           
  138.       Federal Republic of Germany
  139.  
  140.       Tel.: 07304-3745           
  141.  
  142. Viel Spaß 8-)
  143.  
  144. --------------------------- ENTWICKLUNGS-GESCHICHTE -----------------------
  145.  
  146. V0.?? - 23. Dezember 1990 bis 01. Januar 1991:
  147.       - Grundlegende Programmgestaltung.
  148.  
  149. V1.0  - 02. Januar 1991:
  150.       - Erste veröffentlichte Version.
  151.  
  152. V1.01 - 16. Januar 1991:
  153.       - kleinere Veränderungen.
  154.       - Parameterübergabe vom CLI aus.
  155.       - aber kein WorkBench-Start mehr.
  156.  
  157. V1.02 - 21. Januar 1991:
  158.       - kleinere Veränderungen.
  159.       - sqrt durch SPSqrt ersetzt; dadurch fast doppelt so schnell.
  160.  
  161. V1.03 - 26. Februar 1991:
  162.       - kleinere Veränderungen.
  163.       - Quellcode aufgeräumt.
  164.       - bis zu 20 Ladungen werden berechnet.
  165.  
  166. V1.04 - 27. Februar 1991:
  167.       - Reperaturfunktion eingefügt.
  168.       - Feinberechnung nach Überblick mit gleichen Koordinaten.
  169.  
  170. V1.05 - 01. März 1991:
  171.       - Programm kann wieder von der Workbench gestartet werden.
  172.  
  173. V1.06 - 06. März 1991:
  174.       - Einbau von zwei Auto-Requestern (Reperatur, Feinberechnung).
  175.       - Reperatur-Funktion und Fast-Drawing wurden zusammen in einer
  176.         Prozedur untergebracht (Prog. 700 Bytes / Quellc. 1.3 K kürzer).
  177.  
  178.