home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 4: Demo 1 / almathera_demo1.bin / utils / powerplayer / powerplayer.dok < prev    next >
Text File  |  1995-03-17  |  17KB  |  393 lines

  1.  
  2.             P O W E R P L A Y E R
  3.  
  4.             -Bedienungsanleitung-
  5.  
  6. Copyright
  7. ---------
  8. PowerPlayer ist FreeWare, das bedeutet daß er frei kopierbar ist, solange
  9. das Paket unverändert und komplett mit den Dateien PowerPlayer,
  10. PowerPlayer.DOC, PowerPlayer.DOK, PowerPlayer Music Cruncher, ReqToolsLib,
  11. PowerPackerLib, LhLib und dem Installations-Script weitergegeben wird.
  12. Wenn Sie etwas ändern möchten -» schreiben Sie mir zuerst !  Ich kann nicht
  13. garantieren, daß alle Dateien in diesem Paket frei kopierbar und/oder
  14. Public Domain sind.
  15.  
  16. Die Lieder 'Factory' & 'SL-Nights2' wurden 1991 von Stephan Fuhrmann mit
  17. Teijo Kinnunen's wundervollem MED geschrieben ! Sie sind ebenfalls FreeWare,
  18. aber müssen nicht unbedingt mit dem PowerPlayer vertrieben werden.
  19.  
  20.         © 1991/92 STEPHAN FUHRMANN, WEST-GERMANY
  21.  
  22. Diese frei kopierbaren Funktionsbibliotheken gehören zum PowerPlayer-Paket:
  23.  
  24. -ReqTools.Library © Nico François
  25. -PowerPacker.Library © Nico François
  26. -Lh.Library © Holger P.Krekel und Olaf 'Olsen' Barthel
  27.  
  28. Version 2.8 25.6.1992
  29.  
  30. Grüße
  31. -----
  32. Grüße gehen an
  33. -Mutti
  34. -Delta/TCC für die starke REAL DINKELATOR DOPPELBOCK INTRO !
  35. -Flynn/TRSI für seinen bärigen NoisePlayer
  36. -Romeo Knight/RSI dafür, daß er der beste Musiker auf der Welt ist
  37. -Holger P.Krekel & Olaf 'Olsen' Barthel für ihre LH.Library
  38. -Nico François für seine tolle Reqtools.Library & PowerPacker.Library und
  39.  seinen Tips über die Reqtools.Library
  40.  
  41. Geschichte
  42. ----------
  43. V 1.0:    Version mit BUGS & ohne nette Features :-(
  44. V 1.1:    Alle BUGS entfernt, niedliches CLI-Interface & CLI-Infoseite, PMC
  45. V 1.2:    (endlich) Oktalyzer 4-Voice Replay hinzugefügt
  46. V 1.3:    DeltaMusic hinzugefügt, PowerPlayer erkennt jetzt
  47.     alle SoundMon-Versionen, ProTracker-Replay optimiert
  48. V 1.5:    Man kann nun auch für den Datei-Requester ein Verzeichnis festlegen
  49.     (sehr nützlich !), das NoisePacked 1.3D-Replay, das aus irgendwelchen
  50.     Gründen in allen anderen Versionen mal ausgeschaltet war, ist nun
  51.     endlich erhältlich !
  52. V 1.6:    Die inzwischen gealterte Req.Library wurde durch die ReqTools.Library
  53.     ersetzt, die unter anderem schöne 3D-Requester erlaubt.
  54. V 1.7:    Anstelle eines VBlank-Interrupts, der auf Amigas mit NTSC oder
  55.     einem 10 Hz-Monitor Songs mit unnatürlichen Geschwindigkeiten
  56.     fabriziert, wurde ein CIA-Timerinterrupt benutzt.
  57. V 1.8:    Die "Restart"-Funktion wurde hinzugefügt
  58. V 1.9:    Der Fehlerausgabe wurde verbessert, die ECLOCK-Frequenz wird jetzt,
  59.     sofern OS 2.0 benutzt wird, vom System geholt, Abspielroutinen wieder
  60.     optimiert, fand einen Fehler, der in ALLEN Tracker-Abspielroutinen
  61.     existiert - er schreibt in unbelegten Speicher. Ich weiß nicht, ob
  62.     dieser schwerwiegende Fehler in allen anderen Module-Abspielprogrammen
  63.     existiert. Ich empfehle, nur noch PowerPlayer zu benutzen !
  64. V 2.0:  Eine Routine für TFMX-Module mit eingebauter Abspielroutine
  65.     wurde hinzugefügt
  66. V 2.1:    Eine Routine für MED-Module wurde hinzugefügt
  67. V 2.2:  Eine echte grafische Benutzeroberfläche mit einem
  68.     CD-Player-ähnlichen Knopfsystem. Jetzt wird ein großer Lh-Buffer
  69.     für schnelleres Entpacken verwendet.
  70. V 2.3:  Wenn man nun die rechte Maustaste drückt verkleinert/vergrößert
  71.     sich das Fenster, beim Programmstart wird das Fenster unter dem
  72.     Mauszeiger zentriert, neue Tastaturkürzel wurden hinzugefügt,
  73.     der Code wurde optimiert
  74. V 2.4:    Neue Funktionen: Erster Song, letzter Song, Zufalls-Song !
  75. V 2.5:    PowerPlayer zeigt nun einen Busy-Mauszeiger, wenn er lädt und
  76.     entpackt. Gleichzeitig wird dann der IDCMP des Fensters gesperrt.
  77. V 2.6:    PowerPlayer sieht nun auch auf einem 2-Farb-Schirm gut aus
  78. V 2.7:  Ein wenig mehr WB 2.0-Feeling durch 3D-Rahmen
  79. V 2.8:    Neue Protracker-Routine (V2.1A) eingebunden, wenn man jetzt
  80.         während der Darstellung eines Requesters Return drückt wird
  81.         die negative Antwort aktiviert (für alle Pessimisten ;-)),
  82.     der PowerPlayer-Task läuft mit der Priorität 1, alle
  83.     Replays nochmals optimiert
  84.  
  85. Diese Version des PowerPlayers unterstützt:
  86.         FutureComposer 1.4
  87.         NoiseTracker (Protracker V2.1a Replay)
  88.         JamCracker
  89.         SoundMon
  90.         Startrekker 4 Voice
  91.         Fred
  92.         SidMon
  93.         NoiseTracker 1.3D packed modules
  94.         NoiseTracker 1.3D packed modules mit Abspielroutine
  95.         Mark II Sound System
  96.         NoisePacker 2.03
  97.         Oktalyzer 4 Voice
  98.         DeltaMusic
  99.         TFMX mit Abspielroutine
  100.                 MED-Module
  101. Installation
  102. ------------
  103. Der PowerPlayer benötigt die PowerPacker.Library und die ReqTools.Library
  104. in ihrem Libs:-Verzeichnis.  Der beigefügte Installations-Script in diesem
  105. Paket wird alles für sie installieren.  Wahlweise wird die Lh.Library
  106. benutzt.  Wenn sie genug Erfahrung haben können Sie mit dem PMC, welcher
  107. die Lh.Library benutzt, ihre Module packen.
  108.  
  109. Anleitung
  110. ---------
  111. Hallo und Willkommen in der Welt des PowerPlayers!  Dieses fantastische
  112. Tool wurde 1991/1992 von Stephan Fuhrmann geschrieben und benutzt die
  113. hervorragenden Fähigkeiten der
  114.  
  115. -ReqTools.Library von Nico François für die Datei- und Text-Requester
  116.  
  117. -PowerPacker.Library von Nico François um powergepackte Dateien zu entpacken
  118.  
  119. -Lh.Library von Holger P.Krekel und Olaf 'Olsen' Barthel für die beste
  120.  Kompression von Modules, ausführbarer einfacher Cruncher im Paket enthalten.
  121.  
  122. Einleitung
  123. ----------
  124. Der PowerPlayer ist ein Tool, um Musik mit dem guten alten AMIGA STEREO
  125. DIGITAL SOUND abzuspielen, die mit einem der unterstützten Musik-Programme
  126. oder kompatiblen gemacht wurde.  Es gab bereits viele dieser Programme,
  127. doch PowerPlayer ist etwas anderes:
  128.  
  129. -netter schneller trickreicher 100%-iger Assembler-Code, größtenteils
  130.  PC-Relativ
  131. -kleines niedliches Play-Window
  132. -viieeelle Abspielroutinen
  133. -PowerPacker-Library um immer die neueste und schnellste Entpack-Routine
  134.  zu benutzen
  135. -Lh-Library für die beste Kompression, die je ein Module erfahren hat
  136.  (ausprobieren!)
  137. -kann in vielen Arten von der Workbench und vom CLI aufgerufen werden
  138.  
  139. Aber fangen wir am Anfang an:
  140.  
  141. Aufruf vom PowerPlayer
  142. ----------------------
  143.     WorkBench
  144.     ---------
  145.         DoppelKlick
  146.         -----------
  147.             Klicken Sie das Icon vom PowerPlayer doppelt an, wählen
  148.             Sie die Datei im Datei-Requester, drücken Sie 'OK'
  149.             und genießen Sie !
  150.         DefaultTool
  151.         -----------
  152.             Sie haben ein Modul mit Icon. Wählen Sie das
  153.             Icon an und aktivieren Sie die Info-Funktion der
  154.             Workbench. Nun wählen Sie das DefaultTool an.
  155.             Geben sie den Pfad des PowerPlayers ein. Drücken
  156.             Sie das 'SAVE'-Gadget. Immer wenn Sie jetzt das
  157.             Projekt-Icon doppelklicken, wird der PowerPlayer
  158.             geladen und den Song abspielen.
  159.         Mehrfachauswahl
  160.         ---------------
  161.             Bewegen Sie den Mauszeiger über das PowerPlayer-Icon
  162.             und drücken Sie den linken Mausknopf einmal. Drücken
  163.             Sie jetzt SHIFT und lassen Sie es gedrückt.
  164.             Wählen Sie die Songs, die Sie hören wollen, mit der
  165.             Maus aus. Doppelklicken Sie den letzten Song und
  166.             lassen Sie SHIFT los. Ihre Songs werden geladen !
  167.  
  168.     CLI/SHELL
  169.     ---------
  170.         DateiRequester
  171.         --------------
  172.             Jeder weiß, wie man Dateirequester bedient, also
  173.             werde ich den sehr guten Dateirequester der
  174.             ReqTools.Library nicht erklären. Geben Sie den Namen
  175.             des PowerPlayers in der CLI/SHELL, das Sie geöffnet
  176.             haben mit dem Parameter '-r' ein. Es erscheint ein
  177.             DateiRequester und Sie können ihre Songs aussuchen.
  178.             Beispiel: PowerPlayer -r
  179.         Dateiname
  180.         ---------
  181.             Wenn Sie keine Datei mit einem Requester auswählen
  182.             wollen (z.B. in Scripts), können sie ebenfalls
  183.             den Modulnamen mit seinem Pfad an die Kommandozeile
  184.             hängen.
  185.             Beispiel: PowerPlayer df0:modules/MOD.PowerTheme
  186.         Verzeichnis
  187.         -----------
  188.             Es gibt seit der Version 1.5 die Möglichkeit, den
  189.             PowerPlayer vom CLI mit einem Filerequester zu
  190.             starten, der dann schon in einem vom Benutzer
  191.             festgelegten Verzeichnis ist. Es wird einfach das
  192.             Verzeichnis an die Kommandozeile gehängt.
  193.             Beispiel: PowerPlayer ST-00:modules
  194.         Information
  195.         -----------
  196.             Wenn Sie den Informations-Bildschirm sehen wollen,
  197.             geben Sie folgendes ein:
  198.             PowerPlayer ?
  199.  
  200. Play-Requester
  201. --------------
  202. Der Play-Requester enthält Informationen zum Modul und einige Gadgets.
  203. Alle Versionen +2.1 haben ein neues Benutzerinterface. Es gibt ein
  204. Haupt-Fenster, das dort bleibt wo es ist solange der PowerPlayer läuft:
  205.  
  206. Fragezeichen....zeigt die üblichen Informationen über das Copyright und
  207.         die Features.
  208.         Taste: "1"
  209. Eject...........verwirft die aktuelle Songliste & holt sich über einen
  210.         Filerequester eine neue.
  211.         Taste: "2" oder "e"
  212. FirstSong.......lädt und spielt den ersten Song aus der Liste
  213. PrevSong........lädt und spielt den vorangehenden Song aus der Liste.
  214.         Taste: "3", "[", "(" oder "{" !
  215. Play............spielt den Song ab. Entfernt automatisch Pause,
  216.         wenn man wieder auf PLAY hämmert startet der Song neu.
  217.         Taste: "4" oder "p" !
  218. FastForward.....spielt den Song mit doppelter Geschwindigkeit. Ergibt
  219.         einen schönen FF-Effekt ! Nochmal raufhämmern schaltet
  220.         wieder auf normale Geschwindigkeit.
  221.         Taste: "5" oder "f"
  222. NextSong........lädt & spielt den nächsten Song aus der Liste.
  223.         Taste: "6","<RETURN>", "]",")" oder "}" !
  224. LastSong........lädt & spielt den letzten Song aus der Liste.
  225. Stop............stoppt den Song. Deaktiviert automatisch Pause, FF und
  226.         Play !
  227.         Taste: "7" oder "s"
  228. Pause...........stoppt den Song, bis nochmal Pause betätigt wird oder
  229.         Play gedrückt wird.
  230.         Taste: "8" oder "<LEERTASTE>"
  231. Reset...........startet den Song von neuem.
  232.         Taste: "9" oder "r"
  233. RND.............lädt und spielt einen zufällig gewählten Song ab.
  234.         Taste: "~" oder "/"
  235.  
  236. Fast jedes Gadget hat eine dazugehörige Taste (Tasten 1-9), ESC oder CTRL-C
  237. beenden den PowerPlayer.
  238.  
  239. CTRL-F bringt das Fenster auf volle Größe vor alle anderen Fenster.
  240.  
  241. Wenn man die rechte Maustaste drückt, wechselt man in den Iconify-Modus.
  242. Das Fenster schrumpft auf eine minimale Höhe von 10 Pixeln. Die Gadgets
  243. verschwinden zwar, jedoch kann man den PowerPlayer weiterhin mit den
  244. Tastatur-Kürzeln kontrollieren.
  245. Um das Fenster wieder auf seine normale Größe zu bringen muß man
  246. lediglich die rechte Maustaste erneut drücken.
  247.  
  248. Die Anzeige des Fensters beinhaltet
  249. -den Namen des Modules (oben im Fenster)
  250. -Typ & Länge des Modules in Bytes (Mitte des Fensters)
  251. -Gadgets und Positions-Anzeiger, welcher die derzeitige Position in der
  252.  Dateiliste anzeigt.
  253.  
  254. Mein GUI (Grafische Benutzerschnittstelle) arbeitet mit einer
  255. Recolor-Routine, die verrückte Paletten recht gewitzt behandelt. Sie sucht
  256. nach der hellsten und dunkelsten Farbe für die Schatten und sucht nach der
  257. Farbe mit dem größten Kontrast zum Hintergrund für die Textausgabe.
  258.  
  259. Der PowerPlayer Music Cruncher
  260. ------------------------------
  261. Es gibt mächtigere Datenpacker als den PowerPacker, doch LhArc hat ein
  262. komplexes Datei-Format und der IMPLODER hat keine erklärte Funktion in
  263. seiner explode.library, um Dateien des File-Imploders zu entpacken, also
  264. war ich sehr froh als ich die Lh.Library erhielt und endlich meinen eigenen
  265. Packer/Entpacker zu meinem PowerPlayer hinzufügen konnte.  Die Benutzung
  266. des PMC ist sehr einfach.  Sie müssen einfach ein CLI/SHELL öffnen und PMC,
  267. gefolgt vom Namen der zu packenden Datei und der Zieldatei, eingeben.
  268. Beispiel:
  269.  
  270. PMC df0:modules/MOD.PowerTheme df0:modules/MOD.PowerTheme.LH
  271.  
  272. PMC gibt dann irgendetwas wie
  273.  
  274. Crunching df0:modules/MOD.PowerTheme, Please stand by !
  275.  
  276. aus, und nach einer unwichtig kleinen Zeit (99 Sekunden) wird er das Ergebnis
  277. anzeigen:
  278.  
  279.     Result
  280.     ------
  281.     Uncrunched: 214418
  282.     Crunched: 158052
  283.     Percentage: 73
  284.  
  285. PowerPacker packte die selbe Datei in 109 Sekunden, packte Sie jedoch nur
  286. zu 168760 bytes (78%).  Der einzige Vorteil des PowerPackers ist, daß er in
  287. 10 Sekunden entpackt (Lh:  14 Sekunden).  Ich möchte nicht, daß Nico
  288. verhungert :-), aber ich meine, daß man, wenn man den PowerPacker nicht
  289. schon hat, PMC benutzen sollte.  Oder man packt nicht, wenn man eine große
  290. schnelle Festplatte mit hunderten freier Megabytes hat (hab' ICH nicht :-(
  291. !).
  292.  
  293. Es kann passieren, daß die Prozent-Anzeige falsch ist.  Das passiert, wenn
  294. die gepackte Datei zu groß ist.  Der Grund dafür ist die 16-Bit-Quelle des
  295. CPU-Divu-Befehls.  Natürlich ist die Datei davon nicht betroffen.
  296.  
  297. PMC generiert Dateien des SFHD-Formates (Stephan Fuhrmanns Hohe Dichte :-) ).
  298. Man kann diese Dateien an der Kennung 'SFHD' in den ersten 4 Bytes erkennen.
  299. Das 2.Langwort ist die ungepackte Länge, das 3.Langwort ist die
  300. gepackte Länge.
  301.  
  302. Ich habe einige Typen gesehen, die mit dem PMC gepackte Module in Mailboxen
  303. raufgeladen haben.
  304. BITTE unbedingt '.PMC' als Suffix benutzen und schreiben, daß man den
  305. PowerPlayer zum abspielen braucht.
  306. UND unbedingt die Mailbox prüfen, ob der PowerPlayer überhaupt vorhanden
  307. ist, sonst wird so mancher ziemlich sauer sein, wenn er erst die
  308. Modules runterlädt und dann merkt, daß PowerPlayer garnicht da ist
  309. und er die Modules nicht gebrauchen kann !
  310.  
  311. Ein Beispiel-Mailbox-Eintrag könnte so aussehen:
  312. SONG.PMC    Sehr guter Song, nur mit PowerPlayer zu benutzen
  313.  
  314. Es ist unbedingt zu empfehlen, die Modules direkt im PMC-Format ohne
  315. anderen 'Müll' in einem Archiv raufzuladen, zumal einerseits _NICHT_ per
  316. Hand entpackt werden muß, die entpackte Datei keinen Diskettenplatz
  317. verschwendet und letztendlich durch das eigens für den PowerPlayer
  318. entwickelte PMC-Format ein entpacken ohne den PowerPlayer nicht möglich
  319. ist, so daß man sich so oder so des PowerPlayers bedienen muß ß-} !  So
  320. kann man seine Zustimmung zum PowerPlayer ausdrücken!
  321.  
  322. Technische Informationen
  323. ------------------------
  324. Ein seltsames Feature der SHELL ist, daß das ALIAS-Kommando an die
  325. Kommandozeilenparameter ein Leerzeichen anhängt. PowerPlayer löscht darum
  326. sämtliche Leerzeichen vor dem Zeilenende.
  327.  
  328. PowerPlayer generiert nicht einen eigenen Prozess. Es scheint zwar modern zu
  329. sein, alles gleich im Hintergrund ablaufen zu lassen, ich jedoch wollte dem
  330. Benutzer die Möglichkeit geben, den Computer solange anzuhalten, wie ein
  331. Musikstück abgespielt wird (z.B. in der Startup-Sequence). Meiner Meinung
  332. nach ist das die beste Art, das zu realisieren, wenn Sie jedoch PowerPlayer
  333. im Hintergrund laufen lassen wollen, müssen Sie ihn selber mit "RunBack"
  334. starten.
  335.  
  336. PowerPlayer benutzt das AUDIO.DEVICE, um Audio-Kanäle zu belegen.  Ich
  337. glaube, daß PowerPlayer der einzige Modulabspieler ist, der das tut.  Der
  338. große Vorteil dieser Methode ist, daß PowerPlayer NICHT mit anderen
  339. Programmen, die die Audio-Kanäle belegen, kollidiert.  Wenn Sie jemals das
  340. Chaos, das zwei gleichzeitig laufende Modulabspieler fabrizieren, gehört
  341. haben, werden Sie dieses Feature mögen.
  342.  
  343. ACHTUNG! Benutzen Sie die NoisePacker-Routine V2.03 mit Vorsicht ! Mein
  344. Amiga stürzt jedesmal nach einer Weile ab, wenn ich NoisePacker-Module
  345. spiele. Die Programmierer dieser Abspiel-Routine haben etwas GRAUSAMES
  346. mit dem CIA gemacht, daß niemals im Multitasking hätte geschehen sollen !
  347. Wenn Sie einen NoisePacker-Abspieler ohne diese intensive CIA-Nutung
  348. haben, geben Sie ihn mir ! Bearbeiten Sie nicht wichtige Daten während oder
  349. nachdem Sie so ein Modul abgespielt haben !!
  350.  
  351. Da es sooo viele Musik-Programme auf dem Amiga gibt, ist es für mich
  352. unmöglich, alle existierenden Abspielroutinen einzubinden.  Um ihnen und
  353. mir die Möglichkeit zu geben, den PowerPlayer zum besten Modulabspieler,
  354. der je geschrieben wurde, zu erweitern, werde ich jede Abspiel-Routine, die
  355. mir zugesendet wird, einbauen, wenn folgendes erfüllt ist:
  356.  
  357. - Quellcode der Musik-Routine in ASSEMBLER, möglichst PC-Relativ.
  358.   Zur Zeit kann ich nur Abspielroutinen benutzen, die vom Verticalblank-
  359.   Interrupt aufgerufen werden. Der Quellcode muß auf einer 3.5"-Disk sein.
  360. - Beschreibung, wie man eine Erkennung von Modulen dieser Art durchführt.
  361.   Wenn Sie keine Ahnung haben senden Sie 3 oder mehr Module dieser Art mit
  362.   und ich finde es selber heraus.
  363. - 3 oder mehrere Songs, die mit der Routine abgespielt werden können, sollten
  364.   ebenfalls dabei sein. Ich muß die Routinen testen und ein Musik-Programm,
  365.   für das es weniger als 3 Songs gibt, ist sicherlich nicht gut.
  366. - Fügen Sie einen an sich adressierten Umschlag bei, mit 5 DM oder mehr
  367. - Wenn die Diskette auch nur einen Fehler hat, gehe ich davon aus, daß Sie
  368.   sie sowieso nicht mehr haben wollen und werfe sie weg. Also benutzen Sie
  369.   Disketten hoher Qualität und formatieren Sie sie vor der Benutzung !
  370.  
  371. Wenn Sie einige Features zum PowerPlayer dazu haben möchten, tun Sie
  372. folgendes:
  373.  
  374. - Schreiben Sie einen detailierten Brief mit allen neuen Features an die
  375.   Sie denken
  376. - Wenn Sie das Update mit einigen/allen ihrer Features haben wollen,
  377.   fügen Sie eine Diskette und einen an sich selbst adressierten Umschlag
  378.   hinzu
  379. - Fügen Sie 5 DM für all die Arbeit hinzu !
  380.  
  381. Wenn Sie ein Update haben wollen, tun Sie folgendes:
  382. - legen Sie eine Diskette und einen an Sie adressierten Umschlag bei
  383. - 5 DM für Unkosten und Arbeit !
  384. - Ich werde ihnen dann die aktuelle Version des PowerPlayers zukommen lassen
  385.  
  386. KEINE PANIK, wenn ich ihren Brief nicht gleich beantworte !  Ich habe nicht
  387. genug Zeit, den halben Tag mit meinem Computer zu verbringen.
  388.  
  389. Meine Adresse:    Stephan Fuhrmann
  390.         Erikstr. 30
  391.         W-2380 Schleswig
  392.         Germany
  393.