home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d894 / cdtv-player.lha / CDTV-Player / Docs / lismoi < prev    next >
Text File  |  1993-07-19  |  17KB  |  413 lines
  1.    *******************************
  2.    **                           **
  3.    **      CDTV-Player 2.0      **
  4.    **                           **
  5.    **    écrit en avril 1993    **
  6.    **                           **
  7.    **      par Daniel Amor      **
  8.    **                           **
  9.    **        traduit par        **
  10.    **                           **
  11.    **     Frédéric Botton       **
  12.    **                           **
  13.    *******************************
  14.  
  15.    I. Introduction
  16.  
  17.    Bienvenue à CDTV-Player 2.0
  18.  
  19.    L'idée de ce programme m'est venue alors que j'étais assis devant mon
  20.    CDTV, avec l'envie d'écouter de la musique et de travailler en même temps.
  21.    Il est possible d'utiliser la touche Play lorsqu'on se trouve sous
  22.    Workbench, mais rien d'autre que le numéro de la piste n'est affiché.
  23.    L'autre possiblité pour jouer des CD-Audio est de dire adieu au multi-
  24.    tâches et d'utiliser l'écran intégré au CDTV. Je trouve cette solution
  25.    peu agréable. Dans le magazine Allemand 'AMIGA-DOS', j'ai trouvé un
  26.    programme écrit par le Dr. Peter Kittel de Commodore - Allemagne en AMIGA
  27.    BASIC. Ce programme ressemblait plus à un programme pour C-64 avec des
  28.    tas de PEEKS et de POKES. Alors je l'ai traduit en KICK-PASCAL (200 lignes
  29.    d'AMIGA-BASIC contre 15 de KICK-PASCAL) et j'ai créé une interface sous
  30.    Workbench (septembre 1992). Ce programme est FISH-WARE. Commodore peut
  31.    même inclure ce programme dans le package du CDTV ou l'offrir avec chaque
  32.    CD-ROM. Si vous utilisez ce programme a des fins commerciales, n'oubliez
  33.    pas de mentionner mon nom.
  34.  
  35.    II Fonctionnalités
  36.  
  37.    CDTV-Player 2.0 offre pas mal de nouvelles options. Tout d'abord, j'ai
  38.    rajouté des Préférences afin de rendre le programme intuitif (ceci sera
  39.    encore travaillé dans les futures versions). J'ai alors programmé une
  40.    routine qui reconnait un CD si il se trouve dans la bbiliothèque (Merci
  41.    à Frédéric Botton - Paris pour son programme <Gimme_a_CD> et pour l'idée).
  42.    J'ai ensuite introduit une fonction SHUFFLE (choix aléatoire) et une option
  43.    pour avancer et reculer de quelques secondes. Dans les versions
  44.    précédentes, seuls les utilisateurs d'un lecteur CDROM pouvaient utiliser
  45.    le programme. Maintenant tout possesseur d'Amiga a accès à la bibliothèque
  46.    afin de rechercher une chanson, ou encore jeter un oeil au programme. J'ai
  47.    maintenant inclus une fonction KARAOKE. Si les paroles sont présentes dans
  48.    la bibliothèque, elles sont affichées à l'écran. Maintenant un port AREXX
  49.    a été inclus afin de contrôler le CDTV depuis d'autres programmes.
  50.  
  51.    
  52.    III. Gadgets
  53.  
  54.    REW     : Une piste en arrière.
  55.    PLAY    : Joue la piste actuelle.
  56.    FF      : Une piste en avant.
  57.    PAUSE   : Fait une pause.
  58.    STOP    : Stop.
  59.    FADE    : Descend/Augmente doucement le volume.
  60.    LIVE    : FADE automatique en début et fin de chaque piste.
  61.    SINGLE  : Choisit entre jouer une seule piste ou le CD en entier.
  62.    REPEAT  : Choisit entre jouer une seule fois ou plusieurs.
  63.    BACK    : Revient de deux secondes en arrière.
  64.    SCAN    : Scanne chaque piste du CD.
  65.    FORTH   : Avance de deux secondes.
  66.    SECRET  : Pour de futures options.
  67.    KARAOKE : KARAOKE à l'écran. (voir V. KARAOKE)
  68.    SHUFFLE : Choisit entre jouer en ordre normal ou aléatoirement.
  69.    PROGRAM : Définit un ordre de jeu.
  70.    PREFS   : Les préférences internes. (Voir VII. PREFERENCES)
  71.    EDIT    : Ouvre la fenêtre d'édition (Voir IV. EDIT)
  72.    DISPLAY : Choisit le mode d'affichage :
  73.              1. Temps depuis le début de la piste.
  74.              2. Temps depuis le début du CD.
  75.              3. Temps restant avant la fin de la piste.
  76.              4. Temps restant avant la fin du CD.
  77.              5. Pas d'affichage (libère le processeur !).
  78.              Les modes 3 & 4 ne sont accessibles que lorsque SINGLE n'est
  79.              pas activé.
  80.    INFO    : A propos...
  81.  
  82.    Sur le côté droit de la fenêtre, il y a un ascenseur pour contrôler le
  83.    volume.
  84.  
  85.  
  86.    IV. Edit.
  87.  
  88.    ATTENTION: Cette fonction n'est pas encore totalement opérationnelle.
  89.  
  90.    En appuyant sur le gadget EDIT dans la fenêtre principale, une autre
  91.    fenêtre s'ouvrira, et vous aurez accès à la bibliothèque. Dans les versions
  92.    antérieures, vous deviez choisir le CD que vous vouliez écouter. Ceci est
  93.    maintenant automatique, vous pouvez donc jeter un coup d'oeil à la
  94.    bibliothèque dès maintenant. Vous pouvez visualiser les pistes en
  95.    choisissant le titre correspondant. Si CDTV-Player ne trouve pas le CD
  96.    dans la bibliothèque, vous pouvez l'ajouter en appuyant sur le gadget ADD.
  97.    Une nouvelle fenêtre s'ouvrira et vous pourrez faire la saisie de votre CD.
  98.    Après avoir quitté la fenêtre grâce au gadget CLOSE, le CD sera
  99.    automatiquement inséré dans la bibliothèque.
  100.  
  101.  
  102.    V. Karaoke
  103.  
  104.    Lorsque vous activez le gadget KARAOKE dans la fenêtre principale, le
  105.    programme recherche les paroles de la piste en cours. Si il les trouve,
  106.    elles seront affichées sur un écran séparé, pendant le jeu de la piste.
  107.    Il n'y a pas, pour l'instant, d'effets spéciaux, mais je vais en ajouter
  108.    dans un proche futur (toutes les idées sont les bienvenues). Si vous
  109.    voulez créer vos propres chansons KARAOKE, regardez le fichier 
  110.    'lyrics:depeche mode.mx' (le seul complet, je suis trop paresseux pour
  111.    taper les autres paroles). Lorsqu'un Genlock est branché, vous pouvez
  112.    l'utiliser pour KARAOKE.
  113.  
  114.  
  115.    VI. Bibliothèque
  116.  
  117.    ATTENTION: Le format de la bibliothèque est encore en développement.
  118.    Les futures versions pourront ne pas être compatibles avec le format
  119.    actuel.
  120.  
  121.    La bibliothèque est divisée en fait en deux parties. La première regroupe
  122.    les noms des artistes et les noms des CD, les durées des CD, les nombres
  123.    de pistes (par exemple Brian Adams, Waking up the neighbours, 74:54.38|15).
  124.    Dans les version précédentes, je n'utilisais pas les fractions de seconde
  125.    et le nombre de pistes, ce qui était insuffisant pour retrouver les CD
  126.    dans la bibliothèque. J'ai donc dû les inclure. Regardez le fichier 
  127.    'Lyrics/A-ZMusix' pour comprendre comment construire sa propre
  128.    bibliothèque. La seconde partie de la bibliothèque se compose des fichiers
  129.    contenant les noms des pistes et éventuellement les paroles.
  130.  
  131.  
  132.    VII. Préférences
  133.  
  134.    Dans ce menu, vous pouvez modifier les préférences internes de certaines
  135.    fonctions. Sur le côté gauche, vous trouverez deux gadgets. Celui du
  136.    dessus vous permet de choisir le temps de FADE en début et fin de chaque
  137.    piste (1sec à 10sec). Le gadget du bas vous permet de choisir le temps de
  138.    SCAN de chaque piste (5sec à 25sec). Sur le côté droit, vous trouverez
  139.    deux gadgets concernant la fonction Karaoke. Break vous permet de quitter
  140.    la fonction KARAOKE à tout moment (un gadget de fermeture apparaît à
  141.    l'écran) et Time affiche le temps de jeu sur l'écran KARAOKE. Ceci a été
  142.    ajouté pour faciliter la saisie des paroles en mode KARAOKE.
  143.  
  144.  
  145.    VIII. Le futur
  146.  
  147.    Je vais inclure une fonction appelée COPY, qui simplifie la copie de CD
  148.    sur des cassettes. Vous devrez simplement taper le temps exact de la
  149.    cassette et le programme effectuera une sélection des pistes pour respecter
  150.    ce temps au mieux.
  151.  
  152.    Si ce programme fonctionne correctement sur les lecteurs CDROM A570/A670,
  153.    j'aimerai ajouter un port AREXX. Ceci autorisera d'autres programmes à
  154.    accéder aux fonctions de CDTV-Player pour leur propre utilisation (par
  155.    exemple pour des applications Multi-Média).
  156.    CE PORT EST DESORMAIS INCLUS.
  157.  
  158.    Je vais essayer d'utiliser PARNET avec mon programme pour par exemple
  159.    utiliser un AMIGA 4000 pour la fonction KARAOKE alors que le CDTV joue
  160.    les pistes audio (pour plus d'effets).
  161.  
  162.    J'essayerai de supporter les lecteurs CDROM SCSI (si vous avez des
  163.    informations sur des lecteurs SCSI, merci de l'écrire !).
  164.  
  165.    Si quelqu'un a d'autres suggestions, des requêtes ou de précieuses infos,
  166.    écrivez-moi (Voir XII. Remerciements).
  167.  
  168.  
  169.    IX. Sources du programme
  170.  
  171.    Vous pouvez obtenir le source du programme gratuitement, si vous m'écrivez
  172.    et m'envoyez une disquette. Toutes suggestions et idées sont les
  173.    bienvenues. CDTV-Player a été écrit en KICK-PASCAL 2.12.
  174.  
  175.  
  176.    X. Assigns
  177.  
  178.    Pour l'instant, vous devez faire un ASSIGN afin de pouvoir exploiter la
  179.    bibliothèque (Désolé). Par exemple, si le répertoire CDTV-Player se trouve
  180.    en DF1:, faites un ASSIGN Lyrics: DF1:CDTV-Player/Lyrics. J'ai inclus un
  181.    script pour un meilleure compréhension.
  182.  
  183.  
  184.    XI. Arexx
  185.  
  186.    Arexx a été introduit afin de contrôler CDTV-Player depsui d'autres
  187.    programmes. Référez-vous aux exemples sur la disquette. Pour l'instant,
  188.    vous ne pouvez que démarrer une piste et l'arrêter. Les prochaines versions
  189.    vous donneront un contrôle complet !
  190.  
  191.  
  192.    XII. Historique de CDTV-Player
  193.  
  194.    Version 0.8 (12.09.92)
  195.  
  196.    Traduction du programme AMIGA-BASIC du Dr. Peter Kittel en KICK-PASCAL.
  197.    Joue les pistes depuis le CLI/SHELL sans interface WorkBench.
  198.  
  199.    Version 0.9 (14.09.92)
  200.  
  201.    Ajout de l'interface WorkBench afib de jouer les pistes sans clavier.
  202.    Ajout des focntion comme PAUSE, SCAN, SINGLE, REPEAT, FADE, DISPLAY.
  203.  
  204.    Version 1.0ß (18.09.92) Fish-Disk 759
  205.  
  206.    Première version officielle avec une floppée de bugs (par exemple, le
  207.    programme ne reconnaissait pas si un CD était mis ou enlevé du lecteur).
  208.    Ajout d'un fenêtre INFO. Changement de la gestion interne du 'cdtv.device'.
  209.    Réflexion sur la possibilité d'une fonction KARAOKE, sans trop savoir
  210.    comment la réaliser.
  211.  
  212.    Version 1.2 (26.10.92)
  213.  
  214.    Ré-écriture de l'interface WorkBench et ajout de la fenêtre KARAOKE.
  215.    Ceci n'a rien à voir avec la fonction KARAOKE, mais vous pouviez choisir
  216.    les titres d'un CD pendant qu'un CD était joué. Suppression de tous les
  217.    bugs concernant le problème du changement de CD. 
  218.  
  219.    Version 1.3 (05.11.92)
  220.  
  221.    Ajout d'un message pour les machines non équippées d'un 'cdtv.device'.
  222.    Augementation générale de la vitesse du programme, et réduction du temps
  223.    processeur utilisé.
  224.  
  225.    Version 1.4 (26.11.92)
  226.  
  227.    Ajout de nouveaux bugs en voulant en supprimer d'autres. Beaucoup de 
  228.    changements internes (Vous ne pouvez pas 'voir' la différence entre la
  229.    version 1.3 et 1.4, mais la 1.4 est plus sûre).
  230.  
  231.    Version 1.5 (25.12.92) Fish-Disk 805
  232.  
  233.    Augmentation de la taille de la fenêtre KARAOKE et ajout de gadgets.
  234.    Mise à jour de la documentation et encore gain de vitesse. Suppression de
  235.    tous les bugs de la fonction KARAOKE.
  236.  
  237.    Version 1.5d (29.12.92)
  238.  
  239.    Suppression d'un petit bug dans le requester INFO qui donnait parfois
  240.    lieu à un plantage. Dommage car j'avais envoyé la disquette 4 jours
  241.    auparavant.
  242.  
  243.    Version 1.6 (11.01.93)
  244.  
  245.    KARAOKE est renommé en EDIT, du fait que je n'avais pas le temps
  246.    d'implanter une réelle fonction KARAOKE a ce moment. Augmentation de la
  247.    vitesse d'affichage de la fonction EDIT, grâce à un changement des
  248.    structures dynamiques (Hmm, voilà au moins une chose apprise à
  249.    l'Université qui est utile). Ecriture du code sur A4000 (plus de mémoire,
  250.    plus de fun). Ajout de la fonction SHUFFLE.
  251.  
  252.    Version 1.7f (25.01.93)
  253.  
  254.    Troisième version officielle de CDTV-Player. Maintenant tout possesseur
  255.    d'un AMIGA peut lancer le programme et jeter un coup d'oeil aux gadgets,
  256.    et utiliser la fonction EDIT pour rechercher une chanson. Ajout d'une
  257.    fonction de recherche pour retrouver un CD dans la bibliothèque et le
  258.    charger automatiquement. Ajout des fonctions PREFS, BACK et FORTH.
  259.  
  260.    Version 1.7j (20.02.93)
  261.  
  262.    Ajout d'une fonction PROGRAM et de la possibilité de saisir vos propres
  263.    CDs. Suppression de pas mal de lignes de code indésirables. Amélioration
  264.    du design de la fonction EDIT. Suppression de bugs dans les fonctions
  265.    SHUFFLE et PROGRAM (même procédure interne).
  266.  
  267.    Version 1.8 (22.02.93) Fish-Disk 849
  268.  
  269.    Quatrième version officielle de CDTV-Player. Inclusion de la fonction
  270.    KARAOKE (très populaire au Japon et en Italie). Tout texte peut être
  271.    utilisé pour cette option. Egalement inclusion de la fonction ADD CD,
  272.    afin de saisir de nouveaux CDs.
  273.  
  274.    Version 1.9 (23.03.93)
  275.  
  276.    Ajout de nouvelles préférences pour choisir les fonctions de KARAOKE.
  277.    Maintenant KARAOKE peut être arrêté à tout moment, et il est possible de
  278.    visualiser le temps. Augmentation des la vitesse de sortie de la fonction
  279.    KARAOKE, et suppression de lignes de codes indésirables.
  280.  
  281.    Version 2.0 (04.04.93) Fish-Disk 868
  282.  
  283.    Cinquième version officielle de CDTV-Player. Inclut maintenant un port
  284.    AREXX. Ceci vous permet d'utiliser les fonctions de CDTV-Player depuis
  285.    d'autres programmes.
  286.  
  287.    Version 2.01 (23.04.93)
  288.  
  289.    Aaaargh. La version 2.0 ne fonctionnait pas sur des machines où la
  290.    'arexx.library' n'était pas installée. Je n'avais pas remarqué cela,
  291.    du fait que j'utilisais Arexx sur mon CDTV.
  292.  
  293.  
  294.    XIII. Remerciements
  295.  
  296.    (Dans l'ordre alphabétique)
  297.  
  298.    Thomas Bengtsson - SUÈDE,
  299.      pour son e-mail & son intérêt dans le programme source.
  300.  
  301.    Tomi Blinnikka, Helsinki - FINLANDE,
  302.      pour son e-mail & son intérêt.
  303.  
  304.    Frédéric Botton, EDUCOM, Paris - FRANCE,
  305.      pour son programme <Gimme_a_CD>, ses idées, ses lettres quadrilingues,
  306.      ses e-mails et son sens de l'humour.
  307.  
  308.    Ioannis Chatziandreou, Bochum - ALLEMAGNE,
  309.      pour son e-mail & son besoin urgent du source.
  310.  
  311.    Ross Delaforce - AUSTRALIE
  312.      pour son e-mail & son idée pour le SCSI.
  313.  
  314.    Marc Eisenach, Stadtallendorf - ALLEMAGNE,
  315.      pour ses coups de fil, la coversation sur le CDTV et pour les
  316.      différentes informations sur le hardware.
  317.  
  318.    Hans-Christian Eckert, Berlin - GERMANY,
  319.      pour ses e-mails, pour ses suggestions et son besoin du source.
  320.  
  321.    Darren Ewaniuk, Alberta - CANADA,
  322.      pour son e-mail & pour l'inclusion de CDTV-Player dans ses produits.
  323.  
  324.    Fred Fish, Tempe - USA
  325.      pour l'inclusion de mes programmes dans sa fantastique collection.
  326.  
  327.    Wlad Fomin & Dostick of ACL, Riga - LATVIA,
  328.      pour leurs e-mails, leurs lettre russe, leurs intérêt pour le CDTV & 
  329.      AMIGA et leurs and leurs assistence.
  330.  
  331.    Imke Gisch, "Produktmanager CDTV" of Commodore - ALLEMAGNE,
  332.      pour l'accès rapide aux documents.
  333.  
  334.    Dave Hassall - NEW ZEALAND,
  335.      pour son e-mail et son intérêt pour CDTV-Player.
  336.  
  337.    Kai Hofmann, Bremen - ALLEMAGNE,
  338.      pour ses e-mails & son intérêt pour le CDTV.
  339.  
  340.    Jason R. Hulance, Oxford - GRAND BRETAGNE,
  341.      pour ses e-mails & l'intérêt pour le source.
  342.  
  343.    D. Jarvis - USA
  344.      pour ses e-mails et son besoin du source.
  345.  
  346.    Dr. Peter Kittel of Commodore - ALLEMAGNE,
  347.      pour son programme AMIGA-BASIC et pour l'article dans "AMIGA-DOS".
  348.  
  349.    George Knighton, Fremont - USA,
  350.      pour sa lettre et son intérêt pour CDTV-Player.
  351.  
  352.    Tom Kroener, Saarbrücken-Dudweiler - ALLEMAGNE,
  353.      pour ses lettres, critiques et idées.
  354.  
  355.    Gerhard Leibrock, Kirkel - ALLEMAGNE,
  356.      pour ses lettres et ses idées.
  357.  
  358.    Thomas J. Moore - USA
  359.      pour ses e-mails, ses bug-reports et pour ses suggestions 
  360.      (look out for his C version of CDTV-Player).
  361.      
  362.    Arthur T. Murray, Seattle - USA,
  363.      pour sa carte postale.
  364.  
  365.    Nhan Nguyen, Sophomore - USA
  366.      pour son intérêt pour le CDTV-Player, ses idées et ses e-mails.
  367.  
  368.    Stefan Ohlin, Solleftea - SUÈDE,
  369.      pour son intérêt pour le CDTV-Player et le besoin de source.
  370.  
  371.    Oliver Peike - ALLEMAGNE
  372.      pour ses e-mails.
  373.  
  374.    Alfred Prenner, Fürstenfeldbruck - ALLEMAGNE,
  375.      pour sa lettre et pour son intérêt pour le CDTV & Parnet.
  376.  
  377.    Hanns Holger Rutz, Zeven - ALLEMAGNE,
  378.      pour ses lettres, ses idées et ses bug-reports.
  379.  
  380.    Peter Uitz, Vienne - AUTRICHE,
  381.      pour son intérêt pour le documentation du CDTV.
  382.  
  383.    Federico Villata, Rome - ITALIE,
  384.      pour son e-mail et son intérêt pour le CDTV-Player.
  385.  
  386.    Jure Vrhovnik, Ljubljana - SLOWENIA,
  387.      pour son intérêt pour le CDTV, ses e-mails et ses specifications 
  388.      du hardware (dream on).
  389.  
  390.    Werner Völker, Ebersbach - ALLEMAGNE
  391.      pour son coup de fil et la discussion au sujet du CDTV, de l'AMIGA et de
  392.      PARNET.
  393.  
  394.    à suivre...
  395.  
  396.    (Si vous aimez mon programme, faites-le moi savoir, et je vous mentionnerai
  397.     ici...)
  398.  
  399.    ***************************************************************
  400.    **                                                           **
  401.    **                 Vous pouvez m'écrire en                   **
  402.    **   Ceský, Deutsch, English, Français, Italiano, Russkij.   **
  403.    **                                                           **
  404.    **   Courrier : Daniel Amor                                  **
  405.    **              Ludwigstr. 124                               **
  406.    **              70197 Stuttgart                              **
  407.    **              Allemagne                                    **
  408.    **                                                           **
  409.    **  E-Mail:     amor@student.uni-tuebingen.de                **
  410.    **  FidoNet:    2:2407/106 (Intuition Base)                  **
  411.    **                                                           **
  412.    ***************************************************************
  413.