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

@NODE MAIN "AMPlifier Dokumentation"

                        @{b}AMPlifier@{ub}
                      Version 2.21

                Multiformat Audio Player

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

                  http://www.katodev.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

@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)

  * Leistungsfähiges Plugin System - für externe Visualisierungs Plugins

  * 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}Titelinfo...@{ub}
  Zeigt Dateiinformationen an (ID3-Tags).

@{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.
Es ist ebenfalls moeglich das gesamte Verzeichnis ueber den Dateirequester
auszuwaehlen wenn keine Datei angewählt wurde.

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}

@{" Audio I/O     " LINK CFG_AUDIOIO}
@{" Optionen      " LINK CFG_OPTIONS}
@{" Anzeige       " LINK CFG_DISPLAY}

@ENDNODE

@NODE CFG_AUDIOIO "Audio I/O"
@TOC WIN_CONFIG
@{b}Audio I/O@{ub}

Seit AMPlifier 2 gibt es ein neues modulares Plugin System für
verschiedene Eingabe und Ausgabe Module.
Diese Module sind für die Datei-Typ Identifikation und den jeweiligen
Datenstrom zuständig. 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 können.

Folgende Module sind zurzeit realisiert:

@{b}Eingabe Module:@{ub}

 @{" MPEG audio player " LINK INPMOD_MPEG}
  AIFF/MAUD player
  WAV player

@{b}Ausgabe Module:@{ub}

 @{" X-Audio/AHI Modul " LINK OUTMOD_AUDIO}

@ENDNODE

@NODE INPMOD_MPEG "MOD MPEG"
@TOC WIN_CONFIG
@{b}MPEG audio player@{ub}

@{b}ID3 Title@{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.
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}Decoder@{ub}

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

@{b}MPEG Device@{ub}
  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 möglich. Nähere Informationen gibt es auf Anfrage.

  Für die Melody 'melodympeg.device'.
  Peggy-Besitzer tragen hier entsprechend 'peggympeg.device' ein.

@{b}Buffersize@{ub}
  Hier wird die Größe des Datei Puffers eingestellt.

@{b}Blocksize@{ub}
  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.


@ENDNODE

@NODE OUTMOD_AUDIO "MOD Audio"
@TOC WIN_CONFIG
@{b}X-Audio/AHI output@{ub}

@{b}Device@{ub}
  Hier wird der Ausgabetreiber und ihre Unit-Nummer eingestellt.

  @{b}X-Audio@{ub}
    Der Name des Audio Devices (melodyaudio.device).

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


@{b}Buffering@{ub}
  Hier wird der Audio @{b}Puffer@{ub} eingestellt.

  Die Puffergröße wird in Sekunden eingestellt.
  Um beim Beginn eines 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_OPTIONS "Optionen"
@TOC WIN_CONFIG
@{b}Optionen@{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}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}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.

@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.

@{b}Skins Verzeichnis@{ub}
  Verzeichnis wo die einzelnen Skins zu finden sind.

@{b}Skin@{ub}
  Aktuelles Skin

@{b}Fensterinhalt beim verschieben anzeigen@{ub}
  AMPlfifier 2 unterstützt das Verschieben der Fenster in Echtzeit.
  Die Fenster folgen also der jeweiligen Mausposition automatisch.

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

@{b}Fensterinhalt anbinden bei nn Pixeln@{ub}
  Ist diese Option angeschaltet, so docken die Fenster automatisch
  aneinander an, wenn Diese einen gewissen Abstand von @{i}nn@{ui}
  Pixeln erreicht haben.

@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: AMPlifier.cfg)

@{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}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}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}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.

@{b}Equalizer@{ub}
  Der Equalizer ist nun voreingestellt ausgeschalten.
  Hiermit lässt sich der Equalizer wieder einchalten.


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

    FILENAME=StartFile
    CONF=CONFIGFILE
    CX_POPUP=<YES/NO>
    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