home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1998 #5 / AmigaPlus_CD-ROM_Nr.5-98.iso / pd / musik / prltapedeck / tapedeck.readme < prev    next >
Text File  |  1998-03-03  |  8KB  |  255 lines
  1. Short:    Plays AIFF, MP2 and MP3 with Prelude
  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:  1.5
  6.  
  7.  
  8. Introduction
  9. ------------
  10. Prelude Tapedeck is a GUI based sound player for the Prelude soundcard.
  11. It makes use of some of Prelude's special realtime features and won't work
  12. with any other soundcard.
  13.  
  14. This program auto-detects a PowerUP environment and will use the PPC to
  15. decode MPEG-audio layer 2 and 3 in realtime with almost no system load on
  16. the 68k side.
  17.  
  18. Supported filetypes are:
  19.  
  20.  - AIFF 16 bit stereo (68030 or better)
  21.  - MPEG-audio j-stereo or dual-ch (PowerPC required!)
  22.  * That's all! Don't try to play other files! :-)
  23.  
  24. Operation
  25. ---------
  26. Well, it works like a mixture of tapedeck and CD player :-)
  27. The buttons in the bottom row are:
  28.  
  29.  - Power
  30.    switches the tapedeck off and quits the program
  31.  
  32.  - Input Gain
  33.    changes the input gain for recording, upper slider for left channel,
  34.    lower slider for right channel
  35.  
  36.  - Eject
  37.    clears the current Playlist and opens a file requester to select
  38.    one or more new files
  39.  
  40.  - Review
  41.    move backwards in the current track, works only in play mode
  42.  
  43.  - Stop
  44.    stops playback and returns to the beginning of the current track
  45.  
  46.  - Play/Pause
  47.    toggles between playback and pause
  48.  
  49.  - Cue
  50.    move forwards in the current track, works only in play mode
  51.  
  52.  - Record
  53.    clears the current Playlist and opens a file requester to select a new
  54.    file for recording
  55.    The tapedeck will be in rec-pause mode afterwards to let you adjust the
  56.    input gain and will start recording when you press the Play/Pause button.
  57.  
  58. The buttons just below the display are:
  59.  
  60.  - MODE
  61.    changes the display mode of the realtime counter
  62.  
  63.  - INPUT
  64.    switches between the three possible Prelude inputs for recording
  65.  
  66.  - FREQ
  67.    changes the recording frequency, works only in stop mode
  68.  
  69.  - PEAK
  70.    resets the peak value which will be displayed right of the bargraph
  71.    levelmeter
  72.  
  73.  - SKIP BACK
  74.    skips back one track
  75.  
  76.  - SKIP FORWARD
  77.    skips forward one track
  78.  
  79.  
  80. Requirements
  81. ------------
  82. asyncio.library v39.x or higher (Aminet:dev/c/AsyncIO.lha)
  83. prelude.library v2.41 or higher (v2.41 is included)
  84. 128KB stack (remember to update your icon!)
  85.  
  86. Known bugs
  87. ----------
  88. The user interface looks broken on ECS or AGA screens. However, it works
  89. perfectly with CyberGraphX AND Picasso96. Workaround: Buy a graphics card ;)
  90.  
  91. Legal stuff
  92. -----------
  93. PreludeTapedeck is copyrighted freeware.  It may be distributed freely as
  94. long as no modifications are made to the executable and this document.  A
  95. nominal fee may be asked to cover distribution costs.
  96.  
  97. PreludeTapedeck may not be used for any commercial purposes or included
  98. with any commercial product without the written permission of the author.
  99. It may NOT be stored on ftp servers or websites that also hold commercial
  100. software products or drivers for commercial hardware.  The only exception
  101. are servers of the Aminet archive.
  102.  
  103. No responsibilities are taken for damaged speakers, amplifiers, Amigas or
  104. any other components or data involved while using PreludeTapedeck.
  105.  
  106. Although I've done some beta testing I can't guarantee that PreludeTapedeck
  107. will not crash!  If you find any bugs, let me know.
  108.  
  109. PreludeTapedeck uses the AMP decoding engine by Tomislav Uzelac for MPEG-
  110. audio playback.
  111.  
  112.  
  113. Here's the original amp.readme:
  114. -------------------------------
  115. amp MPEG audio decoder readme file (version 0.7.5)
  116. (C) Tomislav Uzelac  1996,1997
  117.  
  118. amp is free software and can be _used_ freely by anyone. If you want to
  119. do anything else with it, be sure to check the Legal section of this
  120. document for legal issues.
  121.  
  122. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  123. of this document.
  124.  
  125. 1. Introduction
  126. 2. Installation
  127. 3. Running
  128. 4. Feedback
  129. 5. Contributing
  130. 6. Legal
  131.  
  132.  
  133. 1. Introduction
  134.  
  135. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  136. putting together as a side project of the MPEG hardware design project at 
  137. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  138. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  139. defined in MPEG2), layers 2 and 3. 
  140.  
  141. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  142. available at the amp home site ftp://ftp.rasip.fer.hr
  143.  
  144. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  145.  
  146. The following people contributed their time and knowledge to amp:
  147. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  148. Edouard Lafargue, Andrew Richards, George Colouris,
  149. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  150.  
  151. amp home location is
  152.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  153.  
  154. and the mailing list: send 'HELP' in the body of the message to:
  155.     multimedia@rasip.fer.hr
  156.  
  157. If you want to find out more about MPEG, best places to start are
  158.     http://www.mpeg.org
  159.     http://www.mpeg2.de 
  160.  
  161.  
  162. 2. Installation
  163.  
  164. Installation should be simple enough if amp was ported to your system,
  165. just do a 
  166.  
  167. ./configure
  168. make 
  169.  
  170. You can edit the makefile further to suit your system. If configure fails 
  171. to make a usable Makefile, you'll _have_ to edit it yourself.
  172.  
  173. Linux users should try real-time playing support, as described
  174. in doc/realtime.txt. Some people that might pass on this feature are
  175. those with slower machines (i.e. 486's), or SMP systems (see the
  176. doc/linuxrealtime.txt file). 
  177. Some versions of the linux C library produce an error when compiling
  178. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  179. and replace _P in the offending line with __P.
  180.  
  181. ./configure --enable-realtime
  182. make
  183. chown root.root amp
  184. chmod u+s amp
  185.  
  186. ... this requires /dev/dsp to be both world readable and writeable. If you
  187. have a special group for people allowed to use the sound device (for
  188. instance, a group called sound), you can do a:
  189.  
  190. chmod g+s amp
  191.  
  192. or make your audio card world read/writeable (not recomended)
  193.  
  194. chmod o+rw /dev/dsp*
  195.  
  196. 3. Running:
  197.  
  198. 'amp -h' gives you usage & options. If your computer is on the slower
  199. side, direct playback might not work, but you can decode it
  200. to .wav or raw pcm and play it later.
  201.  
  202.  
  203. 4. Feedback
  204.  
  205. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  206. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  207.  
  208. If you find any mpeg audio files that amp has trouble decoding, please tell
  209. me about this via e-mail <tuzelac@rasip.fer.hr>.
  210.  
  211.  
  212. 5. Contributing
  213.  
  214. Please contribute to amp. If you want to know what is going on in amp 
  215. development, you can join the developers mailing list
  216.  
  217.     mpeg_audio_developers@rasip.fer.hr
  218.  
  219. There are certain debugging facilities that I made in amp, but are disabled
  220. in the current release (they are neither nice nor user-friendly). If anyone
  221. enhances them (they are in dump.c) to the point that they're actually
  222. usable I'll be happy to include the changes in the release. I think this
  223. kind of debug output would be very useful to people studying these audio
  224. algorithms.
  225.  
  226.  
  227. 6. Legal
  228.  
  229. This software can be used freely for any purpose. It can be distributed
  230. freely, as long as it is not sold commercially without permission from
  231. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  232. on CD_ROMs containing other free software is explicitly permitted even 
  233. when a modest distribution fee is charged for the CD, as long as this
  234. software is not a primary selling argument for the CD.
  235.  
  236. Building derived versions of this software is permitted, as long as they
  237. are not sold commercially without permission from Tomislav Uzelac 
  238. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  239. such, and must be called by a name other than amp. Any derived versions
  240. must retain this copyright notice.
  241.  
  242. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  243.  * not mention being copyrighted itself :)
  244.  */
  245.  
  246. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  247. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  248. any damages that might occur to your computer, software, etc. in
  249. consequence of you using this freeware program.
  250.  
  251.  
  252. Tomislav Uzelac
  253. <tuzelac@rasip.fer.hr>
  254.  
  255.