@database Soliton @master Soliton.guide @author "Kai Nickel" @node "MAIN" "Inhaltsverzeichnis" @{b}S o l i t o n@{ub} Solitär - Kartenspiel @{b}Einleitung@{ub} @{" Beschreibung " link "DESCRIPTION" } @{" Installation " link "INSTALLATION"} @{" Autor " link "AUTHOR" } @{b}Bedienung@{ub} @{" Hauptfenster " link "MAINWINDOW" } @{" Einstellungen " link "SETTINGS" } @{" Spielkarten erstellen " link "CARDS"} @{b}Anhang@{ub} @{" Geschichte " link "HISTORY" } @{" Copyright " link "COPYRIGHT" } @{" MUI " link "MUI" } @endnode @node "DESCRIPTION" "Beschreibung" @{b}B e s c h r e i b u n g@{ub} @{b}Eigenschaften@{ub} Soliton ist ein Solitär-Kartenspiel mit den folgenden Eigen- schaften: * Spielkarten werden per Datatypes eingeladen. Sie können in beliebigen Farbtiefen und Größen auch sehr leicht @{"selbst angefertigt" link "CARDS"} werden. * Systemkonforme @{"MUI" link "MUI"}-Oberfläche, läuft wahlweise auf der Workbench oder auf eigenen Bildschirmen. Insbesondere auch gut für Graphikkarten geeignet. * Hintergrundmuster frei wählbar. * Opaque Kartenverschiebung per drag'n'drop. * Viele Spieleinstellungen, Timer, Statistiken, Zugvorschlag. * @{"Giftware" link "COPYRIGHT"}. @{b}Voraussetzungen@{ub} Um Soliton zu spielen benötigt man einen Amiga mit Kickstart 3.0 oder höher und @{"MUI" link "MUI"} Version 3.6 oder höher. @endnode @node "INSTALLATION" "Installation" @{b}I n s t a l l a t i o n@{ub} @{b}Automatisch@{ub} Am besten installiert man Soliton, indem man das beigelegte Skript "Soliton-Install" startet. Keine Angst: @{b}Alle Dateien werden in das Soliton-Verzeichnis kopiert.@{ub} Soliton wird gestartet, indem man es einfach von der Work- bench aus anklickt. @{b}Manuell@{ub} Wenn das Skript nicht funktioniert, weil man den Installer nicht besitzt, kann man die "Soliton"-Schublade auch einach irgendwohin auf die Festplatte schieben. Dann nimmt man die "Soliton.guide" aus dem "Soliton/Docs/Deutsch/" Verzeichnis und verschiebt sie direkt nach "Soliton/", damit sie als Online-Hilfe gefunden wird. Wenn man will kann man dann noch die Icons durch die aus der "MWB"-Schublade ersetzen. @{b}Deinstallation@{ub} Da alle zu Soliton gehörenden Dateien im Soliton-Verzeichnis liegen, genügt es, zur Deinstallation einfach das Soliton- Verzeichnis zu löschen. @endnode @node "AUTHOR" "Autor" @{b}A u t o r@{ub} Soliton wurde von Kai Nickel geschrieben. @{b}Post@{ub} Kai Nickel Herzogstraße 29 67435 Neustadt BRD @{b}EMail@{ub} un7x@rz.uni-karlsruhe.de kai@rpsbbs.palatinate.de @{b}WWW@{ub} http://www.uni-karlsruhe.de/~un7x Hier gibt es Updates und auch eine kleine Spielkarten- Galerie! @{b}Bankverbindung@{ub} Konto#: 247 014 Bank : Raiffeisenbank Neustadt/Nord BLZ : 546 600 24 @{b}Supportbox@{ub} Außer im Aminet (game/think und game/data) gibt es Updates in der Mailbox RPSBBS: Modem: 06323/93066 ISDN : 06323/93065 Login: graph2d Pfad : /Lokal/Support/Amiga/Graph2D @{b}Translation@{ub} Alle Übersetzungen wurden von der Amiga Translators Organisation (@{b}ATO@{ub}) ausgeführt. Ich möchte den folgenden Personen für ihre Arbeit danken: Francais: Franck Aniere (Guide, Install) Francis Labrie (Catalog) Franck Routier (Proofreader) Svenska: Magnus Holmgren (Translator) Linus Silvander (Proofreader) Norsk: Audun Vaaler Italiano: Luca Nora (Translator) Roberto Patriarca (Proofreader) Nederlands: Guno Heitman (Translator) Frank Mosch (Proofreader) Español: Arturo Roa @endnode @node "MAINWINDOW" "Hauptfenster" @{b}H a u p t f e n s t e r@{ub} Das Fenster besteht eigentlich nur auf dem Spielfeld. Karten werden per drag'n'drop verschoben, indem man sie anklickt, die Maustaste gedrückt hält und über ihrem Zielort wieder losläßt. @{b}Knöpfe@{ub} Am oberen oder am linken Fensterrand befindet sich eine Knopfleiste, deren Funktion der der entsprechenden Menüpunkte entspricht. Eine Ausnahme ist der "Zug"-Anzeigeknopf, der dann und nur dann erscheint, wenn mit den sichtbaren Karten ein Zug gemacht werden kann. Drückt man ihn, wird dieser Zug auto- matisch ausgeführt. Zuguterletzt tickt auf der Knopfleiste auch noch die Spiel- zeit, die zu Beginn eines neuen Spiels zurückgesetzt wird. Sie läuft übrigens nur, wenn das Soliton-Fenster aktiv ist. Das Aussehen der Knopfleiste und das Vorhandensein des "Zug"- Knopfs läßt sich @{"einstellen" link "SETTINGS"}. @{b}Menü@{ub} Das Menü bietet die folgenden Funktionen: Projekt Neu : Neues Spiel beginnen. Abräumen : Automatisch alle offenen Karten auf ihre Zielpositionen befördern, sofern dies möglich ist. Undo : Letzten Zug rückgängig machen. Über : Öffnet Soliton Informationsfenster. Hilfe : Zeigt die Online-Hilfe. Das gleiche passiert, wenn man irgendwo die HELP-Taste drückt. Statistiken : Öffnet ein Fenster mit Spielstatistiken. Verkleinern : Schließt Soliton und legt ein Symbol auf der Workbench ab, mit dem es wieder zum Leben erweckt werden kann. Ende : Soliton beenden Graphik Hier kann zwischen den verschiedenen Karten-Hintergrund- Kombinationen umgeschaltet werden, die man in den @{"Einstellungen" link "SETTINGS"} definieren kann. Einstellungen Soliton : Soliton @{"Einstellungen" link "SETTINGS"} ändern MUI : MUI-Einstellungen für Soliton ändern @{b}Hilfe@{ub} Bei Druck auf die HELP-Taste öffnet sich die Online-Hilfe, die diese Dokumentation hier enthält. Läßt man den Mauszeiger einen Moment über einem Oberflächen- element ruhen, erscheint eine Sprechblase mit einem kleinen Hilfstext. @endnode @node "SETTINGS" "Einstellungen" @{b}E i n s t e l l u n g e n@{ub} Die Soliton-Programmeinstellungen sind in drei Kategorien gegliedert: @{b}Regeln@{ub} @{b}Umdrehen@{ub} Anzahl der Karten die umgedreht werden, wenn man auf den Spielstapel oben links klickt. Je mehr Karten desto schwieriger wird das Spiel. @{b}Als Block@{ub} Ist diese Option aktiv, können die Karten von den unteren Stapeln nur alle zusammen verschoben werden. Anderenfalls kann man auch einen Teil abheben und verschieben. Diese Option macht das Spiel schwieriger. @{b}Automat. Umdrehen@{ub} Die oberste Karte eines Stapels umdrehen, sobald sie frei wird. Diese Option dient nur der Bequemlichkeit. @{b}Automat. Quellstapel umdrehen@{ub} Die ersten 1 bis 3 Karten des Quellstapels aufdecken, nachdem er umgedreht wurde. Diese Option dient nur der Bequemlichkeit. @{b}Zug-Anzeige@{ub} Legt fest, ob der "Zug"-Knopf im Hauptfenster erscheint, der über Zugmöglichkeiten Auskunft gibt. @{b}Aussehen@{ub} @{b}Knöpfe@{ub} Hier kann zwischen den "Cool buttons" am linken Fensterrand oder der Standardknopfleiste oben gewählt werden. Die Funktionalität ist die gleiche, aber die "Cool buttons" sehen einfach besser aus. Wer diese Meinung nicht teilt, kann die Knopfleisten auch ganz ausschalten - es gibt ja immer noch das Menü. @{b}Fluggeschwindigkeit@{ub} Geschwindigkeit, mit der die Karten zu ihren Zielen fliegen, wenn man z. B. auf 'Aufräumen' klickt. 'Sofort' bewirkt, daß die Karten ohne Gimmicks springen. @{b}Opaque Karten@{ub} Zeigt die Karten beim Bewegen mit der Maus voll an, anstatt lediglich einen Rahmen zu zeichnen. @{b}Piep@{ub} Systempieps benutzen, um Fehler anzuzeigen. @{b}Sicherheitsabfragen@{ub} Beim Start eines neues Spiels oder beim Beenden nachfragen. @{b}Graphik@{ub} Es können bis zu 10 Graphikkombinationen definiert werden, zwischen denen im Graphik-Menü umgeschaltet werden kann. Eine Kombination besteht aus einer Kartendatei und einem Hintergrundmuster. @{b}Graphikkombination@{ub} Name der Kombination. @{b}Kartendatei@{ub} Soliton kann Spielkarten in zwei Formaten laden: 1. Die Karten befinden sich in alle einem Bild. In diesem Fall wählt man einfach diese Bilddatei aus. 2. Die Karten befinden sich als einzelne Dateien in einem Verzeichnis. In diesem Fall wählt man nur das Verzeichnis aus (aber keine Datei!). Eigene Spielkarten können leicht @{"selbst erstellt" link "CARDS"} werden. @{b}Hintergrund@{ub} Der Hintergrund des Spielfelds kann mit einem Muster versehen werden. Dazu kann man hier eine beliebige Bilddatei aus- wählen, die per Datatypes geladen wird. @endnode @node "CARDS" "Eigene Spielkarten" @{b}E i g e n e S p i e l k a r t e n@{ub} @{b}Format@{ub} Allgemein gilt: * Alle Karten eines Kartensatzes müssen rechteckig sein und genau die gleichen Ausmaße haben. Bei großen Karten wird zum Spielen ein entsprechend üppiger Bildschirmmodus erforderlich sein. Karten von etwa 80*120 Pixeln werden noch auf einen 640*512 Bildschirm passen. * Soliton zeigt bei übereinanderliegenden Karten abhängig von der Fensterhöhe immer mindestens 1/9 der Höhe der über- deckten Karten an. Der Wert der Karten sollte deshalb nach Möglichkeit größtenteils im oberen Neuntel untergebracht werden. * Die Karten können in beliebiger Farbtiefe vorliegen. Sie beim Laden an die aktuelle Graphikumgebung angepaßt, indem die Farben gegebenenfalls reduziert und umgestellt werden. UNGEEIGNET sind allerdings HAM-Karten, da diese nicht auf "normalen" Bildschirmmodi dargestellt werden können. * Als Bildformat darf im Grunde alles verwendet werden, was mit Datatypes gelesen werden kann. Es ist aber zu beachten, daß nicht jeder alle exotischen Datatypes besitzt. Deshalb halte ich IFF, JPEG oder PNG für die beste Wahl. @{b}Dateien@{ub} Soliton kann Karten wahlweise auf zwei Arten einlesen: * Alle Karten befinden sich in einem Bild. Sie müssen dort direkt nebeneinander liegen und wie im Beispiel "Cards_Default.iff" angeordnet sein. Dieses Bild muß pixel- genau abgespeichert werden (z.B. als Brush), da Soliton die Größe der Karten als Bildbreite/14 und Bildhöhe/4 annimmt. Vorteil : Relativ schneller Ladevorgang. Nachteil: Alle Karten müssen beim Erstellen auf dieselbe Farbpalette gebracht werden. Dies ist bei 24Bit- Dateien aber kein Problem. * Jede Karte befindet sich als einzelne Bilddatei in einem gemeinsamen Verzeichnis. Die Namen ergeben sich wie folgt: Back für die Kartenrückseite Empty für ein leeres Spielfeld Clubs_A für Kreuz Ass Clubs_2 für Kreuz 2 . . . . . . Clubs_10 für Kreuz 10 Clubs_J für Kreuz Bube Clubs_Q für Kreuz Dame Clubs_K für Kreuz König ebenso: Diamonds_# für Karo Hearts_# für Herz Spades_# für Pik Vorteil : Einzelne Palette für jede Karte Nachteil: Lange Ladezeit @{b}Veröffentlichung@{ub} Es bleibt natürlich jedem selbst überlassen, ob und wie er seine Karten veröffentlicht. Bei Uploads ins Aminet empfehle ich das Verzeichnis "game/data". Bitte vergeßt nicht, ein .readme beizulegen. VIEL SPASS !!! @endnode @node "HISTORY" "Geschichte" @{b}E n t w i c k l u n g s g e s c h i c h t e@{ub} @{b}V1.50 (01.06.97)@{ub} * Drag'n'Drop-Mechanismus fast vollständig neu programmiert: Jetzt "fliegt" die Karte auch am Ende eines Drag'n'Drop- Vorgangs an die genaue Zielposition, bzw. an die Ausgangs- position im Falle eines Fehlers. * Mehrstufiges, "fliegendes" Undo, das bis zum Spielstart zurückreicht. * Minimale Fenstergröße wieder verringert. Das ist notwendig, um auch auf kleinen Bildschirmen zu starten. * Neues Punktesystem, das von der Spielzeit beeinflußt wird. * Punkteanzeige im Hauptfenster, Highscoreliste. * Übersetzungs-Update: Nederlands * Reko2Soliton.ifx verbessert (Nathan Black). * Kosmetik im Über-Fenster. Schon gesehen? @{b}V1.40 (03.05.97)@{ub} * Soltion ist jetzt toleranter was die Position des Fallenlassens der Karten betrifft. Nun also weniger Beeps bei schnellem Spiel. * Doppelte Häkchen im Graphik-Menu beseitigt. * Wieder "Friend-Bitmaps" für CyberGfx -> schneller * Neue Übersetzungen: español, nederlands * Default-Spielkarten überarbeitet * Konvertierungs-Skript für PPaint7 @{b}V1.31b (10.0.97)@{ub} * Möglichen Absturz/Enforcer Hit beim Start beseitigt * Gelegentliches "Hängenbleiben" beim Drag'n'Drop * Statistikfenster behält jetzt an seine Position * Schwedischer Katalog aktualisiert. * Zuganzeigeknopf verschwindet nun komplett, wenn er ab- geschaltet ist. * 'Fliegende Karten' standardmäßig abgeschaltet. Diese Option scheint fehlerhaft zu sein und bringt manche Amigas zum Absturz. Siehe "readme.1st" für Details. * Anzeige der Graphikhardware im Aboutfenster und Compilierung ohne Optimierung - beides aus Debugginggründen. * Zuganzeige im Standarddesign hat nicht richtig funktioniert. @{b}V1.30 (09.03.97)@{ub} * Zug-Anzeigeknopf * "Cool buttons" ;-) am linken Fensterrand (optional) * Karten fliegen an ihre Ziele (optional) * Graphikkombinationen bestehend aus Karten und Hintergrund- muster definierbar und per Menu auswählbar. * Karten sollten jetzt nicht mehr irgendwo im Fenster hängen- bleiben * Schalter für opaque Karenbewegung wurde manchmal ignoriert. * Benutzung des System-Pieps und automat. Öffnen der ersten Karten nach Umdrehen des "Quellstapels" jetzt abschaltbar. * 'Hilfe' Menüpunkt funktionierte nicht. * ImageFX-Skripts, die Karten ins Soltion Format konvertieren können sollen. * Fehler beim Aufräumen, wenn "Automat. Aufdecken" ausge- schaltet war. * Regelkorrektur: A auf 2 jetzt erlaubt (obwohl sinnlos), jedoch kein K mehr auf A. Es besteht jetzt die Möglichkeit, Karten von den vier Zielstapel wieder zurückzuholen. * Sicherheitsrequester beim Beenden und beim Starten eines neues Spiels (optional). * Neue Sprachen @{b}V1.20 (18.02.97)@{ub} * Timer eingebaut. * Statistik-Fenster. * Unterstützung der V43-Datatypes zur Darstellung von mehr als 256 Farben. * Höhere Geschwindigkeit auf Cybergraphics-Bildschirmen mit mehr als 8bit Farbtiefe. * Französischer und schwedischer Katalog. * Default-Cardset etwas verbessert. * Drag-Punkt konnte leicht "verrissen" werden. * Installationsskript überarbeitet. @{b}V1.10 (10.02.97)@{ub} * Kartenverschiebung optional auch mit Bild ("opaque") anstatt mit Rahmen. * Undo-Möglichkeit. * Drag'n'drop Vorgang beginnt jetzt erst, wenn die Maus nach dem Click auch bewegt wird. Rechte Maustaste bricht den Vorgang ab. * Größe des angezeigten Teils überdeckter Karten abhängig von der Fenstergröße. * Automatisches Aufdecken der obersten Karte jetzt abschalt- bar. * Kosmetik im Statusfenster, den Requestern und den Programm- einstellungen. Neues Icon. * Neue Spiele wurden manchmal sofort abgeräumt. * Intern: KaiLib @{b}V1.00 (01.02.97)@{ub} * Erste Version @endnode @node "COPYRIGHT" "Copyright" @{b}C o p y r i g h t@{ub} Soliton ist Copyright ©1997 Kai Nickel. Soliton ist GIFTWARE. Man darf es also frei benutzen und kopieren solange damit keine geschäftlichen Interessen ver- bunden sind. Das Originalarchiv muß dabei unverändert und zusammen bleiben. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Wer das Programm benutzt ist aufgefordert, dem Autor ein kleines Geschenk zukommen zu lassen. Wer es gerne einfach hat, kann die im Kapitel @{"Autor" link "AUTHOR"} angegebene Konto- nummer benutzen ;-) !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Es ist ausdrücklich erlaubt, das Programm in die Meeting- Pearls und die Aminet CD-Rom Serien aufzunehmen. Der Autor übernimmt keine Garantie für das Funktionieren von Soliton und kann nicht für eventuelle Schäden verantwortlich gemacht werden, die durch Soliton entstehen könnten. Soliton benutzt das @{"MUI-System" link "MUI"} von Stefan Stuntz. Alle @{"Übersetzungen" link "AUTHOR"} wurden von der ATO ausgeführt. @endnode @node "MUI" "MUI" @{b}M U I@{ub} This application uses MUI - MagicUserInterface (c) Copyright 1993-97 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 @{b}MUI in Soliton@{ub} Um eine optisch ansprechende und komfortable Oberfläche zu bieten, benutzt Soliton das MUI-System von Stefan Stuntz. Für Soliton muß deshalb MUI in der Version 3.6 oder höher installiert sein. @{b}Registrierung@{ub} Man darf MUI benutzen, @{b}ohne@{ub} sich dafür registrieren zu lassen. In der registrierten Version hat man allerdings den Vorteil, daß alle Einstellungen in dem zu MUI gehörenden Preferences-Programm abgespeichert werden können, und so jede MUI-Applikation (also auch Soliton) in ihrem Aussehen dauer- haft den eigenen Wünschen angepaßt werden kann! Die wichtigsten Einstellungen lassen sich allerdings auch in der nicht registrierten Version von MUI tätigen. Möchte man beispielsweise, daß sich Soliton nicht mehr auf dem Workbench-Screen öffnet, so kann mit den MUI-Preferences leicht ein anderer Public-Screen oder auch ein eigener Bild- schirm eingestellt werden, auf dem Soliton dann in Zukunft erscheinen wird. Es empfielt sich also auf jeden Fall, auch die Anleitung(en) des MUI-Systems - insbesondere der @{b}MUI-Preferences@{ub} - gründlich zu lesen. @endnode