amp MPEG audio decoder readme file (version 0.7)
(C) tomislav uzelac  1996,1997

amp is free software and can be _used_ freely by anyone. if you want to
do anything else with it, be sure to check the Legal section of this
document for legal issues.

THERE IS NO WARRANTY FOR THIS PROGRAM. please check out the Legal section
of this document.

0. READ THIS
1. Introduction
2. Installation
3. Running
4. Feedback
5. Contributing
6. Legal


0. READ THIS

this is the first release of amp, and it hasn't been much tested. i 
tested it with two files (both, of course, layer3):
   MPEG1, 44100Hz, ms stereo, 128 kbit/s
   MPEG2, 22050Hz, intensity stereo, 56 kbit/s 
the player is only sketchy and will work only on the fastest computers,
and .wav writing is somewhat crude as well. i wrote raw PCM files, and
played them with a simple routine for testing purposes.

if you try writing raw pcm on ultra it will be byte-swapped (ie. little
endian) as if you were writing a .wav file. to play raw pcm on ultra
the data has to be big endian, so you have to byte-swap it again. sorry.


1. Introduction

amp (Audio Mpeg Player) is an MPEG audio decoder which i originally started 
putting together as a side project of the MPEG hardware design project at 
FER/Zagreb - just to confirm my knowledge of the standard. it works with
both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
defined in MPEG2), layer3 only for now. 

there is a home page for amp
	http://www.rasip.fer.hr/research/compress/<undetermined at this time>

and it's home location
	ftp://ftp.rasip.fer.hr/pub/mpeg/amp-0.7.0.tgz

and the mailing list: send 'HELP' in the body of the message to:
	multimedia@rasip.fer.hr

if you want to find out more about MPEG, best places to start are
	http://www.mpeg.org
	http://www.mpeg2.de 


2. Installation

- edit the makefile to suit your system. 

make dep
make
(as root) mkdir /usr/local/amp
(as root) mv t/* /usr/local/amp      (see comment)
(as root) mv amp  usr/local/bin      (or wherever)   
amp

if you don't have root passwd, or you want to put the tables 
somewhere else than /usr/local/amp, you can edit huffman.c near
the beginning of huffman_init() to change the default location.
please don't complain about this as huffman tables will be 
hardcoded for version 0.8 just like all the others.

3. Running:

'amp' gives you usage & options. if your computer is on the slower
side, direct playback might not work, but you can decode it
to .wav or raw pcm and play it later.


4. Feedback

send in your makefiles, opinions, bugreports, fixes; anything related to this
program. you can also send me unlimited amounts of money, sugar, milk, etc.

If you find any mpeg audio files that amp has trouble decoding, please tell
me about this via e-mail <tuzelac@rasip.fer.hr>.


5. Contributing

please contribute to amp. you can do that either by cleaning up something i
did wrogn, or adding a new feature. one of the things amp _really_ needs
these days is some sort of a gui. any sort of platform-specific tweaking 
would be ok as well.


6. Legal

this software can be used freely for any purpose. it can be distributed
freely, as long as it is not sold commercially without permission from
tomislav uzelac <tuzelac@rasip.fer.hr>. however, including this software
on CD_ROMs containing other free software is explicitly permitted even 
when a modest distribution fee is charged for the CD, as long as this
software is not a primary selling argument for the CD.

Building derived versions of this software is permitted, as long as they
are not sold commercially without permission from tomislav uzelac 
<tuzelac@rasip.fer.hr>. any derived versions must be clearly marked as
such, and must be called by a name other than amp. any derived versions
must retain this copyright notice.

/* this license is itself copied from Tatu Ylonen's ssh package. it does 
 * not mention being copyrighted itself :)
 */

THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. you use it entirely
at your risk, and neither tomislav uzelac, nor FER will be liable for
any damages that might occur to your computer, software, etc. in
consequence of you using this freeware program.


tomislav uzelac
<tuzelac@rasip.fer.hr>
