   ********************************
   **                            **
   **      CDTV-Player 2.2       **
   **                            **
   **    erstellt im April 1993  **
   **                            **
   **      von Daniel Amor       **
   **                            **
   ********************************


   I. Einleitung

   Willkommen zum CDTV-Player 2.2

   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 FISH-WARE. 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 2.2 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. Jetzt wurde noch ein AREXX-Port ein-
   gebaut, damit man die Funktionen des CDTVs von anderen Programmen steuern
   kann.
   

   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. (Siehe VII. Preferences)
   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

   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 Sie die Lieder einer CD anschauen mchten, dann klicken Sie den
   entsprechenden Titel an. Wenn der CDTV-Player die CD nicht im Archiv 
   findet, haben Sie die Mglichkeit diese CD zum Archiv hinzuzufgen, indem 
   man das ADD CD-Gadget anklickt. Ein neues Fenster ffnet sich und man 
   kann die neue CD eingeben. Wenn man eine Gruppe auswhlt, so erscheint
   der Gruppenname automatisch im ersten Feld.

   
   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).
   Wenn man ein Genlock besitzt, kann man es fr KARAOKE benutzen.


   VI. Archiv

   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.

   WICHTIGE BEMERKUNG:

   Obwohl es einen Standard fr AUDIO-CDs gibt, kann es vorkommen, da die
   gleiche CD in verschiedenen Lndern eine unterschiedliche Spielzeit 
   aufweist. Sollten Sie eine CD besitzen, die sich im Archiv befindet, jedoch
   nicht erkannt wird, dann ndern Sie die Zeit, die im ADD-CD Fenster 
   angezeigt wird (normalerweise handelt es sich nur um einige Sekunden). 
   Ich werde wohl ein Funktion einbauen, was die nderung der Zeit nachtrglich
   erlaubt.


   VII. Preferences

   In diesem Men knnen Sie einige Einstellungen ndern. Auf der linken Seite
   befinden sich zwei Slider-Gadgets. Mit dem oberen kann man die Dauer fr das
   Ein- & Ausblenden am Anfang und am Ende des Liedes einstellen (1Sek - 10Sek).
   Mit dem unteren kann man die Scan-Zeit einstellen (5Sek - 25Sek). Auf der
   rechten Seite befinden sich zwei Check Boxes, die beide in Verbindung mit 
   KARAOKE ntzlich sind. 'Break' ermglicht das Abbrechen des KARAOKE whrend 
   des Spielens (es wird ein Close-Gadgets angezeigt). 'Time' erzeugt auf 
   dem KARAOKE-Schirm eine Zeitanzeige. Dies wurde eingefhrt, um die Eingabe
   neuer KARAOKE-Titel zu vereinfachen. Beim Speichern wird ein File mit dem
   Namen s:CDTV.config angelegt.

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

   Ich werde 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). 

   Ich werde versuchen SCSI-Drives ins Programm mit aufzunehmen (wenn
   jemand Informationen ber SCSI-Drives besitzt, dann her damit). 

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

   
   IX. Source-Code & Updates

   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. 

   Updates gibt es direkt bei mir, im AMINET, im FRAS und in allen 
   gutsortierten Mailboxen und natrlich auf den Fish-Disks. 


   X. Assigns

   Gilt nur fr OS 1.3!

   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. 
   

   XI. Arexx

   Arexx wurde eingefhrt, um die Kontrolle ber den CDTV-Player von aussen zu 
   erhalten. Schauen Sie sich die Beispiele auf der Disk an. Im Augenblick 
   kann man nur ein Lied starten und stoppen. In zuknftigen Versionen
   wird man alle Funktionen des CDTV-Players steuern knnen.


   XII. Die Geschichte von CDTV-Player

   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)

   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 849

   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.

   Version 1.9 (23.03.93) 

   Fgte noch mehr Preferences hinzu, um KARAOKE besser handhaben zu knnen. 
   Jetzt kann KARAOKE zu jeder Zeit gestoppt werden und es ist mglich die
   Spielzeit einzublenden. Erhhte die Ausgabegeschwindigkeit von KARAOKE
   und entfernte einigen unntigen Code.

   Version 2.0 (04.04.93) Fish-Disk 868

   Fnfte offizielle Verffentlichung des CDTV-Players. Beinhaltet jetzt 
   einen AREXX-Port. Dies versetzt Sie in die Lage den CDTV-Player von
   anderen Programmen aus zu steuern.

   Version 2.01 (23.04.93)

   Aaaargh. V2.0 funktionierte nicht auf Maschinen, auf denen nicht die
   arexx.library installiert war. Ich bemerkte es bisher nicht, da ich
   es bei mir auf dem CDTV installiert hatte.

   Version 2.02 (13.06.93)

   AREXX unterbunden, aufgrund von timing Probleme. Verbesserte ADDCD-
   Funktion.

   Version 2.03 (28.06.93)

   AREXX wieder eingebunden, da alle Probleme damit beseitigt wurden.

   Version 2.05 (13.07.93) Fish-Disk 894

   Sechste offizielle Verffentlichung. Entfernte BUG in der ADDCD-Funktion. 
   Jetzt speichert er die Eintrge ohne Probleme (durch Umgehung eines 
   Compiler-bugs erreicht). REW & FF sind nicht anklickbar, wenn es keine 
   hhere bzw. tiefere Spur mehr gibt.

   Version 2.06 (28.08.93)

   CDTV-Player verbrauchte wegen eines kleines Fehlers die ganze Rechenzeit.
   Fehler behoben. 

   Version 2.10 (29.08.93)

   Fgte neuen Info-Requester hinzu und entfernte kleinen Bug bei REW & FF.
   Verbesserte ADDCD-Funktion. Trgt nun Titel der ausgewhlten Gruppe ein.

   Version 2.15 (30.08.93)

   Stark verbesserte ADDCD-Funktion. Abbruch mglich.

   Version 2.18 (01.09.93)

   Speichert jetzt die PREFERENCES ab. WINDOWDEPTH bei INFO-REQUESTER 
   hinzugefgt.

   Version 2.20 (02.09.93)

   Ab Workbench 2.0 ist nun kein ASSIGN mehr ntig! Update der Docs.

   Version 2.25 (05.09.93)

   Topaz 8 wird nun explizit verlangt. Ausgabegeschwindigkeit erhht.

   Version 2.30 (23.09.93)

   Programm teilweise fontsensitiv gemacht und den Rest darauf 
   vorbereitet.


   XIII. Credits

   (In alphabetischer Reihenfolge)

   Markus Bahr, Berlin - DEUTSCHLAND,
     fr seinen Brief und sein Interesse.

   Thomas Bengtsson - SCHWEDEN,
     fr sein e-mail & sein Interesse am Source-Code.

   Tomi Blinnikka, Helsinki - FINNLAND,
     fr sein e-mail & fr sein Interesse am Source-Code.

   Frdric Botton von EDUCOM, Paris - FRANKREICH,
     fr sein Programm Gimme_a_CD, seine Ideen, seine viersprachigen
     Briefe & e-mails und seinen Sinn fr Humor.

   Dimitrios Charalampidis, Thessaloniki - GRIECHENLAND,
     fr seine Briefe.

   Ioannis Chatziandreou, Bochum - DEUTSCHLAND,
     fr sein e-mail & sein dringendes Verlangen nach dem Source-Code.

   Ross Delaforce - AUSTRALIEN,
     fr sein e-mail & die SCSI-Idee.

   Hans-Christian Eckert, Berlin - DEUTSCHLAND,
     fr seine e-mails, seine Vorschlge und das Interesse am Source-Code.

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

   Darren Ewaniuk, Alberta - KANADA,
     fr sein e-mail & fr das Hereinnehmen des CDTV-Player in seine Produkte.

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

   Wlad Fomin & Dostick von ACL, Riga - LETTLAND,
     fr ihre e-mails, ihre russischen Briefe, ihr Interesse an CDTV & AMIGA
     und ihre Untersttzung.

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

   Andreas Happel, Flensburg - DEUTSCHLAND,
     fr seinen Brief, seine interessanten Fragen und das Interesse an CDTV.

   Dave Hassall - NEUSEELAND,
     fr sein e-mail und sein Interesse am CDTV-Player.
 
   Peter Hellweg, Wetter - DEUTSCHLAND,
     fr sein e-mail.

   Sebastian Hesselbarth, Aerzen - DEUTSCHLAND,
     fr seinen Brief und seine Ideen.

   Kai Hofmann, Bremen - DEUTSCHLAND,
     fr seine e-mails & das Interesse an CDTV.

   Jason R. Hulance, Oxford - GROSSBRITANNIEN,
     fr seine e-mails & das Interesse am Source-Code.

   D. Jarvis - USA
     fr sein e-mail & das Interesse am Source-Code.

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

   George Knighton, Fremont - USA,
     fr seinen Brief und sein Interesse am CDTV-Player.

   Thorsten Kratz, Erlangen - DEUTSCHLAND,
     fr seine e-mails und seine Ideen.

   Tom Kroener, Saarbrcken-Dudweiler - DEUTSCHLAND,
     fr seine Briefe, seine Kritik und seine Ideen.

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

   Wai Hung Liu, Dublin - IRLAND,
     fr seine Briefe und sein Interesse an CDTV.

   Nick MacDonald - KANADA,
     fr sein e-mail und sein Interesse.

   Thomas J. Moore - USA
     fr seine e-mails, seine bug-reports und seine netten Anmerkungen
     (haltet nach seiner C Version des CDTV-Player ausschau).

   Felice Murolo, Salerno - ITALIEN,
     fr seinen Brief und sein Interesse am Source des CDTV-Player.

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

   Nhan Nguyen, Sophomore - USA
     fr seine e-mails, seine Ideen und sein Interesse am CDTV-Player.

   Stefan Ohlin, Solleftea - SCHWEDEN,
     fr seinen Brief und sein Interesse am Source-Code.

   Oliver Peike - DEUTSCHLAND,
     fr sein e-mail.

   Alfred Prenner, Frstenfeldbruck - DEUTSCHLAND,
     fr seinen Brief und sein Interesse an CDTV & Parnet.

   Uwe Ripl - DEUTSCHLAND,
     fr sein e-mail.

   Hanns Holger Rutz, Zeven - DEUTSCHLAND,
     fr seine Briefe, seine Ideen und seine Bug-reports.

   Stefan Schmidt, Wahnebergen - DEUTSCHLAND,
     fr sein e-mail und seine Ideen.

   Ralph Seichter, Hueth - DEUTSCHLAND,
     fr seine e-mails und seine Ideen.

   Peter Uitz, Wien - STERREICH,
     fr sein Interesse an der Dokumentation des CDTV.

   Federico Villata, Rom - ITALIEN,
     fr sein e-mail & sein Interesse am CDTV-Player.

   Jure Vrhovnik, Ljubljana - SLOWENIEN,
     fr sein Interesse am CDTV, seine e-mails und seine Hardware-
     Spezification (trum weiter...).

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

   Michael Zielinski, Hamburg - DEUTSCHLAND,
     fr seine Ideen und sein Interesse an CDTV-Player.

   wird fortgesetzt...

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


   XIV. Adresse

   ***************************************************************
   **                                                           **
   **      Sie knnen mir in folgenden Sprachen schreiben:      **
   **   Cesk, Deutsch, English, Franais, Italiano, Russkij.   **
   **                                                           **
   **  Schneckenpost: Daniel Amor                               **
   **                 Ludwigstr. 124                            **
   **                 70197 Stuttgart                           **
   **                 Germany                                   **
   **                                                           **
   **  E-Mail:        amor@student.uni-tuebingen.de             **
   **  FidoNet:       2:246/1416 (Amiga Universe)               **
   **                                                           **
   ***************************************************************
