home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 501.lha / CrossWordPuzCreator_v3.3 / Cross.docD.pp / Cross.docD
Text File  |  1991-04-09  |  12KB  |  322 lines
  1. Crossword Puzzle Creator V3.3
  2. -----------------------------
  3.  
  4. Copyright © 1991 by Jürgen Weinelt
  5.                     Zur Kanzel 1
  6.                     8783 Hammelburg
  7.                     Deutschland
  8.  
  9. Crossword Puzzle Creator (CPC) V3.3 ist Freeware.
  10.  
  11. CPC darf auf nicht-kommerzieller Basis weitergegeben werden, z.B. im Rahmen
  12. von PD-Serien.
  13. Ich bin wirklich relativ tolerant, was die Kopiergebühren für PD-Disketten
  14. angeht; trotzdem behalte ich mir vor, bei besonders üblen Auswüchsen alle
  15. mir zur Verfügung stehenden rechtlichen Mittel einzusetzen!
  16.  
  17.  
  18.  
  19. Der Quellcode ist bei diesem Release enthalten, allerdings stellt ihr
  20. besser keine besonders hohen Ansprüche... ich habe das Programm
  21. ursprünglich vor ca. fünf Jahren in C64-Basic
  22.  
  23. ("   **** COMMODORE 64 BASIC V2 ****
  24.   64K RAM SYSTEM  38911 BASIC BYTES FREE ", gelle?)
  25.  
  26. entwickelt, vor ca. 3 Jahren umgesetzt in AmigaBASIC und während der
  27. letzten beiden Jahre nach und nach in Modula-II umgestrickt.
  28.  
  29. Entsprechend sieht der Sourcecode aus...
  30.  
  31.  
  32.  
  33. Hinweis: Benutzung des Programms auf eigene Gefahr; d.h. wenn es irgendwas
  34.          demoliert, beschwert euch nicht bei mir!
  35.          Über größere Bugs wüßte ich trotzdem gerne Bescheid...
  36.  
  37. Hinweis: CPC greift auf den Drucker über das PAR:-Device zu, weil das
  38.          Rätsel im Grafikmodus gedruckt wird. (Kann mir jemand erklären,
  39.          wie man sowas mit dem PRT: machen kann? Ich bräuchte punktweisen
  40.          Zeilenvorschub und Ausgabe einer Zeile mit der "ESC *"-Sequenz).
  41.          Der Ausdruck sollte mit jedem Epson-kompatiblen Drucker problemlos
  42.          möglich sein, testen konnte ich es allerdings nur mit meinem
  43.          Star NL10.
  44.          Die Ausgabe der Rätsel-Lösung erfolgt übrigens über PRT:
  45.  
  46. Hinweis: CPC benötigt sehr viel Speicher; auf 512K-Systemen mit Extras wie
  47.          z.B. mehreren Laufwerken kann es u.U. Schwierigkeiten geben.
  48.          Ich hatte auch einen sehr seltsamen Absturz auf einem solchen
  49.          512K-System; ich versuche zur Zeit, das Problem zu reproduzieren.
  50.          Zur Zeit habe ich ehrlich gesagt den M2Amiga selbst im Verdacht,
  51.          denn der stürzt ja (angeblich; siehe README auf Compiler-Disk)
  52.          auch ab, wenn nicht viel Speicher übrig ist...
  53.  
  54. Hinweis: Ich selbst habe einen A1000 mit 2.5MB, Festplatte und Kick/WB 1.3;
  55.          wer Probleme mit dem Programm hat, möge mir bitte eine kurze
  56.          Problembeschreibung mit möglichst exakter Angabe der Konfiguration
  57.          (Hard- UND Software) schicken.
  58.  
  59.  
  60.  
  61. Aufruf
  62. ------
  63. CROSS [-xXSIZE] [-yYSIZE] [-d]
  64.          (1)       (2)     (3)
  65.  
  66. Das Programm akzeptiert bis zu 3 Parameter:
  67.  (1) Größe des Rätsels in x-Richtung; 5<=XSIZE<=39; Default: 19
  68.  (2) Größe des Rätsels in y-Richtung; 5<=YSIZE<=35; Default: 19
  69.                                (NTSC: 5<=YSIZE<=25)
  70.  (3) Debug-Modus für das Meldungs-Datenfile; Erklärung später.
  71.  
  72. Die Parameter können in beliebiger Reihenfolge angegeben werden; alle
  73. Parameter sind optional.
  74.  
  75.  
  76.  
  77. Vor dem Aufruf von CPC muß mittels ASSIGN ein logisches Device namens
  78. "CROSS:" definiert werden; dort sucht CPC seine Datenfiles:
  79.  
  80.  (1) DATA               (Verzeichnis)
  81.  
  82.  (2) DATA/msgtxt.data   (Datenfile mit mehrsprachigen Meldungen)
  83.  
  84.  (3) DATA/words01.crw   (Wortschatzdatenfile)   oder
  85.      DATA(words02.crw   (Wortschatzdatenfile)
  86.  
  87.  (4) DATA/ (...) .crd   (Rätseldatenfiles)
  88.  
  89. In diesem Release wird CPC mit zwei Wortschatzdatenfiles geliefert:
  90.   words01.crw enthält deutsche Wörter
  91.   words02.crw enthält englische Wörter
  92.  
  93.  
  94.  
  95. Bedienung
  96. ---------
  97. Das Programm ist weitgehend selbsterklärend. Hier nur einige wichtige
  98. Hinweise:
  99.  
  100.  - Direkt nach dem Programmstart liest CPC das Message-Datenfile.
  101.    Es erscheint eine Liste aller verfügbaren Sprachen (zur Zeit nur Deutsch
  102.    und Englisch), und der Benutzer kann dann auswählen, welche Sprache
  103.    verwendet werden soll (Zifferntaste, dann Return).
  104.    Eine ausführliche Beschreibung von "msg.txt" folgt weiter unten.
  105.  
  106.  - Die Auswahl der einzelnen Funktionen erfolgt über die Gadgets auf der
  107.    rechten Hälfte des Bildschirms. Die Bedeutung der Gadgets sollte
  108.    weitgehend selbsterklärend sein.
  109.  
  110.  - Einige Anmerkungen zum "Automatiksuche"-Gadget:
  111.  
  112.     * Es muß sich ein Wortschatz im Speicher befinden.
  113.  
  114.     * Es muß bereits mindestens ein Wort vorher plaziert worden sein (als
  115.       "Keim", aus dem das Rätsel "wachsen" kann).
  116.       Das erledigt das Programm im Moment automatisch.
  117.  
  118.     * Die Automatiksuche wird durch nochmaliges Betätigen des Gadgets
  119.       beendet, der gerade laufende Suchvorgang wird aber noch beendet.
  120.  
  121.     * Es kann jederzeit (wenn die Automatiksuche aus ist, jedenfalls) ein
  122.       anderer Wortschatz geladen werden.
  123.  
  124.  - Das "Limit zurücksetzen"-Gadget:
  125.  
  126.     * CPC versucht zuerst möglichst lange Wörter zu plazieren; die "Limit"-
  127.       variable gibt die momentan gültige Untergrenze für die Wortlänge an.
  128.  
  129.     * Mit dem "Limit zurücksetzen"-Gadget kann der Benutzer diese Längen-
  130.       beschränkung selbst wieder auf den Ausgangswert hochsetzen.
  131.  
  132.  
  133.  
  134. Message-Datenfile
  135. -----------------
  136. Diese Datei enthält (fast) alle Texte, die das Programm benutzt, und zwar
  137. (zur Zeit) in Englisch und Deutsch. Die Datei kann problemlos um weitere
  138. Sprachen erweitert werden (insgesamt bis zu 9 Sprachen).
  139. Jeder Eintrag in der Datei belegt eine eigene Zeile.
  140.  
  141.  
  142.  
  143. Aufbau des Message-Datenfile
  144. ----------------------------
  145. Die erste Zeile enthält eine Ziffer. Diese Ziffer gibt die Anzahl der vor-
  146. handenen Sprachen an. Es darf nur eine einzelne Ziffer sein.
  147.  
  148. Danach folgen die Bezeichnungen der einzelnen Sprachen (z.Z. ENGLISH und
  149. DEUTSCH).
  150.  
  151. Die folgenden Einträge sind ebenfalls jeweils für jede Sprache einmal
  152. vorhanden; sie stellen die Programmmeldungen dar.
  153.  
  154. Falls Sie das Message-Datenfile um eine neue Sprache erweitern wollen,
  155. beachten Sie bitte, daß die Übersetzungen nicht wesentlich länger als
  156. die Originalmeldungen sein sollten, da die Texte zum Teil in Gadgets
  157. oder Requestern auftauchen.
  158.  
  159. Jeder Eintrag muß mit einer dreistelligen Nummer beginnen, die mit der
  160. tatsächlichen Meldungsnummer (durchzählen) übereinstimmen muß (Sicherheits-
  161. maßnahme). Das hört sich recht kompliziert an, aber wenn man sich das
  162. Message-Datenfile einmal genau ansieht, versteht man bald, was gemeint ist.
  163. Die einzige Ausnahme is die die Meldung Nummer 999, die das Dateiende
  164. anzeigt.
  165.  
  166. Nach der Meldung 999 können beliebige Kommentare angehängt werden, der Rest
  167. des Files wird nämlich ignoriert.
  168.  
  169. Falls bei der Anpassung an eine neue Sprache Schwierigkeiten auftreten
  170. sollten, kann man CPC mit der Option "-d" aufrufen, dann werden während
  171. des Programmlaufs die Meldungen zusammen mit der Meldungsnummer ausgegeben;
  172. so können Probleme leichter lokalisiert und behoben werden.
  173.  
  174.  
  175.  
  176. ¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡
  177. ############################################################################
  178. Haben Sie Cross an eine weitere Sprache angepaßt? Bitte schicken Sie mir
  179. eine Diskette mit Ihrem "msgtxt.data"-File zu, damit ich es im nächsten
  180. Release berücksichtigen kann. Als Dank bekommen Sie Ihre Diskette mit einem
  181. anderen PD-Programm von mir zurück.
  182. ############################################################################
  183. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  184.  
  185.  
  186.  
  187. Wortschatzdatenfiles
  188. --------------------
  189. Eigene Wortschatzdatenfiles können jederzeit benutzt werden, wenn folgende
  190. Einschränkungen beachtet werden:
  191.  
  192.  (1) Alle Wörter müssen in GROSSBUCHSTABEN eingegeben sein.
  193.  
  194.  (2) Die Wörter dürfen keine Sonderzeichen enthalten, nur "A" bis "Z".
  195.  
  196.  (3) Die Wörter sollten eine ungerade Länge (=Anzahl von Buchstaben) haben,
  197.      also 3, 5, 7, 9, 11, ..., 25 Buchstaben (Ausnahme: zweibuchstabige
  198.      Wörter). Diese Einschränkung ist nötig, um eine optimale Vernetzung
  199.      der Wörter untereinander zu erreichen. Wenn Wörter mit gerader Länge
  200.      benutzt werden, können später im Rätsel unter Umständen größere Lücken
  201.      auftreten.
  202.      Die Wörter sollten außerdem nach der Länge sortiert sein; eine zusätz-
  203.      liche alphabetische Sortierung ist nicht zwingend erforderlich.
  204.  
  205.  (4) Kein Wort darf länger als 25 Buchstaben oder kürzer als 2 Buchstaben
  206.      sein.
  207.  
  208.  (5) Die Wortschatzdatei darf keine Leerzeilen enthalten.
  209.  
  210.  (6) Der letzte Eintrag muß unbedingt "***END***" sein, ohne die Anführungs-
  211.      zeichen natürlich.
  212.  
  213. Mit dem ebenfalls mitgelieferten Hilfsprogramm "PreProcessor" kann man eine
  214. normale ASCII-Textdatei in eine Wortschatzdatei umwandeln. Dazu filtert man
  215. einen beliebigen Text durch den PreProcessor und sieht sich das resul-
  216. tierende File mit einem ASCII-Editor an. Dabei löscht man einfach alle
  217. Wörter, die nicht benötigt werden, wieder heraus (es sind wahrscheinlich
  218. auch einige Wörter bei der Umwandlung verstümmelt worden). So kann man in
  219. wenigen Minuten fast mühelos neue Wortschatzdateien erzeugen.
  220.  
  221. Aufruf des PreProcessors:
  222.   PreProcessor
  223.  
  224. Es werden keine Parameter benötigt, die Dateien werden mittels FileRequester
  225. ausgewählt.
  226.  
  227. Hinweis: Der PreProcessor arbeitet mit einem rekursiven Algorithmus
  228.          (zum Sortieren wird nämlich ein binärer Baum aufgebaut); deshalb
  229.          sollte genügend Stack-Speicher reserviert sein. Gegebenenfalls
  230.          kann der CLI-Befehl "STACK" benutzt werden, um mehr Stack-
  231.          Speicher zu reservieren.
  232.          Ich arbeite z.B. prinzipiell mit 50000 Bytes Stack.
  233.          PreProcessor ist übrigens auch ansonsten ein ziemlicher
  234.          Speicherfresser... bei umfangreicheren ASCII-Dateien wird es
  235.          vermutlich Schwierigkeiten mit 512K-Amigas geben.
  236.  
  237.  
  238.  
  239. Eine Warnung: Besonders umfangreiche Wortschatzdaten haben natürlich den
  240. Vorteil, daß besonders gut vernetzte Rätsel entstehen; allerdings sollte
  241. man auch bedenken, daß die Rechenzeit mit zunehmendem Umfang des Wort-
  242. schatzes rapide ansteigt... und zwar nicht bloß linear!
  243. Meine Empfehlung: man benutzt am besten mehrere (kleinere) Wortschatz-
  244. datenfiles, und lädt immer dann, wenn für ein Datenfile keine Wörter
  245. mehr plaziert werden können, das nächste File nach. Besonders sinnvoll wäre
  246. es dabei, wenn man die Wörter gemäß ihrer Länge auf die Datenfiles verteilen
  247. würde, z.B.
  248.  
  249.   File         | Wortlänge
  250.   -------------+-----------
  251.   words05.crw  | 25..17
  252.   words06.crw  | 15.. 9
  253.   words07.crw  |  7.. 5
  254.   words08.crw  |  3.. 2
  255.  
  256.  
  257.  
  258. Bekannte Probleme/Fehler von CPC
  259. --------------------------------
  260.  - Seltsames Verhalten bei Speichermangel
  261.    (manchmal Absturz; Grund: unbekannt, aber Verdacht auf Compilerproblem)
  262.  
  263.  - (selten) Speicher-Fragmentierung (Grund: unbekannt)
  264.  
  265. Wer selbst ähnliche Probleme hat, möge mir bitte eine möglichst detaillierte
  266. Beschreibung des Problems, sowie der zugrundeliegenden Hard-/Softwarekonfi-
  267. guration zuschicken. Danke.
  268.  
  269.  
  270.  
  271. Zukünftige Erweiterungen von CPC
  272. --------------------------------
  273.  - "GENERIC"-Modus beim Ausdrucken des Rätsels, und zwar über PRT:
  274.  
  275.  - Hochauflösender Ausdruck über PAR:
  276.  
  277.  - Plaziertes Wort wieder entfernen
  278.  
  279.  - Verschiedene Grundmuster zur Plazierung der ersten "Keim"-Wörter
  280.  
  281.  - Icons für alle Datenfiles
  282.  
  283.  - NEW-Option
  284.  
  285.  - NEW_SIZE-Option
  286.  
  287.  - Benutzerkonfigurierbarkeit (wow, verdammt langes Wort... muß unbedingt
  288.    noch ins Wortschatzfile)
  289.  
  290.  - möglicherweise dynamische Speicherung des Wortschatzes in einer
  291.    doppelt verketteten Liste o.ähnl. (muß ich noch 'drüber nachdenken)
  292.  
  293.  - Rätsel mit nicht-rechteckigem Grundriss
  294.  
  295.  
  296.  
  297. History
  298. =======
  299.  
  300. V3.3    PAL/NTSC-Erkennung durch Abfrage der Höhe des Workbench-Screen
  301.         kleine Schönheitsfehler in Programm und Dokumentation behoben
  302.  
  303. V3.2    erter RELEASE der M2-Version auf AMOK
  304.  
  305.  
  306.  
  307. Viel Spass.
  308.  
  309.  
  310.  
  311.                    ####################################
  312.                  ########################################
  313.                 ##                                      ##
  314.                ##    /¯¯¯¯\   \\|||// \              /   ##
  315.                ##   /      \  \|o o|/  \            /    ##
  316.                ##          |   | . |    \    /\    /     ##
  317.                ##   \      /   | ' |     \  /  \  /      ##
  318.                ##    \____/    \ ~ /      \/    \/       ##
  319.                 ##              ¯¯¯                     ##
  320.                  ########################################
  321.                    ####################################
  322.