**************************************************************************** * Q U I S E L M E N U 2 . 0 * **************************************************************************** - Das Schnellwahl-Menü - 1) EINLEITUNG ============= QUISELMENU ist wieder nur eines von diesen Diskmenü-Programmen, die ver- suchen, Ihnen einen schnellen und bequemen Zugriff zu Ihrer Lieblings- software auf Ihren Disketten und/oder Ihrer Festplatte zu ermöglichen. Aber die meisten dieser Menüs haben große Nachteile. Einige sind Bootmenüs, die auf einer Diskette installiert werden müssen und nicht von der Fest- platte gestartet werden können, andere wiederum sind so mit tollen Effekten vollgestopft (Musik, Grafik, Animationen,...), daß sie zu groß geworden sind, um noch auf Ihre fast vollen Disketten zu passen. Und hier setzt QUISELMENU an! QUISELMENU enthält keine überflüssigen, speichervergeudenden Extras, die sowieso keiner braucht. Dadurch ist es sehr, sehr kurz und kann auf nahezu jeder Diskette mit mindestens etwa 4 KB freiem Platz verwendet werden. Außerdem benötigen Sie keinen speziellen Editor, um Ihre Scripts zu er- stellen. Ein einfacher ASCII-Editor (z.B. ED) reicht aus. 2) SYSTEMANFORDERUNGEN ====================== Jeder funktionierende Amiga (Ich hoffe es), aber Kickstart 2.0 oder höher wird empfohlen. QUISELMENU wurde auf dem A1200 und A500 getestet. Sollte es auf Ihrem Rech- ner nicht laufen, so lassen Sie es mich bitte wissen. 3) DIE INSTALLATION VON QUISELMENU ================================== QUISELMENU zu installieren ist recht einfach: - Kopieren Sie das File "QUISELMENU" auf Ihre gewünschte Diskette - Erzeugen Sie ein "S"-Verzeichnis, falls keines vorhanden ist - Kopieren Sie Ihr Script (siehe unten) dort hinein - Fügen Sie QUISELMENU in die Startup-Sequence der Diskette ein Das war es auch schon! Hinweis für Kickstart 1.3-Nutzer: Sie müssen auch den CLI-Befehl "Run" mit auf die Diskette kopieren. Sonst kann QUISELMENU keine Files starten. 4) QUISELMENU STARTEN ===================== *** Achtung! Sie benutzen mein Programm auf eigenes Risiko! Ich über- *** *** nehme keine Verantwortung für den Verlust von Daten, falls QUISEL- *** *** MENU Ihren Amiga zum Abstürzen bringt! *** *** Warnung: Versuchen Sie nicht, QUISELMENU resident zu machen! Ein *** *** Absturz ist dann wohl unvermeidlich! *** QUISELMENU kann nur vom CLI aus gestartet werden. Tippen Sie einfach QUISELMENU oder, wenn Sie Ihren eigenen Titel wünschen, QUISELMENU hinter dem CLI-Prompt ein, sofern es nicht bereits automatisch durch die Startup-Sequence geschehen ist. Für den Titeltext können Sie bis zu 45 Zeichen verwenden. QUISELMENU sucht dann nach einem gültigen Scriptfile auf dem aktuellen (!) Laufwerk und lädt es wenn möglich. Danach erscheint das Menü auf dem Bild- schirm. 5) WIE DAS MENÜ BEDIENT WIRD ============================ Es gibt zwei Möglichkeiten, QUISELMENU zu bedienen: Per Tastatur: ------------- Benutzen Sie die Cursortasten, um durch die Zeilen zu scrollen. Längeres Drücken der Tasten erhöht die Geschwindigkeit. Drücken Sie oder , um den Eintrag zu bestätigen. Sie können das Menü jederzeit durch Drücken von verlassen. Per Maus: --------- Um durch die Zeilen zu scrollen, bewegen Sie den Mauszeiger einfach hoch oder runter und drücken die rechte Maustaste. Scrollrichtung und -speed hängen von der augenblicklichen Y-Position des Mauszeigers ab. Zum Beispiel scrollen die Zeilen umso schneller, je höher Sie den Mauszeiger bewegen und umgekehrt. Der Bildschirm ist dabei in 3 verschiedene "Speed-Zonen" eingeteilt. Um einen Eintrag auszuwählen, drücken Sie die linke Maustaste. 6) WIE MAN EIN SCRIPT SCHREIBT ============================== Bevor Sie QUISELMENU zum ersten Mal benutzen können, müssen Sie ein Script schreiben, in dem alle gewünschten Einträge aufgeführt sind. Dieses Script muß als reine ASCII-Datei geschrieben werden und als "SCRIPT.menu" im "S"- Verzeichnis abgespeichert werden. Hinweis an alle ED-Benutzer: Drücken Sie nach der letzten Zeile nicht . Ansonsten hängt ED noch ein an Ihr Script an, und dessen Struktur wird ungültig! 6.1) Standardeinträge --------------------- Ein Standardeintrag besteht immer aus 3 Datenzeilen: - Name des Eintrages (max. 30 Zeichen) - Kurze Beschreibung/Kommentar (max. 70 Zeichen) - Pfad und Filename (beliebige Länge) Dann folgt wieder direkt der nächste Name, Beschreibung, Filename,... Bitte beachten Sie, daß Leerzeilen (einfach nur ) auch als Daten- zeilen interpretiert werden und Sie nicht versuchen dürfen, zwei Einträge auf diese Weise zu trennen! Ein Beispiel: Das folgende Script enthält 3 verschiedene Einträge: Peg It! Ein süchtig machendes Denkspiel! DH1:Spiele/Denk/PegIt Multiview Universeller Fileviewer mit Datatypes SYS:System/Multiview Protracker Das beste Musikprogramm der Welt! DH2:musik/Protracker Nun, das sieht ein bißchen unordentlich aus. Was kann man tun, um es ein wenig aufzuräumen? 6.2) Kommentare im Script ------------------------- Um einen Kommentar zu schreiben, beginnen Sie die Zeile einfach mit einem Semikolon (;), so wie Sie es bei einer normalen Batchdatei machen würden. Für alle Funktionszeichen von QUISELMENU gilt: Sie müssen IMMER DAS ERSTE ZEICHEN einer Zeile sein. Sonst werden sie wie normale Datenzeilen behan- delt. ; Dies wäre ein Kommentar ; Das hier ist KEIN Kommentar, da die Zeile mit beginnt! Beachten Sie bitte, daß Sie keine Kommentare an bestehende Datenzeilen an- hängen können, so wie hier: Das ist ein Eintrag ;...aber das KEIN Kommentar! Das ist eine Beschreibung RAM:File Um Ihr Script etwas übersichtlicher zu machen, empfehle ich den Gebrauch von ";" zwischen zwei Einträgen, etwa so: Peg It! Ein süchtig machendes Denkspiel! DH1:Spiele/Denk/PegIt ; Multiview Universeller Fileviewer mit Datatypes SYS:System/Multiview 6.3) Hervorgehobene Textzeilen ------------------------------ Wenn Sie einen Eintrag oder eine Beschreibung hervorheben wollen, dann können Sie das mit dem ">"-Symbol erreichen: >Dieser Eintrag wird rot angezeigt Diese Beschreibung bleibt türkis df0:file1 ; Ein weißer Eintrag... >...aber ein roter Kommentar! df0:file2 Ein spezieller Tip: Wenn Sie den Filenamen eines Eintrages weglassen und stattdessen nur drücken, dann ist dieser Eintrag nicht anwählbar. Zusammen mit einem hervorgehobenen Text können Sie auf diese Weise Trenn- zeilen oder Kommentare einfügen! 6.4) Multifiles --------------- Manchmal kann es notwendig sein, mehr als ein File für einen Eintrag zu starten. Dieses können Sie mit dem "+"-Zeichen leicht erreichen. Wenn Sie also Ihre Workbench laden wollen, was die Befehle SETPATCH, LOADWB und ENDCLI voraussetzt, dann können Sie schreiben: Laden der Workbench Lädt und startet Ihre Workbench Setpatch +LoadWB +EndCLI Das vor SETPATCH ist nicht unbedingt notwendig. Es wurde nur ein- gefügt, um das Script lesbarer zu machen. Hinweis für Kickstart 1.3-Nutzer: Die Execute()-Routine von Kickstart kann leider keine Filestrings verar- beiten, die länger als 255 Zeichen (inklusive s) sind. Sollte Ihre Multifile-Liste zu lang werden, so wird QUISELMENU überhaupt kein File davon ausführen. In diesem Falle sollten Sie eine richtige Batchdatei schreiben und diese dann aus QUISELMENU mit "Execute " aufrufen. Stellen Sie dann aber auch sicher, daß der Execute-Befehl auf der Diskette vorhanden ist! 7) FEHLER UND BUGS ================== Hier ist eine kurze Beschreibung der QUISELMENU-Alerts: "SORRY, A ROM LIBRARY REFUSES TO OPEN!" --------------------------------------- Das Programm konnte eine Systemlibrary nicht öffnen. Vermutlich haben Sie keinen freien Speicher mehr. Versuchen Sie daher, andere laufende Pro- gramme zu beenden oder - falls möglich - Ihren Amiga zu reseten und ver- suchen es noch einmal. "SORRY, I COULD NOT OPEN MY OUTPUTSCREEN OR WINDOW!" ---------------------------------------------------- Das Programm konnte seinen Ausgabebildschirm nicht öffnen. Vermutlich ist nicht mehr genug Speicher frei. "SORRY, I COULD NOT FIND A SCRIPT 'S/SCRIPT.menu'" --------------------------------------------------- Stellen Sie sicher, daß auf Ihrem aktuellen Laufwerk ein Script verfügbar ist. In den meisten Fällen haben Sie wohl vergessen, auf das gewünschte Laufwerk zu wechseln bevor Sie QUISELMENU gestartet haben, und das Programm sucht auf dem total falschen Laufwerk. "SORRY, YOUR SCRIPT CONTAINS ILLEGAL STRUCTURES..." --------------------------------------------------- Die einzige "illegale Struktur", die QUISELMENU bislang kennt, ist, wenn das Scriptfile nicht mit einem endet. Rufen Sie also noch einmal Ihren Texteditor auf und stellen Sie sicher, daß die letzte Zeile Ihres Scripts mit abschließt. "SORRY, BUT YOUR SCRIPT IS TOO LONG..." --------------------------------------- Entweder hat Ihr Script eine vollkommen verrückte Struktur, oder Sie haben tatsächlich versucht, mehr als 5000 Einträge in ein Script zu schreiben. Überprüfen Sie das bitte! "MEMORY ALLOCATION FOR SCRIPT OR FILEBUFFER HAS FAILED!" -------------------------------------------------------- Es ist kein Speicher mehr frei. Stellen Sie bitte sicher, daß genügend RAM für das gesamte Scriptfile sowie einige KB für die Datentabellen zur Ver- fügung steht. "SCRIPTFILE COULD NOT BE OPENED CORRECTLY THOUGH IDENTIFICATION..." ------------------------------------------------------------------- Hm... Das ist ein interessanter Fehler. Normalerweise sollte, wenn ein File-Infoblock existiert, auch das entsprechende File selbst vorhanden sein. Und das ist hier nicht der Fall. Wenn Sie Ihr Script noch mit TYPE oder einem Texteditor anzeigen lassen können, dann teilen Sie mir das bitte mit, denn es könnte sich um einen Bug in QUISELMENU handeln! Unter normalen Umständen kann das nämlich nicht auftreten! "WARNING! YOUR SCRIPTFILE HAS AN INVALID STRUCTURE..." ------------------------------------------------------ Wenn Sie das erste Mal versuchen, ein Script schreiben, dann wird Ihnen diese Meldung bald geläufig sein. Sie bedeutet, daß die Anzahl an Daten- zeilen nicht restlos durch 3 geteilt werden kann (Sie erinnern sich? Jeder Eintrag besteht aus 3 Zeilen...). Um zu sehen, was schiefgegangen sein könnte, bietet QUISELMENU Ihnen an, das Script trotzdem zu verwenden. Wenn dann alles gut aussieht, hat Ihr Script vielleicht eine Leerzeile am Ende (nur ). Das passiert vor allem häufig bei der Benutzung des DOS-Texteditors ED. Prüfen Sie es! 8) FRAGEN, DIE SIE VIELLEICHT GERN STELLEN WÜRDEN... ==================================================== F: Wie viele Einträge kann ich in einem Script verwenden? A: Sie können bis zu 5000 Einträge schreiben. F: Ich habe mein Script lange Zeit nicht geändert. Aber manchmal meldet QUISELMENU eine illegale Struktur, obwohl alles in Ordnung ist. Warum? A: Bitte schreiben Sie mir und senden eine Kopie Ihres Scripts. Es könnte ein Fehler im Programm sein! F: Es heißt, es sei nicht möglich, einen Kommentar hinter einen Text zu schreiben. Ich habe es nun mal probiert, und es hat geklappt! A: Für Filenamen funktioniert es, da DOS das Semikolon selbst für Kommen- tare benutzt. Aber innerhalb normaler Textzeilen klappt das nur, wenn Ihr 'Kommentar' außerhalb der maximalen Länge dieser Zeile steht, da QUISELMENU die Zeile dann abschneidet. Dann dürfte der Text aber links- bündig anstatt zentriert angezeigt werden. F: Wieviel Speicher bleibt nach der Auswahl belegt? A: 1. Der Speicher für QUISELMENU selbst (etwa 3.5 KB) 2. Ein Speicherblock, der den/die Filename(n) enthält 3. Der Speicher für die "dos.library" Alle Speicherblöcke werden nach der Ausführung des letzten Files wieder freigegeben. F: Ich habe versucht, das Programm XXXXXX von QUISELMENU aus zu starten, aber es klappt nicht! Mein Amiga stürzt immer ab! A: Versuchen Sie, dieses Programm direkt vom CLI aus aufzurufen, aber als Zusatztask (schreiben Sie "RUN XXXXXX"). Funktioniert das, so erzählen Sie mir bitte mehr über das Programm. Vielleicht haben Sie ja einen neuen Fehler in meinem Menü gefunden! F: Ich möchte einen Eintrag ">>> Spezial <<<" nennen, aber QUISELMENU zeigt diesen dann immer als ">> Spezial <<<" in rot an. Was kann ich da machen? A: Setzen Sie einfach ein davor. Dann wird das ">" nicht mehr als Funktionszeichen erkannt. Das kann man auch für ";" und "+" verwenden. F: Quiselmenu zeigt Einträge immer zentriert an. Ich hätte es aber gerne links- oder rechtsbündig. Was kann ich tun? A: Füllen Sie den String mit s auf, bis er die maximal erlaubte Länge erreicht hat. Wenn Ihr Texteditor Leerzeichen am Ende einer Zeile abschneidet, dann können Sie das vermeiden, indem Sie einfach noch ein Zeichen anhängen. F: Ich habe versucht, die Multifile-Funktion zu benutzen. Aber jetzt er- halte ich immer die CLI-Meldung: "+echo: Unknown command"! A: Anscheinend haben Sie bereits vor den ersten Filenamen das "+" gesetzt. Löschen Sie es, und es müßte funktionieren. 9) WIE MAN MICH ERREICHEN KANN ============================== Sollten Sie irgendwelche Vorschläge, Hinweise, Probleme oder ähnliches haben oder mir Bugs mitteilen wollen, so können Sie mich erreichen: - per E-mail: CATBOY@litter.leine.de - per Post: Kai Andres Wilhelmstr. 25 31595 Steyerberg Wenn Sie mir einen normalen Brief schreiben: Bitte fügen Sie einen fran- kierten, an sich selbst adressierten Rückumschlag oder aber eine E-Mail- Adresse bei, unter der ich Sie erreichen kann. Andernfalls werde ich nicht antworten. Ich hoffe, daß Ihnen QUISELMENU gefällt und Sie es nützlich finden. Sie können es gerne weiterkopieren, das Programm ist Freeware. Und falls Sie es in Ihre eigene PD-Serie aufnehmen möchten - senden Sie mir bitte eine Demodiskette! Bis dann Catboy