home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 4: Demo 1
/
almathera_demo1.bin
/
utils
/
powerplayer
/
powerplayer.dok
< prev
next >
Wrap
Text File
|
1995-03-17
|
17KB
|
393 lines
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.
Die Lieder 'Factory' & 'SL-Nights2' wurden 1991 von Stephan Fuhrmann mit
Teijo Kinnunen's wundervollem MED geschrieben ! Sie sind ebenfalls FreeWare,
aber müssen nicht unbedingt mit dem PowerPlayer vertrieben 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 2.8 25.6.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
-Romeo Knight/RSI dafür, daß er der beste Musiker auf der Welt ist
-Holger P.Krekel & Olaf 'Olsen' Barthel für ihre LH.Library
-Nico François für seine tolle Reqtools.Library & PowerPacker.Library und
seinen Tips über die Reqtools.Library
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
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
MED-Module
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.
Anleitung
---------
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.
Einleitung
----------
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 100%-iger Assembler-Code, größtenteils
PC-Relativ
-kleines niedliches Play-Window
-viieeelle 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!)
-kann in vielen Arten von der Workbench und vom CLI aufgerufen werden
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 !
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 der CLI/SHELL, das Sie geöffnet
haben mit dem Parameter '-r' ein. Es erscheint ein
DateiRequester und Sie können ihre Songs aussuchen.
Beispiel: PowerPlayer -r
Dateiname
---------
Wenn Sie keine Datei mit einem Requester auswählen
wollen (z.B. in Scripts), können sie ebenfalls
den Modulnamen mit seinem Pfad an die Kommandozeile
hängen.
Beispiel: PowerPlayer df0:modules/MOD.PowerTheme
Verzeichnis
-----------
Es gibt seit der Version 1.5 die Möglichkeit, den
PowerPlayer vom CLI mit einem Filerequester zu
starten, der dann schon in einem vom Benutzer
festgelegten Verzeichnis ist. Es wird einfach das
Verzeichnis an die Kommandozeile gehängt.
Beispiel: PowerPlayer ST-00:modules
Information
-----------
Wenn Sie den Informations-Bildschirm sehen wollen,
geben Sie folgendes ein:
PowerPlayer ?
Play-Requester
--------------
Der Play-Requester enthält Informationen zum Modul und einige Gadgets.
Alle Versionen +2.1 haben ein neues Benutzerinterface. Es gibt ein
Haupt-Fenster, das dort bleibt wo es ist solange der PowerPlayer läuft:
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","<RETURN>", "]",")" 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 "<LEERTASTE>"
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.
Der PowerPlayer Music Cruncher
------------------------------
Es gibt mächtigere Datenpacker als den PowerPacker, doch LhArc hat ein
komplexes Datei-Format und der IMPLODER hat keine erklärte Funktion in
seiner explode.library, um Dateien des File-Imploders zu entpacken, also
war ich sehr froh als ich die Lh.Library erhielt und endlich meinen eigenen
Packer/Entpacker zu meinem PowerPlayer hinzufügen konnte. Die Benutzung
des PMC ist sehr einfach. Sie müssen einfach ein CLI/SHELL öffnen und PMC,
gefolgt vom Namen der zu packenden Datei und der Zieldatei, eingeben.
Beispiel:
PMC df0:modules/MOD.PowerTheme df0:modules/MOD.PowerTheme.LH
PMC gibt dann irgendetwas wie
Crunching df0:modules/MOD.PowerTheme, Please stand by !
aus, und nach einer unwichtig kleinen Zeit (99 Sekunden) wird er das Ergebnis
anzeigen:
Result
------
Uncrunched: 214418
Crunched: 158052
Percentage: 73
PowerPacker packte die selbe Datei in 109 Sekunden, packte Sie jedoch nur
zu 168760 bytes (78%). Der einzige Vorteil des PowerPackers ist, daß er in
10 Sekunden entpackt (Lh: 14 Sekunden). Ich möchte nicht, daß Nico
verhungert :-), aber ich meine, daß man, wenn man den PowerPacker nicht
schon hat, PMC benutzen sollte. Oder man packt nicht, wenn man eine große
schnelle Festplatte mit hunderten freier Megabytes hat (hab' ICH nicht :-(
!).
Es kann passieren, daß die Prozent-Anzeige falsch ist. Das passiert, wenn
die gepackte Datei zu groß ist. Der Grund dafür ist die 16-Bit-Quelle des
CPU-Divu-Befehls. Natürlich ist die Datei davon nicht betroffen.
PMC generiert Dateien des SFHD-Formates (Stephan Fuhrmanns Hohe Dichte :-) ).
Man kann diese Dateien an der Kennung 'SFHD' in den ersten 4 Bytes erkennen.
Das 2.Langwort ist die ungepackte Länge, das 3.Langwort ist die
gepackte Länge.
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
------------------------
Ein seltsames Feature der SHELL ist, daß das ALIAS-Kommando an die
Kommandozeilenparameter ein Leerzeichen anhängt. PowerPlayer löscht darum
sämtliche Leerzeichen vor dem Zeilenende.
PowerPlayer generiert nicht einen 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.
PowerPlayer benutzt das AUDIO.DEVICE, um Audio-Kanäle zu belegen. Ich
glaube, daß PowerPlayer der einzige Modulabspieler ist, der das tut. Der
große Vorteil dieser Methode ist, daß PowerPlayer NICHT mit anderen
Programmen, die die Audio-Kanäle belegen, kollidiert. Wenn Sie jemals das
Chaos, das zwei gleichzeitig laufende Modulabspieler fabrizieren, gehört
haben, werden Sie dieses Feature mögen.
ACHTUNG! Benutzen Sie die NoisePacker-Routine V2.03 mit Vorsicht ! Mein
Amiga stürzt jedesmal nach einer Weile ab, wenn ich NoisePacker-Module
spiele. Die Programmierer dieser Abspiel-Routine haben etwas GRAUSAMES
mit dem CIA gemacht, daß niemals im Multitasking hätte geschehen sollen !
Wenn Sie einen NoisePacker-Abspieler ohne diese intensive CIA-Nutung
haben, geben Sie ihn mir ! Bearbeiten Sie nicht wichtige Daten während oder
nachdem Sie so ein Modul abgespielt haben !!
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.
Zur Zeit kann ich nur Abspielroutinen benutzen, die vom Verticalblank-
Interrupt aufgerufen werden. 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.
- Fügen Sie einen an sich adressierten Umschlag bei, mit 5 DM oder mehr
- 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 Diskette und einen an sich selbst adressierten Umschlag
hinzu
- Fügen Sie 5 DM für all die Arbeit hinzu !
Wenn Sie ein Update haben wollen, tun Sie folgendes:
- legen Sie eine Diskette und einen an Sie adressierten Umschlag bei
- 5 DM für Unkosten und Arbeit !
- Ich werde ihnen dann die aktuelle Version des PowerPlayers zukommen lassen
KEINE PANIK, wenn ich ihren Brief nicht gleich beantworte ! Ich habe nicht
genug Zeit, den halben Tag mit meinem Computer zu verbringen.
Meine Adresse: Stephan Fuhrmann
Erikstr. 30
W-2380 Schleswig
Germany