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