   ********************************
   **                            **
   **      CDTV-Player 1.8       **
   **                            **
   **  erstellt im Februar 1993  **
   **                            **
   **     von Daniel Amor        **
   **                            **
   ********************************


   I. Einleitung

   Willkommen zum CDTV-Player 1.8

   Die Idee fr dieses Programm kam mir, als ich vor meinem CDTV sa und 
   gleichzeitig Musik hren und arbeiten wollte. Es gibt zwar die 
   Mglichkeit whrend der Arbeit auf der Workbench die Play-Taste zu
   drcken, aber die einzige Information, die man erhlt ist die 
   Tracknummer. Die andere Mglichkeit Audio-CDs abzuspielen war auf das
   Multitasking zu verzichten und den eingebauten Player zu benutzen.
   Dies fand ich ziemlich bel. In der deutschen Zeitschrift 'AMIGA-DOS'
   habe ich zum Glck ein Programm von Dr. Peter Kittel (Commodore 
   Deutschland) in AMIGA-BASIC gefunden. Dieses Programm sah eher aus 
   wie ein C-64 Programm mit vielen PEEKS und POKES. Aus diesem Grunde
   bersetzte ich es nach KICK-PASCAL (Zeilen in AmigaBasic : Zeilen in
   Kick-Pascal = 200 : 15) and entwarf eine Workbench-Oberflche 
   (September 1992). Dieses Programm ist FREEWARE. Commodore hat das Recht
   dieses Programm zusammen mit dem original CDTV-Paket oder mit jedem
   CD-ROM zu vertreiben. Wenn Sie das Programm professionell einsetzen,
   erwhnen Sie bitte meinen Namen.


   II. Funktionen

   CDTV-Player 1.8 besitzt eine Menge neuer Funktionen. Zuerst einmal habe
   ich Preferences hinzugefgt, um das Programm benutzerfreundlicher zu
   gestalten (dies wird in Zukunft ausgebaut). Dann habe ich eine Routine
   programmiert, die die CDs erkennt, wenn sie sich im Archiv befinden 
   (Vielen Dank an Frdric Botton - Paris fr sein Programm Gimme_a_CD
   und der Idee). Dann habe ich noch eine SHUFFLE Funktion eingebaut und die
   Option zwei Sekunden vor oder zurck zu springen (BACK und FORTH).
   In frheren Versionen konnten nur Besitzer eines CD-ROM-Laufwerks das
   Programm benutzen. Jetzt hat jeder AMIGA-Benutzer Zugriff auf das Archiv,
   um z.B. ein Lied zu suchen oder nur um das Programm anzuschauen. Ich habe
   jetzt die Funktion KARAOKE. Wenn sich die Liedtexte im Archiv knnen sie
   auf dem Bildschirm angezeigt werden.
   

   III. Gadgets

   Hier ist eine kurze Liste der Gadgets:

   REW     : Veringert die Titelnummer.
   PLAY    : Spielt den aktuellen Titel.
   FF      : Erhht die Titelnummer.
   PAUSE   : Macht eine Pause.
   STOP    : Bricht den aktuellen Titel ab.
   FADE    : An- und Abschwellen der Lautstrke.
   LIVE    : Automatischen Anschwellen am Anfang des Liedes und automatisches
             Abschwellen am Ende.
   SINGLE  : Wechsel zwischen einem Lied und der ganzen CD.
   REPEAT  : Wechsel zwischen einfachem und mehrfachem Abspielen.
   BACK    : Springt zwei Sekunden zurck.
   SCAN    : Spielt jedes Lied kurz an.
   FORTH   : Springt zwei Sekunden vor.
   SECRET  : Zuknftige Optionen.
   KARAOKE : Echtzeit-Karaoke (Siehe V. KARAOKE)
   SHUFFLE : Wechsel zwischen normaler und zuflliger Abspielreihenfolge.
   PROGRAM : Programmiert Abspielreihenfolge.
   PREFS   : Zugang zu den Voreinstellungen.
   EDIT    : ffnet das Edit-Fenster. (Siehe IV. EDIT)
   DISPLAY : Es gibt fnf Anzeige-Modi:
             1. Die schon gespielte Titelzeit.
             2. Die noch zu spielende Titelzeit.
             3. Die schon gespielte Gesamtzeit.
             4. Die noch zu spielende Gesamtzeit.
             5. Keine Anzeige (nimmt weniger Prozessorzeit in Anspruch).
             Die Modi 3&4 knnen nur angewhlt werden, wenn SINGLE 
             ausgeschaltet ist. 
   INFO    : Zeigt ein Informationsfenster an.

   Es gibt ein Scroll-Gadget am rechten Rand, mit der Sie die Lautstrke
   einstellen knnen.


   IV. Edit

   WARNUNG: Funktioniert noch nicht vollstndig, wird aber stndig 
            verbessert.

   Wenn man das EDIT-Gadget im Hauptfenster drckt, ffnet sich ein neues
   Fenster und Sie bekommen Zugriff zum Archiv. In frheren Versionen
   muten Sie hier die CD auswhlen, die Sie hren wollten. Dies wird nun
   automatisch gemacht, so da Sie das Archiv nur noch anschauen knnen.
   Wenn der CDTV-Player die CD nicht im Archiv findet, haben Sie die 
   Mglichkeit diese CD zum Archiv hinzuzufgen.

   
   V. Karaoke

   Wenn man das KARAOKE-Gadget anklickt, sucht das Program nach den 
   Liedtexten des aktuellen Liedes. Wenn sie sich im Archiv befinden,
   werden sie auf einem eigenem Schirm anzeigt, whrend das Lied abgespielt
   wird. Im Augenblick gibt es keine Spezialeffekte, die werden jedoch in
   naher Zukunft eingebaut (Ideen sind immer willkommen). Wenn Sie eigene
   KARAOKE-Lieder entwerfen wollen, schauen Sie sich "lyrics:depeche mode.mx"
   an (das einzig komplette, da ich zu faul bin alle meine CDs einzugeben).


   VI. Archiv

   WARNUNG: Das Format ist noch nicht endgltig. Gehen Sie nicht davon aus,
            da zuknftige Versionen das aktuelle Format untersttzen werden.

   Das Archiv ist in zwei Teile gespalten. Der erste Teil enthlt die 
   Gruppennamen und die CD Titel, CD Zeit, Anzahl der Lieder (z.B. Brian
   Adams, Waking up the neighbours,74:54.38|15). In frheren Versionen
   hatte ich auf die Hunderstelsekunden und die Anzahl der Lieder verzichtet.
   Dies erwies sich aber als nicht besonders genau bei der CD-Suche, so da
   ich es hinzufgen mute. Der zweite Teil des Archivs enthlt die 
   Gruppendaten mit den Liedernamen und den Texten.

   
   VII. Die Zukunft

   Ich werde eine Funktion einbauen, die COPY heit, die das Kopieren der 
   CD's auf Kassette vereinfachen wird. Sie geben nur die Zeit an, die auf
   der Kassette noch vorhanden ist und das Programm wird die Lieder 
   heraussuchen, die mglichst nahe an die Vorgaben herankommen.

   Sollte dieses Programm mit den CD-ROM-Laufwerken A570/A670 
   zusammenarbeiten, dann wrde ich einen AREXX-Port einbauen. Dies wrde
   es anderen Programmen ermglichen auf die Funktionen des CDTV-Players
   zugreifen zu knnen (z.B. Multi-Media-Anwendungen).

   Ich werden versuchen PARNET in das Programm zu integrieren, um z.B.
   einen AMIGA 4000 fr KARAOKE zu benutzen, whrend eine CD im CDTV 
   abgespielt wird (d.h. es wird mehr & schnellere Effekte geben). 

   Wenn jemand Vorschlge, spezielle Bedrfnisse oder ntzliche 
   Informationen besitzt, dann setzen Sie sich mit mir in Verbindung.
   Siehe X. Credits.

   
   VIII. Source-Code

   Sie knnen den Source-Code kostenlos bei mir bekommen. Sie mssen mir
   dazu nur schreiben und eine Diskette beilegen. Vorschlge und Ideen sind
   immer willkommen. Neue Gruppen fr das Archiv sind ebenfalls willkommen.
   CDTV-Player wurde in KICK-PASCAL 2.12 geschrieben.


   IX. Assigns

   Zur Zeit mu man (leider!) ein ASSIGN durchfhren, um das Archiv 
   laden zu knnen. Wenn sich z.B. das Verzeichnis CDTV-Player in DF1: 
   befindet, mu man ASSIGN Lyrics: DF1:CDTV-Player/Lyrics angeben. Ich 
   habe fr diesen Zweck ein Skript geschrieben.
   

   X. Die Geschichte von CDTV-Player@{ub}

   Version 0.8 (12.09.92)

   bersetzung des AMIGA-BASIC-Programms von Dr. Peter Kittel nach
   KICK-PASCAL. Spielt Lieder vom CLI/SHELL aus ab, ohne Workbench-Oberflche.


   Version 0.9 (14.09.92)

   Fgte Workbench-Oberflche hinzu, um Lieder ohne Tastatur abzuspielen.
   Fgte PAUSE, SCAN, SINGLE, REPEAT, FADE, DISPLAY hinzu.


   Version 1.0 (18.09.92) Fish-Disk 759

   Die erste Verffentlichung - mit einer Menge Fehler (z.B. konnte es 
   nicht erkennen, ob nun eine CD oder eine Disk aus einem Laufwerk genommen 
   wurde). Fgte ein INFO-Fenster hinzu. Verbesserte die interne Benutzung 
   des 'cdtv.device'. Dachte mir eine Funktion aus, die KARAOKE heien soll, 
   hatte aber noch keine Ahnung, wie das zu bewerkstelligen ist.


   Version 1.2 (26.10.92)

   Erneuerte die Workbench-Oberflche und fgte das KARAOKE-Fenster hinzu. 
   Dies hatte zwar im Augenblick nichts mit KARAOKE zu tun, aber man konnte 
   sich den Titel der CD auswhlen, der angezeigt wird, whrend man sie ab-
   spielt. Entfernte alle Fehler, die den Disk-Wechsel betrafen.


   Version 1.3 (05.11.92)

   Fgte eine Meldung fr Leute hinzu, die kein "cdtv.device" besitzen. Er-
   hhte die Geschwindigkeit des Programms und verringerte die Prozessor-
   belastung.


   Version 1.4 (26.11.92)

   Fgte einige Fehler ein, whrend ich andere entfernte. Viele interne Ver-
   nderungen (Man kann der Unterschied zwischen 1.3 und 1.4 nicht sehen, aber
   1.4 ist stabiler). 


   Version 1.5 (25.12.92) Fish-Disk 805

   Zweite Verffentlichung.Erhhte die Geschwindigkeit des KARAOKE Fensters, 
   fgte einige Gadgets hinzu. Erneuerte die Dokumentation und erhhte mal 
   wieder die Geschwindigkeit. Entfernte alle strenden Fehler, die die 
   KARAOKE Option betrafen.


   Version 1.5d (29.12.92)

   Entferne einen kleinen Fehler im Info-Requester, der im ungstigen Fall 
   den Absturz des Programms hervorrufen konnte. Schade, da ich die Disk vor 
   vier Tagen die Diskette weggeschickt habe.


   Version 1.6 (11.01.93)

   nderte den Namen von KARAOKE nach EDIT, da ich im Augenblick nicht die 
   Zeit habe eine richtige KARAOKE Funktion einzubauen. Erhhte die Ausgabe-
   geschwindigkeit des EDIT-Fensters, in dem ich dynamische Strukturen ver-
   wendete (wenigstens etwas, da ich von der Uni benutzen kann). Verlegte 
   die Programmierarbeiten auf den AMIGA 4000 (mehr Speicher, mehr Spa). 
   Fgte SHUFFLE hinzu.

   Version 1.7f (25.01.93) Fish-Disk 8??

   Die dritte Verffentlichung des CDTV-Player. Jetzt hat jeder mit einem 
   CDTV-Player die Mglichkeit ins Programm zu kommmen, um einen Blick auf 
   die Gadgets werfen zu knnen und die EDIT zu benutzen, um z.B. ein 
   bestimmtes Lied zu finden. Fgte eine Suchfunktion hinzu, um die aktuelle 
   CD aus dem Archiv herauszusuchen und sie automatisch zu laden. Fgte 
   PREFS, BACK & FORTH hinzu.


   Version 1.7j (20.02.93)
   Fgte die Funktion PROGRAM hinzu und jetzt ist es mglich eigene CDs 
   einzugeben. Entfernte eine Menge unntigen Code. Verbesserte das Design 
   von EDIT. Entfernte Fehler in SHUFFLE & PROGRAM (im Programm eigentlich 
   dasselbe).


   Version 1.8 (22.02.93) Fish-Disk 8??

   Vierte offizielle Verffentlichung des CDTV-Player. Fgte KARAOKE hinzu 
   (sehr populr in Japan & Italien). Jeder beliebige Text kann dazu benutzt 
   werden. Fgte noch ADD CD hinzu, um selbst CDs eingeben zu knnen.


   XI. Credits

   (In alphabetischer Reihenfolge)

   Frdric Botton von EDUCOM, Paris - Frankreich,
     fr sein Programm Gimme_a_CD und seine Ideen.

   Marc Eisenach, Stadtallendorf - Deutschland,
     fr seine Anrufe, das Gesprch ber CDTV und fr verschiedene
     Informationen zur Hardware.

   Fred Fish, Tempe - USA
     fr das Hereinnehmen meiner Programme in seine tolle Kollektion.

   Imke Gisch, "Produktmanager CDTV" von Commodore - Deutschland,
     fr die schnelle Untersttzung und die Dokumente.

   Dr. Peter Kittel von Commodore - Deutschland,
     fr sein AMIGA-BASIC-Programm und den Artikel in der "AMIGA-DOS".

   Tom Kroener, Saarbrcken-Dudweiler - Deutschland,
     fr seinen Brief.

   Gerhard Leibrock, Kirkel - Deutschland,
     fr seine Briefe und seine Ideen.

   Arthur T. Murray, Seattle - USA,
     fr seine Postkarte.

   Werner Vlker, Ebersbach - Deutschland
     fr seinen Anruf und das Gesprch ber CDTV, AMIGA & PARNET.

   wird fortgesetzt...

   (Wenn Ihnen mein Programm gefllt, lassen Sie es mich wissen,
   dann werden Sie hier genannt).

   ***************************************************************
   **                                                           **
   **      Sie knnen mir in folgenden Sprachen schreiben:      **
   **   Cesk, Deutsch, English, Franais, Italiano, Russkij.   **
   **                                                           **
   **  Schneckenpost: Daniel Amor                               **
   **                 Ludwigstr. 124                            **
   **                 7000 Stuttgart 1                          **
   **                 Germany                                   **
   **                                                           **
   **  E-Mail:        amor@student.uni-tuebingen.de             **
   **  FidoNet:       2:2407/106 (Intuition Base)               **
   **                                                           **
   ***************************************************************
