home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Amiga / Applications / Musique / WarpAMP.readme < prev   
Text File  |  1998-05-11  |  9KB  |  269 lines
  1. Short:    PPC MPEG audio player for AHI
  2. Author:   see documentation
  3. Uploader: MagicSN@Birdland.es.bawue.de
  4. Version:  0.9
  5. Type:     mus/play
  6.  
  7. Introduction
  8. ------------
  9. WarpAMP is an MPEG audio player based on Tomislav Uzelac's
  10. amp decoding engine. It is based on Tomislav Uzelac's AMP.
  11. It supports AHI, but it also has a special mode where it
  12. directly accesses a Prelude Soundboard using the prelude.library,
  13. if present. As Default it uses AHI (AHI V4 required).
  14.  
  15. The prelude.library Audio-Code is based on Thomas Wenzel's
  16. PreludeAMP for ppc.library (i got his permission to use
  17. this Replay source on a email-request by myselves to him, he uploaded
  18. the Source recently on Aminet). The AHI Code was done by
  19. Thorsten Hansen of KATO, thanks for his help with AHI :)
  20.  
  21. Version 0.8 fixes some small bugs.
  22. Version 0.9 changes some small things to make it work okay with OpusMPEGA
  23.  
  24. Features
  25. --------
  26.  - FREEWARE!
  27.  - Compiled with StormC PPC
  28.  - Does not need ixemul.library!
  29.  - Does not need the AHI audio system, but supports it
  30.  - Does not stop the music, when Intuition is locked, if
  31.    -quiet mode is used
  32.  
  33. Requirements
  34. ------------
  35.  
  36.  - AHI or prelude.library v2 (V2.41 recommended)
  37.  - A PowerUP compatible system with WarpOS installed
  38.    (should also work with V7, though not tested... might
  39.    give slowdown in V7...)
  40.  
  41. Usage
  42. -----
  43.  
  44.  WarpAMP infile
  45.  
  46.  If you call it without parameter, a Filerequester will be invoked.
  47.  MultiSelect is possible.
  48.  
  49.  It is also possible to use a program file by
  50.  
  51.  WarpAMP -program
  52.  
  53.  or
  54.  
  55.  WarpAMP -program prgfile
  56.  
  57.  The first version uses a Filerequester, the second not.
  58.  
  59.  The programfile format looks like:
  60.  
  61.  work:mpg/mympg1.mp3
  62.  work:mpg/mympg2.mp3
  63.  repeat
  64.  
  65.  This file plays the two MPEG files (one line, one file) and then repeats.
  66.  Until CTRL-C is pressed. If you do not specify repeat at the end, it does
  67.  not repeat. Program files have filenames with .prg at the end.
  68.  
  69.  By default WarpAMP
  70.  
  71.  - uses a PPC BAT register.
  72.  - disables the Caches for the Sound-Memory-Buffer
  73.  
  74.  If you do not like this, use the option
  75.  
  76.  -nobat
  77.  
  78.  -prelude uses the prelude.library Replaycode, if you do not specify this,
  79.  AHI is used.
  80.  
  81.  -quiet makes WarpAMP not to print out any output. This has the effect,
  82.  that WarpAMP will not stop when you do Intuition-Operations. I know,
  83.  handling it in a new task would be the cleaner implementation, but
  84.  this was more easy to do. :)
  85.  
  86. History
  87. -------
  88. v0.5 - First version, based on PreludeAMP with some modifications
  89. v0.6 - Added AHI Support
  90. v0.7 - Added -quiet mode
  91.  
  92. Legal stuff
  93. -----------
  94.  
  95. WarpAMP
  96. -------
  97.  
  98. I don't claim a specific copyright on it. It is just freeware. You are
  99. obliged to confirm to the copyright notices of PreludeAMP and AMP, though.
  100. I am in no way responsible, if this program should damage your computer (but
  101. it should not, just a standard disclaimer) or anything else.
  102.  
  103. PreludeAMP of Thomas Wenzel Copyright Notice
  104. --------------------------------------------
  105.  
  106. PreludeAMP is copyrighted freeware. It may be distributed freely as long as
  107. no modifications are made to the executable and this document. A nominal
  108. fee may be asked to cover distribution costs.
  109.  
  110. PreludeAMP may not be used for any commercial purposes or included with any
  111. commercial product without the written permission of the author. It may
  112. NOT be stored on ftp servers or websites that also hold commercial software
  113. products or drivers for commercial hardware. The only exception are servers
  114. of the Aminet archive.
  115.  
  116. No responsibilities are taken for damaged speakers, amplifiers, Amigas
  117. or any other components or data involved while using PreludeAMP.
  118.  
  119. Although I've done some beta testing I can't guarantee that PreludeAMP will
  120. not crash! If you find any bugs, let me know.
  121.  
  122. -----
  123.  
  124. Note, that i (Steffen Haeuser) have the email-permission to use his sources
  125. and modify them in a way to create an MPEG Player of my own, as long as i
  126. conform to the AMP license.
  127.  
  128. Here's the original amp.readme:
  129. -------------------------------
  130. amp MPEG audio decoder readme file (version 0.7.5)
  131. (C) Tomislav Uzelac  1996,1997
  132.  
  133. amp is free software and can be _used_ freely by anyone. If you want to
  134. do anything else with it, be sure to check the Legal section of this
  135. document for legal issues.
  136.  
  137. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  138. of this document.
  139.  
  140. 1. Introduction
  141. 2. Installation
  142. 3. Running
  143. 4. Feedback
  144. 5. Contributing
  145. 6. Legal
  146.  
  147.  
  148. 1. Introduction
  149.  
  150. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  151. putting together as a side project of the MPEG hardware design project at 
  152. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  153. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  154. defined in MPEG2), layers 2 and 3. 
  155.  
  156. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  157. available at the amp home site ftp://ftp.rasip.fer.hr
  158.  
  159. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  160.  
  161. The following people contributed their time and knowledge to amp:
  162. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  163. Edouard Lafargue, Andrew Richards, George Colouris,
  164. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  165.  
  166. amp home location is
  167.         ftp://ftp.rasip.fer.hr/pub/mpeg/
  168.  
  169. and the mailing list: send 'HELP' in the body of the message to:
  170.         multimedia@rasip.fer.hr
  171.  
  172. If you want to find out more about MPEG, best places to start are
  173.         http://www.mpeg.org
  174.         http://www.mpeg2.de 
  175.  
  176.  
  177. 2. Installation
  178.  
  179. Installation should be simple enough if amp was ported to your system,
  180. just do a 
  181.  
  182. ./configure
  183. make 
  184.  
  185. You can edit the makefile further to suit your system. If configure fails 
  186. to make a usable Makefile, you'll _have_ to edit it yourself.
  187.  
  188. Linux users should try real-time playing support, as described
  189. in doc/realtime.txt. Some people that might pass on this feature are
  190. those with slower machines (i.e. 486's), or SMP systems (see the
  191. doc/linuxrealtime.txt file). 
  192. Some versions of the linux C library produce an error when compiling
  193. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  194. and replace _P in the offending line with __P.
  195.  
  196. ./configure --enable-realtime
  197. make
  198. chown root.root amp
  199. chmod u+s amp
  200.  
  201. ... this requires /dev/dsp to be both world readable and writeable. If you
  202. have a special group for people allowed to use the sound device (for
  203. instance, a group called sound), you can do a:
  204.  
  205. chmod g+s amp
  206.  
  207. or make your audio card world read/writeable (not recomended)
  208.  
  209. chmod o+rw /dev/dsp*
  210.  
  211. 3. Running:
  212.  
  213. 'amp -h' gives you usage & options. If your computer is on the slower
  214. side, direct playback might not work, but you can decode it
  215. to .wav or raw pcm and play it later.
  216.  
  217.  
  218. 4. Feedback
  219.  
  220. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  221. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  222.  
  223. If you find any mpeg audio files that amp has trouble decoding, please tell
  224. me about this via e-mail <tuzelac@rasip.fer.hr>.
  225.  
  226.  
  227. 5. Contributing
  228.  
  229. Please contribute to amp. If you want to know what is going on in amp 
  230. development, you can join the developers mailing list
  231.  
  232.         mpeg_audio_developers@rasip.fer.hr
  233.  
  234. There are certain debugging facilities that I made in amp, but are disabled
  235. in the current release (they are neither nice nor user-friendly). If anyone
  236. enhances them (they are in dump.c) to the point that they're actually
  237. usable I'll be happy to include the changes in the release. I think this
  238. kind of debug output would be very useful to people studying these audio
  239. algorithms.
  240.  
  241.  
  242. 6. Legal
  243.  
  244. This software can be used freely for any purpose. It can be distributed
  245. freely, as long as it is not sold commercially without permission from
  246. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  247. on CD_ROMs containing other free software is explicitly permitted even 
  248. when a modest distribution fee is charged for the CD, as long as this
  249. software is not a primary selling argument for the CD.
  250.  
  251. Building derived versions of this software is permitted, as long as they
  252. are not sold commercially without permission from Tomislav Uzelac 
  253. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  254. such, and must be called by a name other than amp. Any derived versions
  255. must retain this copyright notice.
  256.  
  257. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  258.  * not mention being copyrighted itself :)
  259.  */
  260.  
  261. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  262. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  263. any damages that might occur to your computer, software, etc. in
  264. consequence of you using this freeware program.
  265.  
  266.  
  267. Tomislav Uzelac
  268. <tuzelac@rasip.fer.hr>
  269.