
                        AMPlifier
                       Version 2.0

                    MPEG Audio Player



   Einfhrung                Worum geht's
   Systemvoraussetzungen     Ohne das geht nichts

   Benutzung                 So funktioniert's
   Tooltypes und Parameter   Einstellungen


Einfhrung in AMPlifier

AMPlifier ist in erster Linie ein Abspielprogramm fr MPEG-Audio, kann aber
auch 16-bit Sound in verschiedenen Formaten abspielen.
Mit AMPlifier ist es nun mglich auf jedem Amiga komfortabel MPEGs abzuspielen.
AMPlifier untersttzt sowohl hardware basierende MPEG Audio Dekoder als auch
Softwaredekodierung mittels mpega.library.

   Untersttzt Hardware Decoder:

      Melody Z2, Melody1200+/pro, Peggy+, CD32 FMV


   Software Dekodierung mittels mpega.library und AHI oder X-Audio.


Features:}

  * Untersttzt Musicam bis Layer III und auch AIFF, MAUD, WAVE und RAW.

  * Grundlegende Funktionalitt, die von CD-Playern bekannt ist
    (play, pause, stop, forward, backward, skip back, skipforward)

  * Leistungsfhiges Plugin System - fr externe Visualisierungs Plugins

  * Grenvernderbare und konfigurierbare Benutzeroberflche - einfach zu
    benutzen

  * WinAMP skins (verschiedene Grafikdesigns)

  * ffnet und wechselt auf jeden "public screen" nach Wahl des Anwenders

  * Komfortable und schnelle Positionierung in einem Song mittels Slider

  * Umfangreiche Abspielliste (sortierbar)

  * Laden, Speichern und Editieren der Abspielliste

  * Zuflliges und endloses Abspielen

  * Drag and Drop von Dateien und Verzeichnissen

  * Rekursiver Scan durch Verzeichnisse, Unterverzeichnisse usw. (Drag&Drop)
    mit Abbruchmglichkeit!

  * ID3-Tag Untersttzung fr genauere und bessere Informationen zu den Songs
    (artist, title, album, year,...)

  * Spielzeit/Restzeit Anzeige

  * ARexx port

  * Commodity

  ...



Hard- und Softwarevoraussetzungen

* Amplifier luft auf allen Amigas ab AmigaOS 2.04. Da die Entwicklermaschinen
  ausschlielich OS 3.1 benutzen, und der Player an die Mglichkeiten dieser
  Betriebssystemversion angepat wurde, sollte mglichst OS 3.0 oder besser
  genutzt werden.

* AMPlifier untersttzt sowohl DSP basierende Dekoder Karten als auch eine
  reine Softwaredekodierung. Fr die Softwaredekodierung wird die
  mpega.library von Stephan Tavenard bentigt.
  Bei Hardware basierender Dekodierung mu das entsprechende MPEG Device
  eingestellt werden.


Benutzung

AMPlifier kann von der Workbench oder einer Shell aus gestartet werden.
Die Benutzeroberflche ist der eines CD-Players nachempfunden.
Im PullDown Men lt sich ein Fenster mit der Abspielliste ffnen. Es
beinhaltet die Songs, die nacheinander abgespielt werden. Durch Anklicken
eines Eintrags in der Liste kann man den Titel direkt abspielen oder auch
Titel berspringen.

Werden Songs per Drag-and-Drop auf den Player geworfen oder ber den Datei
Requester ausgewhlt, wird die Abspielliste ersetzt. Um Songs zur Liste
hinzuzufgen, werden diese auf dem Fenster der Abspielliste fallengelassen.

Daten unbekannten Formats werden grundstzlich nicht abgespielt. Man kann dies
durch einen Tooltype toleranter gestalten, um RAW-Samples (Big-Endian, MSB
first, Motorola) abzuspielen.
Durch Ziehen an der rechten unteren Ecke des Playerfensters, kann man dessen
Gre variieren.

 Mens        

 Player       
 Abspielliste 
 Konfiguration


Menpunkte

 Projekt      
 Einstellungen



Projekt}

ffnen...
  Hiermit wird ein ASL-Filerequester zur Auswahl der abzuspielenden Files
  geffnet.

Hinzufgen...
  ffnet einen ASL-Filerequester um mehrere Titel der Abspielliste
  hinzuzufgen.

Abspielliste...
  ffnet das Fenster mit der Abspielliste.

Abspielliste laden...
  Hier lt sich eine zuvor abgespeicherte Abspielliste einladen,
  welche die aktuelle Liste ersetzt.

Abspielliste speichern...
  Speichert die aktuelle Abspielliste in einer Datei.

ber
  Informationen ber den Autor und das Programm.

Verbergen
  Verstecken der Oberflche des Players. Dies ist eine sogenannte
  Commodity-Fhigkeit.
  Der versteckte Player lt sich mit dem Betriebssystem Commodity Exchange
  zurckholen.

Beenden
  Der Punkt, den Sie hoffentlich nur sehr selten benutzen: Er dient zum
  Beenden des Programms und erfllt die gleiche Funktion wie das
  Schliesssymbol des Playerfensters.


Einstellungen}

Konfiguration...
  ffnet das Konfigurationsfenster.

Zufall
  Bei Aktivierung dieses Punktes werden die Titel in einer
  Zufallsreihenfolge abgespielt.

Wiederholung
  Nach Abspielen des letzen ungespielten Titels stoppt der Player
  nicht, sondern beginnt die Liste erneut abzuspielen.

Vergehende Zeit
  Zeigt die gespielte Zeit an.

Verbleibende Zeit
  Schaltet auf Restzeit Anzeige um.

Anzeige

  Standard Oberflche}

  Info
    Schaltet die Zeile des Players, in der Informationen ber den
    laufenden Titel dargestellt werden, an bzw. ab.

  Positions-Slider
    Schaltet den Positions-Slider an bzw. ab.

  Bedienungsfeld
    Schaltet das Bedienfeld ('CD-Player-Tasten') an bzw. ab.

  Skin Oberflche}

  Skin auswhlen...
    ffnet ein Fenster mit den vorhandenen Skins um den Player ein neues
    Aussehen zu verschaffen.

Bildschirm
  ber diesen Punkt lt sich ein Fenster ffnen, in dem man zwischen den
  vorhandenen Public-Screens auswhlen kann. Auf dem gewhlten Screen wird
  dann AMPlifier seine Oberflche ffnen.

Fixieren
  Hiermit wird z.B. die Position und Gre des Player-Fensters und der
  Abspielliste fr den nchsten Programmstart gespeichert.


Player

Die Bedienung des Players ist einem CD-Player nachempfunden. Die selbe
Funktionalitt wird man auch hier wiederfinden.

Es gibt Knpfe fr Play, Stop, Pause sowie fr das berspringen
und Zurckgehen zu vorher gespielten Liedern.

Die zu spielenden Songs lassen sich mittels Dateirequester auswhlen welcher
ebenfalls eine Mehrfachauswahl (Multiselect) untersttzt.
Es ist ebenfalls moeglich das gesamte Verzeichnis ueber den Dateirequester
auszuwaehlen wenn keine Datei angewhlt wurde.

Die einfachste Mglichkeit neue Lieder zu Spielen ist das Drag-and-Drop von
Dateien oder Verzeichnissen ber den Player. Dazu braucht man lediglich eine
Datei oder auch ein Verzeichnis welches dann nach spielbaren Liedern durchsucht
wird auf das Fenster des Players werfen.


Abspielliste

In der Abspielliste werden die zu spielenden Lieder aufgelistet. Es wird zu
jedem Lied die Spielzeit und der Titel angezeigt.
Bei MPEG Dateien mit ID3 Informationen werden diese statt des Titels angezeigt.

Zum Editieren der Abspielliste finden sich an der Oberseite des Fensters
die notwendigen Funktionen. Es knnen eine oder mehrere Dateien mittels
Dateirequester ausgewhlt und damit zu der derzeitigen Liste hinzugefgt
werden. Eine Mehrfachauswahl ist auch hier mglich.
Es gibt Knpfe zum Entfernen eines Eintrages oder zum Lschen der gesamten
Liste. Ausserdem lt sich die Liste Alphabetisch Sortieren.

Solange der Player Verzeichnisse rekursiv durchsucht (Laufwerk bzw.
Verzeichnis, Unterverzeichnis, dessen Unterverzeichnisse etc.)  wird rechts
unten ein Abbruchknopf angezeigt. Sollte die Suche zu lange Dauern, kann sie
hiermit abgebrochen werden. Der Knopf verschwindet brigens im Anschlu, wenn
der komplette Verzeichnisbaum eingelesen wurde.

Bereits abgespielte Eintrge werden von Fett auf Normalschrift umgeschaltet.
Ein besonderer Genuss dieses Fensters sollte der schnelle und softscrollende
Listview sein, der natrlich mit jedem Schriftsatz zurechtkommt.


Konfiguration

 Audio I/O    
 Optionen     
 Anzeige      


Audio I/O

Seit AMPlifier 2 gibt es ein neues modulares Plugin System fr
verschiedene Eingabe und Ausgabe Module.
Diese Module sind fr die Datei-Typ Identifikation und den jeweiligen
Datenstrom zustndig. Dadurch ergibt sich, da jedes Eingabe Modul
sein eigenes Datei-Info Fenster bereitstellt (Der MPEG audio player
bietet beispielsweise den bekannten ID3-Tag Editor).

Jedes Modul besitzt eventuell ein eigenes Konfigurations Fenster wo
weitere Einstellungen vorgenommen werden knnen.

Folgende Module sind zurzeit realisiert:

Eingabe Module:

  MPEG audio player
  AIFF/MAUD player
  WAV player

Ausgabe Module:

  X-Audio/AHI Modul


MPEG audio player

ID3 Title

ID3-Tag ist ein angehngter Infoblock fr MPEG-Dateien.
Dort werden Informationen wie Titel, Interpret, Musikrichtung etc.
abgelegt.
Es kann eingestellt werden ob AMPlifier die erweiterten Daten auswerten soll.
Mit einer Konfigurationszeile lt sich das Anzeigeformat definieren.

Natrlich knnen nur Informationen angezeigt werden, wenn welche vorhanden
sind. Es gibt Werkzeuge, um diese Eintrge zu erzeugen und zu bearbeiten.
Ein in Krze erscheinender Standard wird zuknftig ebenfalls untersttzt
werden, da ID3-Tag angehngte Daten nutzt, die z.B. im Sendebetrieb erst
verfgbar werden, wenn der Song bereits abgespielt wurde.

Decoder

Hier werden die MPEG Einstellungen fr die Hardware- und Software-dekodierung
vorgenommen. Es kann getrennt fr MPEG Audio Layer I/II und fr Layer III
die Software-dekodierung eingeschaltet und konfiguriert werden.

MPEG Device
  Hier wird der MPEG Ausgabetreiber (Device) und ihre Unit-Nummer
  eingestellt. Dies ist beim Betrieb mehrerer Karten notwendig.
  Es ist beispielsweise auch ein Betrieb von zwei bereinander gesteckten
  Melody 1200 mglich. Nhere Informationen gibt es auf Anfrage.

  Fr die Melody 'melodympeg.device'.
  Peggy-Besitzer tragen hier entsprechend 'peggympeg.device' ein.

Buffersize
  Hier wird die Gre des Datei Puffers eingestellt.

Blocksize
  Die Blockgre gibt an, in wie groe Blcke der Puffer unterteilt ist.
  Der Datei Transfer geschieht dann in der angegebenen Blockgre.
  Achtung: Bei der Peggy darf der Wert nicht grer als 5 kB
  betragen.


X-Audio/AHI output

Device
  Hier wird der Ausgabetreiber und ihre Unit-Nummer eingestellt.

  X-Audio
    Der Name des Audio Devices (melodyaudio.device).

  AHI
    Nicht Melody Benutzer schalten hier auf AHI Ausgabe um.
    Es knnen auch mehrere Instanzen von AMPlifier gestartet werden und
    gleichzeitig ber AHI die Ausgabe mischen.


Buffering
  Hier wird der Audio Puffer eingestellt.

  Die Puffergre wird in Sekunden eingestellt.
  Um beim Beginn eines Titels oder nach dem Positionieren des Sliders
  kurzzeitige Aussetzer zu vermeiden ist die Vor-Puffern Einstellung.
  Hier wird angegeben, wieviel Prozent des Audio-Puffers gefllt sein mssen
  bis das Abspielen beginnt.

  Auerdem kann die Prioritt des Audio Tasks eingestellt werden.
  Empfohlen ist eine Prioritt von ber 20.


Optionen

Prfe Dateityp beim Laden
  veranlat AMPlifier schon beim Laden zu prfen, ob Dateien abspielbar sind.
  Vor dem Abspielen wird in jedem Fall kontrolliert.

Lied Verzeichnis
  Standard Lied Verzeichnis.

Titellisten Verzeichnis
  Standard Titellisten Verzeichnis.

Start Datei
  Hier kann ein Titel oder ein Verzeichnis angegeben werden welche beim
  Programmstart gestartet/eingelesen wird.

Datei Muster
  Hirmit lt sich das Suchen nach spielbaren Titeln einschrnken.
  Es werden nur Dateien angeschaut welche auf die Beschreibung passen.

Starte Abspielen
  Das Einlesen kann je nach Datenbestand sehr lange dauern. AMPlifier kann
  schonmal anfangen zu spielen, whrend die Datentrger noch nach spielbaren
  Titeln durchsucht werden. Die Zeit, wie lange abgewartet werden soll, ist
  in Sekunden einstellbar.

Anzeige

Skins
  Amplifier kann neben der traditionellen Oberflche auch die sogenannten
  Skins des auf PC's verbeiteten Players WinAMP benutzen. Diese gemalten
  Oberflchen sind leider oftmals schwer zu erkennen und besitzen nicht die
  Fhigkeit frei vergrsserbar zu sein. Sie sind bedienungstechnisch
  eingeschrnkt aber hbsch bunt. Es ist eben eine Geschmackssache.

  Bei Nutung der Skin Oberflche lt sich eine optische Anzeige in Form
  eines Volume Meter, Oscilloscope oder eines Spectrum Analyzers
  einschalten.

   (Wenn eine Melody1200 mit MPEG Hardware Unterstuetzung vorhanden
    ist, so wird die spezielle Hardware fr die graphische Anzeige
    genutzt!)

  In dieser Rubrik kann das Verzeichnis gewhlt werden, in dem sich die
  Skins befinden.
  Die aus der PC-Welt stammenden Skins sind in Echtfarben realisiert. Auf
  einem Amiga mit wenig Farben sehen sie also ggf. etwas bel aus.
  Es sei auf farbreduzierte Umrechnungen verwiesen. Sollte es Probleme mit
  der Darstellung geben, ist das picture.datatype zu alt und evtl.
  auch zu langsam.

  Sind die Skins aktiviert, erscheint ein neuer Menpunkt im Pull-Down-Men
  Einstellungen, worber diese ausgewhlt werden knnen.

Skins Verzeichnis
  Verzeichnis wo die einzelnen Skins zu finden sind.

Skin
  Aktuelles Skin

Fensterinhalt beim verschieben anzeigen
  AMPlfifier 2 untersttzt das Verschieben der Fenster in Echtzeit.
  Die Fenster folgen also der jeweiligen Mausposition automatisch.

  Die Fenster knnen brigens an irgendeiner Stelle wo sich kein
  anderes Gadget befindet angefasst werden (also nicht nur in der
  Titelleiste).

Fensterinhalt anbinden bei nn Pixeln
  Ist diese Option angeschaltet, so docken die Fenster automatisch
  aneinander an, wenn Diese einen gewissen Abstand von nn
  Pixeln erreicht haben.


