Das JAVA-Applet des Kreuzworträtsel ChampionDas JAVA-Applet ermöglicht es, interaktive Kreuzworträtsel auf der eigenen Web-Seite zu veröffentlichen. Anders als reine Bitmap-Lösungen kann das Applet direkt auf Eingaben des Anwenders reagieren und das Rätsel auch individuell formatieren. Für die Umsetzung sind drei Dateien erforderlich:
Eine Rätseldatei besitzt üblicherweise die Erweiterung .CWA und ist eine Textdatei im ANSI-Textformat, deren Informationen zeilenweise abgelegt sind. Zeilentrennungen erfolgen durch 0D (13) oder 0D0A (13,10); beide Varianten sind erlaubt. Zeilen, die mit # beginnen, werden als Kommentare überlesen.
Als erste Pflichtzeile ist die Größe des Rätsels in Kästchen anzugeben: SYNTAX: BREITE, HOEHE BREITE und HOEHE bezeichnen die Anzahl der waagrechten bzw. senkrechten Kästchen des Rätsels. Es folgen anschließend die Begriffe, wobei jeder Begriff wie folgt anzugeben ist Syntax: X, Y/ARROWTYPE/WORD=DEFINITION [//DEF1 [\nDEF2 [\nDEF3 [\nDEF4]]]] X und Y spezifizieren das Kästchen, in dem die Fragestellung platziert werden soll. Beide Angaben sind nullbasiert, d.h. das erste Kästchen links oben besitzt die Position (0, 0), während das letzte rechts unten mit (BREITE-1, HOEHE-1) adressiert wird. ARROWTYPE gibt die Art des Pfeils und damit gleichzeitig auch die Laufrichtung des Worts an. Mögliche Werte sind:
Andere Richtungen sind nicht erlaubt. WORD enthält das zu ratende Wort in Großbuchstaben. DEFINITION enthält die Fragestellung im ANSI-Format. Die Beschreibung enthält die komplette Frage wie sie in der Kopfzeile angezeigt wird. DEF1-DEF4 sind optional und enthalten die vorgetrennte Fragestellung in bis zu vier Zeilen. Dies ermöglicht es dem Rätselhersteller, optimal formatierte Begriffe zu liefern. Fehlen diese, trennt das Applet selbst nach Bedarf.
Nach den Begriffen folgen zwei weitere Pflichtzeilen: Syntax: BILD=left, top, right, bottom Die BILD-Klausel definiert die Position eines optionalen Bildes. Ist im Rätsel kein Bild enthalten, so sind statt dessen left, top, right und bottom als "-1" anzugeben. Die Positionen werden in Kästchen bei Null beginnend gezählt. Syntax: CHARNUM=1,2,3,4,5,...,25,26 Die CHARNUM-Klause ist zwar Pflicht, aber nur für Buchstabenrätsel interessant. Das Applet kann für diese Rätselvariante jedem Buchstaben des Alphabets eine Zahl zuordnen, die dann im Kästchen angezeigt wird.
Eine Rätseldatei besitzt üblicherweise die Erweiterung .SOL und ist eine Textdatei im ANSI-Textformat, deren Informationen zeilenweise abgelegt sind. Zeilentrennungen erfolgen durch 0D (13) oder 0D0A (13,10); beide Varianten sind erlaubt. Durch den Einsatz einer Lösungsdatei können einem Rätsel mehrere verschiedene Lösungswörter zugewiesen werden, so dass unterschiedliche Preisrätsel mit einem Kreuzworträtsel möglich sind, indem die HTML-Dateien jeweils andere SOL-Dateien spezifizieren. Der Aufbau der Lösungsdatei gliedert sich in eine Beschreibung der Lösung sowie einen Block mit Formatanweisungen. Die erste Pflichtzeile definiert die Anzahl der Buchstaben für das Lösungswort: Syntax: ANZAHL=## Die Zahl in ## wird anschließend für das Lesen der einzelnen Positionen der Lösungsbuchstaben verwendet, die ab der zweiten Zeile folgen und folgendes Format besitzen: Syntax: XY=X,Y X und Y spezifizieren das Kästchen, dessen Buchstabe Teil der Lösung ist. Die Reihenfolge der Lösungsbuchstaben ergibt sich aus der Reihenfolge der Auflistung der Positionen in der Lösungsdatei. Als Abschluss folgt noch einmal eine spezielle Markierung: Syntax: ENDPOS Positionsangaben nach dieser Marke werden ignoriert. Im darauf folgenden Formatblock wird die Darstellung der Lösungselemente definiert. Syntax: TYPE=Element Element enthält die Art der optischen Hervorhebung des Lösungskästchens. Erlaubte Werte sind:
Die farbliche Gestaltung des Elements beschreiben die nachfolgenden Anweisungen: Syntax: UC bezeichnet die Farbe, mit der das durch TYPE spezifizierte Element gezeichnet wird, während FC die Füllfarbe definiert. Dabei bezeichnen jeweils "-1" die Defaultwerte. Die Angabe der Farbe erfolgt im RGB-System. Zusätzlich kann die Position des Buchstabens im Kästchen in dem Lösungswort durch eine Zahl sichtbar gemacht werden. Dazu dient das Flag: Syntax: WITHCHARPOS=OnOff Ist OnOff auf 1 gesetzt, werden die Positionszahlen angezeigt. Die Schrift der Positionsangabe ist ebenfalls indivduell einstellbar. Dazu dienen die nachfolgenden Angaben: Syntax:WITHCHARFONT=Name In Name kann die Schriftart für die Positionsangabe definiert werden. Per Default ist dies Arial. Syntax:WITHCHARSIZEFONT=Size Size bezeichnet die Größe der Schrift für die Positionsangabe. Syntax:WITHCHARSTYLEFONT=## Der zu verwendende Schriftstil ist durch ## numerisch definiert. Es gelten:
Syntax:WITHCHARCOLORFONT=Color Color bezeichnet schließlich die Farbe der Schrift für die Positionsangabe. Sie ist wiederum im RGB-System anzugeben. Als letzte Option kann auch das gesamte Kästchen mit einer speziellen Farbe hinterlegt werden. Dies steuert die Angabe: Syntax:SOLCOLOR=Color Der Defaultwert "-1" setzt die Farbe auf die Farbe des Hintergrunds, so dass keine spezielle Hervorhebung erfolgt.
Das Applet wird in der HTML-Datei an der gewünschten Stelle mit Hilfe eines APPLET-Tags eingebunden. Der Aufruf hat das Format:
<applet
codebase = "." Variable sind hierbei neben dem Titel, der im Parameter "name" anzugeben ist, vor allem die Ausrichtung in align sowie als wichtigste Angabe die Größe des Applets. Sie berechnet sich wie folgt: width = (Kästchengröße in Pixel) * (Anzahl der waagrechten Kästchen) + 1 Pixel Die Kästchengröße selbst wird als Parameter übergeben. Hierauf folgen die Parameter des Applets, die an dieser Stelle zunächst erst einmal auf einen Blick präsentiert werden sollen:
<param name="TYPE" value="STANDARD"> Die Bedeutung der Parameter wird nachfolgend beschrieben. TYPE Der Parameter TYPE kennt zwei mögliche Werte:
"STANDARD" bezeichnet dabei ein normales Schwedenrätsel, während "ZAHLENRAETSEL" den Buchstaben eine Zahl zuordnet, so dass gleiche Zahlen auch gleiche Buchstaben bedeuten. Für alle anderen Werte korrigiert das Applet auf "STANDARD". ZRFONT, ZRSIZEFONT, ZRSTYLEFONT, ZRCOLORFONT Die ZR-Parameter definieren die Schriftart für die Angabe der zugeordneten Zahlen im Falle eines Zahlenrätsels. CELLWITH Der Parameter CELLWIDTH definiert die Breite und Höhe eines Kästchens in Pixel. Dieser Wert korrespondiert mit der Gesamtgröße des Rätsels, wird jedoch nicht automatisch korrigiert, wenn die Werte nicht zusammenpassen. CELLCOLOR, DEFCOLOR Die Parameter CELLCOLOR und DEFCOLOR spezifizieren die Farben für die Eingabe- und Beschreibungskästchen im RGB-Format, wobei "-1" die Defaultwerte weiß und schwarz setzt. DATAURL Die Referenz des Applets auf die zugehörige Rätseldatei stellt der Parameter DATAURL her. Sie wird auf die Adresse der Seite bezogen und entsprechend vervollständigt, wenn in DATAURL nur der Dateiname angegeben ist. Man kann hier jedoch auch eine vollständige Adresse eintragen. COPYRIGHT Der Parameter COPYRIGHT liefert den Text, der in der Fußzeile des Applets ausgegeben wird. COPYRIGHTFONT, COPYRIGHTCOLOR Die Parameter COPYRIGHTFONT und COPYRIGHTCOLOR definieren die Schriftart und die Farbe für den Copyrightvermerk. FOKUSCHAR, FOKUSWORD, FOKUSDEF Über die Parameter FOKUSCHAR, FOKUSWORD und FOKUSDEF können individuelle Farben für den jeweils aktuellen Buchstaben, das aktuell markierte Wort und die aktuell markierte Fragestellung vorgegeben werden. "-1" steht für die Defaultwerte rot, gelb und blau. DEFCENTER Per Default werden die Fragestellungen linksbündig im Kästchen platziert. Es ist jedoch auch möglich, diese blockzentriert anzuzeigen. Dazu muß DEFCENTER auf "1" gesetzt werden. ADPICTURE Enthält das Rätsel ein Bild, so wird die entsprechende Datei über ADPICTURE referenziert. ADPICTUREURL Enthält das Rätsel ein Bild und ist in ADPICTURE eine gültige Adresse eingetragen, so führt ein Klick auf das Bild dazu, dass das Applet die durch ADPICTUREURL referenzierte eite anzeigt. BACKCOLOR Die Hintergrundfarbe des gesamten Applets wird durch BACKCOLOR definiert. Der Defaultwert "-1" steht für dunkelgrau. SOLFILEURL Der Parameter SOLFILEURL referenziert die Lösungsdatei, die zu dem Rätsel gehört.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|