@DATABASE "AMPlifier.guide"
@AUTHOR "Thorsten Hansen"
@-WORDWRAP

@NODE MAIN "AMPlifier Dokumentation"

                        @{b}AMPlifier@{ub}
                      Version 1.48

                    MPEG Audio Player

                 © 1998 Thorsten Hansen
                    @{i}Kato Development@{ui}

                http://kato.home.pages.de

@{JLEFT}
  @{" Einführung              " LINK INTRODUCTION}   Worum geht's
  @{" Systemvoraussetzungen   " LINK REQUIREMENTS}   Ohne das geht nichts

  @{" Benutzung               " LINK USAGE}   So funktioniert's
  @{" Tooltypes und Parameter " LINK CONFIG}   Einstellungen
  @{" ARexx                   " LINK AREXX}   ARexx Port

  @{" Registrierung           " LINK REGISTRATION}   Vollversion

@ENDNODE


@NODE INTRODUCTION "Einführung"
@TOC MAIN
@{b}Einführung in AMPlifier@{ub}

AMPlifier ist in erster Linie ein Abspielprogramm für MPEG-Audio, kann aber
auch 16-bit Sound in verschiedenen Formaten abspielen.
Mit AMPlifier ist es nun möglich auf jedem Amiga komfortabel MPEGs abzuspielen.
AMPlifier unterstützt sowohl hardware basierende MPEG Audio Dekoder als auch
Softwaredekodierung mittels mpega.library.

   Unterstützt Hardware Decoder:

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


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


@{u}Features:@{uu}

  * Unterstützt Musicam bis Layer III und auch AIFF, MAUD, WAVE und RAW.

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

  * Größenveränderbare und konfigurierbare Benutzeroberfläche - 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

  * Zufälliges und endloses Abspielen

  * Drag and Drop von Dateien und Verzeichnissen

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

  * ID3-Tag Unterstützung für genauere und bessere Informationen zu den Songs
    (artist, title, album, year,...)

  * Spielzeit/Restzeit Anzeige

  * ARexx port

  * Commodity

  ...


@ENDNODE


@NODE REQUIREMENTS "Hardwarevoraussetzungen"
@TOC MAIN
@{b}Hard- und Softwarevoraussetzungen@{ub}

* Amplifier läuft auf allen Amigas ab AmigaOS 2.04. Da die Entwicklermaschinen
  ausschließlich OS 3.1 benutzen, und der Player an die Möglichkeiten dieser
  Betriebssystemversion angepaßt wurde, sollte möglichst OS 3.0 oder besser
  genutzt werden.

* AMPlifier unterstützt sowohl DSP basierende Dekoder Karten als auch eine
  reine Softwaredekodierung. Für die Softwaredekodierung wird die
  @{b}mpega.library@{ub} von Stephan Tavenard benötigt.
  Bei Hardware basierender Dekodierung muß das entsprechende MPEG Device
  eingestellt werden.

@ENDNODE


@NODE USAGE "Benutzung"
@TOC MAIN
@{b}Benutzung@{ub}

AMPlifier kann von der Workbench oder einer Shell aus gestartet werden.
Die Benutzeroberfläche ist der eines CD-Players nachempfunden.
Im PullDown Menü läßt 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 ausgewählt, wird die Abspielliste ersetzt. Um Songs zur Liste
hinzuzufügen, werden diese auf dem Fenster der Abspielliste fallengelassen.

Daten unbekannten Formats werden grundsätzlich 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
Größe variieren.

@{" Menüs         " LINK MENUS}

@{" Player        " LINK WIN_PLAYER}
@{" Abspielliste  " LINK WIN_PLAYLIST}
@{" Konfiguration " LINK WIN_CONFIG}

@ENDNODE

@NODE MENUS "Menues"
@TOC USAGE
@{b}Menüpunkte@{ub}

@{" Projekt       " LINK MENU_PROJECT}
@{" Einstellungen " LINK MENU_SETTINGS}

@ENDNODE

@NODE MENU_PROJECT "Projekt"

@{b}@{u}Projekt@{uu}@{ub}

@{b}Öffnen...@{ub}
  Hiermit wird ein ASL-Filerequester zur Auswahl der abzuspielenden Files
  geöffnet.

@{b}Hinzufügen...@{ub}
  Öffnet einen ASL-Filerequester um mehrere Titel der Abspielliste
  hinzuzufügen.

@{b}Abspielliste...@{ub}
  Öffnet das Fenster mit der Abspielliste.

@{b}Abspielliste laden...@{ub}
  Hier läßt sich eine zuvor abgespeicherte Abspielliste einladen,
  welche die aktuelle Liste ersetzt.

@{b}Abspielliste speichern...@{ub}
  Speichert die aktuelle Abspielliste in einer Datei.

@{b}Über@{ub}
  Informationen über den Autor und das Programm.

@{b}Verbergen@{ub}
  Verstecken der Oberfläche des Players. Dies ist eine sogenannte
  Commodity-Fähigkeit.
  Der versteckte Player läßt sich mit dem Betriebssystem Commodity Exchange
  zurückholen.

@{b}Beenden@{ub}
  Der Punkt, den Sie hoffentlich nur sehr selten benutzen: Er dient zum
  Beenden des Programms und erfüllt die gleiche Funktion wie das
  Schliesssymbol des Playerfensters.

@ENDNODE

@NODE MENU_SETTINGS "Einstellungen"

@{b}@{u}Einstellungen@{uu}@{ub}

@{b}Konfiguration...@{ub}
  Öffnet das Konfigurationsfenster.

@{b}Zufall@{ub}
  Bei Aktivierung dieses Punktes werden die Titel in einer
  Zufallsreihenfolge abgespielt.

@{b}Wiederholung@{ub}
  Nach Abspielen des letzen ungespielten Titels stoppt der Player
  nicht, sondern beginnt die Liste erneut abzuspielen.

@{b}Vergehende Zeit@{ub}
  Zeigt die gespielte Zeit an.

@{b}Verbleibende Zeit@{ub}
  Schaltet auf Restzeit Anzeige um.

@{b}Anzeige@{ub}

  @{u}Standard Oberfläche@{uu}

  @{b}Info@{ub}
    Schaltet die Zeile des Players, in der Informationen über den
    laufenden Titel dargestellt werden, an bzw. ab.

  @{b}Positions-Slider@{ub}
    Schaltet den Positions-Slider an bzw. ab.

  @{b}Bedienungsfeld@{ub}
    Schaltet das Bedienfeld ('CD-Player-Tasten') an bzw. ab.

  @{u}Skin Oberfläche@{uu}

  @{b}Skin auswählen...@{ub}
    Öffnet ein Fenster mit den vorhandenen Skins um den Player ein neues
    Aussehen zu verschaffen.

@{b}Bildschirm@{ub}
  Über diesen Punkt läßt sich ein Fenster öffnen, in dem man zwischen den
  vorhandenen Public-Screens auswählen kann. Auf dem gewählten Screen wird
  dann AMPlifier seine Oberfläche öffnen.

@{b}Fixieren@{ub}
  Hiermit wird z.B. die Position und Größe des Player-Fensters und der
  Abspielliste für den nächsten Programmstart gespeichert.

@ENDNODE

@NODE WIN_PLAYER "Player"
@TOC USAGE
@{b}Player@{ub}

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

Es gibt Knöpfe für @{i}Play@{ui}, @{i}Stop@{ui}, @{i}Pause@{ui} sowie für das Überspringen
und Zurückgehen zu vorher gespielten Liedern.

Die zu spielenden Songs lassen sich mittels Dateirequester auswählen welcher
ebenfalls eine Mehrfachauswahl (Multiselect) unterstützt.

Die einfachste Möglichkeit 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.

@ENDNODE

@NODE WIN_PLAYLIST "Playlist"
@TOC USAGE
@{b}Abspielliste@{ub}

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 können eine oder mehrere Dateien mittels
Dateirequester ausgewählt und damit zu der derzeitigen Liste @{b}hinzugefügt@{ub}
werden. Eine Mehrfachauswahl ist auch hier möglich.
Es gibt Knöpfe zum @{b}Entfernen@{ub} eines Eintrages oder zum @{b}Löschen@{ub} der gesamten
Liste. Ausserdem läßt sich die Liste Alphabetisch @{b}Sortieren@{ub}.

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 Einträge werden von Fett auf Normalschrift umgeschaltet.
Ein besonderer Genuss dieses Fensters sollte der schnelle und softscrollende
Listview sein, der natürlich mit jedem Schriftsatz zurechtkommt.

@ENDNODE

@NODE WIN_CONFIG "Konfiguration"
@TOC USAGE
@{b}Konfiguration@{ub}

@{" Allgemein     " LINK CFG_GENERAL}
@{" Anzeige       " LINK CFG_DISPLAY}
@{" Ausgabe       " LINK CFG_Output}
@{" MPEG          " LINK CFG_MPEG}

@ENDNODE

@NODE CFG_GENERAL "Allgemein"
@TOC WIN_CONFIG
@{b}Allgemein@{ub}

@{b}@{u}Laden@{uu}@{ub}

@{b}Prüfe Dateityp beim Laden@{ub}
  veranlaßt AMPlifier schon beim Laden zu prüfen, ob Dateien abspielbar sind.
  Vor dem Abspielen wird in jedem Fall kontrolliert.

@{b}ID3-Tag Info@{ub}
  ID3-Tag ist ein angehängter Infoblock für MPEG-Dateien.
  Dort werden Informationen wie Titel, Interpret, Musikrichtung etc.
  abgelegt. Es kann eingestellt werden ob AMPlifier die erweiterten Daten
  auswerten soll und ob dies schon beim Einlesen der Dateien geschehen soll.
  Mit einer Konfigurationszeile läßt sich das Anzeigeformat definieren.

  Natürlich können nur Informationen angezeigt werden, wenn welche vorhanden
  sind. Es gibt Werkzeuge, um diese Einträge zu erzeugen und zu bearbeiten.
  Ein in Kürze erscheinender Standard wird zukünftig ebenfalls unterstützt
  werden, da ID3-Tag angehängte Daten nutzt, die z.B. im Sendebetrieb erst
  verfügbar werden, wenn der Song bereits abgespielt wurde.

@{b}Starte Abspielen@{ub}
  Das Einlesen kann je nach Datenbestand sehr lange dauern. AMPlifier kann
  schonmal anfangen zu spielen, während die Datenträger noch nach spielbaren
  Titeln durchsucht werden. Die Zeit, wie lange abgewartet werden soll, ist
  in Sekunden einstellbar.

@{b}@{u}Versch.@{uu}@{ub}

@{b}Lied Verzeichnis@{ub}
  Standard Lied Verzeichnis.

@{b}Titellisten Verzeichnis@{ub}
  Standard Titellisten Verzeichnis.

@{b}Start Datei@{ub}
  Hier kann ein Titel oder ein Verzeichnis angegeben werden welche beim
  Programmstart gestartet/eingelesen wird.

@{b}Datei Muster@{ub}
  Hirmit läßt sich das Suchen nach spielbaren Titeln einschränken.
  Es werden nur Dateien angeschaut welche auf die Beschreibung passen.

@{b}Aktivieren mit Doppelklick@{ub}
  Möchte man die Abspielliste Editieren wärend der Player im Hintergrund
  spielt so kann es störend sein, daß beim Anwählen eines Eintrages in der
  Abspiellieste dieser sofort gespielt wird. Diese Option aktiviert einen
  Eintrag erst nach einem Doppelklick.

@{b}Scroll Titel@{ub}
  Der Platz für den Titelnamen reicht oftmals nicht aus um ihn vollständig
  darzustellen. Hirmit kann eingestellt werden, ob der Titel als
  Laufschrift gescrollt werden soll.

@ENDNODE

@NODE CFG_DISPLAY "Anzeige"
@TOC WIN_CONFIG
@{b}Anzeige@{ub}

@{b}Skins@{ub}
  Amplifier kann neben der traditionellen Oberfläche auch die sogenannten
  Skins des auf PC's verbeiteten Players WinAMP benutzen. Diese gemalten
  Oberflächen sind leider oftmals schwer zu erkennen und besitzen nicht die
  Fähigkeit frei vergrösserbar zu sein. Sie sind bedienungstechnisch
  eingeschränkt aber hübsch bunt. Es ist eben eine Geschmackssache.

  Bei Nutung der Skin Oberfläche läßt sich eine optische Anzeige in Form
  eines @{i}Volume Meter@{ui}, @{i}Oscilloscope@{ui} oder eines @{i}Spectrum Analyzers@{ui}
  einschalten.

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

  In dieser Rubrik kann das Verzeichnis gewählt 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 @{b}picture.datatype@{ub} zu alt und evtl.
  auch zu langsam.

  Sind die Skins aktiviert, erscheint ein neuer Menüpunkt im Pull-Down-Menü
  @{i}Einstellungen@{ui}, worüber diese ausgewählt werden können.

@ENDNODE

@NODE CFG_OUTPUT "Ausgabe"
@TOC WIN_CONFIG
@{b}Ausgabe@{ub}

@{b}Ausgabegerät@{ub}
  Es lassen sich die Ausgabetreiber (Device) und ihre Unit-Nummer sowohl für
  MPEG DSP Karten als auch für Audio Ausgabe einstellen.
  Dies ist beim Betrieb mehrerer Karten notwendig.
  Es ist beispielsweise auch ein Betrieb von zwei übereinander gesteckten
  Melody 1200 möglich. Nähere Informationen gibt es auf Anfrage.

  @{b}MPEG@{ub}
    Für die Melody 1200 pro und plus 'mel1200mpeg.device'.
    Peggy-Besitzer tragen hier entsprechend 'peggympeg.device' ein.

  @{b}Audio@{ub}
    Der Name des Audio Devices (mel1200audio.device).

  @{b}Benutze AHI@{ub}
    Nicht Melody Benutzer schalten hier auf AHI Ausgabe um.
    Es koennen auch mehrere Instanzen von AMPlifier gestartet werden und
    gleichzeitig über AHI die Ausgabe mischen.

@{b}Datei Puffer@{ub}
  Hier wird die Größe des Datei Puffers eingestellt.
  Die Blockgröße gibt an, in wie große Blöcke der Puffer unterteilt ist.
  Der Datei Transfer geschieht dann in der angegebenen Blockgröße.
  @{i}Achtung:@{ui} Bei der Peggy darf der Wert nicht größer als 5 kB
  betragen.

@{b}Audio@{ub}
  Hier wird der Audio @{b}Puffer@{ub} eingestellt. Diese Einstellung wird bei MPEG
  Hardware Dekodierung ignoriert. Sie gilt für die Softwaredekodierung und
  für das Abspielen von anderen Audio Dateien.

  Die Puffergröße wird in Sekunden eingestellt.
  Um beim Beginn eines MPEG Titels oder nach dem Positionieren des Sliders
  kurzzeitige Aussetzer zu vermeiden ist die @{b}Vor-Puffern@{ub} Einstellung.
  Hier wird angegeben, wieviel Prozent des Audio-Puffers gefüllt sein müssen
  bis das Abspielen beginnt.

  Außerdem kann die @{b}Priorität@{ub} des Audio Tasks eingestellt werden.
  Empfohlen ist eine Priorität von über 20.

@ENDNODE

@NODE CFG_MPEG "MPEG"
@TOC WIN_CONFIG
@{b}MPEG@{ub}

Hier werden die MPEG Einstellungen für die Softwaredekodierung vorgenommen.
Es kann getrennt für MPEG Audio Layer I/II und für Layer III die Software-
dekodierung eingeschaltet und konfiguriert werden.

@{i}Achtung:@{ui} Für die DSP basierende MPEG Dekodierung darf die Option @{b}nicht@{ub}
         eingeschaltet sein.

@ENDNODE

@NODE CONFIG "Konfiguration"
@TOC MAIN
@{b}Einstellungen und Parameter@{ub}

Es lassen sich diverse Optionen mittels Tooltypes einstellen oder per Shell
als Argument übergeben.

Folgende Tooltypes sind im Programm Icon einstellbar:

@{b}CONFIG=Prefsfile@{ub}
  Hier kann die Datei gewählt werden in der AMPlifier seine Einstellungen
  speichert. Dies ist beim betrieb von mehreren Instanzen mit
  unterschiedlicher Konfiguration Sinnvoll.
  (Default: ENVARC:AMPlifier.prefs)

@{b}CX_POPUP=Yes/No@{ub}
  Wenn auf 'No' gesetzt erscheint nach dem Programmstart anstatt der
  Oberfläche ein AppIcon.

@{b}CX_POPKEY=Hotkey@{ub}
  Definiert die Tastenkombination um die Programmoberfläche zu öffnen.
  Voreingestellt ist @{i}shift-F1@{ui}.

@{b}CX_PRIORITY=pri@{ub}
  Definiert die Priorität des Commodities.

@{b}MPEGDevice=MPEGDeviceName@{ub}
  Hier wird der Device Name der entsprechenden MPEG Hardware eingetragen.
  Für die Melody 1200 pro und plus 'mel1200mpeg.device'.
  Peggy-Besitzer tragen hier entsprechend 'peggympeg.device' ein.

@{b}MPEGUnit=Nummer@{ub}
  Identifikation von mehreren MPEG Karten. (normal 0)

@{b}AudioDevice=AudioDeviceName@{ub}
  Hier wird der Device Name der entsprechenden Audio Hardware eingetragen.
  Für die Melody 1200 'mel1200audio.device'.

@{b}AudioUnit=Nummer@{ub}
  Identifikation von mehreren MPEG Karten. (normal 0)

@{b}BuffSize=Puffergröße in Bytes@{ub}
  Anzahl der der Bytes die zur Pufferung des Datenstroms eingesetzt werden.

@{b}BlockSize=Größe eines einzelnen Pufferblock@{ub}
  Anzahl der der Bytes die in einem Stück vom Datenstrom in das Device
  geschrieben werden.
  Ausreichend sind 32kb.
  @{i}Achtung:@{ui} Bei der Peggy aufgrund eines Fehlers im Device nicht mehr
           als 5000 eintragen.

@{b}noAppIcon@{ub}
  Der Player läßt kein AppIcon auf der Workbench erscheinen

@{b}PubScreen=ScreenName@{ub}
  Hier kann ein beliebiger Public Screen eingetragen werden, auf den
  AMPlifier geöffnet werden soll.

@{b}AudioPri=Priorität@{ub}
  Hier kann die Priorität des Audiotasks eingestellt werden. (default 21)

@{b}RemainingTime@{ub}
  Der Player zeigt nicht mehr die gespielte Zeit, sondern die Restzeit an.

@{b}Pattern=#?.(MP2|AIFF|WAV|MAUD)@{ub}
  Im Dateirequester werden nur die Files mit der hier definierten Endung
  angezeigt.

@{b}Random@{ub}
  Der Player spielt die Einträge der Abspielliste nicht mehr nacheinander
  sondern in zufälliger Reihenfolge ab.

@{b}Loop@{ub}
  Der Player stopt nicht, nachdem die Abspielliste komplett abgespielt
  wurde, sondern arbeitet die Liste erneut ab.

@{b}CDDA@{ub}
  Wird CDDA aktiviert, so ist es möglich Titel, welche keinen Header haben,
  abzuspielen. Ist dieses Flag nicht aktiviert, wird Amplifier gewisse Songs
  schlicht ignorieren und so ein Rauschen verhindern.

@{b}CDDAIntel@{ub}
  Für CDDA-Daten (RAW) gibt es zwei verschiedene Kodierungen, die ihren
  Ursprung ganz unten auf Prozessorebene haben. Dieses Flag ermöglicht das
  Spielen von Daten, die aus Sicht des im Amiga verwendeten Prozessors
  verdreht sind. Wenn es beim Abspielen nur rauscht einschalten bzw.
  ausschalten.

@{b}StopBeforeScan@{ub}
  Bevor AMPlifier einen neuen Titel spielt wird dieser erstmal gescheckt,
  ob dieser auch spielbar ist. Wenn gleichzeitig ein anderer Titel gespielt
  wird kann dies bei sehr langsamen Datentraegern etwas dauern.
  Mit dieser Option eingeschaltet wird zuerst der alte Titel gestoppt bevor
  der neue eingelesen wird.

@{b}Visual=1,2,3@{ub}
  Hier kann die optische Anzeige gewählt werden die bei der Nutzung der Skin
  Oberfläche angezeigt wird.
  1=Volume Meter, 2=Oscilloscope, 3=Spectrum Analyzer

@{b}SAScale=spectrum scale@{ub}
  Hier kann die Skalierung des Frequenzbereichs vom Spectrum Analyzer Effekt
  eingestellt werden.

@{b}VisualPri=pri@{ub}
  Hier kann die Priorität des Visualtasks eingestellt werden.

Viele Optionen stehen als Shell-Argumente zur verfügung.
Die bedeutung ist mit dem WB-Tooltypes identisch.

    FILENAME=StartFile
    CONF=CONFIGFILE
    DEV=DEVICENAME
    U=UNIT
    BUFF=BUFFERSIZE
    BLOCK=BLOCKSIZE
    PS=PUBLICSCREEN


@ENDNODE

@NODE AREXX "ARexx"
@TOC MAIN

@{b}AMPlifier ARexx-Port@{ub}

Der ARexx-Port von AMPlifier ist unter @{b}AMPLIFIER.1@{ub} ansprechbar. Weitere
gestartete Instanzen von AMPlifier erhalten den Namen @{b}AMPLIFIER.2@{ub} usw.

Folgende ARexx-Befehle stehen zur Verfügung:

   @{" QUIT          " LINK QUIT}   Beendet das Programm
   @{" HIDEGUI       " LINK HIDEGUI}   Anzeige verbergen
   @{" SHOWGUI       " LINK SHOWGUI}   Anzeige öffnen
   @{" OPEN          " LINK OPEN}   Öffnet einen Titel
   @{" PLAY          " LINK PLAY}   Starte Abspielen
   @{" STOP          " LINK STOP}   Stoppe Abspielen
   @{" PLAYPAUSE     " LINK PLAYPAUSE}   Wechsel von Play/Pause
   @{" PAUSE         " LINK PAUSE}   Pausieren
   @{" PLAYNEXT      " LINK PLAYNEXT}   Spielt nächsten Titel
   @{" PLAYPREV      " LINK PLAYPREV}   Spielt vorigen Titel
   @{" SELECT        " LINK SELECT}   Wählt Titel in der Abspielliste
   @{" QUERYSELECTED " LINK QUERYSELECTED}   Gibt Informationen über angewählten Titel
   @{" SEEK          " LINK SEEK}   Setzt die Spielposition
   @{" VOLUME        " LINK VOLUME}   Setzen/Abfragen der Lautstärke
   @{" WAIT          " LINK WAIT}   Warten auf Liedende
   @{" WAITABORT     " LINK WAITABORT}   WAIT abbrechen
   @{" ADD           " LINK ADD}   Dateinen/Verzeichnisse hinzufügen
   @{" REM           " LINK REM}   Titel aus Abspielliste entfernen
   @{" CLEAR         " LINK CLEAR}   Löscht die Abspielliste
   @{" SORTLIST      " LINK SORTLIST}   Sotiert die Abspielliste

   @{" PLAYSTATE     " LINK PLAYSTATE}   Zustand des Players abfragen
   @{" GETTIME       " LINK GETTIME}   Spielzeit abfragen
   @{" GETLENGTH     " LINK GETLENGTH}   Länge des Titels abfragen
   @{" GETTAGINFO    " LINK GETTAGINFO}   ID3-TAG Informationen abfragen

@ENDNODE


@NODE QUIT "QUIT"
@TOC AREXX

@{b}@{u}QUIT@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Beendet das Programm

@ENDNODE

@NODE HIDEGUI "HIDEGUI"
@TOC AREXX

@{b}@{u}HIDEGUI@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Verbirgt die Benutzeroberfläche

@ENDNODE

@NODE SHOWGUI "SHOWGUI"
@TOC AREXX

@{b}@{u}SHOWGUI@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Öffnet die Benutzeroberfläche

@ENDNODE

@NODE OPEN "OPEN"
@TOC AREXX

@{b}@{u}OPEN@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    TITLE/A

@{i}Beschreibung@{ui}
    Öffnet den Titel mit dem angegebenen Dateinamen.

@ENDNODE

@NODE PLAY "PLAY"
@TOC AREXX

@{b}@{u}PLAY@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    TITLE,INDEX/N/K

@{i}Beschreibung@{ui}
    Ohne Argument wird der aktuelle Titel abgespielt;
    mit Argument wird die entsprechende Datei geladen und abgespielt.
    Mit dem Index Argument wird die enstrechende Nummer in der
    Abspielliste gespielt.

@ENDNODE

@NODE STOP "STOP"
@TOC AREXX

@{b}@{u}STOP@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Stoppt das Abspielen des aktuellen Titels.

@ENDNODE

@NODE PLAYPAUSE "PLAYPAUSE"
@TOC AREXX

@{b}@{u}PLAYPAUSE@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Schaltet nach jedem Aufruf zwischen Play und Pause um.

@ENDNODE

@NODE PAUSE "PAUSE"
@TOC AREXX

@{b}@{u}PAUSE@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Hält das Abspielen des aktuellen Titels an.

@ENDNODE

@NODE PLAYNEXT "PLAYNEXT"
@TOC AREXX

@{b}@{u}PLAYNEXT@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Spielt den nächsten Titel in der Abspielliste.
    Ist der Zuffals-Modus aktiviert, so wird ein zuffälliger Titel
    gespielt.

@ENDNODE

@NODE PLAYPREV "PLAYPREV"
@TOC AREXX

@{b}@{u}PLAYPREV@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Spielt den vorigen Titel.

@ENDNODE

@NODE SELECT "SELECT"
@TOC AREXX

@{b}@{u}SELECT@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    INDEX/N/K,NEXT/S,PREV=PREVIOUS/S,TOP/S,BOTTOM/S

@{i}Beschreibung@{ui}
    Wählt Titel in der Abspielliste.

@ENDNODE

@NODE QUERYSELECTED "QUERYSELECTED"
@TOC AREXX

@{b}@{u}QUERYSELECTED@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    PLAYED/S,INDEX/S,NAME/S,LABEL/S

@{i}Beschreibung@{ui}
    Gibt Informationen über den angewählten Titel in der Abspielliste
    zurück.

@ENDNODE

@NODE SEEK "SEEK"
@TOC AREXX

@{b}@{u}SEEK@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    SEC/N/A

@{i}Beschreibung@{ui}
    Setzt die Spielzeit des aktuellen Titels in Sekunden.

@ENDNODE

@NODE VOLUME "VOLUME"
@TOC AREXX

@{b}@{u}VOLUME@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    LEVEL/N

@{i}Beschreibung@{ui}
    Einstellen der Lautstärke (0-64).
    Ohne Argument wird die aktuelle Lautstärke zurückgegeben.

@ENDNODE

@NODE WAIT "WAIT"
@TOC AREXX

@{b}@{u}WAIT@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Dieser Befehl wartet solange bis der aktuelle Titel abgespielt wurde.

@ENDNODE

@NODE WAITABORT "WAITABORT"
@TOC AREXX

@{b}@{u}WAITABORT@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Bricht den @{" WAIT " LINK WAIT} Befehl ab.

@ENDNODE

@NODE ADD "ADD"
@TOC AREXX

@{b}@{u}ADD@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    TITLES/M

@{i}Beschreibung@{ui}
    Fügt mehrere Dateien oder Verzeichnisse der Abspielliste hinzu.

@ENDNODE

@NODE REM "REM"
@TOC AREXX

@{b}@{u}REM@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Entfernt Titel aus der Abspielliste.

@ENDNODE

@NODE CLEAR "CLEAR"
@TOC AREXX

@{b}@{u}CLEAR@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Löscht die Abspielliste.

@ENDNODE

@NODE SORTLIST "SORTLIST"
@TOC AREXX

@{b}@{u}SORTLIST@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Sortiert die Abspielliste alphabetisch.

@ENDNODE

@NODE PLAYSTATE "PLAYSTATE"
@TOC AREXX

@{b}@{u}PLAYSTATE@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Zustand des Players abfragen.

@{i}Rückgabewert@{ui}
    1=Stop
    2=Pause
    3=Wiedergabe

@ENDNODE

@NODE GETTIME "GETTIME"
@TOC AREXX

@{b}@{u}GETTIME@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Aktuelle Spielzeit abfragen.

@{i}Rückgabewert@{ui}
    Spielzeit in Sekunden.

@ENDNODE

@NODE GETLENGTH "GETLENGTH"
@TOC AREXX

@{b}@{u}GETLENGTH@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    -

@{i}Beschreibung@{ui}
    Länge des aktuellen Titels abfragen.

@{i}Rückgabewert@{ui}
    Titellänge in Sekunden.

@ENDNODE

@NODE GETTAGINFO "GETTAGINFO"
@TOC AREXX

@{b}@{u}GETTAGINFO@{uu}@{ub}

@{i}Befehlsmuster@{ui}
    STEM/K

@{i}Beschreibung@{ui}
    Gibt in der angegebenen Variable ID3-TAG Informationen über den
    aktuellen Titel zurück.

@{i}Rückgabewert@{ui}
    READY    0 - keine ID3-TAG Informationen vorhanden.
             1 - die folgenden Informationen sind vorhanden und können
                 abgefragt werden.
    TITLE    Titel
    ARTIST   Interpret
    ALBUM    Album
    YEAR     Jahr
    COMMENT  Kommentar
    GENRE    Kategorie

@{i}Beispiel@{ui}

    OPTIONS RESULTS

    ADDRESS AMPLIFIER.1

    GETTAGINFO STEM tag

    IF tag.ready = "1" THEN DO
      SAY "Title:" tag.title
      SAY "Artist:" tag.artist
      SAY "Album:" tag.album
      SAY "Year:" tag.year
      SAY "Comment:" tag.comment
      SAY "Genre:" tag.genre
    END

@ENDNODE

@NODE REGISTRATION "Registrierung"
@TOC MAIN

@{b}Registrierung@{ub}

@{u}Melody Benutzer@{uu}
Solten Sie stolzer Besitzer einer Melody Z2/Melody 1200 Soundkarte sein,
dann ist AMPlifier uneingeschränkt für Sie nutzbar und Sie brauchen sich
nicht registrieren.

@{u}Alle Anderen@{uu}
AMPlifier ist Shareware. Wenn Sie das Programm länger als zwei Wochen
nutzen, müssen Sie sich Registrieren lassen.

Die Shareware-Gebühr beträgt 30 DM.

Registrierte Benutzer erhalten von mir ein persönliches Keyfile. Im Keyfile
sind Ihre Daten gespeichert.
Das Keyfile darf nur auf einem Rechner installiert sein und auf keinen Fall
weitergegeben werden.

Das Keyfile werde ich in uuencodeter Form per EMail verschicken.

Ich benötige von Ihnen:  Name
                         Adresse
                         EMail Adresse

Die Zahlung erfolgt bar oder durch Überweisung auf mein Bank Konto
(Senden Sie mir eine EMail um meine Konto-Nummer etc. zu erfragen).


Thorsten Hansen
Geerzkamp 16a
22119 Hamburg
Germany

EMail: hansen_t@informatik.fh-hamburg.de

@ENDNODE