@database amigaguide.guide
@rem $Date 03/04/93 13:27:32 $ $Revision: 2.0 $
@wordwrap

@node MAIN "CDTV-Player 2.0 AmigaGuide.Dokument"
@title 
   ********************************
   **                            **
   **      CDTV-Player 2.0       **
   **                            **
   **   erstellt im April 1993   **
   **                            **
   **      von Daniel Amor       **
   **                            **
   ********************************

   I.    @{"Einleitung " link CDTV_INTRODUCTION}
   II.   @{"Funktionen " link CDTV_FEATURES}
   III.  @{"Gadgets " link CDTV_GADGETS}
   IV.   @{"Edit " link CDTV_EDIT}
   V.    @{"Karaoke " link CDTV_KARAOKE}
   VI.   @{"Archiv  " link CDTV_ARCHIVE}
   VII.  @{"Preferences " link CDTV_PREFERENCES}
   VIII. @{"Die Zukunft " link CDTV_FUTURE}
   IX.   @{"Source-Code " link CDTV_SOURCE}
   X.    @{"Assigns " link CDTV_ASSIGNS}
   XI.   @{"Arexx " link CDTV_AREXX}
   XII.  @{"History " link CDTV_HISTORY}
   XIII. @{"Credits " link CDTV_CREDITS}

@endnode

@node CDTV_INTRODUCTION "I. Einführung"

   @{b}I. Willkommen zum CDTV-Player 2.0@{ub}

   Die Idee für dieses Programm kam mir, als ich vor meinem CDTV saß und 
   gleichzeitig Musik hören und arbeiten wollte. Es gibt zwar die 
   Möglichkeit während der Arbeit auf der Workbench die Play-Taste zu
   drücken, aber die einzige Information, die man erhält ist die 
   Tracknummer. Die andere Möglichkeit 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 Glück 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-Oberfläche 
   (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,
   erwähnen Sie bitte meinen Namen.
@endnode

@node CDTV_FEATURES "II. Funktionen"

   @{b}II. Funktionen@{ub}

   CDTV-Player 2.0 besitzt eine Menge neuer Funktionen. Zuerst einmal habe
   ich Preferences hinzugefügt, 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 Frédéric Botton - Paris für sein Programm «Gimme_a_CD»
   und der Idee). Dann habe ich noch eine SHUFFLE Funktion eingebaut und die
   Option zwei Sekunden vor oder zurück zu springen (BACK und FORTH).
   In früheren 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 können 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.
@endnode

@node CDTV_GADGETS "III. Gadgets"

   @{b}III. Gadgets@{ub}

   Hier ist eine kurze Liste der Gadgets.

   @{b}REW@{ub}     : Verringert die Titelnummer.
   @{b}PLAY@{ub}    : Spielt den aktuellen Titel.
   @{b}FF@{ub}      : Erhöht die Titelnummer.
   @{b}PAUSE@{ub}   : Macht eine Pause.
   @{b}STOP@{ub}    : Bricht den aktuellen Titel ab.
   @{b}FADE@{ub}    : An- und Abschwellen der Lautstärke.
   @{b}LIVE@{ub}    : Automatischen Anschwellen am Anfang des Liedes und 
             automatisches Abschwellen am Ende.
   @{b}SINGLE@{ub}  : Wechsel zwischen einem Lied und der ganzen CD.
   @{b}REPEAT@{ub}  : Wechsel zwischen einfachem und mehrfachem Abspielen.
   @{b}BACK@{ub}    : Springt zwei Sekunden zurück.
   @{b}SCAN@{ub}    : Spielt jedes Lied kurz an.
   @{b}FORTH@{ub}   : Springt zwei Sekunden vor.
   @{b}SECRET@{ub}  : Zukünftige Optionen.
   @{b}KARAOKE@{ub} : Echtzeit-Karaoke (Siehe V. @{"Karaoke " link CDTV_KARAOKE})
   @{b}SHUFFLE@{ub} : Wechsel zwischen normaler und zufälliger Abspielreihenfolge.
   @{b}PROGRAM@{ub} : Programmiert Abspielreihenfolge.
   @{b}PREFS@{ub}   : Zugang zu den Voreinstellungen. (Siehe VII. @{"Preferences " link CDTV_PREFERENCES}).
   @{b}EDIT@{ub}    : Öffnet das Edit-Fenster. (Siehe IV. @{"Edit " link CDTV_EDIT}).
   @{b}DISPLAY@{ub} : Es gibt fünf 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).
   @{b}INFO@{ub}    : Zeigt ein Informationsfenster an.

   Es gibt ein Scroll-Gadget am rechten Rand, mit der Sie die Lautstärke
   einstellen können.
@endnode
 
@node CDTV_EDIT "IV. Edit"

   @{b}IV. Edit@{ub}

   WARNUNG: Funktioniert noch nicht vollständig, wird aber ständig 
            verbessert.

   Wenn man das EDIT-Gadget im Hauptfenster drückt, öffnet sich ein neues
   Fenster und Sie bekommen Zugriff zum Archiv. In früheren Versionen
   mußten Sie hier die CD auswählen, die Sie hören wollten. Dies wird nun
   automatisch gemacht, so daß Sie das Archiv nur noch anschauen können.
   Wenn Sie die Lieder einer CD anschauen möchten, dann klicken Sie den
   entsprechenden Titel an. Wenn der CDTV-Player die CD nicht im Archiv 
   findet, haben Sie die Möglichkeit diese CD zum Archiv hinzuzufügen, indem 
   man das ADD CD-Gadget anklickt. Ein neues Fenster öffnet sich und man kann 
   die neue CD eingeben. Nachdem man das Fenster durch das CLOSE-GADGET 
   verlassen hat, wird der Eintrag automatisch im Archiv gespeichert.
@endnode

@node CDTV_KARAOKE "V. Karaoke"

   @{b}V. Karaoke@{ub}

   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, während 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 für KARAOKE benutzen.
@endnode

@node CDTV_ARCHIVE "VI. Archiv"

   @{b}VI. Archiv@{ub}

   WARNUNG: Das Format ist noch nicht endgültig. Gehen Sie nicht davon aus,
            daß zukünftige Versionen das aktuelle Format unterstützen 
            werden.

   Das Archiv ist in zwei Teile gespalten. Der erste Teil enthält die 
   Gruppennamen und die CD Titel, CD Zeit, Anzahl der Lieder (z.B. Brian
   Adams, Waking up the neighbours,74:54.38|15). In früheren 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 hinzufügen mußte. Der zweite Teil des Archivs 
   enthält die Gruppendaten mit den Liedernamen und den Texten.
@endnode

@node CDTV_PREFERENCES "VII. Preferences"

   @{b}VII. Preferences@{ub}

   In diesem Menü können Sie einige Einstellungen ändern. Auf der linken Seite
   befinden sich zwei Slider-Gadgets. Mit dem oberen kann man die Dauer für 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 nützlich sind. 'Break' ermöglicht das Abbrechen des KARAOKE während 
   des Spielens (es wird ein Close-Gadgets angezeigt). 'Time' erzeugt auf 
   dem KARAOKE-Schirm eine Zeitanzeige. Dies wurde eingeführt, um die Eingabe
   neuer KARAOKE-Titel zu vereinfachen.
@endnode

@node CDTV_FUTURE "VIII. Die Zukunft"

   @{b}VIII. Die Zukunft@{ub}

   Ich werde eine Funktion einbauen, die COPY heißt, 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 möglichst nahe an die Vorgaben herankommen.

   Sollte dieses Programm mit den CD-ROM-Laufwerken A570/A670 
   zusammenarbeiten, dann würde ich einen AREXX-Port einbauen. Dies würde
   es anderen Programmen ermöglichen auf die Funktionen des CDTV-Players
   zugreifen zu können (z.B. Multi-Media-Anwendungen). JETZT EINGEBAUT.

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

   Wenn jemand Vorschläge, spezielle Bedürfnisse oder nützliche 
   Informationen besitzt, dann setzen Sie sich mit mir in Verbindung.
   (Siehe XIII. @{"Credits " link CDTV_CREDITS}).
@endnode

@node CDTV_SOURCE "IX. Source-Code"

   @{b}IX. Source-Code@{ub}

   Sie können den Source-Code kostenlos bei mir bekommen. Sie müssen mir
   dazu nur schreiben und eine Diskette beilegen. Vorschläge und Ideen sind
   immer willkommen. Neue Gruppen für das Archiv sind ebenfalls willkommen.
   CDTV-Player wurde in KICK-PASCAL 2.12 geschrieben.
@endnode

@node CDTV_ASSIGNS "X. Assigns"

   @{b}X. Assigns@{ub}

   Zur Zeit muß man (leider!) ein ASSIGN durchführen, um das Archiv 
   laden zu können. Wenn sich z.B. das Verzeichnis CDTV-Player in DF1: 
   befindet, muß man ASSIGN Lyrics: DF1:CDTV-Player/Lyrics angeben. Ich 
   habe für diesen Zweck ein Skript geschrieben.
@endnode

@node CDTV_AREXX "XI. Arexx"

   @{b}XI. Arexx@{ub}

   Arexx wurde eingeführt, 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 zukünftigen Versionen
   wird man alle Funktionen des CDTV-Players steuern können.
@endnode

@node CDTV_HISTORY "XII. History"

   @{b}XII. Die Geschichte von CDTV-Player@{ub}

   @{u}Version 0.8 (12.09.92)@{uu}

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


   @{u}Version 0.9 (14.09.92)@{uu}

   Fügte Workbench-Oberfläche hinzu, um Lieder ohne Tastatur abzuspielen.
   Fügte PAUSE, SCAN, SINGLE, REPEAT, FADE, DISPLAY hinzu.


   @{u}Version 1.0ß (18.09.92) Fish-Disk 759@{uu}

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


   @{u}Version 1.2 (26.10.92)@{uu}

   Erneuerte die Workbench-Oberfläche und fügte das KARAOKE-Fenster hinzu. Dies 
   hatte zwar im Augenblick nichts mit KARAOKE zu tun, aber man konnte sich den 
   Titel der CD auswählen, der angezeigt wird, während man sie abspielt. Ent-
   fernte alle Fehler, die den Disk-Wechsel betrafen.


   @{u}Version 1.3 (05.11.92)@{uu}

   Fügte eine Meldung für Leute hinzu, die kein "cdtv.device" besitzen. Erhöhte 
   die Geschwindigkeit des Programms und verringerte die Prozessorbelastung.


   @{u}Version 1.4 (26.11.92)@{uu}

   Fügte einige Fehler ein, während ich andere entfernte. Viele interne Ver-
   änderungen (Man kann der Unterschied zwischen 1.3 und 1.4 nicht sehen, aber 
   1.4 ist stabiler). 


   @{u}Version 1.5 (25.12.92) Fish-Disk 805@{uu}

   Zweite Veröffentlichung. Erhöhte die Geschwindigkeit des KARAOKE Fensters, 
   fügte einige Gadgets hinzu. Erneuerte die Dokumentation und erhöhte mal 
   wieder die Geschwindigkeit. Entfernte alle störenden Fehler, die die 
   KARAOKE Option betrafen.


   @{u}Version 1.5d (29.12.92)@{uu}

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


   @{u}Version 1.6 (11.01.93)@{uu}

   Änderte den Namen von KARAOKE nach EDIT, da ich im Augenblick nicht die Zeit 
   habe eine richtige KARAOKE Funktion einzubauen. Erhöhte die Ausgabege-
   schwindigkeit des EDIT-Fensters, in dem ich dynamische Strukturen verwendete
   (wenigstens  etwas, daß ich von der Uni benutzen kann). Verlegte die Program-
   mierarbeiten auf den AMIGA 4000 (mehr Speicher, mehr Spaß). Fügte SHUFFLE
   hinzu.


   @{u}Version 1.7f (25.01.93) Fish-Disk 8??@{uu}

   Die dritte Veröffentlichung des CDTV-Player. Jetzt hat jeder mit einem CDTV-
   Player die Möglichkeit ins Programm zu kommmen, um einen Blick auf die 
   Gadgets werfen zu können und die EDIT zu benutzen, um z.B. ein bestimmtes 
   Lied zu finden. Fügte eine Suchfunktion hinzu, um die aktuelle CD aus dem 
   Archiv herauszusuchen und sie automatisch zu laden. Fügte PREFS, BACK & 
   FORTH hinzu.


   @{u}Version 1.7j (20.02.93)@{uu}
   Fügte die Funktion PROGRAM hinzu und jetzt ist es möglich eigene CDs ein-
   zugeben. Entfernte eine Menge unnötigen Code. Verbesserte das Design von 
   EDIT. Entfernte Fehler in SHUFFLE & PROGRAM (im Programm eigentlich dasselbe).


   @{u}Version 1.8 (22.02.93) Fish-Disk 8??@{uu}

   Vierte offizielle Veröffentlichung des CDTV-Player. Fügte KARAOKE hinzu (sehr 
   populär in Japan & Italien). Jeder beliebige Text kann dazu benutzt werden. 
   Fügte noch ADD CD hinzu, um selbst CDs eingeben zu können.

   
   @{u}Version 1.9 (23.03.93) @{uu}

   Fügte noch mehr Preferences hinzu, um KARAOKE besser handhaben zu können. 
   Jetzt kann KARAOKE zu jeder Zeit gestoppt werden und es ist möglich die
   Spielzeit einzublenden. Erhöhte die Ausgabegeschwindigkeit von KARAOKE
   und entfernte einigen unnötigen Code.

   @{u}Version 2.0 (04.03.93) Fish-Disk ???@{uu}

   Fünfte offizielle Veröffentlichung des CDTV-Players. Beinhaltet jetzt 
   einen AREXX-Port. Dies versetzt Sie in die Lage den CDTV-Player von
   anderen Programmen aus zu steuern.

@endnode

@node CDTV_CREDITS "XIII. Credits"

   @{b}XIII. Credits@{ub}  
 
   (In alphabetischer Reihenfolge)

   @{b}Frédéric Botton@{ub} von EDUCOM, Paris - Frankreich,
     für sein Programm «Gimme_a_CD» und seine Ideen.

   @{b}Marc Eisenach@{ub}, Stadtallendorf - Deutschland,
     für seine Anrufe, das Gespräch über CDTV und für verschiedene
     Informationen zur Hardware.

   @{b}Fred Fish@{ub}, Tempe - USA
     für das Hereinnehmen meiner Programme in seine tolle Kollektion.

   @{b}Imke Gisch@{ub}, Produktmanager CDTV von Commodore - Deutschland,
     für die schnelle Unterstützung und die Dokumente.

   @{b}Dr. Peter Kittel@{ub} von Commodore - Deutschland,
     für sein AMIGA-BASIC-Programm und den Artikel in der "AMIGA-DOS".

   @{b}Tom Kroener@{ub}, Saarbrücken-Dudweiler - Deutschland,
     für seine Briefe, seine Kritik und seine Ideen.

   @{b}Gerhard Leibrock@{ub}, Kirkel - Deutschland,
     für seine Briefe und seine Ideen.

   @{b}Arthur T. Murray@{ub}, Seattle - USA,
     für seine Postkarte.

   @{b}Werner Völker@{ub}, Ebersbach - Deutschland
     für seinen Anruf und das Gespräch über CDTV, AMIGA & PARNET.

   wird fortgesetzt...

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

   ***************************************************************
   **                                                           **
   **      Sie können mir in folgenden Sprachen schreiben:      **
   **   Ceský, Deutsch, English, Français, Italiano, Russkij.   **
   **                                                           **
   **  @{b}Schneckenpost:@{ub} Daniel Amor                               **
   **                 Ludwigstr. 124                            **
   **                 7000 Stuttgart 1                          **
   **                 Germany                                   **
   **                                                           **
   **  @{b}E-Mail:@{ub}        amor@student.uni-tuebingen.de             **
   **  @{b}FidoNet: @{ub}      2:2407/106 (Intuition Base)               **
   **                                                           **
   ***************************************************************
@endnode
