Short:    Plays AIFF, MP2 and MP3 with Prelude
Uploader: Thomas Wenzel (wenzel@act-net.com)
Author:   Thomas Wenzel (wenzel@act-net.com)
Type:     mus/play
Version:  1.13


Neu in V1.13
------------

 - Einige kleinere Bugfixes


Neu in V1.12
------------

 - AmigaOS 3.0 Kompatibilitätsprobleme behoben


Einführung
----------
Prelude Tapedeck ist ein GUI basiertes Audio Abspielprogramm für die Prelude
Soundkarte. Es benutzt einige der Prelude-spezifischen Echtzeit Features und
läuft daher mit keiner anderen Soundkarte.

Dieses Programm erkennt automatisch eine PowerUP Umgebung und benutzt dann
den PPC, um MPEG-audio Layer 2 und 3 in Echtzeit mit sehr geringer
Systemlast auf der 68k Seite zu dekodieren.

Unterstützte Dateiformate sind:

 - AIFF 16 bit stereo (68030 oder besser)
 - MPEG-audio j-stereo oder dual-ch (PowerPC erforderlich!)
 * Das ist alles! (Bitte nicht versuchen, andere Dateien abzuspielen! :-)

Benutzung
---------
Nun ja, es funktioniert wie die Mischung aus einem Tapedeck und CD Player :-)
Die Knöpfe in der unteren Reihe sind:

 - Netz
   schaltet das Tapedeck aus und beendet das Programm

 - Aussteuerung
   regelt die Aussteuerung, oberer Regler für linken Kanal, unterer
   Regler für rechten Kanal

 - Auswurf
   löscht die aktuelle Wiedergabeliste und öffnet einen Dateirequester
   um eine oder mehrere neue Dateien auszuwählen

 - Schneller Rücklauf
   im aktuellen Stück zurückspulen, funktioniert nur während der Wiedergabe

 - Stop
   stoppt die Wiedergabe und springt zum Anfang des Stückes zurück

 - Play/Pause
   schaltet zwischen Wiedergabe und Pause um

 - Schneller Vorlauf
   im aktuellen Stück vorspulen, funktioniert nur während der Wiedergabe

 - Aufnahme
   löscht die aktuelle Wiedergabeliste und öffnet einen Dateirequester
   um eine neue Datei für die Aufnahme auszuwählen
   Das Tapedeck befindet sich danach im Aufnahme-Pause-Modus, damit die
   Aussteuerung in Ruhe eingestellt werden kann und beginnt mit der Aufnahme,
   wenn die Play/Pause-Taste gedrückt wird.

Die Knöpfe direkt unter der Anzeige sind:

 - MODE
   wechselt den Anzeigemodus des Echtzeit-Zählwerkes

 - INPUT
   schaltet zwischen den drei Aufnahme-Eingängen der Prelude um

 - FREQ
   wechselt die Aufnahmefrequenz, funktioniert nur bei gestopptem Tapedeck

 - PEAK
   setzt den Spitzenwert zurück, der rechts neben der Aussteuerungsanzeige
   angezeigt wird

 - SKIP BACK
   springt ein Stück zurück

 - SKIP FORWARD
   springt ein Stück vor

Voraussetzungen
---------------
asyncio.library v39.x oder höher (Aminet:dev/c/AsyncIO.lha)
prelude.library v3.4 oder höher (v3.4 ist mit dabei)
64KB Stack

Bekannte Fehler
---------------
Die Grafik sieht auf ECS oder AGA kaputt aus, es funktioniert jedoch
problemlos mit CyberGraphX UND Picasso96. Abhilfe: Grafikkarte kaufen :-)

Rechtliches
-----------
Prelude Tapedeck ist Freeware, das Copyright liegt beim Autor.  Es darf frei
kopiert werden, solange keine Änderungen am Code oder der Dokumentation
vorgenommen werden.  Eine (vertretbare) Gebühr zur Deckung der Kopierkosten
darf erhoben werden.

Prelude Tapedeck darf nicht für kommerzielle Zwecke verwendet werden, es
darf auch nicht in kommerziellen Distribtutionen vertrieben werden, ohne daß
hierfür eine schriftliche Einverständniserklärung des Autors vorliegt.  Es
darf nicht auf ftp- oder Webservern abgelegt werden, die kommerzielle
Software oder Treiber für kommerzielle Hardware anbieten.  Die einzige
Ausnahme sind die Server des Aminet Archivs.

Es wird keine Verantwortung für Schäden an Lautsprechern, Verstärkern,
Amigas oder anderen Komponenten sowie Daten, die durch die Verwendung von
Prelude Tapedeck berührt werden könnten, übernommen.

Obwohl ich ausgiebige Betatests vorgenommen habe, kann ich nicht
garantieren, daß Prelude Tapedeck unter allen Umständen immer überall völlig
problemlos funktioniert.  Wenn Sie also Fehler oder Probleme entdecken,
lassen Sie es mich bitte wissen.

Prelude Tapedeck benutzt den AMP decoder von Tomislav Uzelac für die MPEG-
audio Wiedergabe. Der original Text zu AMP folgt...


amp MPEG audio decoder readme file (version 0.7.5)
(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.

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


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), layers 2 and 3. 

There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
available at the amp home site ftp://ftp.rasip.fer.hr

Another gui supported is the Sajber Jukebox, written by Joel Lindholm.

The following people contributed their time and knowledge to amp:
Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
Edouard Lafargue, Andrew Richards, George Colouris,
Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel

amp home location is
	ftp://ftp.rasip.fer.hr/pub/mpeg/

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

Installation should be simple enough if amp was ported to your system,
just do a 

./configure
make 

You can edit the makefile further to suit your system. If configure fails 
to make a usable Makefile, you'll _have_ to edit it yourself.

Linux users should try real-time playing support, as described
in doc/realtime.txt. Some people that might pass on this feature are
those with slower machines (i.e. 486's), or SMP systems (see the
doc/linuxrealtime.txt file). 
Some versions of the linux C library produce an error when compiling
amp with realtime support. A quick fix is to edit /usr/include/sched.h
and replace _P in the offending line with __P.

./configure --enable-realtime
make
chown root.root amp
chmod u+s amp

... this requires /dev/dsp to be both world readable and writeable. If you
have a special group for people allowed to use the sound device (for
instance, a group called sound), you can do a:

chmod g+s amp

or make your audio card world read/writeable (not recomended)

chmod o+rw /dev/dsp*

3. Running:

'amp -h' 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. If you want to know what is going on in amp 
development, you can join the developers mailing list

	mpeg_audio_developers@rasip.fer.hr

There are certain debugging facilities that I made in amp, but are disabled
in the current release (they are neither nice nor user-friendly). If anyone
enhances them (they are in dump.c) to the point that they're actually
usable I'll be happy to include the changes in the release. I think this
kind of debug output would be very useful to people studying these audio
algorithms.


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>

