   *******************************
   **                           **
   **      CDTV-Player 2.1      **
   **                           **
   **    crit en avril 1993    **
   **                           **
   **      par Daniel Amor      **
   **                           **
   **        traduit par        **
   **                           **
   **     Frdric Botton       **
   **                           **
   *******************************

   I. Introduction

   Bienvenue  CDTV-Player 2.1

   L'ide de ce programme m'est venue alors que j'tais assis devant mon
   CDTV, avec l'envie d'couter de la musique et de travailler en mme temps.
   Il est possible d'utiliser la touche Play lorsqu'on se trouve sous
   Workbench, mais rien d'autre que le numro de la piste n'est affich.
   L'autre possiblit pour jouer des CD-Audio est de dire adieu au multi-
   tches et d'utiliser l'cran intgr au CDTV. Je trouve cette solution
   peu agrable. Dans le magazine Allemand 'AMIGA-DOS', j'ai trouv un
   programme crit par le Dr. Peter Kittel de Commodore - Allemagne en AMIGA
   BASIC. Ce programme ressemblait plus  un programme pour C-64 avec des
   tas de PEEKS et de POKES. Alors je l'ai traduit en KICK-PASCAL (200 lignes
   d'AMIGA-BASIC contre 15 de KICK-PASCAL) et j'ai cr une interface sous
   Workbench (septembre 1992). Ce programme est FISH-WARE. Commodore peut
   mme inclure ce programme dans le package du CDTV ou l'offrir avec chaque
   CD-ROM. Si vous utilisez ce programme a des fins commerciales, n'oubliez
   pas de mentionner mon nom.

   II Fonctionnalits

   CDTV-Player 2.1 offre pas mal de nouvelles options. Tout d'abord, j'ai
   rajout des Prfrences afin de rendre le programme intuitif (ceci sera
   encore travaill dans les futures versions). J'ai alors programm une
   routine qui reconnait un CD si il se trouve dans la bbiliothque (Merci
    Frdric Botton - Paris pour son programme <Gimme_a_CD> et pour l'ide).
   J'ai ensuite introduit une fonction SHUFFLE (choix alatoire) et une option
   pour avancer et reculer de quelques secondes. Dans les versions
   prcdentes, seuls les utilisateurs d'un lecteur CDROM pouvaient utiliser
   le programme. Maintenant tout possesseur d'Amiga a accs  la bibliothque
   afin de rechercher une chanson, ou encore jeter un oeil au programme. J'ai
   maintenant inclus une fonction KARAOKE. Si les paroles sont prsentes dans
   la bibliothque, elles sont affiches  l'cran. Maintenant un port AREXX
   a t inclus afin de contrler le CDTV depuis d'autres programmes.

   
   III. Gadgets

   REW     : Une piste en arrire.
   PLAY    : Joue la piste actuelle.
   FF      : Une piste en avant.
   PAUSE   : Fait une pause.
   STOP    : Stop.
   FADE    : Descend/Augmente doucement le volume.
   LIVE    : FADE automatique en dbut et fin de chaque piste.
   SINGLE  : Choisit entre jouer une seule piste ou le CD en entier.
   REPEAT  : Choisit entre jouer une seule fois ou plusieurs.
   BACK    : Revient de deux secondes en arrire.
   SCAN    : Scanne chaque piste du CD.
   FORTH   : Avance de deux secondes.
   SECRET  : Pour de futures options.
   KARAOKE : KARAOKE  l'cran. (voir V. KARAOKE)
   SHUFFLE : Choisit entre jouer en ordre normal ou alatoirement.
   PROGRAM : Dfinit un ordre de jeu.
   PREFS   : Les prfrences internes. (Voir VII. PREFERENCES)
   EDIT    : Ouvre la fentre d'dition (Voir IV. EDIT)
   DISPLAY : Choisit le mode d'affichage :
             1. Temps depuis le dbut de la piste.
             2. Temps depuis le dbut du CD.
             3. Temps restant avant la fin de la piste.
             4. Temps restant avant la fin du CD.
             5. Pas d'affichage (libre le processeur !).
             Les modes 3 & 4 ne sont accessibles que lorsque SINGLE n'est
             pas activ.
   INFO    : A propos...

   Sur le ct droit de la fentre, il y a un ascenseur pour contrler le
   volume.


   IV. Edit.

   ATTENTION: Cette fonction n'est pas encore totalement oprationnelle.

   En appuyant sur le gadget EDIT dans la fentre principale, une autre
   fentre s'ouvrira, et vous aurez accs  la bibliothque. Dans les versions
   antrieures, vous deviez choisir le CD que vous vouliez couter. Ceci est
   maintenant automatique, vous pouvez donc jeter un coup d'oeil  la
   bibliothque ds maintenant. Vous pouvez visualiser les pistes en
   choisissant le titre correspondant. Si CDTV-Player ne trouve pas le CD
   dans la bibliothque, vous pouvez l'ajouter en appuyant sur le gadget ADD.
   Une nouvelle fentre s'ouvrira et vous pourrez faire la saisie de votre CD.
   Aprs avoir quitt la fentre grce au gadget CLOSE, le CD sera
   automatiquement insr dans la bibliothque.


   V. Karaoke

   Lorsque vous activez le gadget KARAOKE dans la fentre principale, le
   programme recherche les paroles de la piste en cours. Si il les trouve,
   elles seront affiches sur un cran spar, pendant le jeu de la piste.
   Il n'y a pas, pour l'instant, d'effets spciaux, mais je vais en ajouter
   dans un proche futur (toutes les ides sont les bienvenues). Si vous
   voulez crer vos propres chansons KARAOKE, regardez le fichier 
   'lyrics:depeche mode.mx' (le seul complet, je suis trop paresseux pour
   taper les autres paroles). Lorsqu'un Genlock est branch, vous pouvez
   l'utiliser pour KARAOKE.


   VI. Bibliothque

   ATTENTION: Le format de la bibliothque est encore en dveloppement.
   Les futures versions pourront ne pas tre compatibles avec le format
   actuel.

   La bibliothque est divise en fait en deux parties. La premire regroupe
   les noms des artistes et les noms des CD, les dures des CD, les nombres
   de pistes (par exemple Brian Adams, Waking up the neighbours, 74:54.38|15).
   Dans les version prcdentes, je n'utilisais pas les fractions de seconde
   et le nombre de pistes, ce qui tait insuffisant pour retrouver les CD
   dans la bibliothque. J'ai donc d les inclure. Regardez le fichier 
   'Lyrics/A-ZMusix' pour comprendre comment construire sa propre
   bibliothque. La seconde partie de la bibliothque se compose des fichiers
   contenant les noms des pistes et ventuellement les paroles.


   VII. Prfrences

   Dans ce menu, vous pouvez modifier les prfrences internes de certaines
   fonctions. Sur le ct gauche, vous trouverez deux gadgets. Celui du
   dessus vous permet de choisir le temps de FADE en dbut et fin de chaque
   piste (1sec  10sec). Le gadget du bas vous permet de choisir le temps de
   SCAN de chaque piste (5sec  25sec). Sur le ct droit, vous trouverez
   deux gadgets concernant la fonction Karaoke. Break vous permet de quitter
   la fonction KARAOKE  tout moment (un gadget de fermeture apparat 
   l'cran) et Time affiche le temps de jeu sur l'cran KARAOKE. Ceci a t
   ajout pour faciliter la saisie des paroles en mode KARAOKE.


   VIII. Le futur
 
   Je vais inclure une fonction appele COPY, qui simplifie la copie de CD
   sur des cassettes. Vous devrez simplement taper le temps exact de la
   cassette et le programme effectuera une slection des pistes pour respecter
   ce temps au mieux.

   Si ce programme fonctionne correctement sur les lecteurs CDROM A570/A670,
   j'aimerai ajouter un port AREXX. Ceci autorisera d'autres programmes 
   accder aux fonctions de CDTV-Player pour leur propre utilisation (par
   exemple pour des applications Multi-Mdia).
   CE PORT EST DESORMAIS INCLUS.

   Je vais essayer d'utiliser PARNET avec mon programme pour par exemple
   utiliser un AMIGA 4000 pour la fonction KARAOKE alors que le CDTV joue
   les pistes audio (pour plus d'effets).

   J'essayerai de supporter les lecteurs CDROM SCSI (si vous avez des
   informations sur des lecteurs SCSI, merci de l'crire !).

   Si quelqu'un a d'autres suggestions, des requtes ou de prcieuses infos,
   crivez-moi (Voir XII. Remerciements).


   IX. Sources du programme

   Vous pouvez obtenir le source du programme gratuitement, si vous m'crivez
   et m'envoyez une disquette. Toutes suggestions et ides sont les
   bienvenues. CDTV-Player a t crit en KICK-PASCAL 2.12.


   X. Assigns

   Pour l'instant, vous devez faire un ASSIGN afin de pouvoir exploiter la
   bibliothque (Dsol). Par exemple, si le rpertoire CDTV-Player se trouve
   en DF1:, faites un ASSIGN Lyrics: DF1:CDTV-Player/Lyrics. J'ai inclus un
   script pour un meilleure comprhension.


   XI. Arexx

   Arexx a t introduit afin de contrler CDTV-Player depsui d'autres
   programmes. Rfrez-vous aux exemples sur la disquette. Pour l'instant,
   vous ne pouvez que dmarrer une piste et l'arrter. Les prochaines versions
   vous donneront un contrle complet !


   XII. Historique de CDTV-Player

   Version 0.8 (12.09.92)

   Traduction du programme AMIGA-BASIC du Dr. Peter Kittel en KICK-PASCAL.
   Joue les pistes depuis le CLI/SHELL sans interface WorkBench.

   Version 0.9 (14.09.92)

   Ajout de l'interface WorkBench afib de jouer les pistes sans clavier.
   Ajout des focntion comme PAUSE, SCAN, SINGLE, REPEAT, FADE, DISPLAY.

   Version 1.0 (18.09.92) Fish-Disk 759

   Premire version officielle avec une floppe de bugs (par exemple, le
   programme ne reconnaissait pas si un CD tait mis ou enlev du lecteur).
   Ajout d'un fentre INFO. Changement de la gestion interne du 'cdtv.device'.
   Rflexion sur la possibilit d'une fonction KARAOKE, sans trop savoir
   comment la raliser.

   Version 1.2 (26.10.92)

   R-criture de l'interface WorkBench et ajout de la fentre KARAOKE.
   Ceci n'a rien  voir avec la fonction KARAOKE, mais vous pouviez choisir
   les titres d'un CD pendant qu'un CD tait jou. Suppression de tous les
   bugs concernant le problme du changement de CD. 

   Version 1.3 (05.11.92)

   Ajout d'un message pour les machines non quippes d'un 'cdtv.device'.
   Augementation gnrale de la vitesse du programme, et rduction du temps
   processeur utilis.

   Version 1.4 (26.11.92)

   Ajout de nouveaux bugs en voulant en supprimer d'autres. Beaucoup de 
   changements internes (Vous ne pouvez pas 'voir' la diffrence entre la
   version 1.3 et 1.4, mais la 1.4 est plus sre).

   Version 1.5 (25.12.92) Fish-Disk 805

   Augmentation de la taille de la fentre KARAOKE et ajout de gadgets.
   Mise  jour de la documentation et encore gain de vitesse. Suppression de
   tous les bugs de la fonction KARAOKE.

   Version 1.5d (29.12.92)

   Suppression d'un petit bug dans le requester INFO qui donnait parfois
   lieu  un plantage. Dommage car j'avais envoy la disquette 4 jours
   auparavant.

   Version 1.6 (11.01.93)

   KARAOKE est renomm en EDIT, du fait que je n'avais pas le temps
   d'implanter une relle fonction KARAOKE a ce moment. Augmentation de la
   vitesse d'affichage de la fonction EDIT, grce  un changement des
   structures dynamiques (Hmm, voil au moins une chose apprise 
   l'Universit qui est utile). Ecriture du code sur A4000 (plus de mmoire,
   plus de fun). Ajout de la fonction SHUFFLE.

   Version 1.7f (25.01.93)

   Troisime version officielle de CDTV-Player. Maintenant tout possesseur
   d'un AMIGA peut lancer le programme et jeter un coup d'oeil aux gadgets,
   et utiliser la fonction EDIT pour rechercher une chanson. Ajout d'une
   fonction de recherche pour retrouver un CD dans la bibliothque et le
   charger automatiquement. Ajout des fonctions PREFS, BACK et FORTH.

   Version 1.7j (20.02.93)

   Ajout d'une fonction PROGRAM et de la possibilit de saisir vos propres
   CDs. Suppression de pas mal de lignes de code indsirables. Amlioration
   du design de la fonction EDIT. Suppression de bugs dans les fonctions
   SHUFFLE et PROGRAM (mme procdure interne).

   Version 1.8 (22.02.93) Fish-Disk 849

   Quatrime version officielle de CDTV-Player. Inclusion de la fonction
   KARAOKE (trs populaire au Japon et en Italie). Tout texte peut tre
   utilis pour cette option. Egalement inclusion de la fonction ADD CD,
   afin de saisir de nouveaux CDs.
 
   Version 1.9 (23.03.93)

   Ajout de nouvelles prfrences pour choisir les fonctions de KARAOKE.
   Maintenant KARAOKE peut tre arrt  tout moment, et il est possible de
   visualiser le temps. Augmentation des la vitesse de sortie de la fonction
   KARAOKE, et suppression de lignes de codes indsirables.

   Version 2.0 (04.04.93) Fish-Disk 868

   Cinquime version officielle de CDTV-Player. Inclut maintenant un port
   AREXX. Ceci vous permet d'utiliser les fonctions de CDTV-Player depuis
   d'autres programmes.

   Version 2.01 (23.04.93)

   Aaaargh. La version 2.0 ne fonctionnait pas sur des machines o la
   'arexx.library' n'tait pas installe. Je n'avais pas remarqu cela,
   du fait que j'utilisais Arexx sur mon CDTV.


   XIII. Remerciements

   (Dans l'ordre alphabtique)

   Markus Bahr, Berlin - ALLEMAGNE,
     pour sa lettre et son intrt.

   Thomas Bengtsson - SUDE,
     pour son e-mail & son intrt dans le programme source.

   Tomi Blinnikka, Helsinki - FINLANDE,
     pour son e-mail & son intrt.

   Frdric Botton, EDUCOM, Paris - FRANCE,
     pour son programme <Gimme_a_CD>, ses ides, ses lettres quadrilingues,
     ses e-mails et son sens de l'humour.

   Dimitrios Charalampidis, Thessaloniki - GRCE,
     pour ses lettres.

   Ioannis Chatziandreou, Bochum - ALLEMAGNE,
     pour son e-mail & son besoin urgent du source.

   Ross Delaforce - AUSTRALIE
     pour son e-mail & son ide pour le SCSI.

   Marc Eisenach, Stadtallendorf - ALLEMAGNE,
     pour ses coups de fil, la coversation sur le CDTV et pour les
     diffrentes informations sur le hardware.

   Hans-Christian Eckert, Berlin - GERMANY,
     pour ses e-mails, pour ses suggestions et son besoin du source.

   Darren Ewaniuk, Alberta - CANADA,
     pour son e-mail & pour l'inclusion de CDTV-Player dans ses produits.

   Fred Fish, Tempe - USA
     pour l'inclusion de mes programmes dans sa fantastique collection.

   Wlad Fomin & Dostick of ACL, Riga - LATVIA,
     pour leurs e-mails, leurs lettre russe, leurs intrt pour le CDTV & 
     AMIGA et leurs and leurs assistence.

   Imke Gisch, "Produktmanager CDTV" of Commodore - ALLEMAGNE,
     pour l'accs rapide aux documents.

   Andreas Happel, Flensburg - ALLEMAGNE,
     pour sa lettre, ses questions intressantes et pour l'intrt pour
     le CDTV.

   Dave Hassall - NEW ZEALAND,
     pour son e-mail et son intrt pour CDTV-Player.

   Peter Hellweg, Wetter - ALLEMAGNE,
     pour son e-mail.

   Sebastian Hesselbarth, Aerzen - ALLEMAGNE,
     pour sa lettre et ses ides.

   Kai Hofmann, Bremen - ALLEMAGNE,
     pour ses e-mails & son intrt pour le CDTV.

   Jason R. Hulance, Oxford - GRAND BRETAGNE,
     pour ses e-mails & l'intrt pour le source.

   D. Jarvis - USA
     pour ses e-mails et son besoin du source.

   Dr. Peter Kittel of Commodore - ALLEMAGNE,
     pour son programme AMIGA-BASIC et pour l'article dans "AMIGA-DOS".

   George Knighton, Fremont - USA,
     pour sa lettre et son intrt pour CDTV-Player.

   Thorsten Kratz, Erlangen - ALLEMAGNE,
     pour ses e-mails et pour ses ides.

   Tom Kroener, Saarbrcken-Dudweiler - ALLEMAGNE,
     pour ses lettres, critiques et ides.

   Gerhard Leibrock, Kirkel - ALLEMAGNE,
     pour ses lettres et ses ides.

   Wai Hung Liu, Dublin - IRLANDE,
     pour ses lettres et son intrt pour le CDTV.

   Thomas J. Moore - USA
     pour ses e-mails, ses bug-reports et pour ses suggestions 
     (look out for his C version of CDTV-Player).
     
   Felice Murolo, Salerno - ITALIE,
     pour sa lettre et son intrt pour le source de CDTV-Player.

   Arthur T. Murray, Seattle - USA,
     pour sa carte postale.

   Nhan Nguyen, Sophomore - USA
     pour son intrt pour le CDTV-Player, ses ides et ses e-mails.

   Stefan Ohlin, Solleftea - SUDE,
     pour son intrt pour le CDTV-Player et le besoin de source.

   Oliver Peike - ALLEMAGNE
     pour ses e-mails.

   Alfred Prenner, Frstenfeldbruck - ALLEMAGNE,
     pour sa lettre et pour son intrt pour le CDTV & Parnet.

   Uwe Ripl - ALLEMAGNE,
     pour son e-mail.

   Hanns Holger Rutz, Zeven - ALLEMAGNE,
     pour ses lettres, ses ides et ses bug-reports.

   Ralph Seichter, Hueth - ALLEMAGNE,
     pour ses e-mails et ses ides.

   Peter Uitz, Vienne - AUTRICHE,
     pour son intrt pour le documentation du CDTV.

   Federico Villata, Rome - ITALIE,
     pour son e-mail et son intrt pour le CDTV-Player.

   Jure Vrhovnik, Ljubljana - SLOWENIA,
     pour son intrt pour le CDTV, ses e-mails et ses specifications 
     du hardware (dream on).

   Werner Vlker, Ebersbach - ALLEMAGNE
     pour son coup de fil et la discussion au sujet du CDTV, de l'AMIGA et de
     PARNET.

   Michael Zielinski, Hamburg - ALLEMAGNE,
     pour ses ides et pour son intrt pour le CDTV.

    suivre...

   (Si vous aimez mon programme, faites-le moi savoir, et je vous mentionnerai
    ici...)

   ***************************************************************
   **                                                           **
   **                 Vous pouvez m'crire en                   **
   **   Cesk, Deutsch, English, Franais, Italiano, Russkij.   **
   **                                                           **
   **   Courrier : Daniel Amor                                  **
   **              Ludwigstr. 124                               **
   **              70197 Stuttgart                              **
   **              Allemagne                                    **
   **                                                           **
   **  E-Mail:     amor@student.uni-tuebingen.de                **
   **  FidoNet:    2:246/1416 (Amiga Universe)                  **
   **                                                           **
   ***************************************************************
