home *** CD-ROM | disk | FTP | other *** search
/ Login Magazine 68 / LoginMagazineNo68.bin / contribs / amp.txt < prev    next >
Text File  |  1999-11-07  |  5KB  |  140 lines
  1. amp MPEG audio decoder readme file (version 0.7.6)
  2. (C) Tomislav Uzelac  1996,1997
  3.  
  4. amp is free software and can be _used_ freely by anyone. If you want to
  5. do anything else with it, be sure to check the Legal section of this
  6. document for legal issues.
  7.  
  8. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  9. of this document.
  10.  
  11. 1. Introduction
  12. 2. Installation
  13. 3. Running
  14. 4. Feedback
  15. 5. Contributing
  16. 6. Legal
  17.  
  18.  
  19. 1. Introduction
  20.  
  21. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  22. putting together as a side project of the MPEG hardware design project at 
  23. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  24. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  25. defined in MPEG2), layers 2 and 3. 
  26.  
  27. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  28. available at the amp home site ftp://ftp.rasip.fer.hr
  29.  
  30. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  31.  
  32. The following people contributed their time and knowledge to amp:
  33. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  34. Edouard Lafargue, Andrew Richards, George Colouris,
  35. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  36.  
  37. amp home location is
  38.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  39.  
  40. and the mailing list: send 'HELP' in the body of the message to:
  41.     multimedia@rasip.fer.hr
  42.  
  43. If you want to find out more about MPEG, best places to start are
  44.     http://www.mpeg.org
  45.     http://www.mpeg2.de 
  46.  
  47.  
  48. 2. Installation
  49.  
  50. Installation should be simple enough if amp was ported to your system,
  51. just do a 
  52.  
  53. ./configure
  54. make 
  55.  
  56. You can edit the makefile further to suit your system. If configure fails 
  57. to make a usable Makefile, you'll _have_ to edit it yourself.
  58.  
  59. Linux users should try real-time playing support, as described
  60. in doc/realtime.txt. Some people that might pass on this feature are
  61. those with slower machines (i.e. 486's), or SMP systems (see the
  62. doc/linuxrealtime.txt file). 
  63. Some versions of the linux C library produce an error when compiling
  64. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  65. and replace _P in the offending line with __P.
  66.  
  67. ./configure --enable-realtime
  68. make
  69. chown root.root amp
  70. chmod u+s amp
  71.  
  72. ... this requires /dev/dsp to be both world readable and writeable. If you
  73. have a special group for people allowed to use the sound device (for
  74. instance, a group called sound), you can do a:
  75.  
  76. chmod g+s amp
  77.  
  78. or make your audio card world read/writeable (not recomended)
  79.  
  80. chmod o+rw /dev/dsp*
  81.  
  82. 3. Running:
  83.  
  84. 'amp -h' gives you usage & options. If your computer is on the slower
  85. side, direct playback might not work, but you can decode it
  86. to .wav or raw pcm and play it later.
  87.  
  88.  
  89. 4. Feedback
  90.  
  91. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  92. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  93.  
  94. If you find any mpeg audio files that amp has trouble decoding, please tell
  95. me about this via e-mail <tuzelac@rasip.fer.hr>.
  96.  
  97.  
  98. 5. Contributing
  99.  
  100. Please contribute to amp. If you want to know what is going on in amp 
  101. development, you can join the developers mailing list
  102.  
  103.     mpeg_audio_developers@rasip.fer.hr
  104.  
  105. There are certain debugging facilities that I made in amp, but are disabled
  106. in the current release (they are neither nice nor user-friendly). If anyone
  107. enhances them (they are in dump.c) to the point that they're actually
  108. usable I'll be happy to include the changes in the release. I think this
  109. kind of debug output would be very useful to people studying these audio
  110. algorithms.
  111.  
  112.  
  113. 6. Legal
  114.  
  115. This software can be used freely for any purpose. It can be distributed
  116. freely, as long as it is not sold commercially without permission from
  117. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  118. on CD_ROMs containing other free software is explicitly permitted even 
  119. when a modest distribution fee is charged for the CD, as long as this
  120. software is not a primary selling argument for the CD.
  121.  
  122. Building derived versions of this software is permitted, as long as they
  123. are not sold commercially without permission from Tomislav Uzelac 
  124. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  125. such, and must be called by a name other than amp. Any derived versions
  126. must retain this copyright notice.
  127.  
  128. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  129.  * not mention being copyrighted itself :)
  130.  */
  131.  
  132. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  133. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  134. any damages that might occur to your computer, software, etc. in
  135. consequence of you using this freeware program.
  136.  
  137.  
  138. Tomislav Uzelac
  139. <tuzelac@rasip.fer.hr>
  140.