============================================================================== P O W E R P L A Y E R -Bedienungsanleitung- ============================================================================== Copyright --------- PowerPlayer ist FreeWare, das bedeutet daß er frei kopierbar ist, solange das Paket unverändert und komplett mit den Dateien PowerPlayer, PowerPlayer.DOC, PowerPlayer.DOK, PowerPlayer Music Cruncher, ReqToolsLib, PowerPackerLib, LhLib und dem Installations-Script weitergegeben wird. Wenn Sie etwas ändern möchten -» schreiben Sie mir zuerst ! Ich kann nicht garantieren, daß alle Dateien in diesem Paket frei kopierbar und/oder Public Domain sind. Der Autor dieser Software kann für den Inhalt dieses Paketes und jegliche Schäden, die dadurch verursacht werden nicht haftbar gemacht werden. © 1991/92 STEPHAN FUHRMANN, WEST-GERMANY Diese frei kopierbaren Funktionsbibliotheken gehören zum PowerPlayer-Paket: -ReqTools.Library © Nico François -PowerPacker.Library © Nico François -Lh.Library © Holger P.Krekel und Olaf 'Olsen' Barthel Version 3.4 16.9.1992 ============================================================================== Grüße ----- Grüße gehen an -Mutti -Delta/TCC für die starke REAL DINKELATOR DOPPELBOCK INTRO ! -Flynn/TRSI für seinen bärigen NoisePlayer -Holger P.Krekel & Olaf 'Olsen' Barthel für ihre LH.Library -Bryan Ford (Mr.MultiPlayer) -Nico François für seine tolle Reqtools.Library & PowerPacker.Library und seine Tips zur Reqtools.Library -Teijo Kinnunen für seine Routinen & 68030-Tests ============================================================================== Geschichte ---------- V 1.0: Version mit BUGS & ohne nette Features :-( V 1.1: Alle BUGS entfernt, niedliches CLI-Interface & CLI-Infoseite, PMC V 1.2: (endlich) Oktalyzer 4-Voice Replay hinzugefügt V 1.3: DeltaMusic hinzugefügt, PowerPlayer erkennt jetzt alle SoundMon-Versionen, ProTracker-Replay optimiert V 1.5: Man kann nun auch für den Datei-Requester ein Verzeichnis festlegen (sehr nützlich !), das NoisePacked 1.3D-Replay, das aus irgendwelchen Gründen in allen anderen Versionen mal ausgeschaltet war, ist nun endlich erhältlich ! V 1.6: Die inzwischen gealterte Req.Library wurde durch die ReqTools.Library ersetzt, die unter anderem schöne 3D-Requester erlaubt. V 1.7: Anstelle eines VBlank-Interrupts, der auf Amigas mit NTSC oder einem 10 Hz-Monitor Songs mit unnatürlichen Geschwindigkeiten fabriziert, wurde ein CIA-Timerinterrupt benutzt. V 1.8: Die "Restart"-Funktion wurde hinzugefügt V 1.9: Der Fehlerausgabe wurde verbessert, die ECLOCK-Frequenz wird jetzt, sofern OS 2.0 benutzt wird, vom System geholt, Abspielroutinen wieder optimiert, fand einen Fehler, der in ALLEN Tracker-Abspielroutinen existiert - er schreibt in unbelegten Speicher. Ich weiß nicht, ob dieser schwerwiegende Fehler in allen anderen Module-Abspielprogrammen existiert. Ich empfehle, nur noch PowerPlayer zu benutzen ! V 2.0: Eine Routine für TFMX-Module mit eingebauter Abspielroutine wurde hinzugefügt V 2.1: Eine Routine für MED-Module wurde hinzugefügt V 2.2: Eine echte grafische Benutzeroberfläche mit einem CD-Player-ähnlichen Knopfsystem. Jetzt wird ein großer Lh-Buffer für schnelleres Entpacken verwendet. V 2.3: Wenn man nun die rechte Maustaste drückt verkleinert/vergrößert sich das Fenster, beim Programmstart wird das Fenster unter dem Mauszeiger zentriert, neue Tastaturkürzel wurden hinzugefügt, der Code wurde optimiert V 2.4: Neue Funktionen: Erster Song, letzter Song, Zufalls-Song ! V 2.5: PowerPlayer zeigt nun einen Busy-Mauszeiger, wenn er lädt und entpackt. Gleichzeitig wird dann der IDCMP des Fensters gesperrt. V 2.6: PowerPlayer sieht nun auch auf einem 2-Farb-Schirm gut aus V 2.7: Ein wenig mehr WB 2.0-Feeling durch 3D-Rahmen V 2.8: Neue Protracker-Routine (V2.1A) eingebunden, wenn man jetzt während der Darstellung eines Requesters Return drückt wird die negative Antwort aktiviert (für alle Pessimisten ;-)), der PowerPlayer-Task läuft mit der Priorität 1, alle Replays nochmals optimiert V 2.9: Sonix Arranger-Routine wurde hinzugefügt, neue Kommandozeilen= analysier-Routinen + Kommandozeilenflags, mehrere Modulnamen in der Kommandozeile können angegeben werden V 3.0: Workbench-ToolTypes für alle Flaggen werden unterstützt (bitte im Abschnitt "Aufruf vom PowerPlayer" nachlesen), ARexx wird mit vielen Befehlen unterstützt (bitte im Abschnitt "ARexx-Unterstützung" nachlesen), neues "NoReq"-Flag für Workbench und CLI (nützlich für ARexx) V 3.1: Optional kann nun der Dateirequester der ASL.Library benutzt werden V 3.2: beim SoundMod-Replay funktioniert nun die Reset-Funktion 100%, Zeit-Probleme bei schnelleren Prozessoren als 68000 beseitigt, es ist nun 99.9% sicher NoisePacker-Modules abzuspielen, neues OctaMED pro-Replay V 3.3: Neue kraftvolle Komprimierung, OctaMED 4.0-Replay, SoundMon- Routine spielt nun Samples korrekt, neuer BP-Soundmon Typ V 3.4: Hotkeys, Betrieb auch ohne Fenster möglich, AmigaDOS BREAK-bar ============================================================================== Diese Version des PowerPlayers unterstützt: FutureComposer 1.4 NoiseTracker (Protracker V2.1a Replay) JamCracker SoundMon Startrekker 4 Voice Fred SidMon NoiseTracker 1.3D packed modules NoiseTracker 1.3D packed modules mit Abspielroutine Mark II Sound System NoisePacker 2.03 Oktalyzer 4 Voice DeltaMusic TFMX mit Abspielroutine OctaMED-Module (MMD0 & MMD1) Sonix Arranger mit Abspielroutine Morten Grouleff's Musicprogram ============================================================================== Installation ------------ Der PowerPlayer benötigt die PowerPacker.Library und die ReqTools.Library in ihrem Libs:-Verzeichnis. Der beigefügte Installations-Script in diesem Paket wird alles für sie installieren. Wahlweise wird die Lh.Library benutzt. Wenn sie genug Erfahrung haben können Sie mit dem PMC, welcher die Lh.Library benutzt, ihre Module packen. ============================================================================== Einleitung ---------- Hallo und Willkommen in der Welt des PowerPlayers! Dieses fantastische Tool wurde 1991/1992 von Stephan Fuhrmann geschrieben und benutzt die hervorragenden Fähigkeiten der -ReqTools.Library von Nico François für die Datei- und Text-Requester -PowerPacker.Library von Nico François um powergepackte Dateien zu entpacken -Lh.Library von Holger P.Krekel und Olaf 'Olsen' Barthel für die beste Kompression von Modules, ausführbarer einfacher Cruncher im Paket enthalten. Der PowerPlayer ist ein Tool, um Musik mit dem guten alten AMIGA STEREO DIGITAL SOUND abzuspielen, die mit einem der unterstützten Musik-Programme oder kompatiblen gemacht wurde. Es gab bereits viele dieser Programme, doch PowerPlayer ist etwas anderes: -netter schneller trickreicher optimierter 100%-iger Assembler-Code, größtenteils PC-Relativ -kleines hübsches (?) Play-Window -viieeelle optimierte Abspielroutinen -PowerPacker-Library, um immer die neueste und schnellste Entpack-Routine zu benutzen -Lh-Library für die beste Kompression, die je ein Module erfahren hat (ausprobieren!) -ARexx-Port für die Fernbedienung des PowerPlayers -kann in vielen Arten von der Workbench und vom CLI aufgerufen werden -belegt seine Kanäle mit dem Audio.Device Aber fangen wir am Anfang an: Aufruf vom PowerPlayer ---------------------- WorkBench --------- DoppelKlick ----------- Klicken Sie das Icon vom PowerPlayer doppelt an, wählen Sie die Datei im Datei-Requester, drücken Sie 'OK' und genießen Sie ! DefaultTool ----------- Sie haben ein Modul mit Icon. Wählen Sie das Icon an und aktivieren Sie die Info-Funktion der Workbench. Nun wählen Sie das DefaultTool an. Geben sie den Pfad des PowerPlayers ein. Drücken Sie das 'SAVE'-Gadget. Immer wenn Sie jetzt das Projekt-Icon doppelklicken, wird der PowerPlayer geladen und den Song abspielen. Mehrfachauswahl --------------- Bewegen Sie den Mauszeiger über das PowerPlayer-Icon und drücken Sie den linken Mausknopf einmal. Drücken Sie jetzt SHIFT und lassen Sie es gedrückt. Wählen Sie die Songs, die Sie hören wollen, mit der Maus aus. Doppelklicken Sie den letzten Song und lassen Sie SHIFT los. Ihre Songs werden geladen ! ToolTypes --------- Bewegen Sie den Mauszeiger über das PowerPlayer- Icon, aktivieren Sie es und wählen Sie "Info" aus dem Workbench-Menü. Sie haben die Möglichkeit, folgende ToolTypes zu ändern/hinzuzufügen: QUALIFIER=(Qualifier für Hotkeys) Legt den Qualifier für die Hotkeys fest DIRECTORY=(Verzeichnis für den Dateirequester) Legt das Verzeichnis fest, das zuerst im Dateirequester angezeigt wird Beispiel: DIRECTORY=DF0:Modules PATTERN=(Muster, das Sie im Dateirequester wünschen) Left das Muster fest, mit dem alle Dateien im Dateirequester verglichen werden Beispiel: PATTERN=MOD.#? LED=[0|1|M] Legt den Modus der Filter-LED fest: 0=Filter-led aus 1=Filter-led an M=überläßt dem Modul die Kontrolle (Voreinstellung) Beispiel: LED=0 NOREQ=[TRUE|FALSE] Weist PowerPlayer an, keinen Dateirequester zu öffnen, wenn er ohne irgendwelche angegebenen Dateien gestartet wurde. Nützlich für ARexx, da man Nico's Dateirequester nicht mit ARexx kontrollieren kann ;-). NOWIN=[TRUE|FALSE] Weist PowerPlayer an, kein Fenster zu öffnen. ASL=[TRUE|FALSE] Weist PowerPlayer an, den Dateirequester der ASL.Library zu benutzen. Hierzu wird (noch) OS 2.0 benötigt. Wenn die Library oder der Requester nicht geöffnet werden konnte wird einfach der ReqTools-Requester benutzt. CLI/SHELL --------- DateiRequester -------------- Jeder weiß, wie man Dateirequester bedient, also werde ich den sehr guten Dateirequester der ReqTools.Library nicht erklären. Geben Sie den Namen des PowerPlayers in dem CLI/SHELL, das Sie geöffnet haben, mit dem Parameter '-r' ein. Es erscheint ein DateiRequester und Sie können ihre Songs aussuchen. Versionen +2.2 benötigen dieses Flag nicht mehr, der PowerPlayer öffnet den Dateirequester, wenn keine Dateien beim Start angegeben werden. Beispiel: PowerPlayer -r Dateiname --------- Wenn Sie keine Datei mit einem Requester auswählen wollen (z.B. in Scripts), können sie ebenfalls den/die Modulnamen mit seinem/ihren Pfad(en) an die Kommandozeile hängen. Beispiel: PowerPlayer df0:MOD.PowerTheme ram:SID.Mega Information ----------- Wenn Sie den Informations-Bildschirm sehen wollen, geben Sie folgendes ein: PowerPlayer ? Flags ----- Es gibt mehrere Flags, die die Zeit, die Sie mit dem PowerPlayer verbringen, angenehmer machen: -r........Dateirequester benutzen (veraltet) -nr.......keinen Dateirequester beim Start öffnen, wenn keine Dateien angegeben werden -nw.......kein Fenster beim Start öffnen -dDIR.....legt das Verzeichnis des Dateirequesters fest. z.B. "-dDF0:modules". -dPAT.....legt das Vergleichsmuster des Datei= requesters fest. z.B. "-pMOD#?". -qQUAL....legt den Qualifier für die Hotkeys fest. -l0/1/M...legt den Modus der Filter-Led fest. 0=Filter aus 1=Filter an M=Modul verfügt über den Filter -ASL......läßt PowerPlayer den Dateirequester der ASL.Library benutzen. Hierzu wird (noch) OS 2.0 benötigt. Wenn die Library oder der Requester nicht geöffnet werden konnte wird einfach der Requester der Reqtools.Library benutzt. Play-Requester -------------- Der Play-Requester enthält Informationen zum Modul und einige Gadgets. Wenn Sie PowerPlayer ohne ein Fenster starten (NOWIN) und einen Qualifier festgelegt haben, können Sie das Fenster öffnen, indem Sie den Qualifier und 'w' drücken. Fragezeichen....zeigt die üblichen Informationen über das Copyright und die Features. Taste: "1" Eject...........verwirft die aktuelle Songliste & holt sich über einen Filerequester eine neue. Taste: "2" oder "e" FirstSong.......lädt und spielt den ersten Song aus der Liste PrevSong........lädt und spielt den vorangehenden Song aus der Liste. Taste: "3", "[", "(" oder "{" ! Play............spielt den Song ab. Entfernt automatisch Pause, wenn man wieder auf PLAY hämmert startet der Song neu. Taste: "4" oder "p" ! FastForward.....spielt den Song mit doppelter Geschwindigkeit. Ergibt einen schönen FF-Effekt ! Nochmal raufhämmern schaltet wieder auf normale Geschwindigkeit. Taste: "5" oder "f" NextSong........lädt & spielt den nächsten Song aus der Liste. Taste: "6","", "]",")" oder "}" ! LastSong........lädt & spielt den letzten Song aus der Liste. Stop............stoppt den Song. Deaktiviert automatisch Pause, FF und Play ! Taste: "7" oder "s" Pause...........stoppt den Song, bis nochmal Pause betätigt wird oder Play gedrückt wird. Taste: "8" oder "" Reset...........startet den Song von neuem. Taste: "9" oder "r" RND.............lädt und spielt einen zufällig gewählten Song ab. Taste: "~" oder "/" Fast jedes Gadget hat eine dazugehörige Taste (Tasten 1-9), ESC oder CTRL-C beenden den PowerPlayer. CTRL-F bringt das Fenster auf volle Größe vor alle anderen Fenster. Wenn man die rechte Maustaste drückt, wechselt man in den Iconify-Modus. Das Fenster schrumpft auf eine minimale Höhe von 10 Pixeln. Die Gadgets verschwinden zwar, jedoch kann man den PowerPlayer weiterhin mit den Tastatur-Kürzeln kontrollieren. Um das Fenster wieder auf seine normale Größe zu bringen muß man lediglich die rechte Maustaste erneut drücken. Die Anzeige des Fensters beinhaltet -den Namen des Modules (oben im Fenster) -Typ & Länge des Modules in Bytes (Mitte des Fensters) -Gadgets und Positions-Anzeiger, welcher die derzeitige Position in der Dateiliste anzeigt. Mein GUI (Grafische Benutzerschnittstelle) arbeitet mit einer Recolor-Routine, die verrückte Paletten recht gewitzt behandelt. Sie sucht nach der hellsten und dunkelsten Farbe für die Schatten und sucht nach der Farbe mit dem größten Kontrast zum Hintergrund für die Textausgabe. Hotkeys ------- Hotkeys bemächtigen Sie, PowerPlayers Standardsatz an Tasten zu benutzen - egal, was das aktive Fenster oder der aktuelle Bildschirm ist. Das bedeutet, daß Sie PowerPlayer von ihrer Textverarbeitung kontrollieren können, ohne den Bildschirm bzw. das Fenster ihrer Textverarbeitung zu verlassen. Dieses Feature wird mit dem QUALIFIER ToolType oder mit der -q Flagge abgeschaltet. Gültige Qualifiers sind: LSHIFT/LEFT_SHIFT RSHIFT/RIGHT_SHIFT CAPSLOCK CONTROL LALT/LEFT_ALT RALT/RIGHT_ALT LCOMMAND/LEFT_COMMAND/LAMIGA/LEFT_AMIGA RCOMMAND/RIGHT_COMMAND/RAMIGA/RIGHT_AMIGA Um diese Qualifiers zu mixen, müssen sie die Qualifiers mit einem "!" oder einem "|" trennen: CONTROL!LSHIFT!LALT Dies ist der empfohlene Standard-Qualifier, der in PowerPlayers ToolType voreingestellt ist. ============================================================================== ARexx-Unterstützung ------------------- PowerPlayer bietet einen ARexx-Port mit dem Namen "PowerPlayer.REXX" an. Der ARexx-Port unterstützt folgende Befehle: PlEject arbeitet wie der "Eject"-Knopf PlFirst arbeitet wie der "First"-Knopf PlPrevious arbeitet wie der "Previous"-Knopf PlPlay arbeitet wie der "Play"-Knopf PlFF arbeitet wie der "FF"-Knopf PlNext arbeitet wie der "Next"-Knopf PlLast arbeitet wie der "Last"-Knopf PlStop arbeitet wie der "Stop"-Knopf PlPause arbeitet wie der "Pause"-Knopf PlReset arbeitet wie der "Reset"-Knopf PlRnd arbeitet wie der "Rnd"-Knopf PlQuit beendet PowerPlayer. Versuchen Sie nicht, den ARexx-Port nach diesem Kommando anzusprechen PlLoad "" lädt und spielt es ab. ============================================================================== Der PowerPlayer Music Cruncher ------------------------------ PMC wurde entwickelt, um nur Module zu packen und ich finde, daß er seinen Job recht gut macht. Er schlägt die Compressions-Rate JEDES bekannten Crunchers/Archivierers auf dem Amiga und packt & entpackt sehr schnell. Ich habe den neuen "SFCD" (Stephan Fuhrmanns Compackte Dichte) Modus, der auf dem alten "SFHD" (Stephan Fuhrmanns Hohe Dichte) basiert entwickelt. Um "SFCD"/"SFHD"-Module zu packen/entpacken benötigen Sie Lh.Library v1.8+. MOD.TEST |UNGEPACKT |SFCD |SFHD |POWERPACKER ----------------+---------------+-------+-------+----------- GRÖßE(bytes) |320044 |189734 |210540 |237832 ERFOLG |00% |40% |34% |25% PACKZEIT |0:00 |2:37 |2:47 |2:58 ENTPACKZEIT |0:00 |0:17 |0:17 |0:07 PMC zu benutzen ist ziemlich simpel: PMC [QUELLNAME] [ZIELNAME] PMC lädt [SOURCENAME], packt es (oder entpackt es, wenn es schon gepackt ist) und speichert es als [ZIELNAME]. PMC schreibt nur "SFCD"-Module, kann jedoch "SFCD" UND "SFHD" lesen und entpacken. Der PowerPlayer lädt und entpackt "SFCD" & "SFHD" Module automatisch, wenn die Lh.Library in ihrem Libs:-Verzeichnis ist. Ich habe einige Typen gesehen, die mit dem PMC gepackte Module in Mailboxen raufgeladen haben. BITTE unbedingt '.PMC' als Suffix benutzen und schreiben, daß man den PowerPlayer zum abspielen braucht. UND unbedingt die Mailbox prüfen, ob der PowerPlayer überhaupt vorhanden ist, sonst wird so mancher ziemlich sauer sein, wenn er erst die Modules runterlädt und dann merkt, daß PowerPlayer garnicht da ist und er die Modules nicht gebrauchen kann ! Ein Beispiel-Mailbox-Eintrag könnte so aussehen: SONG.PMC Sehr guter Song, nur mit PowerPlayer zu benutzen Es ist unbedingt zu empfehlen, die Modules direkt im PMC-Format ohne anderen 'Müll' in einem Archiv raufzuladen, zumal einerseits _NICHT_ per Hand entpackt werden muß, die entpackte Datei keinen Diskettenplatz verschwendet und letztendlich durch das eigens für den PowerPlayer entwickelte PMC-Format ein entpacken ohne den PowerPlayer nicht möglich ist, so daß man sich so oder so des PowerPlayers bedienen muß ß-} ! So kann man seine Zustimmung zum PowerPlayer ausdrücken! ============================================================================== Technische Informationen ------------------------ PowerPlayer generiert nicht seinen eigenen Prozess. Es scheint zwar modern zu sein, alles gleich im Hintergrund ablaufen zu lassen, ich jedoch wollte dem Benutzer die Möglichkeit geben, den Computer solange anzuhalten, wie ein Musikstück abgespielt wird (z.B. in der Startup-Sequence). Meiner Meinung nach ist das die beste Art, das zu realisieren, wenn Sie jedoch PowerPlayer im Hintergrund laufen lassen wollen, müssen Sie ihn selber mit "RunBack" starten. ============================================================================== Da es sooo viele Musik-Programme auf dem Amiga gibt, ist es für mich unmöglich, alle existierenden Abspielroutinen einzubinden. Um ihnen und mir die Möglichkeit zu geben, den PowerPlayer zum besten Modulabspieler, der je geschrieben wurde, zu erweitern, werde ich jede Abspiel-Routine, die mir zugesendet wird, einbauen, wenn folgendes erfüllt ist: -Quellcode der Musik-Routine in ASSEMBLER, möglichst PC-Relativ. Der Quellcode muß auf einer 3.5"-Disk sein. -Beschreibung, wie man eine Erkennung von Modulen dieser Art durchführt. Wenn Sie keine Ahnung haben senden Sie 3 oder mehr Module dieser Art mit und ich finde es selber heraus. -3 oder mehrere Songs, die mit der Routine abgespielt werden können, sollten ebenfalls dabei sein. Ich muß die Routinen testen und ein Musik-Programm, für das es weniger als 3 Songs gibt, ist sicherlich nicht gut. -Wenn die Diskette auch nur einen Fehler hat, gehe ich davon aus, daß Sie sie sowieso nicht mehr haben wollen und werfe sie weg. Also benutzen Sie Disketten hoher Qualität und formatieren Sie sie vor der Benutzung ! Wenn Sie einige Features zum PowerPlayer dazu haben möchten, tun Sie folgendes: -Schreiben Sie einen detailierten Brief mit allen neuen Features an die Sie denken. -Wenn Sie das Update mit einigen/allen ihrer Features haben wollen, fügen Sie eine Disk für den PowerPlayer und 5 DM für all die Arbeit hinzu ! Wenn Sie ein Update haben wollen, tun Sie folgendes: -fügen Sie eine Diskette für den PowerPlayer und 5 DM für Unkosten und Arbeit (Brief, Briefmarken...)! -Ich werde ihnen dann die aktuelle Version des PowerPlayers zukommen lassen Spenden sind immer willkommen und können unter Umständen die Antwort beschleunigen!! Denken Sie an all die Arbeit, die ich hatte, um PowerPlayer zu dem zu machen, was er heute ist. Meine Adresse: Stephan Fuhrmann Erikstr. 30 W-2380 Schleswig Germany Schreiben sie immer, welche PowerPlayer-Version Sie benutzen und woher Sie sie haben! ============================================================================== (EOF)