home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 2 / MECOMP-CD-II.iso / amiga / sound / amigaamp / amigaamp.liesmich < prev    next >
Encoding:
Text File  |  1998-06-03  |  15.9 KB  |  398 lines
  1. Short:    MPEG audio player with GUI (68k/PPC)
  2. Uploader: Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  3. Author:   Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  4. Type:     mus/play
  5. Version:  2.0
  6.  
  7.  
  8. Einführung
  9. ----------
  10. AmigaAMP ist ein MPEG Audio Player mit grafischer Benutzeroberfläche.
  11. Zur Dekodierung wird auf dem 68k-Prozessor die mpega.library verwendet,
  12. die PPC-Version basiert auf dem amp Dekoder. Die Soundausgabe erfolgt
  13. über das AHI Audio System. Dieses Programm ist KEINE neue Oberfläche
  14. für CLI basierte Player sondern ein eigenständiges Produkt.
  15. Sollten Probleme mit AHI, der AsyncIO.library oder der mpega.library
  16. auftreten, bitte ich jedoch darum, die jeweiligen Autoren zu kontaktieren,
  17. da ich hier ohnehin nicht helfen könnte.
  18.  
  19.  
  20. Benötigt werden:
  21. ----------------
  22. AmigaOS 3.0 oder höher
  23. 68020 Prozessor oder besser
  24. mpega.library    (Aminet:util/libs/mpega_library.lha)
  25. asyncio.library  (Aminet:dev/c/AsyncIO.lha)
  26. AHI audio system (Aminet:mus/misc/ahiusr.lha)
  27.  
  28.  
  29. Empfohlen
  30. ---------
  31. PowerUP und ppc.library v45
  32. AmigaOS 3.1 (OS3.1 UND Powerup werden für den Spectrum Analyzer benötigt!)
  33.  
  34.  
  35. Besonderheiten
  36. --------------
  37.  - FREEWARE!  Keine Beta, keine Requester, keine beschränkte Laufzeit!
  38.  - GadTools basiertes, Font sensitives Interface
  39.  - Alternativ dazu ein WinAMP kompatibles GUI
  40.  - Workbench Applikation (Drag'nDrop Möglichkeit für Daten-Icons)
  41.  - sehr leicht konfigurierbar
  42.  - AHI Device Zugriff (der AHI Default Modus wird automatisch unterstützt)
  43.  - PPC (PowerUP) Unterstützung
  44.  - ID3 Tag Editor (Interpret, Titel, Album, etc.)
  45.  
  46. Einschränkungen
  47. ---------------
  48.  - Die PPC-Version unterstützt noch kein MPEG2.5, ich arbeite dran
  49.  - Keine Echtzeit Spektrometer in der 68k Version
  50.  - Keine Echtzeit Spektrometer unter AmigaOS 3.1 -- nix zu machen!
  51.  - Keine Echtzeit Spektrometer beim abspielen von MP2 -- noch nicht
  52.  
  53.  
  54. Entwicklungsgeschichte
  55. ----------------------
  56.  
  57. v2.0 - Sehr viele Änderungen die einen Sprung der Versionsnummer wert sind :-)
  58.      - Position des Genre Listview Gadgets korrigiert
  59.      - Fehler beim Abspielen von Mono- oder 22.05 kHz Dateien beseitigt
  60.      - Digitale Lautstärkeregelung
  61.      - AREXX Interface (siehe AREXX.readme -- nur in englisch)
  62.      - Automatische Erkennung ob bereits ein anderer AmigaAMP Task läuft
  63.      - Alphabetisch sortierte Playliste (noch nicht editierbar)
  64.      - Konfigurierbare Puffergröße
  65.      - Oberfläche, die so aussieht wie WinAMP (siehe unten)
  66.      - Fontsensitivität der alten Oberfläche verbessert
  67.      - TagInfo wird gepuffert und erst beim schließen der Datei geschrieben
  68.  
  69. v1.1 - In AmigaAMP umbenannt
  70.      - PPC Version
  71.      - ID3 Tag Editor
  72.      - Kommandozeilenunterstützung
  73.  
  74. v1.0 - Erste Veröffentlichung, die noch MPEGAHI hieß
  75.  
  76. Einführung / Konfiguration
  77. --------------------------
  78. Wichtig! Eine korrekt installierte AHI Konfiguration ist Grundvoraussetzung
  79. für ein Funktionieren von AmigaAMP. Ohne korrekte AHI Installation wird
  80. der Klang wahrscheinlich ziemlich schlecht sein...
  81.  
  82. Starten Sie zunächst das AHI Setup Programm in Ihrem Prefs-Verzeichnis.
  83. Wählen Sie eins der Units 0 bis 3 (nicht das Music Unit). Wenn Sie noch kein
  84. Unit anderweitig verwenden, empfehle ich, Unit 0 einzustellen.
  85.  
  86. Wählen Sie einen der "Fast Stereo++" AudioModes aus, der sich mit der 
  87. von Ihnen verwendeten Soundkarte verträgt. Für die Prelude empfehle ich
  88. die Verwendung des "Prelude:Fast 16 bit stereo++ realtime" Modus.
  89.  
  90. Nun sollten Sie in Erfahrung bringen, in welcher Samplingrate die meisten
  91. Ihrer MPEG Files kodiert sind. Normalerweise wird dies 44100Hz sein, da
  92. dies die Standard CD Rate ist. Wenn Sie einen langsamen Prozessor haben
  93. und Sie AmigaAMP daher mit heruntergeteilter Frequenz laufen lassen müssen,
  94. können Sie dies im Konfigurationsfenster einstellen. Sehen Sie sich unten
  95. stehende Tabelle zu diesem Thema an.
  96.  
  97. Es ist wichtig, daß der Frequenz-Regler auf der Frequenz steht, die
  98. tatsächlich am häufigsten benutzt wird. Wenn Sie zum Beispiel viele
  99. 44.1kHz Samples abspielen wollen und eine Frequenz-Teilung von 1:2 verwenden,
  100. sollte der Regler auch 22050 Hz stehen!
  101.  
  102. Wenn Sie nicht vorhaben, verschiedene Programme zur gleichen Zeit mit
  103. unterschiedlichen Wiedergabefrequenzen laufen zu lassen, können Sie den
  104. Kanal-Regler auf der Position 1 stehen lassen. Die restlichen Einstellungen
  105. sind von Ihrer Audio Hardware abhängig.
  106.  
  107. Wählen Sie zum Abschluss der Konfiguration das "Save" Gadget links unten.
  108.  
  109. Nun ist es Zeit, AmigaAMP zu konfigurieren. Wenn Sie ein anderes AHI Unit
  110. als 0 gewählt haben, sollten Sie den ToolType AHIUNIT im AmigaAMP Info-
  111. Fenster anpassen. Wenn Sie Unit 0 verwenden, starten Sie AmigaAMP einfach
  112. durch ein Doppelklick. Wählen Sie "Config" aus dem Menü.
  113.  
  114. Stellen Sie die Regler und Checkmarks auf die von Ihnen gewünschten Settings.
  115. Speichern Sie die Einstellungen und schließen Sie das Konfigurations-
  116. Fenster.
  117.  
  118. Das war's auch schon! AmigaAMP ist damit komplett konfiguriert. Sie können
  119. später Feineinstellungen vornehmen. Die Performance des Systems hängt
  120. sehr von der Leistung der mpega.library und der Geschwindigkeit Ihres
  121. AHI Treibers für die verwendete Soundkarte ab.
  122.  
  123. Empfohlene Einstellungen (mit Prelude:Fast 16 bit stereo++ realtime getestet)
  124. -----------------------------------------------------------------------------
  125.  
  126.           |     Layer 1/2        |        Layer 3
  127. Prozessor | Quality|FreqDiv|Mono | Quality|FreqDiv|Mono
  128. ----------+--------+-------+-----+--------+-------+-----
  129. 68040-40  |  high  |  1:2  | off | medium |  1:2  | on 
  130. 68060-50  |  high  |  1:1  | off |  high  |  1:1  | off
  131. PPC604e   |  high  |  1:1  | off |  high  |  1:1  | off
  132.  
  133. Hinweis: Nur die 68k Version wird von diesen Einstellungen beeinflußt.
  134.  
  135.  
  136. Fortgeschrittene Konfiguration
  137. ------------------------------
  138. * Bufsize:
  139. Größe des Lesepuffers. Am besten etwas probieren bis die besten Resultate
  140. erzielt werden. (Am besten ist normalerweise 16 bis 32K)
  141.  
  142. *TaskPri:
  143. Setzt die laufende Taskpriorität von AmigaAMP. Der Empfohlene Wert für
  144. unterbrechungsfreie Wiedergabe ist 1. Gott weiß, was passiert, wenn
  145. irgendein Dritthersteller Task-Scheduler anfängt an AmigaAMPs internen
  146. Task-Prioritäten herumzufummeln...
  147.  
  148. * Read ID3 TagInfo
  149. Versucht, Informationen über Interpret, Titel, etc. zu lesen. Da diese am
  150. Ende der Datei gespeichert werden, kann diese Funktion das laden etwas
  151. verlangsamen. Wenn diese Funktion ausgeschaltet ist, können die
  152. Informationen weder geändert noch gespeichert werden!
  153.  
  154. * Allow multiple instances
  155. Normalerweise, wenn auf ein MPEG Datei Projekt-Icon geklickt wird während
  156. AmigaAMP bereits eine andere Datei spielt, wird kein zweiter AmigaAMP Task
  157. gestartet, sondern der bereits laufende spielt die neue Datei. Dieses
  158. Verhalten kann abgeschaltet werden. Damit es reibungsfrei funktioniert,
  159. muß AmigaAMP vorher zweimal manuell gestartet und bei eingeschaltetem
  160. "Allow multiple instances" jeweils die Konfiguration gespeichert werden.
  161.  
  162. * Limit volume to 0dB
  163. Der Lautstärkeregler reicht von Stille bis +6dB so daß leisere Aufnahmen
  164. verstärkt werden können. Um die Lautstärke nicht aus versehen über Normal
  165. zu ziehen kann diese Option eingeschaltet werden.
  166.  
  167. * ToolType: DIRECTORY
  168. Dieses Verzeichnis wird standardmäßig im Dateirequester angezeigt.
  169.  
  170. Benutzung (wie man Sounds lädt und spielt)
  171. ------------------------------------------
  172.  
  173. Die meisten Funktionen von AmigaAMP sollten selbsterklärend sein, da sie
  174. sich in ähnlicher Darstellung auf jedem CD Spieler wiederfinden.
  175. AmigaAMP verwendet jedoch natürlich keine CDs sondern Dateien - es handelt
  176. sich schließlich um ein Computerprogramm... Die Unterschiede in der
  177. Benutzung sind also wie folgt - die untere Reihe von Gadgets:
  178.  
  179.  - Eject      Stopt die Wiedergabe, löscht die derzeitige Spielliste
  180.               und öffnet einen Filerequester, der die Auswahl eines
  181.               oder mehrerer neuer Samples erlaubt.
  182.  - Skip Back  springt zum vorherigen Track der Playliste zurück - wenn
  183.               es einen solchen gibt.
  184.  - Stop       Stopt die Wiedergabe (was sonst?)
  185.  - Play       Startet die Wiedergabe, wenn mindestens ein File geladen
  186.               (und damit in der Playliste eingetragen) ist. Ist kein
  187.               File geladen (also z.B. beim Programmstart), wird ein
  188.               Filerequester geöffnet und Sie können ein oder mehrere
  189.               Files auswählen.
  190.  - Skip Fwd   springt zum nächsten Track in der Playliste (zum nächsten
  191.               File, wenn Sie mehrere geöffnet haben)
  192.  - Pause      Unterbricht die Wiedergabe zeitweilig, um sie später an der
  193.               gleichen Stelle fortzusetzen
  194.  
  195.  
  196. Über den Kontroll-Gadgets findet sich ein Positions-Regler. Wenn Sie
  197. ein File abspielen, können Sie durch Verschieben dieses Reglers die
  198. momentane Abspielposition innerhalb des Files verändern.
  199.  
  200. Über die WinAMP Oberfläche
  201. --------------------------
  202. Seit WinAMP 1.80 kann man eigene Texturen (sogenannte Skins) für die
  203. Oberfläche laden. Die Texturen bestehen aus mehreren Bitmap-Bildern die
  204. zusammen in einem Verzeichnis liegen. Sie enthalten das Aussehen des
  205. Abspielfensters und der Gadgets. Da mich mehr und mehr Leute darum bitten,
  206. AmigaAMP wie WinAMP aussehen zu lassen habe ich nun eine alternative GUI
  207. Routine eingebaut, die diese WinAMP Skins laden kann!
  208.  
  209. Die drei Varianten, die mir am besten gefallen habe ich AmigaAMP beigelegt.
  210. Sie befinden sich im "skins" Verzeichnis in folgenden Unterverzeichnissen:
  211.  
  212.  - base      -> Das original WinAMP Design
  213.  - sex       -> Ein ziemlich buntes, poppiges Aussehen
  214.  - eXquisite -> Holzgehäuse und polierte Messingknöpfe :)
  215.  
  216. Um eines der neuen GUIs zu aktivieren muß AmigaAMP mit den Optionen NewGUI
  217. und Skin=<Unterverzeichnisname> gestartet werden.  Falls einfach nur der
  218. normale WinAMP-Look gewünscht wird, reicht "AmigaAMP NG" als Abkürzung.
  219. Für die anderen Designs empfehle ich dringend die HighColor Darstellung
  220. einer Grafikkarte.
  221.  
  222. Obwohl die Bilder alle die Erweiterung .iff haben müssen, können sie in
  223. jedem beliebigen Format sein, für das ein funktionierender Datatype
  224. installiert ist (am besten durch laden in Multiview überprüfen). Mit einem
  225. geeigneten BMP Datatype lassen sich sogar die WinAMP skins 1:1 übernehmen.
  226. AmigaAMP versucht automatisch, Bilder mit den Erweiterungen iff oder bmp
  227. zu laden.
  228.  
  229. Zur Zeit funktionieren nicht alle Elemente der WinAMP Oberfläche. Es gibt
  230. z.B. kein Spektrogramm bei MP2 und auch keinen Equalizer. Der Shuffle-Knopf
  231. bewirkt auch (noch) nichts. Ansonsten läuft aber so gut wie alles!
  232.  
  233.  
  234. Rechtliches
  235. -----------
  236. AmigaAMP ist Freeware, das Copyright liegt beim Autor. Es darf frei kopiert
  237. werden, solange keine Änderungen am Code oder der Dokumentation vorgenommen
  238. werden. Eine (vertretbare) Gebühr zur Deckung der Kopierkosten darf erhoben
  239. werden.
  240.  
  241. AmigaAMP darf nicht für kommerzielle Zwecke verwendet werden, es darf auch
  242. nicht in kommerziellen Distribtutionen vertrieben werden, ohne daß hierfür
  243. eine schriftliche Einverständniserklärung des Autors vorliegt. Es darf
  244. nicht auf ftp- oder Webservern abgelegt werden, die kommerzielle Software
  245. oder Treiber für kommerzielle Hardware anbieten. Die einzige Ausnahme sind
  246. die Server des Aminet Archivs.
  247.  
  248. Es wird keine Verantwortung für Schäden an Lautsprechern, Verstärkern,
  249. Amigas oder anderen Komponenten sowie Daten, die durch die Verwendung
  250. von AmigaAMP berührt werden könnten, übernommen.
  251.  
  252. Obwohl ich ausgiebige Betatests vorgenommen habe, kann ich nicht garantieren,
  253. daß AmigaAMP unter allen Umständen immer überall völlig problemlos
  254. funktioniert. Wenn Sie also Fehler oder Probleme entdecken, lassen Sie
  255. es mich bitte wissen.
  256.  
  257. Hier das originale Readme zu amp:
  258. ---------------------------------
  259. amp MPEG audio decoder readme file (version 0.7.5)
  260. (C) Tomislav Uzelac  1996,1997
  261.  
  262. amp is free software and can be _used_ freely by anyone. If you want to
  263. do anything else with it, be sure to check the Legal section of this
  264. document for legal issues.
  265.  
  266. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  267. of this document.
  268.  
  269. 1. Introduction
  270. 2. Installation
  271. 3. Running
  272. 4. Feedback
  273. 5. Contributing
  274. 6. Legal
  275.  
  276.  
  277. 1. Introduction
  278.  
  279. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  280. putting together as a side project of the MPEG hardware design project at 
  281. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  282. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  283. defined in MPEG2), layers 2 and 3. 
  284.  
  285. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  286. available at the amp home site ftp://ftp.rasip.fer.hr
  287.  
  288. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  289.  
  290. The following people contributed their time and knowledge to amp:
  291. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  292. Edouard Lafargue, Andrew Richards, George Colouris,
  293. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  294.  
  295. amp home location is
  296.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  297.  
  298. and the mailing list: send 'HELP' in the body of the message to:
  299.     multimedia@rasip.fer.hr
  300.  
  301. If you want to find out more about MPEG, best places to start are
  302.     http://www.mpeg.org
  303.     http://www.mpeg2.de 
  304.  
  305.  
  306. 2. Installation
  307.  
  308. Installation should be simple enough if amp was ported to your system,
  309. just do a 
  310.  
  311. ./configure
  312. make 
  313.  
  314. You can edit the makefile further to suit your system. If configure fails 
  315. to make a usable Makefile, you'll _have_ to edit it yourself.
  316.  
  317. Linux users should try real-time playing support, as described
  318. in doc/realtime.txt. Some people that might pass on this feature are
  319. those with slower machines (i.e. 486's), or SMP systems (see the
  320. doc/linuxrealtime.txt file). 
  321. Some versions of the linux C library produce an error when compiling
  322. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  323. and replace _P in the offending line with __P.
  324.  
  325. ./configure --enable-realtime
  326. make
  327. chown root.root amp
  328. chmod u+s amp
  329.  
  330. ... this requires /dev/dsp to be both world readable and writeable. If you
  331. have a special group for people allowed to use the sound device (for
  332. instance, a group called sound), you can do a:
  333.  
  334. chmod g+s amp
  335.  
  336. or make your audio card world read/writeable (not recomended)
  337.  
  338. chmod o+rw /dev/dsp*
  339.  
  340. 3. Running:
  341.  
  342. 'amp -h' gives you usage & options. If your computer is on the slower
  343. side, direct playback might not work, but you can decode it
  344. to .wav or raw pcm and play it later.
  345.  
  346.  
  347. 4. Feedback
  348.  
  349. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  350. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  351.  
  352. If you find any mpeg audio files that amp has trouble decoding, please tell
  353. me about this via e-mail <tuzelac@rasip.fer.hr>.
  354.  
  355.  
  356. 5. Contributing
  357.  
  358. Please contribute to amp. If you want to know what is going on in amp 
  359. development, you can join the developers mailing list
  360.  
  361.     mpeg_audio_developers@rasip.fer.hr
  362.  
  363. There are certain debugging facilities that I made in amp, but are disabled
  364. in the current release (they are neither nice nor user-friendly). If anyone
  365. enhances them (they are in dump.c) to the point that they're actually
  366. usable I'll be happy to include the changes in the release. I think this
  367. kind of debug output would be very useful to people studying these audio
  368. algorithms.
  369.  
  370.  
  371. 6. Legal
  372.  
  373. This software can be used freely for any purpose. It can be distributed
  374. freely, as long as it is not sold commercially without permission from
  375. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  376. on CD_ROMs containing other free software is explicitly permitted even 
  377. when a modest distribution fee is charged for the CD, as long as this
  378. software is not a primary selling argument for the CD.
  379.  
  380. Building derived versions of this software is permitted, as long as they
  381. are not sold commercially without permission from Tomislav Uzelac 
  382. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  383. such, and must be called by a name other than amp. Any derived versions
  384. must retain this copyright notice.
  385.  
  386. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  387.  * not mention being copyrighted itself :)
  388.  */
  389.  
  390. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  391. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  392. any damages that might occur to your computer, software, etc. in
  393. consequence of you using this freeware program.
  394.  
  395.  
  396. Tomislav Uzelac
  397. <tuzelac@rasip.fer.hr>
  398.