                                   DigitalCD
                                   

                         Version 3.16, 21 Dcembre 2023
  
   Introduction 

   Lecteurs:               Listes:                
     CDs                    Liste principale    
     Fichiers               File de fichiers    
     Radios internet        Liste secondaire    
     Moniteur sonore        Liste-rpertoire    
   Panneaux de contrle      Liste importes     
                             Pages Jaunes        
                                                  
   Base de donnes CD      Prfrences (sections) 
  
   Gestion des ressources:
     Types de fichiers accepts
     Skins 
     Plug-Ins de visualisation 

   Applications externes requises 

   Liste   Vue arborescente   Problmes et solutions 

         Table des matires    Index   Licence    Crdits    Historique 
  
                                                 Freeware,  Andr Timmermans 


                                   Introduction
                                   

    DigitalCD est un lecteur musical de bureau compatible avec les versions
    3.1 et ultrieures de RISC OS. Il vous fournit des lecteurs indpendants
    pour vos CDs, vos fichiers musicaux et vos stations de radio internet,
    ainsi qu'un moniteur sonore.

    Je vous recommande de commencer par la lecture des concepts de lecteurs,
    panneaux de contrle et de listes.

    Aprs cela, l'utilisation de chacun des types de lecteurs de DigitalCD
    est dcrite dans les liens suivants:

       Lecteur CD
       Lecteur de fichiers
       Lecteur de radios internet
       Moniteur sonore

    DigitalCD offre d'autres attraits tels que les skins, les plug-ins de
    visualisation ou une base de donnes CD. La fentre des prfrences vous
    permet de configurer chaque aspect de DigitalCD. Si vous rencontrez des
    problmes avec ce programme, n'hsitez pas  consulter la section
    problmes et solutions.

    DigitalCD supporte l'aide interactive. Pour cela, chargez l'application
    Help fournie avec votre ordinateur, ou encore une application alternative
    telle que BubbleHelp ou Float. Cette aide interactive vous fournira une
    rapide explication sur chaque fonction de DigitalCD.


                             Introduction: Jouer un CD
                             

      Pour jouer un CD, commencer par ouvrir le menu de DigitalCD sur la
      barre d'icnes, et choisissez dans le sous-menu Lecteurs le lecteur que
      vous voulez utiliser. Le panneau de contrle de ce lecteur s'affichera
      alors. Insrer le CD dans le lecteur et attendez qu'il soit dtect.
      Cela ce voit car le message 'Le lecteur CD n x est vide' est remplac
      par une nouvelle indication. Cliquez ensuite Jouer pour dmarrer la
      lecture CD. Si le mode programme est teint, les pistes seront joues
      dans le mme ordre que sur le CD. Si le mode programme est actif, les
      pistes seront joues dans l'ordre spcifi par votre liste des favoris.
      Pour plus de dtails sur la fentre du lecteur CD, consulter la
      documentation du panneau de contrle.

      La base de donnes CD vous permet de stocker des informations sur le
      CD, telles que le titre et l'artiste du CD et de chacune des pistes.
      Vous pouvez introduire ces informations manuellement, ou utiliser
      AcornCD pour les rcuprer d'internet.

      Note

      Certains lecteurs CD ne fonctionnent pas toujours correctement sous
      RISC OS, mais la plupart des problmes peuvent tre contourns. Si vous
      avez des problmes de lecture de vos CDs, consultez la section
      problmes et solutions de ce manuel.


                          Introduction: Jouer des fichiers
                          

      Pour jouer des fichiers musicaux commencer par ouvrir le menu de
      DigitalCD sur la barre d'icnes et choisissez soit Liste principale,
      soit File de fichiers.

      Une liste apparat, vide au dpart. Fates glisser et dposez une ou
      plusieurs icnes de fichiers ou de rpertoires sur la liste afin de les
      ajouter  la liste. Si vous dposez l'icne d'un rpertoire, tous les
      fichiers musicaux contenus dans ce rpertoire et dans ses
      sous-rpertoires seront ajouts.

      La diffrence premire entre les deux types de liste est que le contenu
      de la liste principale est automatiquement sauvegard lorsque vous
      quittez DigitalCD, tandis que le contenu de la file de fichiers est
      strictement temporaire et sera perdu en sortie.

      Pour jouer des fichiers de votre liste, ouvrez le menu de DigitalCD sur
      la barre d'icnes et choisissez Lecteur de fichiers dans le sous-menu
      Lecteurs. Le panneau de contrle de ce lecteur s'affiche alors et vous
      devez vous assurer de l'tat du mode programme afin de jouer des pistes
      de la bonne liste: actif pour la liste principale et inactif pour la
      file de fichiers.

      Cliquez sur le bouton Jouer pour dmarrer la lecture. Pour plus
      d'information, rfrez-vous  la documentation du panneau de contrle.

      Les liens suivants dcrivent la gestion des listes et le contrle de
      l'ordre de lecture des pistes avec plus de dtails.


                       Introduction: Jouer une radio Internet
                       

      DigitalCD supporte les radios Internet qui se prsentent sous la forme
      de flots HTTP de type MPEG audio ou Ogg Vorbis (les autres types de
      formats tels que AAC ou WMA ne sont pas supports). Toutefois, votre
      machine ainsi que DigitalCD doivent tre convenablement configurs
      avant de pouvoir couter ces radios. Vous avez besoin d'un fichier
      MimeMap  jour, et vous devez configurer DigitalCD, si ncessaire, avec
      les dtails de votre proxy internet. Voyez pr-requis pour plus de
      dtails.

      Obtenir une liste de radios

      1)  Ouvrez le menu de DigitalCD sur la barre d'icnes et choisissez
          Liste principale.

      2)  Veuillez vous assurer que votre machine est connecte  Internet.

      3)  Dmarrez un navigateur Internet et recherchez des listes de radios
          Internet (connues des utilisateurs PC en tant que fichiers .m3u ou
          .pls). Pour les dbutants, pointez votre navigateur vers Winamp
          (http://www.winamp.com/music/) pour les radios MP3 et Icecast
          directory (http://dir.xiph.org/) pour les radios Ogg Vorbis.

      4)  Rcuprez certaines des listes proposes et dposez-les sur la
          liste principale. DigitalCD insrera alors dans la liste une entre
          pour chaque URL de radio list dans les fichiers dposs. Certains
          fichiers peuvent contenir plus d'une radio mais il s'agit le plus
          souvent d'une mme radio propose  diffrents dbits.

      Jouer une radio Internet

      1)  Ouvrez le menu de DigitalCD sur la barre d'icnes et dans le
          sous-menu Lecteurs choisissez Lecteur de radios Internet. Le
          panneau de contrle de ce lecteur s'affichera alors.

      2)  Cliquez sur le bouton Jouer pour dmarrer la lecture. Pour
          slectionner une radio, ouvrez le menu du panneau de contrle et
          slectionner la radio dans le sous-menu Jouer. Voyez la
          documentation du panneau de contrle pour d'autres informations.

      En case de problmes, consulter la page problmes et solutions.


                                     Lecteurs
                                     

    DigitalCD propose un ensemble de lecteurs, lists dans le sous-menu
    Lecteurs du menu de la barre d'icnes. Chaque lecteur utilise son propre
    panneau de contrle. Les lecteurs sont conus pour jouer une liste
    d'objets appels pistes et afficher des informations sur chaque piste
    lorsqu'elle est joue. Les types d'objets utilisables diffrent pour
    chaque lecteur. Par exemple, le lecteur de fichier permet de jouer une
    large varit de formats sonores incluant les MP3s, les Trackers et les
    chantillons sonores, tandis que le lecteur CD joue des CDs audio.

       Un lecteur CD permet de jouer des pistes audio d'un CD. Si vous
        disposez de plusieurs lecteurs physiques, chacun aura son
        correspondant dans DigitalCD, numrot d'aprs le numro du lecteur
        affich  la gauche de la barre d'icnes (':0', ':1', etc.). Les
        informations sur ce CD, telles que le titre et l'artiste du CD et de
        chacune des pistes, peuvent tre introduites dans une base de donnes
        CD, soit manuellement, soit en se servant d'AcornCD pour recueillir
        ces informations d'internet. Enfin, vous pouvez dfinir une liste des
        favoris pour contrler l'ordre dans lequel les pistes sont joues,
        pour rpter certaines pistes, voire ignorer les pistes qui vous
        dplaisent.

       Le lecteur de fichiers permet de jouer des fichiers parmi une grande
        varit de types. Lorsque le lecteur est en mode programme il joue
        des pistes de la file de fichiers, sinon des pistes de la liste
        principale. Le lien suivant donne une description de gestion des
        pistes.

       Le lecteur de radios internet permet de jouer une liste de stations
        de radio internet. Celle-ci est gre depuis la liste principale.

       Le Moniteur sonore vous permet de traiter la sortie de tout
        chantillonneur sonore connus de DigitalCD comme une piste musicale.
        Jouer ces pistes permet d'utiliser les plug-ins de visualisation de
        DigitalCD afin de visualiser des sons produits par des sources autres
        que DigitalCD, comme d'autres applications sonore voire mme des
        sources externes telle qu'un microphone.
     
    Les sons grs par l'un des lecteurs de DigitalCD peuvent tre visualiss
     l'cran par l'intermdiaire de plug-ins. Il faudra cependant pour cela
    que DigitalCD dispose de l'chantillonneur adquat pour capturer le son 
    partir de sa source. Ceci signifie notamment que la musique produite par
    un CD ne peut pas tre visualise,  moins de disposer de matriel de
    capture sonore supplmentaire.


                                   Lecteur de CDs
                                   

      DigitalCD dispose de panneaux de contrle pour jouer des CDs.

      Si vous dbutez avec DigitalCD, commencez par vous rfrer  jouer un
      CD.

         Liste des pistes et ordre de lecture
         CD(s), proprits
         Pistes(s), proprits
         Base de donnes CD

         Problmes et solutions


                 Lecteur de CDs: Liste des pistes et ordre de lecture
                 

        Quelles pistes le lecteur de CD joue dpend du mode programme.

               Si le mode programme est inactif, le lecteur reprendra
               simplement toutes les pistes audio du CD, du dbut  la fin.

               Si le mode programme est actif et qu'une liste des favoris est
               dfinie pour ce CD, le lecteur utilisera cette liste  la
               place. La liste des favoris vous permet de modifier l'ordre de
               lecture des pistes, mais aussi d'en rpter ou en ignorer
               certaines.

        Si le mode mlange est actif, les pistes de la liste seront places
        en ordre alatoire avant d'tre joues.


                            Lecteur CD: CD(s), proprits
                            

             Pour ouvrir la fentre CD(s), proprits slectionnez une ou
             plusieurs CDs de la base de donnes CD puis soit:
                Shift+double-cliquez sur les rfrences,
                cliquez sur le bouton proprits dans la barre d'outils de
                 la liste,
                choisissez Proprits dans le menu de la base de donnes CD.

        L'dition simultane des proprits de plusieurs CDs restreint le
        nombre de proprits ditable. Les proprits qui diffrent d'une
        piste  l'autre seront affiches dans une teinte diffrente.

        La fentre vous permet:
           de modifier le nom de l'album auquel appartient le CD.
           de modifier la date de sortie de l'album, au format AAAA, AAAA-MM
            ou AAAA-MM-JJ.
           de modifier le nom du coffret auquel appartient l'album.
           de modifier le nom de l'artiste auquel appartient la piste.
           de modifier le nom du collectif auquel appartient l'artiste.
           d'ouvrir la fentre liste des favoris qui vous permet une
            squence de lecture alternative des pistes d'un CD. Vous pouvez
            modifier l'ordre de lecture des pistes, mais aussi d'en rpter
            ou en ignorer certaines.


                             Lecteur CD: Liste des favoris
                             

          La fentre liste des favoris est utilise pour dfinir une liste
          prcisant quelles pistes et dans quel ordre l'utilisateur prfre
          jouer les pistes d'un CD. Cette liste est utilise par un panneau
          de contrle CD lorsque celui-ci est en mode programme.

          La fentre contient deux listes: la liste des favoris actuellement
          dfinis  gauche et la liste des pistes disponibles sur ce CD 
          droite.

          La liste de droite vous permet de slectionner des pistes et les
          insrer dans la liste des favoris.

          Afin d'acclrer l'entre des donnes, le bouton Initialiser peut
          tre utilis afin d'effacer la liste actuelle des favoris et d'y
          recopier la liste des pistes disponibles. Tout enlever vide la
          liste des favoris. <= Insrer et Enlever => permettent d'ajouter ou
          de retirer des pistes de la liste des favoris. Vous pouvez
          slectionner plusieurs pistes afin de les traiter en une seule
          opration.

          Vous pouvez ne pas reprendre certaines pistes du CD dans la liste
          des favoris, voire au contraire les insrer plus d'une fois. Notez
          que si la liste des prfrences d'un CD est compltement vide,
          toutes les pistes du CD seront alors joues, que le mode programme
          soit actif ou pas.

          Toutes ces oprations peuvent tre effectues via les boutons, les
          menus et dans certains cas via le clavier ou via un dplacer et
          lcher.


                         Lecteur CD: Piste(s) CD, proprits
                         

             Pour ouvrir la fentre Piste(s) CD, proprits slectionnez une
             ou plusieurs pistes dans la base de donnes CD puis soit:
                Shift+double-cliquez sur les rfrences,
                cliquez sur le bouton proprits dans la barre d'outils de
                 la liste,
                choisissez Proprits dans le menu de la base de donnes CD.

        L'dition simultane des proprits de plusieurs pistes restreint le
        nombre de proprits ditable. Les proprits qui diffrent d'une
        piste  l'autre seront affiches dans une teinte diffrente.

        La fentre vous permet:
           de modifier le titre de la piste.
           de modifier le nom de l'artiste auquel appartient la piste.
           de modifier le nom du collectif auquel appartient l'artiste.


                                Lecteur de fichiers
                                

      DigitalCD utilise le panneau de contrle lecteur de fichiers pour jouer
      diffrents des fichiers contenant de la musique.

      Si vous dbutez avec DigitalCD, commencez par vous rfrer  jouer des
      fichiers.

         Liste des pistes et ordre de lecture
         Types de fichiers accepts
         Proprits d'un fichier
         Mtadonnes et extracteurs de mtadonnes

         Problmes et solutions


              Lecteur de fichiers: Liste des pistes et ordre de lecture
              

        La composition de la liste des pistes du lecteur de fichiers dpend
        du mode programme.

               Si le mode programme est actif, le lecteur jouera le contenu
               de la file de fichiers.

               Si le mode programme est dsactiv, la liste est construite
               sur base du contenu de la liste principale. Chaque rfrence
               est examine et seules celles prcdes par une checkbox
               coche sont considres:

                  Les rfrences vers des fichiers sont ajoutes  la liste
                   des pistes.
                  Les listes ou listes-rpertoires non charges sont
                   ignores.
                  Le contenu des listes ou listes-rpertoires charges est
                   examin et les rfrences vers des fichiers prcdes par
                   une checkbox coche sont ajoutes  la liste des pistes.

        Certains rglages de la fentre Prfrences, section Fichiers vous
        permettre de contrler le comportement de DigitalCD lors du
        glissement d'un fichier vers le panneau ou vers l'icne de DigitalCD
        sur la barre d'icnes. Vous pouvez demander  DigitalCD d'ajouter les
        fichiers vers la liste principale ou vers la file de fichiers, voire
        aussi d'activer le mode programme correct et de dmarrer la lecture
        des fichiers.

        L'ordre des pistes dpend du mode mlange et permet d'arranger les
        pistes de diverses manires:

           Les pistes peuvent tre groupes  diffrents niveaux: collectif,
            artiste, coffret, album.
           Les pistes d'un album de compilation suivent le mme ordre de
            niveaux de regroupement que les albums normaux sauf si
            compilation est slectionn. Dans ce cas l'ordre de niveaux de
            regroupement devient coffret, album, suivit par collectif,
            artiste si par artiste est slectionn.
           Les groupes peuvent tre mlangs ou de tris par ordre
            alphabtique  chaque niveau de regroupement.

        Parmi les groupes dfinis, les pistes peuvent tre:
           Mlanges.
           Tries par l'ordre alphabtique.
           Suivre de l'ordre dans l'album (le groupement par album doit tre
            actif).


                         Fichiers: Types de fichiers accepts
                         

        DigitalCD peut jouer tous les formats de fichiers prsents
        ci-dessous, ci ceux-ci ont ts associs aux types de fichiers RISC
        OS attendus. La liste des types de fichiers et formats peut-tre
        adapte si ncessaire. Certaines options de configuration vous
        permettent de:

           Dfinir les types de fichiers pour lesquels DigitalCD sera
            dmarr lorsque vous excutez (double-cliquez sur) un tel fichier.
           Ajouter des types de fichiers supplmentaires accepts par
            d'ventuelles nouvelles versions de modules tels que PlayIt.
           Ajouter des types de fichiers alternatifs utiliss parfois pour
            certains formats (par exemple les MODs contenus dans les jeux de
            Krisalis portent le type &CC5).
           Changer de module utilis pour jouer certains types de fichiers
            lorsque plusieurs sont disponibles (ex.: les fichiers MP3 peuvent
            tre assigns  AMPlayer ou DiskSample).
           Offrir une liste, par ordre de prfrence des modules utiliss
            pour jouer certains types de fichiers (ex.: certains fichiers
            WAVE contiennent du MP3 et peuvent tre jous par DiskSample,
            tandis que la plupart des autres variantes des fichiers WAVE ne
            sont pas supportes et doivent tre passes  PlayIt).

        Si vous utilisez Internet pour tlcharger des fichiers ou changez
        des fichiers avec d'autres plateformes que RISC OS, je vous suggre
        de bien maintenir  jour le fichier centralis MimeMap contenant les
        associations entre types Internet (mimetype), types RISC OS et
        extensions de fichier PC/MAC.

            Formats de fichier supports  Extension Type RISC OS

            Trackers
            MatrixTRK     00B
            Digital Symphony        10B
            ImpulseTracker .it  1AE 
            FastTracker 2  .xm  1AF 
            ScreamTracker  .stm 1B0
            ScreamTracker 3     .s3m 1B0 
            Asylum    .amf 1B1
            DSMI AMF  .amf 1B1
            Composer 669   .669 1B1
            Digi Booster   .digi     1B1
            DigiBooster Pro     .dbm 1B1
            DigiSound .dsm 1B1
            DSIK .dsm 1B1
            Digital Tracker     .dtm 1B1 
            Farandole Composer  .far 1B1
            MultiTracker   .mtm 1B1
            Oktalizer .okta     1B1
            PolyTracker    .ptm 1B1
            UltraTracker   .ult 1B1
            Coconizer     365
            Archimedes Tracker      CB6
            Desktop Tracker         CB6
            Protracker     .mod CB6
            Soundtracker   .mod CB6
            The Xperience  .mod CB6

            Compression avec perte
            Ogg Vorbis     .ogg 1A8
            MPEG Audio Layer 2  .mp2 1AD
            MPEG Audio Layer 3  .mp3 1AD
            AAC (ADTS)     .aac A62
            AAC (MP4) .m4a A62

            Compression sans perte
            Free Lossless Audio Codec (FLAC)   .flac     1CF
            Monkey's Audio (APE)     .ape 1F0
            ALAC (MP4)     .m4a A62

            Non comprims
            CDAudio       0CD
            DataVox       108
            Digital Symphony Sample      10A
            AmigaIFF      693
            ARMovie       AE7
            AudioWorks         BD6
            Armadeus      DC3
            RawSound      ED0
            Creative Voice .voc F96
            Sun Audio .au .snd  FB1
            Wave .wav FB1
            AIFF     FC3

            Autres
            MIDI .mid FD4 

           Ces formats taient auparavant lists sous des types de fichiers
            inofficieux provenant du fameux set d'icnes du groupe de dmos
            The XPerience. Vu la prsence de conflits avec des allocations
            officielles de types de fichiers, ces formats ont reus leurs
            propres types de fichiers officiels.

           Il existe un autre format de fichiers, non support, utilisant la
            mme extension.

           Ces fichiers sont jous via le module MIDIPlay. Ce dernier ne
            dcode pas le son lui-mme mais redirige les commandes MIDI vers
            un synthtiseur MIDI. Aucun synthtiseur MIDI n'est fourni en
            standard sur les machines RISC OS, mais Liquid Silicon vend aussi
            bien le synthtiseur MIDI software Synth que des cartes hardware
            MIDI.


                  Fichiers: Types de fichiers accepts, configuration
                  

          Liste des types de fichiers

              Dans le rpertoire !DCDRes vous trouverez un fichier appel
              Setup (cliquez ici pour ouvrir), et dans ce fichier une section
              [FileTypes]. Lors du boot ou du dmarrage, DigitalCD parcourt
              cette section  la recherche de lignes ayant le format:

              type = chargeur1, chargeur2, ...

              o type est un type de fichier RISC OS, chargeur1 le premier
              pilote qui tentera de jouer le fichier, chargeur2 est le second
              au cas o le premier refuse, et ainsi de suite.

              Par exemple, "CB6 = tim, qtm" dit  DigitalCD d'accepter les
              fichiers de types CB6 et de les jouer avec le module TimPlayer,
              ou avec QTM si TimPlayer refuse.

              Avec l'exception notable de ses propres fichiers de type
              FileList (RISC OS type 155), DigitalCD accepte seulement de
              charger les fichiers dont le type est list dans cette section.
              Vous pouvez ajouter, modifier voire mme supprimer  volont
              ces associations de fichiers et de pilotes car vous pouvez
              toujours consulter si ncessaire la version de rfrence
              prsente dans le rpertoire !DigitalCD.Copy.

              Pour une liste complte des chargeurs, rfrez vous  la
              section Crdits. A cette liste il faut ajouter le chargeur
              smpext, une variante de smp qui tente d'utiliser l'extension du
              nom de fichier (par exemple "/mpeg" ou "/ac3") pour identifier
              le type de fichier  jouer.

          DigitalCD comme application par dfaut pour un type de fichier donn

              Dans la liste des types de fichiers, mettez un "!" devant les
              types de fichier pour lesquels vous dsirez que DigitalCD se
              charge lorsque vous double-cliquez sur un fichier de ce type.
              Bien videmment DigitalCD doit avoir t vu par le bureau (tre
              boot) pour que ceci fonctionne.

          Nouvelles versions de DigitalCD

              !DCDRes.Setup est votre version prive du fichier Setup et
              DigitalCD ne tentera jamais de la modifier. Il est donc
              recommand de vrifier lors de chaque nouvelle version de
              DigitalCD si des modifications n'ont pas t apportes  la
              liste par dfaut propose dans !DigitalCD.Copy.Setup.


                                 Fichiers: Proprits
                                 

             Pour ouvrir la fentre Proprits des fichiers slectionnez une
             ou plusieurs rfrences  des fichiers dans une liste puis soit:
                Shift+double-cliquez sur les rfrences,
                cliquez sur le bouton proprits dans la barre d'outils de
                 la liste,
                choisissez Proprits dans le sous-menu Fichiers du menu de
                 la liste.

        La fentre peut aussi tre ouverte par un clic sur le bouton
        d'dition des proprits de la piste dans le panneau de contrle du
        lecteur de fichiers lorsqu'un fichier est jou.

        L'dition simultane des proprits de plusieurs pistes restreint le
        nombre de proprits ditable. Les proprits qui diffrent d'une
        piste  l'autre seront affiches dans une teinte diffrente.

        La fentre vous permet:
           de modifier le nom de fichier (manuellement ou en faisant glisser
            l'icne d'un fichier vers le champ d'dition).
           d'ouvrir le dossier contenant le fichier en cliquant sur l'icne
            de dossier situe  gauche du nom du fichier.
           mtadonnes:
                de dfinir le numro d'ordre de la piste dans l'album.
                de modifier le titre de la piste.
                de modifier le nom de l'album auquel appartient la piste.
                de dfinir si l'album est indpendant de l'artiste de la
                 piste (compilation, concert, ...).
                de modifier la date de sortie de l'album, au format AAAA,
                 AAAA-MM ou AAAA-MM-JJ.
                de modifier le nom du coffret auquel appartient l'album.
                de modifier le nom de l'artiste auquel appartient la piste.
                de modifier le nom du collectif auquel appartient l'artiste.
           lecture:
                dans le cadre d'une piste prsentant plusieurs sections (ou
                 alternatives) de choisir la section  jouer.

                 Ce cas de figure se prsente souvent dans le cadre de
                 fichiers cres pour des jeux (notamment Lemmings) et il faut
                 alors normalement changer de mode pour boucler sur la piste
                 puis naviguer entre les sections  l'aide du panneau de
                 contrle afin de les couter. Une manire plus lgante de
                 procder est d'insrer dans la liste autant de rfrences
                 vers ce fichier que le fichier ne comporte de sections et
                 d'affecter une section diffrente  chaque rfrence.

                d'ajouter des remarques et commentaires dans le champ Info.
                de donner une note/un score  la piste.
                d'associer un indice visuel permettant de reprer facilement
                 cette piste dans la liste.
                de dfinir un volume relatif exprim en tant que pourcentage
                 du volume principal du panneau de contrle vous permettant
                 ainsi d'ajuster le volume de cette piste par rapport aux
                 autres. Ce volume peut tre suprieur  100% afin
                 d'amplifier une piste trop silencieuse.

                 Il est  noter que tous les dcodeurs n'autorisent pas de
                 volume suprieur  100% et donc dans ce cas amplifier le
                 volume de la piste n'aura d'effet que lorsque le volume
                 principal est lui-mme infrieur  100%. Dans ce cadre, si
                 par habitude ou par ncessit, vous laissez le volume
                 principal  100%, je vous recommande d'utiliser comme
                 rfrence la piste la plus silencieuse et d'abaisser le
                 volume relatif des autres pistes.

                pour toutes les pistes que vous conservez uniquement dans le
                 but de disposer d'une collection complte, vous pouvez vous
                 assurer qu'il soit impossible (que ce soit manuellement ou
                 via la fentre de recherche) de les ajouter  la liste des
                 pistes du lecteur de fichiers en slectionnant l'option
                 Jouer: Jamais.
                d'enchainer toutes les sections d'une piste au lieu de n'en
                 jouer qu'une seule en slectionnant l'option Jouer: Toutes
                 les sections.
                 Il est  noter que lorsque cette option est inactive le
                 panneau de contrle vous offre malgr tout la possibilit de
                 voyager entre les diffrentes sections du fichier.
           options pour le module TimPlayer:
                Ignorer boucles sur dernire position permet d'ignorer toute
                 boucle sur la dernire position dans la squence. Ceci
                 permet d'viter le mauvais usage que font certains artistes
                 de cette possibilit: boucles sur un pattern vide, boucles
                 sur des informations textuelles (pour les programmes
                 affichant le nom de l'chantillon actuellement jou sur
                 chaque canal), etc.
                Ignorer position de redmarrage vous permet de boucler au
                 dbut de la squence en lieu et place de la position
                 spcifie par le fichier. 
                Ignorer les marqueurs de fin de squence permet de jouer les
                 sections qui suivent ces marqueurs dans certains fichiers.
                 La plupart du temps ces sections ne sont composes que de
                 patterns exprimentaux mais ils sont parfois excellent (voir
                 le S3M 'Catch that Goblin!!!').
                 Note: cette option est sans doute devenue inutile depuis
                 l'arrive de l'option Jouer: Toutes les sections.
                Ignorer la dsactivation de canaux permet d'couter tous les
                 canaux d'un fichier y compris ceux qui sont marqus comme
                 inactifs dans le fichier.
           options de compatibilit ProTracker pour le module TimPlayer:
                Mode VBlank, l'effet Protracker Fxx est alors toujours la
                 vitesse, jamais le tempo.
                Pas d'change d'instruments, les samples de l'ancien
                 instrument restent alors utiliss si un instrument est
                 spcifi sans note dans un fichier Protracker.
                Ultimate Soundtracker, traite un Soundtracker comme un vieux
                 Ultimate Soundtracker (mme format mais les effets
                 diffrent). Ce drapeau est ignor si le Soundtracker ne peut
                 en tre un (taille des samples > 9999 ou usage d'effets
                 autre que 1xx et 2xx).


                                Fichiers: Mtadonnes
                                

        DigitalCD affiche dans la fentre proprits d'un fichier un ensemble
        de mtadonnes sur le morceau correspondant. Ces donnes proviennent
        dans l'ordre de priorit:
         1  des donnes que vous avez introduites par le pass dans cette
            fentre,
         2  des donnes extraites du nom du fichier et des rpertoires qui le
            contiennent,
         3  des donnes extraites du contenu du fichier lors de l'coute du
            fichier,
         4  enfin, en dernier recours, le nom du fichier est utilis comme
            titre du morceau.

        Les donnes de type 2 ne peuvent provenir que de fichiers rfrencs
        dans des listes secondaires ou des listes-rpertoires pour lequel un
        mode d'extraction des mtadonnes a t dfini. La liste des modes
        d'extraction disponible se compose de deux groupes: les modes
        standards de DigitalCD puis les modes dfinis par les utilisateurs.
        Nous ne dtaillerons ici que le fonctionnement des modes standards
        (exemples).

        Le titre de chaque mode d'extraction se prsente sous la forme
        "structure du chemin | structure du nom de fichier". Ainsi "Artist .
        Album | Title" signale essentiellement qu'en partant du rpertoire de
        base comme point de dpart les fichiers sont regroups dans des
        rpertoires portant le nom de l'artiste, puis dans des
        sous-rpertoires portant le nom de l'album et enfin utilisent comme
        nom de fichier le titre du morceau. De mme "| Artist - Album -
        Title" signale que l'on se sert du nom de l'artiste, de l'album et du
        titre, spars par des tirets pour nommer le fichier et que le nom
        des rpertoires dans lesquels sont stocks ces fichiers n'on pas
        d'importance.

        La structure affiche ne reprend videmment pas toutes les subtilits
        du travail effectu. Ainsi un traitement pralable est effectu pour
        transformer tous les _ en blancs et les versions "hard" des blancs et
        tirets en leurs versions normales. Une fois le dcoupage effectu,
        pour chaque mtadonne extraite les / sont transforms en . (trs
        utiles pour les fichiers stocks sur PCs) et les . en blancs.

        Dtaillons au niveau des chemins:

           "Artist" se traduira par:
                un rpertoire "various" pour regrouper les fichiers
                 d'artiste inconnu, voire pas de rpertoire du tout si aucun
                 sous-regroupement n'est prvu.
                des rpertoires "<nom de l'artiste>" regroupant les fichiers
                 de mme artiste dans un mme rpertoire.
                des rpertoires "/ <nom du collectif>" (notez bien le / en
                 prfixe) regroupant les fichiers de mme collectif
                 d'artistes dans un mme rpertoire.
                 Des sous-rpertoires "various" et "<nom de l'artiste>"
                 regroupent ensuite ces fichiers par artiste.

           "Album" se traduira par:
                un rpertoire "various" pour les fichiers d'album inconnu,
                 voire pas de rpertoire du tout si aucun sous-regroupement
                 n'est prvu.
                des rpertoires "<nom de l'album>" regroupant les fichiers
                 de mme album dans un mme rpertoire.
                des rpertoires "/ <nom du coffret>" (notez bien le / en
                 prfixe) regroupant les fichiers d'un mme coffret d'albums
                 dans un mme rpertoire.
                 Des sous-rpertoires "various" et "<nom de l'album>"
                 regroupent ensuite ces fichiers par album.

           Le sous-rpertoire "collective" du rpertoire de base est rserv
            pour regrouper les albums collectifs (et la structure "Artist .
            Album" y est inverse en "Album . Artist").
           "Collective Album" signale que tous les fichiers seront
            considrs comme faisant partie d'albums collectifs.

           La dernire mtadonne de la liste reprendra tous les
            sous-dossiers restants du chemin.
            Par exemple "album . CD1" deviendra un nom d'abum "album CD1".
           Tout nom de rpertoire dbutant par un ~ sera ignor.
            Ainsi "Artiste . ~ Lives . Album" donnera artiste "Artiste" et
            album "Album".
           Tout nom de rpertoire dbutant par un - sera fusionn avec le
            rpertoire parent.
            Ainsi "Nom . - Prenom . Album" donnera artiste "Nom Prenom" et
            album "Album".

        Dtaillons au niveau du nom de fichier:

           "Artist -" sera interprt comme:
                "" si aucun tiret n'est prsent dans le nom du fichier.
                "<nom de l'artiste> -" si un tiret est prsent.

           "Album -" sera interprt comme:
                "" si aucun tiret n'est prsent.
                "<nom de l'album> -" si un tiret est prsent.
                "<nom du coffret> - <nom de l'album> -" si deux tirets sont
                 prsents.

           "Artist - Album -" sera interprt comme:
                "" si aucun tiret n'est prsent.
                "<nom de l'artiste> -" si un tiret est prsent.
                "<nom de l'artiste> - <nom de l'album> -" si deux tirets
                 sont prsents.
                "<nom de l'artiste> - <nom du coffret> - <nom de l'album> -"
                 si trois tirets sont prsents.

           "( Artist )" sera interprt comme:
                "" en l'absence de parenthses.
                " ( <nom de l'artiste> )" en prsence des deux parenthses.

           Si le nom de fichier commence par "<nr> -", "<nr> /" (traduction
            de la notation "<nr> ." sur PC), "<nr> )" ou encore "<nr>
            <blancs>", <nr> tant un nombre, alors celui-ci sera interprt
            comme numro de piste.
           De mme "<variables> - <nr> - <titre>" verra le nombre <nr>
            interprt comme numro de piste.

           "Album" sera interprt comme:
                "[ <date de l'album> ] <nom de l'album>", si la date est
                 prsente entre [] et dans un format reconnu.
                "<nom de l'album>" sinon.      

           "Title" sera interprt comme:
                "<titre>" si aucun / n'est prsent.
                "<titre> / <extension>" o / est le dernier / prsent
                 (traduction des extensions du style ".mp3" sur PC).
         
        Note: les noms de variables et caractres spciaux dans le texte
        ci-dessus sont spars par des blancs pour plus de clart. Le
        processus d'extraction fonctionne trs bien en leur absence et
        ceux-ci sont simplement ignors si prsents.


                          Fichiers: Extracteurs de mtadonnes
                          

          DigitalCD offre une srie d'extracteurs de mtadonnes analysant
          les noms et chemins de fichiers pour en extraire les informations
          utiles. Si ces extracteurs ne vous conviennent pas il vous est
          possible d'en crer de nouveaux.

          Le rpertoire DigitalCDRes:MetaScan vous est rserv pour stocker
          vos propres dfinitions d'extracteurs tandis que les dfinitions
          des extracteurs standards de DigitalCD, qui vous serviront
          certainement de base pour vos premires expriences, sont stockes
          dans le rpertoire DigitalCD:StdRes.MetaScan. Chaque fichier
          correspond  une dfinition et est compos des lignes suivantes:

             Title: <texte>

              Cette ligne fourni un titre qui sera affich dans le menu
              offrant la liste des extracteurs. Ce titre  pour but de
              fournir une description synthtique de la structure des donnes
              attendue par l'extracteur sous la forme "structure de chemin |
              structure de nom".

             Pre: "<caractres>" "<caractres>"

              Cette ligne dfini un traitement pralable de substitution de
              caractres par d'autres, tels _ vers blanc ou la version "hard"
              des blancs et tirets vers leur version normale. La premire
              chaine de caractres liste les caractres  remplacer et la
              seconde, de mme longueur, les caractres de substitution
              correspondants.

             Post: "<caractres>" "<caractres>"

              Cette ligne dfini un traitement a postriori de substitution
              de caractres par d'autres sur les mtadonnes extraites.

             Join: <caractre>

              Cette ligne dfini un caractre de jointure de rpertoires. Si
              ce caractre est prsent en premire position d'un nom de
              rpertoire, le nom de celui-ci sera fusionn avec le prcdant
              pendant l'analyse, ainsi le chemin ".a.-b.c." sera trait comme
              ".a b.c." si - est le caractre de jointure.

             Skip: <caractre>

              Cette ligne dfini un caractre d'oubli du rpertoire. Si ce
              caractre est prsent en premire position d'un nom de
              rpertoire, le nom de celui-ci sera ignor par l'analyse, ainsi
              le chemin ".a.~b.c." sera trait comme ".a.c." si ~ est le
              caractre d'oubli.

             Date: <caractre>

              Cette ligne dfini le sens d'une date dans un format tel que
              <a>-<b>-<year>.
              Si le caractre spcifi est D ou d alors a est le jour et b le
              mois.
              Si le caractre spcifi est M ou m alors a est le mois et b le
              jour.

             Path:

              Cette ligne signale que chaque ligne qui suit contient un
              agencement possible du chemin du fichier.

             Leaf:

              Cette ligne signale que chaque ligne qui suit contient un
              agencement possible du nom de fichier.


          Dcortiquons maintenant ces lignes d'agencement:

             [ ... ]   signale que cette zone est optionnelle
             ( ... | ... | ... ) permet de lister des alternatives
             \    est un caractre d'chappement signalant que le caractre
                   qui suit ne doit pas tre interprt mais trait comme un
                   caractre normal. Ainsi \[ sera trait comme le caractre
                   [ au lieu de marquer le dbut d'une zone optionnelle.
             %x   signale que l'on s'attend ici  la variable x. IMPORTANT,
                   il faut toujours laisser un blanc entre x et la suite de
                   la dfinition. Le contenu d'une variable fait au moins un
                   caractre de long et s'interrompt ds que la suite le
                   permet, ainsi "%a - %b" verra "x-y-z" dcomposs en a="x"
                   et b="y-z".
             #x   comme %x mais le texte ne peut contenir ".". Voici
                   quelques exemples de decomposition de "v.x.y.z":
                   "%a . %b" donne a="v", b="x.y.z".
                   "%a . #b" donne a="v.x.y", b="z".
                   "#a . #b" rejte "v.x.y.z".
                   "#a . #b [ . %any]" donne a="v", b="x" et ignore ".y.z".
             blancs    sauf dans le cas ci-dessus les blancs sont ignors.
                        Si il est impratif de traiter des blancs, utilisez
                        la variable %space.
             autres    les autres caractres sont utiliss comme caractres
                        normaux pour dfinir des zones de texte constantes.

          Variables correspondant  de mtadonnes:
              nom  type description
             %title    texte     titre du morceau
             %album    texte     nom de l'album
             %box texte     nom du coffret auquel appartient l'album
             %artist   texte     nom de l'artiste
             %collective    texte     nom du collectif auquel appartient
                                       l'artiste
             %track    nombre    numro d'ordre du morceau dans l'album
             %date     date date de l'album dans l'un des formats suivants
                             <anne>[<sep><mois>[<sep><jour>]] ou
                        [[<jour><sep>]<mois><sep>]<anne>
                        o anne est en 4 chiffres, mois en 1/2 chiffres,
                        jour en 1/2 chiffres et sep est "-", "/" ou ".".

          Autres variables:
              nom  type description
             %any texte     marque une zone de texte dont on ne fait rien
             %comp     vide signale  l'extracteur que l'on est en prsence
                             d'un album collectif.
             %ext texte sans /   utilis pour sparer l'extension de fichier
                                  du titre
             %space    blancs    signale  l'extracteur que l'on s'attend 
                                  voir ici au moins un blanc.


                     Fichiers: Extracteurs de mtadonnes en action
                     

          Extracteur Artist . Album | Title

             /Five Musicians.Necros.Mechanism Eight/s3m
              Artiste   : Necros  Titre     : Mechanism Eight
              Collectif : Five Musicians

             Black_Sabbath./Black_Box.Disc _2_-_Paranoid.04_-_Iron Man/mp3
              Artiste   : Black Sabbath     Titre     : Iron Man
              Album     : Disc 2 - Paranoid Ordre     : 4
              Coffret   : Black Box

             Buck-Tick.[1987/04/21] Hurry Up Mode.~Disc 2.0203 Romanesque/mp3
              Artiste   : Buck-Tick    Titre     : Romanesque
              Album     : Hurry Up Mode     Ordre     : 203
              Date : 1987-04-21

          Extracteur Collective Album . Artist | Title

             /Aria.AriatheNaturalDue.Makino Yui.02/Euforia/flac 
              Artiste   : Makino Yui   Titre     : Euforia
              Album     : AriatheNaturalDue Ordre     : 2
              Coffret   : Aria    Compilation    : vrai

          Extracteur | Album - Artist - Title

             Sound.Albums.Moby - [1999] Play - 01 - Honey/mp3
              Artiste   : Moby    Titre     : Honey
              Album     : Play    Ordre     : 1
              Date : 1999


                             Lecteur de radios Internet
                             

      DigitalCD utilise le panneau de contrle lecteur de radios Internet
      pour jouer des radios Internet.

      Si vous dbutez avec DigitalCD, commencez par vous rfrer  jouer une
      radio Internet.

         Liste des pistes et ordre de lecture
         Proprits d'une radio Internet
         Pr-requis

         Problmes et solutions


           Lecteur de radios Internet: Liste et ordre des pistes du lecteur
           

        La liste des pistes du lecteur de radios Internet est construite sur
        base de la liste principale. Chaque rfrence est examine et seule
        celles prcdes d'une checkbox coche sont considres:

           les rfrences vers des radios Internet sont ajoutes  la liste
            des pistes.
           les listes non charges sont ignores.
           le contenu des listes charges est examin et les rfrences vers
            des radios Internet prcdes d'une checkbox coche sont ajoutes
             la liste des pistes.

        L'ordre des pistes dpend du mode mlange et permet d'arranger les
        pistes de diverses manires:

           Les pistes peuvent tre groupes  diffrents niveaux: type MIME,
            vitesse de chargement, diffuseur.
           Les groupes de diffuseurs peuvent tre mlangs ou de tris par
            ordre alphabtique.

        Parmi les groupes dfinis, les pistes peuvent tre:
           Mlanges.
           Tries par l'ordre alphabtique.


                             Radios Internet: Proprits
                             

             Pour ouvrir la fentre Proprits des radios Internet
             slectionnez une ou plusieurs rfrences  des radios dans une
             liste puis soit:
                Shift+double-cliquez sur les rfrences,
                cliquez sur le bouton proprits dans la barre d'outils de
                 la liste,
                choisissez Proprits dans le sous-menu Radios Internet du
                 menu de la liste.

        La fentre peut aussi tre ouverte par un clic sur le bouton
        d'dition des proprits de la piste dans le panneau de contrle du
        lecteur de radios Internet lorsqu'une radio est joue.

        L'dition simultane des proprits de plusieurs radios restreint le
        nombre de proprits ditable. Les proprits qui diffrent d'une
        radio  l'autre seront affiches dans une teinte diffrente.

        La fentre vous permet:
           de modifier l'URL  utiliser pour se connecter  la radio.
           de modifier le nom de la radio.
           de modifier le nom de la station auquel appartient la radio.
           de modifier le type de radio.
           d'ajouter des remarques dans le champ Info.
           de dfinir le dbit habituel de la radio en kilo bits par seconde.
           d'associer un indice visuel permettant de reprer facilement
            cette radio dans la liste.
           de donner une note/un score  la radio.
           de dfinir un volume relatif exprim en tant que pourcentage du
            volume principal du panneau de contrle vous permettant ainsi
            d'ajuster le volume de cette radio par rapport aux autres. Ce
            volume peut tre suprieur  100% afin d'amplifier une radio trop
            silencieuse.


                             Radios Internet: Pr-requis
                             

        Avant de pouvoir couter des radios Internet certaines oprations de
        configuration de votre machine et de DigitalCD sont ncessaires:

           la premire consiste  mettre  jour le fichier MimeMap qui
            dfini notamment les relations entre les descripteurs de contenu
            mime (utiliss par tout service Internet, dont les radios) et les
            types de fichiers RISC OS.

           la suivante consiste  mettre  jour les prfrences de
            DigitalCD, section Internet, avec des informations telles que la
            ncessit ou non de passer par un serveur proxy.


                                  Moniteur sonore
                                  

      Le Moniteur sonore vous permet de traiter les sons capturs par tout
      chantillonneur connus de DigitalCD comme si il s'agissait d'une piste
      musicale. Jouer une telle piste depuis le moniteur sonore permet
      d'utiliser les plug-ins de visualisation sur des sons produits par
      d'autres sources que DigitalCD, telles que d'autres applications
      sonores voire une source externe comme un microphone.

         Informations techniques
         Assignation des chantillonneurs aux sources 
         Configuration de SoundDriver 


                               Panneau de contrle
                               

    Un panneau de contrle est une fentre avec une skin permettant de
    contrler la faon de jouer les pistes d'un lecteur et d'afficher des
    informations sur la piste joue. Chaque panneau de contrle peut prendre
    la forme d'un panneau de grande taille ou d'une mini-barre.

    Panneau de grande taille


    Mini-barre


    Les icnes du panneau de contrle standard sont dcrites ci-dessous.
    Notez que l'aspect et la disposition de ces icnes peuvent varier avec la
    skin utilise, et que certaines skins peuvent ne pas fournir de boutons
    pour toutes les fonctions. Toutes les commandes sont cependant
    disponibles via le menu du panneau de contrle.

    Les fonctions du panneau de contrle standard, de gauche  droite et de
    haut en bas:

   1 Icnes de fentre   4 Chrono              7 Bascules de modes
                                                     10 Boutons de dplacement
   2 Zone de titre       5 Barre de position   8 Zone spcifique au lecteur
   3 Compteur de piste   6 Barre de volume     9 Boutons principaux

    Un bon nombre de raccourcis clavier sont galement fournis.

    Pour ouvrir un panneau de contrle, ouvrez le menu de DigitalCD sur la
    barre d'icnes et choisissez un lecteur depuis le sous-menu Lecteurs.
    Cliquer sur l'icne de DigitalCD dans la barre d'icnes peut aussi ouvrir
    un panneau de contrle. Par dfaut SELECT ouvre le lecteur de fichiers et
    ADJUST le lecteur CD n0. Ce comportement peut tre modifi dans la
    section Barre d'icnes de la fentre Prfrences, tandis le comportement
    des diffrents panneaux est paramtr dans la section Lecteurs de cette
    mme fentre.


                             Panneau de contrle: Skins
                             

      Les skins offrent des prsentations alternatives pour les panneaux de
      contrles de DigitalCD. La skin  utiliser sera slectionne via la
      fentre Prfrences, section Skins.

      Lorsque l'aspect de la nouvelle skin diffre trop de la skin Default
      fournie avec DigitalCD, utilisez un programme d'aide interactive tel
      que Help, BubbleHelp ou Float pour dcouvrir la fonction des
      diffrentes parties de la skin.

      Installer des skins supplmentaires

      Les skins doivent tre installes dans votre rpertoire de ressources.
      Les skins se prsentent comme des rpertoires devant tre copis dans
      !DCDRes.Skins ou dans une quelconque structure de sous-rpertoire au
      sein de celui-ci (par exemple vous pouvez dcider de classer vos skins
      par auteur).

                              Crer vos propres skins


                                   Skins: Cration
                                   

        Les skins offrent des prsentations alternatives pour les panneaux de
        contrles et mini-barres de DigitalCD. Les dfinitions de ces skins
        sont stockes comme des rpertoires  l'intrieur de !DCDRes.Skins ou
        de tout sous-rpertoire de celui-ci. Les skins peuvent galement se
        prsenter sous le forme de sous-rpertoires d'autres skins dans le
        case de diffrentes variantes d'une mme skin.

        La skin se dfinit comme un rpertoire contenant les fichiers
        suivants:

        Obligatoire:       Optionnel:
          Templates        !Help ou !ReadMe
          Sprites          Autres variantes de cette skin (comme
                           sous-rpertoires)
          Settings


                                Skins: Fichier Templates
                                

          Dfinissez dans ce fichier les fentres Control, ControlCD,
          MiniCtrl et MiniCtrlCD avec les icnes listes ci-dessous. Si vous
          ne voulez pas utilisez certaines de ces icnes ne les supprimez
          pas, placez les en dehors de la zone visible de la fentre.

          Les icnes communes:

          0   Fond, couvre toute la surface de la partie visible de la
              fentre avec un sprite.
          1   Bouton 'Jouer'
          2   Bouton 'Pauser'
          3   Bouton 'Stopper'
          4   Bouton 'Reculer'
          5   Bouton 'Avancer'
          6   Bouton 'Prcdent'
          7   Bouton 'Suivant'
          8   String 'Piste' (fonte anticrnele)
          9-10-11-12    Chiffres du numro de la piste (sprites "0" to "9")
          13-14-15-16-17-18  Chiffres du chrono  (sprites "0" to "9")
          19  Texte du mode de chrono (fonte anticrnele)
          20  Slecteur du mode de chrono (icne invisible couvrant les
              icnes 13  19)
          21-22    Icnes de la barre de position (voir fichier Settings)
          23  Volume (sprites "volume0"  "volumex", o x est soit 20 soit
              est dfini dans le fichier Settings)
          24  Mode de rptition (sprites "loop0"  "loop3")
          25  Mlange (sprites "shuffle0"  "shuffle1")
          26  Balayage (sprites "intro0"  "intro1")
          27  Programme (sprites "list0"  "list1")
          28  Slecteur de pistes (icne invisible couvrant les icnes 9  12)
          29  Type-Auteur (fonte anticrnele)
          30  Titre-Dure (fonte anticrnele)
          31  Icne Arrire
          32  Icne Fermer
          33  Icne pingler
          34  Icne Mini/Max
          39  Curseur de la barre de volume (optionnel)

          Uniquement pour CD:

          35  Bouton d'ouverture de la fentre Base de Donnes CD
          37  Bouton d'ouverture du lecteur de CD

          Sauf pour CD:

          35  Bouton supprimer de la liste
          36  Bouton supprimer le fichier
          37  Bouton diter les proprits de la piste
          38  Bouton ouvrir la liste principale

          Notes concernant les changements de pointeurs des icnes

          Pour changer la forme du pointeur sur une icne ajouter comme
          chane de validation:

          Pptr_music    Flche musicale pour les zones actives (barres et
                        boutons)
          Pptr_scrh,11,4     Double flche horizontale pour les curseurs
          Pptr_scrv,4,11     Double flche verticale pour les curseurs

          Ces pointeurs sont malheureusement dfinis globalement pour tout le
          bureau, il ne sert  rien de dfinir vos propres versions dans le
          fichier Sprites de la skin. 

          Note pour les couleurs des textes:

          Puisque DigitalCD utilise des fontes anticrneles pour dfinir les
          couleurs des icnes de texte vous devez les introduire dans la
          chane de validation de l'icne via Fxy o x et y sont des chiffres
          hexadcimaux pour les couleurs de fond et de texte. Il est  noter
          que le "nested window manager" introduit le support des couleurs en
          couleur RVB via Cbbvvrr/bbvvrr (valeurs de fond et de texte RVB
          hexadcimales), Cbbvvrr (texte seul) ou C/bbvvrr (fond seul), que
          vous pouvez donc utiliser mais en introduisant une valeur Fxy par
          dfaut pour ceux utilisant une ancienne version du window manager.


                                 Skins: Fichier Sprites
                                 

          Contient tout simplement les sprites utiliss par les templates.

                                 !!! Trs important !!!

           Pour les sprites  256 couleurs utilisez toujours une palette. Il
             existe en effet un bug dans RISC OS < 4.0 qui cause des crashs
            alatoires pendant l'affichage du contenu des fentres du Filer
          lorsque d'autres applications utilisent des sprites en 256 couleurs
                                     sans palette.


                                Skins: Fichier Settings
                                

          Ce fichier texte contient les caractristiques des fontes de
          chacune des zones de texte (celles contenues dans les templates
          sont totalement ignores), des barres de volume et de position. 

          Sections Author, Title, Track, TimeMode

          Ces sections correspondent aux diffrents champs textes prsent
          dans toute skin: l'artiste (icne 29), le titre (icne 30), le
          texte "piste" (icne 8) et le texte du mode de chrono utilis
          (icne 19). Chacun de ces sections contient 3 proprits
          dfinissant la fonte  utiliser:

                  FontName, le nom de la fonte  utiliser.
                  FontSizeX et FontSizeY, les tailles suivant les axes X et
                   Y de la fonte en 1/16th de point.

          Section Volume

          La barre de volume (icne 23) est dfinie par les proprits
          suivantes:

                  Vertical, la barre sera horizontale si la valeur est gale
                    zro et verticale dans les autres cas.
                  MaxSprite = x signale  DigitalCD qu'en faisant glisser le
                   volume de 0  sa valeur maximale, le sprite affich dans
                   l'icne 23 passera par tous les sprites entre 'volume0' et
                   'volumex'.
                  Button = 39 signale  DigitalCD d'utiliser l'icne 39
                   comme un curseur se dplaant dans les limites de la
                   barre. Si cette proprit n'est pas dfinie, aucun curseur
                   n'est dfini est l'utilisateur clique directement sur la
                   position dsire dans la barre.

          Section PosBar

          Cette section est utilise pour dfinir une barre de position avec
          curseur en lieu et place de la barre traditionnelle en ajoutant la
          ligne 'Button = 22'.

          Dans les deux cas l'icne 21, qui peut tre transparente ou
          prsenter un fond uni, dfinit les limites de la barre.

          Dans le cas d'une barre traditionnelle l'icne 22 est une autre
          barre dont vous dfinissez la couleur de fond dans le template et
          dont DigitalCD grera la position et la taille.

          Dans le cas d'une barre avec curseur, vous devrez dfinir l'icne
          22 comme une icne avec contenu indirect texte+sprite, le texte
          restant vide mais la chane de validation sera par exemple
          'Sbarb,pbarb;Pptr_scrh,11,4'.


                       Panneau de contrle: Icnes de fentre
                       

         L'icne arrire permet de dplacer la fentre vers le dessous de la
         pile des fentres.
         L'icne fermer permet de fermer la fentre.
         L'icne pingler permet d'pingler la fentre sur le bureau.
         L'icne minimiser permet de passer d'un panneau de grande taille 
         une mini-barre.
         L'icne maximiser permet de passer d'une mini-barre  un panneau de
         grande taille.


                         Panneau de contrle: Zone de titre
                         

      La zone de titre contient deux lignes de texte.

      L'une des lignes affiche le titre et la dure de la piste joue. Notez
      que cette information peut ne pas tre correcte pour certains formats
      de Tracker, qui peuvent contenir plus d'un morceau, et/ou des morceaux
      qui se rptent  l'infini.

      L'autre ligne cycle sur d'autres informations disponibles comme le nom
      de l'album, l'artiste ou encore le type de la piste. Le type de la
      piste inclus le type de fichier, le nombre de canaux ainsi que
      certaines informations techniques relevantes pour le fichier jou.


                       Panneau de contrle: Compteur de piste
                       

      Le compteur de piste affiche le numro de la piste joue. Cliquez sur
      le compteur afin d'ouvrir la liste des pistes disponibles et de choisir
      une nouvelle piste.


                            Panneau de contrle: Chrono
                            

      Le chrono dispose de six modes diffrents sur lesquels vous pouvez
      cycler en cliquant sur le chrono avec SELECT ou ADJUST. Ces modes sont:
      temps coul, temps restant, dure, temps total coul, temps total
      restant, dure totale. Leur dfinition varie quelque peu en fonction du
      type de piste joue.

         Dans le cas d'un fichier, les temps normaux se rfrent  la
          section courante de la piste tandis que les totaux se rfrent 
          l'ensemble de la piste (et affichent le plus souvent des valeurs
          identiques les fichiers ne contenant gnralement qu'une seule
          section).

          Note: dans le cas de certains fichiers de types Tracker
          l'information temporelle n'est pas disponible et un pseudo temps
          est affich bas sur le pattern courant et la ligne courante dans
          le pattern. En fonction de la vitesse de lecture des patterns vous
          pourrez donc exprimenter des effets de dilatation ou de
          compression du temps et mme voyager en arrire dans le temps via
          les boucles programmes ;-).

         Dans le cas d'une radio Internet, le temps total coul et la dure
          totale correspondent  la dure depuis laquelle vous coutez cette
          radio, le temps coul se rfre au titre courant (si dtectable).
          Le temps restant total correspond au contenu du tampon de lecture
          et enfin la dure  dfaut d'tre connue est considre comme le
          temps coul le plus lev atteint jusqu' prsent.

         Dans le cas d'un CD, les temps normaux se rfrent  la piste joue
          tandis que les totaux se rfrent  l'ensemble du CD.


                       Panneau de contrle: Barre de position
                       

      La barre de position est une reprsentation graphique de la position
      courante dans la piste joue. En fonction de la skin utilise la barre
      de position peut prsenter ou non un curseur. Afin de vous dplacer
      dans la piste faites glisser le curseur vers la position dsire si
      celui-ci est prsent sinon cliquez directement sur la position dsire
      dans la barre.


                        Panneau de contrle: Barre de volume
                        

      La barre de volume est une reprsentation graphique du volume principal
      du lecteur. En fonction de la skin utilise la barre de volume peut
      tre verticale ou horizontale et prsenter ou non un curseur. Afin de
      modifier le volume faites glisser le curseur vers la position dsire
      si celui-ci est prsent, sinon cliquez directement sur la position
      dsire dans la barre.

      Note importante:

      Lorsque vous jouez un fichier musical ou une radio Internet vous pouvez
      diter ses proprits et spcifier un volume relatif (en tant que
      pourcentage du volume principal). Je vous recommande de choisir un
      volume principal adquat puis, pour chaque piste joue, d'ajuster son
      volume relatif afin de maintenir le volume global constant. Une fois la
      liste des pistes sauve il ne vous sera alors plus ncessaire de
      modifier le volume principal du lecteur  chaque changement de piste.


                       Panneau de contrle: Bascules de modes
                       

      Les bascules de modes vous permettent d'ajuster la manire de jouer les
      pistes. En cliquant avec SELECT ou ADJUST vous pouvez cycler sur les
      diffrentes valeurs possibles des modes suivants:

         Programme

             Si activ, permet de jouer une liste alternative  la liste
             normale des pistes disponibles pour le lecteur:

                pour un lecteur CD, DigitalCD jouera les pistes de la liste
                 des favoris du CD courant en lieu et place de la liste de
                 toutes les pistes de ce CD.

                pour le lecteur de fichiers, DigitalCD jouera la liste des
                 pistes reprise dans la file en lieu et place de la liste des
                 pistes reprise dans la liste principale. Certains rglages
                 de la fentre Prfrences, section Fichiers, peuvent vous
                 permettre lors du glissement d'un fichier vers le panneau ou
                 vers l'icne de DigitalCD sur la barre d'icnes d'ajouter
                 celui-ci  la file, d'activer automatiquement le programme
                 et de jouer ainsi ce fichier sans perturber la liste
                 principale.

         Mlange

             Si activ, avant de commencer  jouer la liste des pistes,
             DigitalCD mlange les pistes afin de les jouer dans un ordre
             diffrent. Ceci diffre d'un mode alatoire en ce sens qu'une
             piste ne sera joue une deuxime fois que lorsque toutes les
             autres pistes auront t joues une premire fois. La fentre
             Prfrences, section Lecteurs, vous permet d'opter pour un
             re-mlange automatique de la liste en fin de boucle afin de ne
             pas rejouer la liste dans le mme ordre que lors de la boucle
             prcdente.

             Il est  noter que les lecteur de fichiers et lecteur de radios
             Internet disposent d'options de mlange bien plus avances.
             Cliquer SELECT sur l'icne de mlange affichera un menu
             reprenant ces options tandis que cliquer ADJUST dsactivera ou
             ractivera le mlange. Les options listes permettent d'arranger
             les pistes de diverses manires:

                Les fichiers peuvent tre groups  diffrents niveaux:
                 collectif, artiste, coffret, album.
                Les fichiers d'un album de compilation suivent le mme ordre
                 de niveaux de regroupement que les albums normaux sauf si
                 compilation est slectionn. Dans ce cas l'ordre de niveaux
                 de regroupement devient coffret, album, suivit par
                 collectif, artiste si par artiste est slectionn.
                Les radios peuvent tre groupes  diffrents niveaux: type
                 MIME, vitesse de chargement, diffuseur.
                Les groupes peuvent tre mlangs ou de tris par ordre
                 alphabtique  chaque niveau de regroupement.

             Parmi les groupes dfinis, les pistes peuvent tre:
                Mlanges.
                Tries par l'ordre alphabtique.
                Suivre de l'ordre dans l'album (le groupement par album doit
                 tre actif).

         Rptition

             Lecture normale, joue les pistes la liste puis s'arrte.
             Liste en boucle, boucle sur les pistes la liste.
             Piste en boucle, boucle sur la piste joue.
             Jouer une seule piste, joue la piste jusqu'au bout avant de
             s'arrter. Cela permet de terminer proprement une session
             d'coute et de repartir lors de la prochaine session avec la
             piste suivante (pour une liste identique et en l'absence de
             mlange).

         Balayage

             Si activ, DigitalCD ne joue que le dbut de chaque piste, vous
             permettant ainsi de rechercher une piste dont vous ne connaissez
             que la mlodie. La fentre Prfrences, section Lecteurs, vous
             permet de rgler la dure du balayage de chaque piste.


                  Panneau de contrle: Zone spcifique au lecteur
                  

      Le contenu de cette zone dpend de la nature du lecteur contrl.

      Pour un lecteur de CD des icnes peuvent tre prsentes pour:

         ouvrir la fentre Base de donnes CD,
         ouvrir le tiroir du lecteur de CD.

      Pour le lecteur de fichiers des icnes peuvent tre prsentes pour:

                retirer la piste joue de sa liste d'origine,
                supprimer (aprs confirmation) le fichier correspondant  la
                 piste joue,
                diter les proprits du fichier jou (SELECT),
                 ouvrir la liste contenant la piste joue (ADJUST),
                ouvrir la liste principale (SELECT),
                 ouvrir la file de fichiers (ADJUST).

      Pour le lecteur de radios Internet des icnes peuvent tre prsentes
      pour:

                retirer la piste joue de sa liste d'origine,
                diter les proprits de la radio joue (SELECT),
                 ouvrir la liste contenant la piste joue (ADJUST),
                ouvrir la liste principale.


                      Panneau de contrle: Boutons principaux
                      

             Jouer vous permet de

                commencer  jouer,
                reculer au dbut de la piste joue, ou
                continuer de jouer aprs une pause.

             Pauser vous permet de

                pauser la piste joue, ou
                continuer de jouer aprs une pause.

             Stopper arrte de jouer.


                    Panneau de contrle: Boutons de dplacement
                    

             Reculer vous permet de reculer dans la piste joue (si la touche
             Shift est presse simultanment vous reculez au dbut de la
             section prcdente de la piste).

             Avancer vous permet d'avancer dans la piste joue (si la touche
             Shift est presse simultanment vous avancez au dbut de la
             section suivante de la piste).

             Prcdent vous permet de reculer  la piste prcdente.

             Suivant vous permet d'avancer  la piste suivante.


                      Panneau de contrle: Raccourcis clavier
                      

      Touche   Action
      
      Espace/Retour Jouer/Pauser
      + Shift  Reculer au dbut la section courante de la piste joue
      + Ctrl   Reculer au dbut la piste joue
      Esc Stopper

      Flche Gauche Reculer dans la piste joue
      Flche Droite Avancer dans la piste joue
      Shift + Gauche     Reculer au dbut de la section prcdente de la
                         piste joue
      Shift + Droite     Avancer au dbut de la section suivante de la piste
                         joue
      Ctrl + Gauche Reculer  la piste prcdente
      Ctrl + Droite Avancer  la piste suivante

      Ctrl + Page vers Haut   Hausser le volume principal du lecteur
      Ctrl + Page vers Bas    Baisser le volume principal du lecteur
      Ctrl + Haut   Hausser finement le volume principal du lecteur
      Ctrl + Bas    Baisser finement le volume principal du lecteur

      I   Activer/Dsactiver le balayage
      P   Activer/Dsactiver le programme
      R, Shift + R  Cycler sur les modes de rptition
      S   Activer/Dsactiver le mlange
      T, Shift + T  Cycler sur les modes du chrono

      Ctrl + K Dmarrer les plug-ins configurs
      Ctrl + Shift + K   Stopper tous les plug-ins

      CDs:

      Ctrl + Insertion   Ouvrir la base de donnes CD

      Fichiers musicaux:

      Page vers Haut     Hausser le volume relatif de la piste joue
      Page vers Bas Baisser le volume relatif de la piste joue
      Flche Haut   Hausser finement le volume relatif de la piste joue
      Flche Bas    Baisser finement le volume relatif de la piste joue

      Insertion     Editer les proprits de la piste joue
      Shift + Insertion  Ouvrir la liste contenant la piste joue
      Ctrl + Insertion   Ouvrir la liste principale
      Ctrl + Shift + Insertion     Ouvrir la file de fichiers

      Supprimer     Retirer la piste joue de sa liste d'origine
      Ctrl + Supprimer   Supprimer le fichier correspondant  la piste joue

      Radios Internet:

      Page vers Haut     Hausser le volume relatif de la piste joue
      Page vers Bas Baisser le volume relatif de la piste joue
      Flche Haut   Hausser finement le volume relatif de la piste joue
      Flche Bas    Baisser finement le volume relatif de la piste joue

      Insertion     Editer les proprits de la piste joue
      Shift + Insertion  Ouvrir la liste contenant la piste joue
      Ctrl + Insertion   Ouvrir la liste principale

      Supprimer     Retirer la piste joue de sa liste d'origine


                                Base de donnes CD
                                

    Ouvrez directement la base de donnes CD depuis le menu de la barre
    d'icne de DigitalCD ou cliquez le bouton Editer dans le panneau de
    contrle du lecteur CD. Dans la Skin par dfaut de DigitalCD, le bouton
    Editer est le logo Compact Disc affich ci-dessous:




    La base de donnes CD sera affiche sous forme de liste ou de vue
    arborescente.

   Groupes dans les vues arborescentes   CD(s), proprits       Marquer des
                                                                 rfrences   
   Options d'affichage                   Pistes(s), proprits   Rechercher
                                                                 des
  rfrences
   Raccourcis claviers                                           Commandes
                                                                 diverses

    Notes

    DigitalCD stocke le code retourn par la commande *WhichDisc
    (gnralement de six chiffres) de chaque CD qu'il joue comme identifiant.
    Cet identifiant est utilis comme nom d'album par dfaut.

    DigitalCD peut tre configur pour utiliser AcornCD afin de rcuprer les
    descriptions de CD sur internet. Vous n'tes donc pas oblig d'introduire
    ces descriptions par vous-mme.


              Base de donnes CD: Groupes dans les vues arborescentes
              

      Les informations dans la base de donnes CD via une vue arborescente
      peut prsenter des groupes de types suivants:

          Collectif d'artistes.
          Artiste.
          Coffret de compilations.
          Coffret d'albums.
          Compilation (album).
          Album.
          Pistes CD.


                           Base de donnes CD: Recherche
                           

           Pour ouvrir la fentre de recherche, cliquez sur le bouton de
           recherche dans la barre d'outils de la liste, ou choisissez
           Recherche depuis le sous-menu Marques ou encore pressez F7.

      Cette fentre vous permet d'agir sur les rfrences de la liste d'un
      certain domaine de recherche et respectant l'un des critres de
      recherche dfinis. L'action par dfaut est de Lister toutes les
      rfrences trouves dans une fentre de rsultats de recherche.

      Les critres de recherches possibles sont:

         Tous pour agir sur toutes les rfrences.
         Mtadonnes    pour agir sur toutes les rfrences dont l'une des
                         mtadonnes (titre, album, artiste, ...)  contient
                         le texte donn.


                        Base de donnes CD: Recherche: Actions
                        

        Les actions possibles  effectuer sur les rfrences trouves sont:

               Lister    pour lister la rfrence dans une fentre de
                          rsultats de recherche.

               Marquer   pour placer une marque devant la rfrence.
               Dmarquer pour enlever toute marque devant la rfrence.

               Slectionner   pour ajouter la rfrence  la slection.
               Dslectionner pour retirer la rfrence de la slection.


                 Base de donnes CD: Recherche: Domaine de recherche
                 

        Les domaines possibles sont:

               Base de donnes     pour chercher parmi toutes les rfrences
                                    de la base de donnes CD.

               Marques  pour chercher parmi toutes les rfrences dj
                          marques.
               Dmarques     pour chercher parmi toutes les rfrences non
                               encore marques.

               Slectionnes  pour chercher parmi toutes les rfrences dj
                               slectionnes.
               Dslectionnes     pour chercher parmi toutes les rfrences
                                    non encore slectionnes.


                 Base de donnes CD: Recherche: Fentre de rsultats
                 

        Une fentre de rsultats de recherche est une liste temporaire
        contenant des liens vers les rfrences vrifiant les critres d'une
        recherche effectue.

        Plusieurs oprations sont disponibles sur ces rfrences:
           retirer des rfrences de la fentre de rsultats,
           diter les proprits d'une ou plusieurs rfrences, tout
            changement affectera les rfrences originales.


                       Base de donnes CD: Commandes diverses
                       

      Sauver

               Cette commande vous permet de sauver les modifications
               apportes  la base de donnes CD.

      Proprits

               Cette commande n'est disponible que si vous slectionnez un
               ensemble de rfrences de mme type. Elle vous permet d'diter
               les proprits d'une ou de plusieurs rfrences  la fois.
               Pour plus de dtails veuillez vous rfrer  la description de
               chaque type de rfrence.

               Voir CD(s), proprits, Pistes(s), proprits.

      Proprits CD

               Cette commande permet de modifier les proprits du ou des CDs
               impliqus dans la slection.

      Recharger

          Cette commande vous permet d'annuler toutes les modifications
          apportes  la base de donnes CD depuis la dernire sauvegarde.

      Supprimer le CD

          Cette commande vous permet de supprimer la description d'un CD.


                                      Listes
                                      

    Une liste est un ensemble d'objets qui peuvent tre utiliss pour dfinir
    la liste des pistes jous par le lecteur de fichiers ou le lecteur de
    radios Internet. La liste sera affiche sous forme de liste ou de vue
    arborescente. Les lecteurs CD ou le moniteur sonore ne font aucun usage
    de ces listes.

    Les objets sont de diffrences sortes:

       Objets jouables. Ce sont:
           des fichiers,
           des radios Internet.

       Listes contenues par la liste principale. Ce sont:
           des listes secondaires,
           des listes-rpertoires,
           des listes importes,
           des pages jaunes.

       Liens. Ils pointent vers des objets stocks dans d'autres listes.
        Toute modification sur ces liens tels que l'dition de leurs
        proprits modifie directement les originaux. Les liens ne peuvent
        tre stocks et donc seules les listes temporaires telles que la file
        de fichiers et les rsultats de recherches peuvent en faire usage. 

   Dtail des rfrences jouables          Ajouter des fichiers  une liste
                                                                               Marquer des rfrences
   Dtail des rfrences vers des listes   Couper et coller, supprimer
                                                                               Rechercher des
  rfrences
   Groupes dans les vues arborescentes     Glisser et dposer
                                                                               Commandes diverses
   Options d'affichage                     Raccourcis claviers


                                  Liste principale
                                  

      La liste principale est une liste permanente listant des rfrences
      vers des objets qui peuvent tre jous par le lecteur de fichiers et le
      lecteur de radios Internet ainsi que des rfrences vers d'autres
      listes:
             des listes secondaires.
             des listes-rpertoires.
             des pages jaunes.

      Les lecteurs susmentionns se servent du contenu de la liste principale
      pour en driver la composition de la liste des pistes qu'ils joueront.

      Pour ouvrir la liste principale, utilisez directement le lecteur de
      fichiers ou ouvrez le menu de DigitalCD sur la barre d'icnes et
      choisissez Liste principale. En fonction des rglages dans la fentre
      Prfrences, section Barre d'icnes, cliquer SELECT or ADJUST sur
      l'icne de DigitalCD dans la barre d'icnes peut aussi ouvrir la liste
      principale.

      Les autres listes et listes-rpertoires peuvent tre ouvertes par un
      double-clique sur leurs rfrences dans la liste principale. Il est 
      noter que fermer la fentre d'une liste ne dcharge pas ce document de
      la mmoire mais le soustrait simplement  votre vue.

       Grer des listes secondaires   Proprits des listes            
       Grer des listes-rpertoires   Proprits des listes-rpertoires
       Grer des pages jaunes         Proprits des pages jaunes      
       Commandes diverses                                              


                                  Liste secondaire
                                  

          Une liste secondaire est une liste permanente stocke  l'endroit
          de votre choix comme un fichier FileList (type 155) et listant des
          rfrences vers des objets qui peuvent tre jous par le lecteur de
          fichiers et le lecteur de radios Internet.

      Toutes les listes secondaires sont gres depuis la liste principale.

      La fentre d'une liste s'ouvre par un double-click sur sa rfrence
      dans la liste principale. Il est  noter que fermer la fentre d'une
      liste ne dcharge pas ce document de la mmoire mais le soustrait
      simplement  votre vue.

       Grer des listes secondaires   Proprits des listes secondaires


                              Liste secondaire: Gestion
                              

        Crer une liste

             Cliquez sur le bouton de cration d'une liste dans la barre
             d'outils de la liste principale. Une nouvelle boite de dialogue
             apparat vous permettant de dfinir ses proprits. Pressez
             Appliquer, la nouvelle liste vide s'ouvre alors  l'cran et est
             liste dans la liste principale.

        Sauver une liste

        Le contenu de la liste principale est automatiquement sauv au mme
        endroit que les prfrences de l'utilisateur lors de l'arrt de
        DigitalCD, mais toutes les autres listes doivent tre explicitement
        sauvegardes vers une destination de votre choix. 

             Cliquez avec SELECT ou ADJUST sur le bouton sauver de la barre
             d'outil de la liste ou pressez F3 or Shift+F3. La premire
             option vous propose une boite de dialogue standard Sauvez sous
             tandis que la seconde sauve directement le fichier sous son nom
             actuel.

        DigitalCD rpartit les modifications d'une liste en deux: catgories:
        changements de statut/proprits (joue, titre, volume relatif, etc.)
        et modifications de contenu (copie, suppression, etc.). Si lors de
        l'arrt de DigitalCD, ou du dchargement de la liste, seules des
        modifications de la premire catgorie sont apparues, DigitalCD
        sauvera automatiquement celles-ci alors qu'il vous demandera
        confirmation des changements de seconde catgorie afin de prvenir
        toute modification accidentelle.

        Ajouter une liste

        Une rfrence vers une liste peut tre ajoute dans la liste
        principale par un double-clique sur l'icne du fichier ou en faisant
        glisser celle-ci vers l'icne de DigitalCD sur la barre d'icnes. Il
        ne faut jamais faire glisser celle-ci vers la liste principale, cette
        opration insre en effet le contenu de la liste dans la liste
        principale (ainsi que cela se produit lorsque vous faites glisser un
        fichier vers un document existant).

        Supprimer une liste

             Pour supprimer une liste, slectionnez sa rfrence dans la
             liste principale et utilisez l'une des deux oprations Couper ou
             Supprimer.

        Charger et dcharger le contenu

        Par dfaut le chargement se fait automatiquement lors du dmarrage de
        DigitalCD mais une liste peut tre configure individuellement pour
        ne pas tre charge au dmarrage. 

        Afin de charger ou de dcharger manuellement le contenu d'une liste,
        slectionnez sa rfrence dans la liste principale et choisissez
        Charger ou Dcharger dans le sous-menu Liste.


                             Liste secondaire: Proprits
                             

             Pour ouvrir la fentre Proprits des listes secondaires
             slectionnez une ou plusieurs rfrences  des listes
             secondaires dans la liste principale puis soit:
                Shift+double-cliquez sur les rfrences,
                cliquez sur le bouton proprits dans la barre d'outils de
                 la liste principale,
                choisissez Proprits dans le sous-menu Listes du menu de la
                 liste principale.

        L'dition simultane des proprits de plusieurs listes restreint le
        nombre de proprits ditable. Les proprits qui diffrent d'une
        liste  l'autre seront affiches dans une teinte diffrente.

        La fentre vous permet:
           de modifier le nom de fichier d'une liste non charge en mmoire
            (manuellement ou en faisant glisser l'icne d'un fichier vers le
            champ d'dition).
           de modifier le rpertoire de base d'une liste charge
            (manuellement ou en faisant glisser l'icne d'un rpertoire vers
            le champ d'dition).
           de laisser, au chargement de la liste, DigitalCD extraire des
            mtadonnes  partir du nom de fichier des rfrences.
           de modifier le titre de la liste.
           de modifier le nom de l'artiste.
           d'ajouter des remarques dans le champ Info.
           de marquer la liste pour le chargement automatique de son contenu
            en mmoire lors du dmarrage de DigitalCD.


                                  Liste-rpertoire
                                  

          Une liste-rpertoire est une liste contenant un instantan du
          contenu du rpertoire sur lequel elles sont bases. Ces listes,
          dont les rfrences et leurs proprits ne sont jamais sauvegardes
          (transfrez les vers une liste classique pour cela), sont juste des
          moyens rapides d'accder  des rpertoires:
                  organiss, o les noms des sous-rpertoires et noms de
                   fichiers permettent de retrouver les mtadonnes
                   principales des fichiers telles que l'artiste, l'album, ou
                   le titre.
                  temporaires, tel que le fameux "<MP3$Dir>" que nombre de
                   personnes utilisent pour stocker les fichiers MP3 qu'ils
                   viennent de tlcharger.

      Toutes les listes-rpertoire sont gres depuis la liste principale.

      La fentre d'une liste-rpertoire s'ouvre par un double-click sur sa
      rfrence dans la liste principale. Il est  noter que fermer la
      fentre d'une liste ne dcharge pas ce document de la mmoire mais le
      soustrait simplement  votre vue.

       Grer des listes-rpertoires   Proprits des listes-rpertoires


                              Liste-rpertoire: Gestion
                              

        Crer une liste-rpertoire

             Cliquez sur le bouton de cration d'une liste-rpertoire dans la
             barre d'outils de la liste principale. Une nouvelle boite de
             dialogue apparat vous permettant de dfinir ses proprits. Au
             minimum, vous devez dfinir le rpertoire de base de la
             liste-rpertoire. Pressez Appliquer, la nouvelle
             liste-rpertoire sera liste dans la liste principale et
             DigitalCD commencera  charger son contenu (voir ci-dessous).

        Supprimer une liste-rpertoire

             Pour supprimer une liste-rpertoire, slectionnez sa rfrence
             dans la liste principale et utilisez l'une des deux oprations
             Couper ou Supprimer.

        Charger et dcharger le contenu

        L'opration de chargement consiste  parcourir rcursivement son
        rpertoire de base et ses sous-rpertoires et  ajouter  la liste
        les rfrences de tous les fichiers ayant un type reconnu.

        Par dfaut le chargement se fait automatiquement lors du dmarrage de
        DigitalCD mais chaque liste peut tre configure individuellement
        pour ne pas tre charge au dmarrage.

        Afin de charger ou de dcharger manuellement le contenu d'une liste,
        slectionnez sa rfrence dans la liste principale et choisissez
        Charger ou Dcharger dans le sous-menu Listes-rpertoire.

        Un rafrachissement du contenu de la liste afin de reflter des
        changements intervenus dans le rpertoire peut donc se faire
        simplement en dchargeant et rechargeant la liste.


                             Liste-rpertoire: Proprits
                             

             Pour ouvrir la fentre Proprits des listes-rpertoire
             slectionnez une ou plusieurs rfrences  des listes-rpertoire
             dans la liste principale puis soit:
                Shift+double-cliquez sur les rfrences,
                cliquez sur le bouton proprits dans la barre d'outils de
                 la liste principale,
                choisissez Proprits dans le sous-menu Listes du menu de la
                 liste principale.

        L'dition simultane des proprits de plusieurs listes restreint le
        nombre de proprits ditable. Les proprits qui diffrent d'une
        liste  l'autre seront affiches dans une teinte diffrente.

        La fentre vous permet:
           de modifier le rpertoire de base d'une liste-rpertoire
            (manuellement ou en faisant glisser l'icne d'un rpertoire vers
            le champ d'dition).
           de laisser, au chargement de la liste, DigitalCD extraire des
            mtadonnes  partir du nom de fichier des rfrences.
           de modifier le titre de la liste.
           de modifier le nom de l'artiste.
           d'ajouter des remarques dans le champ Info.
           de marquer la liste pour le chargement automatique de son contenu
            en mmoire lors du dmarrage de DigitalCD.


                                   Liste importe
                                   

          Une liste importe est une liste permanente stocke  l'endroit de
          votre choix dans un format autre que les listes habituelles de
          DigitalCD. Les listes supportes sont M3U (type de fichier AA7) et
          PLS (type de fichier AA8). Ces deux types de liste contiennent des
          rfrences  des radios Internet.

      Toutes la listes importes sont maintenues depuis la liste principale.

      La fentre d'une liste importe s'ouvre par un double-click sur sa
      rfrence dans la liste principale. Il est  noter que fermer la
      fentre d'une liste ne dcharge pas ce document de la mmoire mais le
      soustrait simplement  votre vue.

       Grer des listes importes   Proprits des listes importes


                               Liste importe: Gestion
                               

        Sauver une liste

             Cliquez avec SELECT ou ADJUST sur le bouton sauver de la barre
             d'outil de la liste ou pressez F3 or Shift+F3. La premire
             option vous propose une boite de dialogue standard Sauvez sous
             tandis que la seconde sauve directement le fichier sous son nom
             actuel.

        Il est  remarquer que toutes (ou presque) les proprits des
        lments de la liste sont perdues car le format de ces listes ne les
        supporte pas.

        Ajouter une liste

        Une rfrence vers une liste importe peut tre ajoute dans la liste
        principale par un double-clique sur l'icne du fichier ou en faisant
        glisser celle-ci vers l'icne de DigitalCD sur la barre d'icnes. Il
        ne faut jamais faire glisser celle-ci vers la liste principale, cette
        opration insre en effet le contenu de la liste dans la liste
        principale (ainsi que cela se produit lorsque vous faites glisser un
        fichier vers un document existant).

        Supprimer une liste

             Pour supprimer une liste, slectionnez sa rfrence dans la
             liste principale et utilisez l'une des deux oprations Couper ou
             Supprimer.

        Charger et dcharger le contenu

        Par dfaut le chargement se fait automatiquement lors du dmarrage de
        DigitalCD mais une liste peut tre configure individuellement pour
        ne pas tre charge au dmarrage. 

        Afin de charger ou de dcharger manuellement le contenu d'une liste,
        slectionnez sa rfrence dans la liste principale et choisissez
        Charger ou Dcharger dans le sous-menu Liste.


                              Liste importe: Proprits
                              

             Pour ouvrir la fentre Proprits des listes importes
             slectionnez une ou plusieurs rfrences  des listes importes
             dans la liste principale puis soit:
                Shift+double-cliquez sur les rfrences,
                cliquez sur le bouton proprits dans la barre d'outils de
                 la liste principale,
                choisissez Proprits dans le sous-menu Listes du menu de la
                 liste principale.

        L'dition simultane des proprits de plusieurs listes restreint le
        nombre de proprits ditable. Les proprits qui diffrent d'une
        liste  l'autre seront affiches dans une teinte diffrente.

        La fentre vous permet:
           de modifier le nom de fichier d'une liste non charge en mmoire
            (manuellement ou en faisant glisser l'icne d'un fichier vers le
            champ d'dition).
           de modifier le titre de la liste.
           de modifier le nom de l'artiste.
           d'ajouter des remarques dans le champ Info.
           de marquer la liste pour le chargement automatique de son contenu
            en mmoire lors du dmarrage de DigitalCD.


                                    Page jaunes
                                    

          Une page jaune est une liste dont le contenu, listant des
          rfrences  des radios Internet, est tlcharg depuis son URL sur
          Internet. Les rfrences et leurs proprits ne sont jamais
          sauvegardes (transfrez les vers une liste classique pour cela).
          La plus grande page jaune tlchargeable que je connais est
          http://dir.xiph.org/yp.xml mais rien ne vous empche d'utiliser
          l'URL de larges fichiers m3u ou pls si vous en connaissez.

      Toutes la pages jaunes sont maintenues depuis la liste principale.

      La fentre d'une page jaune s'ouvre par un double-click sur sa
      rfrence dans la liste principale. Il est  noter que fermer la
      fentre d'une liste ne dcharge pas ce document de la mmoire mais le
      soustrait simplement  votre vue.

       Grer des pages jaunes   Proprits des pages jaunes


                                 Page jaune: Gestion
                                 

        Crer une page jaune

             Cliquez sur le bouton de cration d'une page jaune dans la barre
             d'outils de la liste principale. Une boite de dialogue apparait
             vous permettant de dfinir ses proprits. Dfinissez au minimum
             l'URL de la page jaune (tel que http://dir.xiph.org/yp.xml ou
             l'URL d'un fichier .m3u ou .pls) et pressez Appliquer, la
             nouvelle page jaune est liste  la liste principale et
             DigitalCD commencera  tlcharger son contenu depuis Internet.

        Supprimer une page jaune

             Pour supprimer une page jaune, slectionnez sa rfrence dans la
             liste principale et utilisez l'une des deux oprations Couper ou
             Supprimer.

        Charger et dcharger le contenu

        Dans le cas d'une page jaune l'opration de chargement consiste 
        tlcharger son contenu sur Internet via l'URL spcifi.

        La page jaune peut tre configure individuellement pour ne pas tre
        charge au dmarrage.

        Afin de charger ou de dcharger manuellement le contenu d'une page
        jaune, slectionnez sa rfrence dans la liste principale et
        choisissez Tlcharger ou Dcharger dans le sous-menu Pages Jaunes.


                                Page jaune: Proprits
                                

             Pour ouvrir la fentre Proprits des pages jaunes slectionnez
             une ou plusieurs rfrences  des pages jaunes dans la liste
             principale puis soit:
                Shift+double-cliquez sur les rfrences,
                cliquez sur le bouton proprits dans la barre d'outils de
                 la liste principale,
                choisissez Proprits dans le sous-menu Pages Jaunes du menu
                 de la liste principale.

        L'dition simultane des proprits de plusieurs pages jaunes
        restreint le nombre de proprits ditable. Les proprits qui
        diffrent d'une page jaune  l'autre seront affiches dans une teinte
        diffrente.

        La fentre vous permet:
           de modifier l'URL d'une page jaune non charge.
           d'ajouter des remarques dans le champ Info.
           de marquer la page jaune pour le chargement automatique de son
            contenu en mmoire lors du dmarrage de DigitalCD.


                                  File de fichiers
                                  

      La file de fichiers est une liste listant des rfrences vers des
      fichiers qui seront joues par le lecteur de fichiers lorsque son mode
      programme est actif. Cette liste n'est pas sauvegarde en sortie de
      DigitalCD.

      Pour ouvrir la file de fichiers, utilisez directement le lecteur de
      fichiers ou ouvrez le menu de DigitalCD sur la barre d'icnes et
      choisissez File de fichiers. En fonction des rglages dans la fentre
      Prfrences, section Barre d'icnes, cliquer SELECT or ADJUST sur
      l'icne de DigitalCD dans la barre d'icnes peut aussi ouvrir la file
      de fichiers.

      Les deux manires usuelles d'utiliser la file de fichiers sont de:
         Jouer des fichiers qui ne font pas partie de vos listes en faisant
          glissez directement vers sa fentre des fichiers ou des rpertoires
          depuis le Filer. Ceci vous permet de dfinir une liste temporaire
          sans affecter vos autres listes.
         Jouer un sous-ensemble de vos listes, tels qu'un album ou toutes
          les pistes d'un artiste, en faisant glissez vers sa fentre des
          rfrences provenant d'autres listes. Cette opration insre non
          pas une copie de ces rfrences mais bien des liens vers les
          rfrences originales de sorte que tout changement (extraction de
          mtadonnes, changements de volume relatif, etc) affectera
          directement les rfrences originales.


                       Liste: Dtail des rfrences jouables
                       

      Chaque rfrence peut afficher les informations suivantes:

         Jouabilit. Elle vous indique si la rfrence est  inclure dans la
          liste des pistes  jouer par le lecteur de fichier et le lecteur de
          radios Internet.

         Coch, la rfrence est inclue dans la liste des pistes.
         Non coch, la rfrence est exclue de la liste des pistes.

         Pas de case pour cocher, la proprit Ne jamais jouer de la
         rfrence est active et donc la rfrence est forcment exclue de la
         liste des pistes.

         Icone de type de la rfrence.

         Fichier.
         Radio Internet.

         Marques et indices.

         L'indice visuel de la rfrence.
         La marque d'un rsultat de recherche.
         La marque d'un lien, dnotant le lien vers une rfrence stocke
         dans une autre liste et dont l'dition des proprits affectera
         directement la rfrence originale.

         Marques de jeu.

         L'absence de marque indique que l'objet rfrenc n'a jamais t
         jou.
         Un triangle noir indique que l'objet rfrenc est en train d'tre
         jou.
         Une coche verte indique que l'objet rfrenc a t jou durant
         cette session.
         Une coche grise indique que l'objet rfrenc a t jou durant une
         ancienne session.
         Une croix rouge indique que la dernire tentative pour jouer l'objet
         rfrenc a choue.
         Un point d'interrogation indique que la commande Valider considre
         la rfrence vers l'objet comme incorrecte.

         Pour effacer les marques de jeu d'une liste ouvrez le menu de la
         liste et choisissez Effacer les marques de jeu dans le sous-menu
         Marques.

         Le titre de la rfrence ou un substitut en son absence.


                    Liste: Dtail des rfrences vers des listes
                    

      Chaque rfrence vers une liste peut afficher les informations
      suivantes:

         Jouabilit. Elle vous indique si le contenu de la liste sera repris
          dans la liste des pistes  jouer par le lecteur de fichier et le
          lecteur de radios Internet.

          Coche, toutes les rfrences de la liste elles-mmes coches
          seront reprises dans la liste des pistes.
          Non coche, le contenu de la liste sera exclu de la liste des
          pistes.

         Icnes affichant le type et le statut de la liste. L'icne est
          grise lorsque la liste n'est pas charge en mmoire.

          L'icne d'un rpertoire avec des notes de musique pour une liste
          secondaire.
          L'icne d'un rpertoire pour une liste-rpertoire.
          L'icne d'un rpertoire avec une marque de rseau pour des pages
          jaunes.

         Marques.

         La marque d'un rsultat de recherche.
         La marque d'un lien, dnotant le lien vers une rfrence stocke
         dans une autre liste et dont l'dition des proprits affectera
         directement la rfrence originale.

         Marques d'accs.

         Rien si la liste n'a jamais t charge.
         Une coche verte si la liste a dj t charge durant cette session.
         Une coche grise si la liste a dj t charge durant une ancienne
         session.
         Une croix rouge si la dernire tentative de chargement de la liste a
         choue.
         Un point d'interrogation indique que la commande Valider considre
         la rfrence vers la liste comme incorrecte.

         Le titre de la liste ou un substitut en son absence.


                     Liste: Groupes dans les vues arborescentes
                     

      Les informations dans une liste affiche via une vue arborescente peut
      prsenter des groupes de types suivants:

          Radios Internet.
           Type de radios Internet.
           Diffuseur de radios Internet.
           Vitesse de chargement.

          Listes.

          Fichiers musicaux.
           Collectif d'artistes.
           Artiste.
           Coffret de compilations.
           Coffret d'albums.
           Compilation (album).
           Album.


                             Liste: Options d'affichage
                             

      Cliquer MENU sur la liste et suivre le sous-menu Affichage vous permet
      de modifier l'affichage des rfrences de la liste.

         Hirarchise

          Si cette option est active, la liste s'affiche sous forme d'une vue
          arborescente avec possibilit d'afficher/de cacher des groupes de
          rfrences. Si cette option est inactive la liste s'affiche sous la
          forme d'une liste.

         Grouper par

          Liste les diffrentes possibilits de grouper des rfrences.
          Les radios Internet peuvent tre groupes par diffuseur et vitesse
          de chargement.
          Les fichiers peuvent tre groups par collectif, artiste, coffret,
          album, compilation (et par artiste au sein d'une compilation). Dans
          le regroupement usuel par artiste et album, si compilation est
          laiss inactif, les albums de compilation seront dcoups par
          artiste et les parties correspondantes seront listes comme album
          de chaque artiste. 

         Trier par

          Liste les diffrentes possibilits de trier les rfrences au sein
          de la liste et de chaque groupe. Les groupes sont quant  eux
          toujours tris par ordre alphabtique.
          Les rfrences peuvent tre tris dans l'ordre de l'album
          (normalement utilis en combinaison avec le regroupement par
          album), tris dans l'ordre alphabtique par nom de piste ou peuvent
          ne pas tre tries du tout.

         Vue par dfaut

          Slectionner cette option pour restaurer les options d'affichages
          par dfaut.

         Utiliser comme dfaut

          Slectionner cette option pour utiliser comme valeurs par dfaut
          les options d'affichages actuelles de la liste. Il est  noter que
          des valeurs par dfaut diffrentes sont utilises pour les listes
          et les rsultats de recherche.


                      Liste: Ajouter des fichiers  une liste
                      

      La manire habituelle d'ajouter des fichiers  une liste est de faire
      glisser leurs icnes depuis leur rpertoire vers la position dans la
      liste o vous dsirez insrer ces fichiers. Seules les rfrences vers
      des fichiers dont le type est reconnu seront insres dans la liste.

      Plus pratique encore, vous pouvez galement faire glisser l'icne d'un
      rpertoire vers la liste. Ce rpertoire et l'ensemble de ses
      sous-rpertoires est alors parcouru et une rfrence est insre dans
      la liste pour chaque fichier dont le type est reconnu.

      Enfin, en fonction des rglages de la fentre Prfrences, section
      Fichiers, il peut tre possible d'ajouter des rfrences vers des
      fichiers  la liste principale soit en faisant glisser leurs icnes
      depuis leur rpertoire soit vers l'icne de DigitalCD sur la barre
      d'icnes ou vers le panneau de contrle du lecteur de fichiers, soit
      par un simple double-clique sur les fichiers.


                         Liste: Couper et coller, supprimer
                         

      Couper, Copier et Coller


      Les oprations standards du presse-papiers Couper, Copier et Coller
      ainsi que leurs raccourcis Ctrl+X, Ctrl+C, Ctrl+V sont implments dans
      les listes. Slectionnez des rfrences dans la liste, copiez ou coupez
      les vers le presse-papiers ensuite dplacez le curseur vers la position
      dsire dans la liste (ou dans une autre) et collez le contenu du
      presse-papiers dans la liste.

      Deux restrictions sont d'application:
         seules les rfrences simples sont insres dans le presse-papiers,
          pas les rfrences vers des listes ou listes-rpertoires.
         en collant une section d'un fichier de type FileList (type 155)
          depuis un diteur de texte, veillez  coller uniquement les
          rfrences contenant un chemin complet dans leur nom de fichier ou
          d'URL.

      Pour supprimer des rfrences sans les placer dans le presse-papiers
      utilisez Supprimer (Del).

      Supprimer les fichiers rfrencs

      Les oprations Couper et Supprimer retirent simplement les rfrences
      slectionnes de la liste. Si en plus vous dsirez physiquement
      supprimer les fichiers rfrencs utilisez la commande Supprimer
      Fichiers (Shift+Del). Par mesure de scurit une confirmation de
      l'opration vous sera demande avant son excution.


                             Liste: Glisser et dposer
                             

      Les oprations couper et coller peuvent s'effectuer avec la souris via
      un glisser et dposer de la slection pour autant que la slection ne
      comporte que des rfrences vers des objets jouables (c'est  dire pas
      de listes ni, dans les vues arborescentes, de groupes). A titre
      d'alternative vous pouvez effectuer un glisser de l'icne d'un objet ou
      d'un groupe dans une vue arborescente pour faire glisser toutes les
      rfrences contenues dans ce groupe.

      Ds que vous commencez  dplacer la slection/l'icne vous voyez le
      pointeur se changer en un pointeur de glissement accompagn d'un signe
      signalant l'opration qui prendra lieu lorsque vous relcherez les
      rfrences  la position actuelle du pointeur. L'opration par dfaut
      est un copier  moins que la liste ne s'affiche comme une liste brute
      (pas de vue arborescente, pas de regroupements ni de tri) auquel cas un
      dplacer devient le dfaut car il est dans ce cas possible afin de
      rordonner les rfrences dans la liste.

      Un glisser et dposer n'est pas limit  la liste originale mais des
      que vous quittez la fentre originale l'opration par dfaut devient un
      copier. La destination finale peut tre une autre liste ou mme l'icne
      de DigitalCD sur la barre d'icnes auquel cas l'opration cre une
      nouvelle liste.

      Si vous pressez Shift pendant le glisser une opration alternative vous
      est gnralement propose (un dplacer au lieu d'un copier ou vice
      versa).

      Si vous faites glisser au-dessus d'une liste, positionnez le pointeur
      dans la fentre prs du bord de celle-ci et la liste dfilera
      automatiquement. De mme pour les listes affiches comme liste brute un
      curseur rouge apparait dans la liste et suit le pointeur afin
      d'indiquer le point d'insertion des rfrences dans la liste.

      Le signe combin au pointeur sera remis  jour pour reflter tout
      changement d'opration caus par un Shift ou un changement de
      destination:
         un moins pour indiquer un dplacement des rfrences.
         un plus pour indiquer l'insertion d'une copie des rfrences.
         un lien pour indiquer l'insertion de liens vers les rfrences.
         un signe d'interdiction lorsque l'opration n'aura pas d'effet.
         un point d'interrogation lorsqu'il est impossible de dire comment
          l'application sous le pointeur ragira.

      Dposer les rfrences pour complter l'action ou pressez Esc pour
      abandonner l'opration.


                             Liste: Raccourcis clavier
                             

      Touche   Action
      
      Insert   Activer ou dsactiver la liaison entre le curseur et la
               slection
      Shift + Insert     Dmarrer/Arrter une slection de type SELECT
      Ctrl + Insert Dmarrer/Arrter une slection de type ADJUST
      Espace   Inverser le statut de slection de la rfrence courante
      Ctrl + A Slectionner toutes les rfrences de la liste
      Ctrl + Z Effacer la slection

      Ctrl + X Couper la slection vers le presse-papier
      Ctrl + C Copier la slection vers le presse-papier
      Ctrl + V Coller le contenu du presse-papier dans la liste
      Supprimer     Supprimer la slection sans la copier dans le
                    presse-papier
      Shift + Supprimer  Supprimer physiquement les fichiers rfrencs dans
                         la slection

      Retour   Ouvrir la fentre de proprits de la rfrence courante
      Shift + Retour     Ouvrir la fentre de la liste pointe par la
                         rfrence courante

      F3  Ouvrir une boite de dialogue Sauvez sous
      Shift + F3    Sauver la liste sous son nom actuel

      F7  Ouvrir la fentre de Recherche

      F11 Marquer la slection
      Shift + F11   Effacer les marques de la slection
      Ctrl + F11    Dplacer le curseur vers la marque prcdente
      Ctrl + Shift + F11 Dplacer le curseur vers la marque suivante


                           Liste: Marquer des rfrences
                           

           Les marques vous permettent de naviguer facilement dans une liste.
           Slectionnez simplement les rfrences  marquer et pressez F11 ou
           choisissez Dfinir Marque dans le sous-menu Marques. Des marques
           peuvent aussi tre dfinies depuis la fentre de Recherche si vous
           chercher des rfrences rpondant  des critres donns.

      Une fois vos marques places, pressez Ctrl+F11 (Ctrl+Shift+F11) ou
      choisissez Marque Prcdente (Suivante) dans le sous-menu Marques pour
      dplacer le curseur vers la marque prcdente (suivante). 

      Pour retirer des marques, slectionnez les rfrences et pressez
      Shift+F11 ou choisissez Retirer Marques dans le sous-menu Marques.

      Pour retirer toutes les marques, choisissez Effacer Marques dans le
      sous-menu Marques.


                                  Liste: Recherche
                                  

           Pour ouvrir la fentre de recherche, cliquez sur le bouton de
           recherche dans la barre d'outils de la liste, ou choisissez
           Recherche depuis le sous-menu Marques ou encore pressez F7.

      Cette fentre vous permet d'agir sur les rfrences de la liste d'un
      certain domaine de recherche et respectant l'un des critres de
      recherche dfinis. L'action par dfaut est de Lister toutes les
      rfrences trouves dans une fentre de rsultats de recherche.

      Les critres de recherches possibles sont:

         Tous pour agir sur toutes les rfrences.

         Indice    pour agir sur toutes les rfrences affichant un indice
                    visuel donn, ou si aucun indice visuel n'est donn pour
                    agir sur toutes les rfrences n'affichant aucun indice
                    visuel.

         Nom de fichier pour agir sur toutes les rfrences dont le nom de
                         fichier ou l'URL contiennent le texte donn.
         Mtadonnes    pour agir sur toutes les rfrences dont l'une des
                         mtadonnes (titre, album, artiste, ...)  contient
                         le texte donn.

         Sans score     pour agir sur toutes les rfrences sans score.
         Points    pour agir sur toutes les rfrences respectant la
                    condition de score donne.


                              Liste: Recherche: Actions
                              

        Les actions possibles  effectuer sur les rfrences trouves sont:

               Lister    pour lister la rfrence dans une fentre de
                          rsultats de recherche.

               Marquer   pour placer une marque devant la rfrence.
               Dmarquer pour enlever toute marque devant la rfrence.

               Cocher  jouer pour cocher la rfrence comme tant  jouer.
               Cocher  ne pas jouer    pour cocher la rfrence comme tant
                                          ne pas jouer.

               Slectionner   pour ajouter la rfrence  la slection.
               Dslectionner pour retirer la rfrence de la slection.


                        Liste: Recherche: Domaine de recherche
                        

        Les domaines possibles sont:

               Toutes les listes   pour chercher parmi toutes les rfrences
                                    de toutes les listes.
               Liste     pour chercher parmi toutes les rfrences de la
                          liste courante.

               Marques  pour chercher parmi toutes les rfrences dj
                          marques.
               Dmarques     pour chercher parmi toutes les rfrences non
                               encore marques.

               A jouer   pour chercher parmi toutes les rfrences coches
                          comme tant  jouer.
               A ne pas jouer pour chercher parmi toutes les rfrences
                               coches comme tant  ne pas jouer.
               A ne jamais jouer   pour chercher parmi toutes les rfrences
                                    ayant cette proprit (et qui ne peuvent
                                    donc tre coches). 

               Slectionnes  pour chercher parmi toutes les rfrences dj
                               slectionnes.
               Dslectionnes     pour chercher parmi toutes les rfrences
                                    non encore slectionnes.

               En cours  pour chercher le rfrence en cours de lecture.
               Joues    pour chercher parmi toutes les rfrences dj
                          joues.
               Non joues     pour chercher parmi toutes les rfrences non
                               encore joues.
               Echecs de lecture   pour chercher parmi toutes les rfrences
                                    que DigitalCD n'a pas t en mesure de
                                    jouer.
               Invalides     pour chercher parmi toutes les rfrences
                               invalides.


                        Liste: Recherche: Fentre de rsultats
                        

        Une fentre de rsultats de recherche est une liste temporaire
        contenant des liens vers les rfrences vrifiant les critres d'une
        recherche effectue.

        Plusieurs oprations sont disponibles sur ces rfrences:
           retirer des rfrences de la fentre de rsultats,
           diter les proprits d'une ou plusieurs rfrences, tout
            changement affectera les rfrences originales, mme en
            provenance de plusieurs listes,
           faire glisser des rfrences vers la file de fichiers pour
            insrer de nouveaux liens vers les rfrences originales,
           faire glisser des rfrences vers d'autres listes pour y insrer
            des copies des rfrences originales,
           faire glisser des rfrences vers la l'icne de DigitalCD sur la
            barre d'icnes afin de crer une nouvelle liste.


                             Liste: Commandes diverses
                             

      Valider

          Cette commande parcourt la liste et marque avec un "?" toutes les
          rfrences vers un fichier inexistant ou d'un type incorrect. Cette
          commande est trs utile pour localiser les rfrences vers des
          fichiers supprims, renomms ou dplacs. Faites cependant
          attention car seront galement marques les rfrences vers des
          fichiers accds via des systmes de fichiers non dmarrs au
          moment de la vrification (SparkFS, IZipFS, etc).

      Complter

          Cette commande parcourt le contenu du rpertoire de base et de ses
          sous-rpertoires afin d'ajouter  la liste les fichiers musicaux
          absents de la liste. Cela vous permet de ractualiser la liste
          aprs avoir ajout des fichiers ou des albums  votre collection.

           Proprits

          Cette commande n'est disponible que si vous slectionnez un
          ensemble de rfrences de mme type. Elle vous permet d'diter les
          proprits d'une ou de plusieurs rfrences  la fois. Pour plus de
          dtails veuillez vous rfrer  la description de chaque type de
          rfrence.

          Proprits d'un fichier
          Proprits d'une radio Internet
          Proprits des listes
          Proprits des listes-rpertoires
          Proprits des pages jaunes

           Jouer

          Cette commande n'est disponible que si vous slectionnez une seule
          rfrence et uniquement si celle-ci est marque comme tant 
          jouer. La commande active le lecteur appropri et joue la rfrence
          slectionne ou, dans le cas d'une rfrence de type liste, la
          premire rfrence jouable de cette liste.


                             Liste: Rpertoire de base
                             

      Le rpertoire de base d'une liste est le nom du rpertoire qui devrait
      normalement contenir l'ensemble des fichiers rfrencs par la liste.
      Les fichiers rfrencs dont le chemin d'accs contient le rpertoire
      de base seront conservs dans la liste relativement  ce rpertoire de
      base. Ceci offre plusieurs avantages:

         Ces rfrences occupent moins de place en mmoire et dans le
          fichier Playlist sauvegard.
         Si vous dcidez de dplacer ce rpertoire vers un autre emplacement
          sur votre disque dur voire un autre disque, il n'est pas ncessaire
          de corriger le chemin de chaque fichier rfrenc dans la liste,
          vous devez juste modifier le chemin du rpertoire de base de la
          liste et toutes les rfrences seront ainsi corriges en une seule
          fois.
         La plupart du temps les fichiers ne sont pas placs au hasard dans
          le rpertoire de base mais sont nomms et regroups dans des
          sous-rpertoires en fonction de certaines mtadonnes de ces
          fichiers tels que nom et numro de piste, nom de l'artiste, de
          l'album, etc. Cela signifie qu'en partant du rpertoire de base
          comme point de dpart il est possible pour DigitalCD de deviner
          certaines mtadonnes des fichiers en fonction de la partie
          restante de leurs noms de fichiers.
         Vous pouvez utiliser la commande Complter pour parcourir le
          contenu du rpertoire de base et de ses sous-rpertoires afin
          d'ajouter  la liste les fichiers musicaux absents de la liste.


                                   Prfrences
                                   

    La fentre Prfrences configure les diffrents aspects de DigitalCD.
    Afin de configurer DigitalCD, ouvrez son menu sur la barre d'icnes et
    choisissez Prfrences. A moins que la configuration par dfaut de la
    section Barre d'icnes n'est t modifie cliquer Ctrl-SELECT ou
    Ctrl-ADJUST sur l'icne de DigitalCD sur la barre d'icnes ouvre
    galement cette fentre.

    La fentre est divise en deux zones.  droite une arborescence reprenant
    diffrentes sections et sous-sections, et  gauche le contenu de la
    section actuellement slectionne. Pour afficher le contenu d'une autre
    section, cliquez sur son nom dans l'arborescence.

    Les modifications effectus dans la fentre ne prennent normalement effet
    qu'une fois valides en cliquant sur les boutons Sauver ou Appliquer,
    cependant:

       Les modifications effectues dans les sections Mixage et galiseur
        sont appliqus immdiatement aux fins de test. Les valeurs d'origines
        seront toutefois restaures si vous fermez la fentre ou si vous
        cliquez sur Annuler.
       Certaines options de pilotes ne prennent effet que lorsque la piste
        suivante est lue.

    Cliquer Appliquer fait persister les modifications jusqu' ce que vous
    quittiez DigitalCD. Cliquer Sauver fait de mme mais sauve aussi vos
    prfrences afin qu'elles soient recharges la prochaine fois que
    DigitalCD est utilis.


                          Prfrences: Liste des sections
                          

      Skins    Modifier l'apparence des panneaux de contrle.
      Lecteurs Modifier le comportement des lecteurs.
      Mixage   Options de mixage du son.
       Stro  Positionnement stro du son.
       galiseur    galiseur de frquences sonores.
      Barre d'icnes     Comportement de l'icne de DigitalCD.
      Plug-Ins Slection et configuration des plug-ins de visualisation.
       chantillonneurs  Options d'chantillonnage.
      Fichiers Options de chargement et de lecture des fichiers.
       Types   Associations entre pilotes et types de fichiers.
      Pilotes   
       AMPlayer     Configuration du module AMPlayer.
       CDFS    Options de lecture et configuration des lecteurs CD.
        AcornCD     Chargez vos descriptions de CD depuis le net.
       DiskSample   Configuration du module DiskSample.
       PlayIt  Configuration du module PlayIt.
       TimPlayer    Configuration du module TimPlayer.
      Internet Configuration des radios Internet.


                                  Prfrences: Skins
                                  

        Les skins proposent diffrentes apparences pour les panneaux de
        contrle et mini-barres de DigitalCD. Afin de changer de skin,
        slectionnez en une autre dans la liste ou utilisez les flches pour
        parcourir la liste.

        Si vous installez de nouvelles skins pendant que DigitalCD
        fonctionne, ouvrez la liste avec ADJUST afin de provoquer un
        rafrachissement de celle-ci.

        +   Mode lecteur unique rutilise la mme fentre pour tous les
            lecteurs (Fichiers, Radios, CDs, ...).

        +   'Retirer'  la 'Ne jamais jouer' force la commande Retirer la
            piste  slectionner l'option Ne jamais jouer de la piste en
            cours au lieu de retirer la piste en cours de la liste.


                                Prfrences: Lecteurs
                                

        +   Auto-jouer les listes au dmarrage signale  DigitalCD de
            commencer  jouer la liste principale immdiatement aprs son
            dmarrage.

        +   Mmoriser la position dans la liste sauve au dchargement de
            DigitalCD la dernire position joue afin de pouvoir repartir de
            cette position lors de la prochaine session.

        +   Auto-jouer les nouveaux CDs introduits signale  DigitalCD de
            commencer  jouer immdiatement tout nouveau CD introduit dans un
            lecteur CD (pour autant que le panneau de contrle correspondant
            soit ouvert).

        +   Dure du balayage spcifie le nombre de secondes  jouer avant de
            passer  la piste suivante si le mode Balayage est actif.

        +   Arrter de jouer en cas d'erreur force le lecteur  s'arrter
            aprs une erreur de chargement en lieu et place de passer  la
            piste suivante. Trs utile lorsque les fichiers de la liste sont
            dans une archive et que vous avez oubli de charger SparkFS.

        +   Protger la base CD et les listes dsactive toute fonctionnalit
            modifiant les listes ou la base de donnes CD de sorte que vous
            pouvez en toute scurit mettre DigitalCD entre les mains de
            personnes peu exprimentes telles que des parents gs ou de
            jeunes enfants.

        +   Re-mlanger lorsque la liste boucle ne fonctionne que lorsque le
            mode Mlange est actif. Dans ce cas, lorsque la liste boucle,
            c'est  dire lorsque le lecteur est sur le point de rejouer la
            premire piste, la liste est re-mlange afin de ne pas rejouer
            la liste dans le mme ordre que prcdemment.

        +   Prcharger la piste suivante ouvre la piste suivante en mmoire
            lorsque la piste actuelle est presque joue afin que la piste
            suivante soit prte  jouer lorsque la piste actuelle se termine.
            Ceci permet de rduire le silence entre les pistes  un minimum.
            Faites cependant attention que l'utilisation de la mmoire
            augmente et que le prchargement n'est pas toujours possible car
            les modules que DigitalCD utilise pour certains type de fichiers
            n'acceptent qu'un seul fichier ouvert  la fois.


                                 Prfrences: Mixage
                                 

        Les options dcrites ci-dessous n'affectent que les sons joues via
        la carte audio interne de votre machine et non les sons produits par
        d'autres matriels (lecteurs CD ou cartes MIDI). Certaines options
        sont aussi ignores par les pilotes employs pour jouer certains
        types de flots (fichiers/radios).

        +   La frquence de mixage est la vitesse  laquelle les pilotes
            alimentent votre carte audio avec des chantillons. Utiliser une
            frquence plus leve fournit une meilleure qualit de son mais
            demande des capacits de calcul plus importantes  la machine.
            Notez cependant que pour les flots comprims tels que le MP3, la
            dcompression du flot constitue de loin l'essentiel du travail.
            Les utilisateurs de cartes audio 16-bit pourront choisir parmi la
            liste complte des frquences supportes par la carte, alors que
            les pilotes 8-bit verront cette frquence arrondie vers la plus
            proche frquence supporte par l'ancienne interface 8-bit.

            Vous pouvez choisir d'utiliser la frquence spcifie mais aussi
            d'utiliser un multiple de la frquence d'chantillonnage de la
            piste. Ce dernier mode rduit la distortion introduite par le
            fait de jouer une piste  une autre frquence que sa frquence
            d'chantillonnage (en prsumant que la carte sonore effectue une
            conversion digitale vers analogique dcente pour toutes les
            frquences supportes). Si la frquence d'chantillonnage n'a pas
            de correspondance dans la liste des frquences de la carte, la
            frquence la plus proche est choisie. De mme, si la piste n'a
            pas de frquence d'chantillonnage (Tracker, ...) la frquence
            spcifie est utilise.

        +   La Taille des buffers sonores DMA est la taille, en nombre
            d'chantillons, du buffer rempli lors de chaque interruption de
            remplissage de buffer sonore.

            Le systme de surveillance sonore utilis par les plug-ins de
            visualisation sonore ne peuvent suivre plus de 100 remplissages
            par secondes et il est donc prfrable d'utiliser la taille 1024
            afin de diminuer la frquence des remplissages et viter des
            inconsistances dans l'affichage des pistes sonores et spectres de
            frquence.

            En cas d'incompatibilit avec une autre application, utilisez
            toutefois une taille sans danger de 208.

        +   Activez Interpolation si vous dsirez que les pilotes effectuent
            une interpolation linaire entre les valeurs des chantillons de
            frquence infrieure  la frquence de mixage (le son devient
            moins mtallique). Dsactiver cette option sur les plus anciennes
            machines permet de diminuer notablement la puissance de calcul
            utilise.

        +   Activez Rampe de volume afin que les pilotes utilisent une courte
            rampe de volume pour changer le volume d'une note au lieu de
            sauter directement d'un volume de note  l'autre, attnuant de la
            sorte les clics et autre grsillements ainsi produits.

        +   Ignorer le volume systme signale  DigitalCD de ne pas tenir du
            volume sonore systme et donc un volume de 100% dans DigitalCD
            correspondra au volume maximum permis par la machine alors qu'en
            temps normal un volume de 100% dans DigitalCD correspond au
            volume sonore systme (valeur configure via la barre de volume
            la section Son de votre configuration systme ou modifie via la
            commande CLI *volume).


                             Prfrences: Mixage, Stro
                             

        Les options dcrites ci-dessous n'affectent que les sons joues via
        la carte audio interne de votre machine et non les sons produits par
        d'autres matriels (lecteurs CD ou cartes MIDI). Certaines options
        sont aussi ignores par les pilotes employs pour jouer certains
        types de flots (fichiers/radios).

        +   La glissire de balance permet de dplacer la balance du son vers
            la gauche ou la droite.

        +   La glissire de sparation stro permet de modifier la
            sparation entre les canaux de droite et de gauche. Vous aurez
            peut-tre envie de la diminuer pour une coute au casque ou de
            l'augmenter pour un son plus spatial. Vous pouvez mme inverser
            la stro.

        Note: comme racourci, cliquez directement sur les nombres sous les
        barres afin de positionner directement la glissire  cette valeur.


                                Prfrences: galiseur
                                

        Cette option n'est disponible que lors de la lecture de fichiers ou
        flots utilisant les pilotes TimPlayer et DiskSample et ncessite que
        le processeur de votre machine soit au moins un StrongARM. Pour
        l'utiliser, slectionnez galiseur puis, tout en jouant une piste,
        ajustez les barres d'amplifications des diffrentes bandes de
        frquences.

        Une fois que vous tes content de la combinaison entrez son nom dans
        le champ de saisie et cliquez sur Sauver. La combinaison est alors
        sauve et apparat dans le menu associ  l'icne pop-up  droite du
        champ de saisie. Vous tes donc libre d'exprimenter diffrentes
        combinaisons et de sauver les meilleures. Une combinaison sauve peut
        tre rappele en la slectionnant dans le menu.

        Pour supprimer une combinaison slectionnez-la depuis le menu puis
        cliquer sur Supprimer.


                             Prfrences: Barre d'icnes
                             

        Cette fentre dfinit quelles fentres sont ouvertes lorsque vous
        cliquer sur l'icne de DigitalCD sur la barre d'icnes.

        Choisissez pour chaque variante de SELECT et ADJUST (seul ou en
        pressant simultanment l'une des touches Shift ou Ctrl) l'une des
        fentres de la liste.


                                Prfrences: Plug-ins
                                

        Les plug-ins offrent des animations contrles par la musique en
        version bureau (dans une fentre) ou plein-cran. Les plug-ins ne
        peuvent seulement tre dmarrs que lorsque vous jouez des pistes
        pour lesquelles DigitalCD peut extraire des chantillons du son
        produit, il convient donc de vous assurer que les chantillonneurs
        sont configurs correctement.

        +   Pendant que vous jouez, vous pouvez dmarrer un plug-in
            plein-cran (un seul peut fonctionner  la fois) ou une
            combinaison de plusieurs plug-ins de bureau. Ainsi vous devez
            soit activer l'option Plug-in plein-cran et slectionner un
            plug-in plein-cran dans la liste ou bien activer l'option
            Plug-ins de bureau, parcourir la liste des plug-ins de bureau et
            (d)activer chacun d'entre eux.

            Dans chaque cas, cliquez Info pour obtenir des informations
            dtailles sur un plug-in et cliquez Config pour le configurer.

        +   Si l'option Auto-dmarrer avec la piste est active les plug-ins
            slectionns seront dmarrs automatiquement lorsque vous
            commencez  jouer des pistes. Dans tous les autres cas il vous
            faudra les dmarrer via le panneau de contrle.

        +   L'option Multiplier par volume de la piste affecte le rendu des
            plug-ins de visualisations. Les chantillons fournis aux plug-ins
            sont en effet remis  l'chelle en fonction du volume principal
            du lecteur afin de fournir une visualisation identique quelle que
            soit le volume que vous utilisez. Il ne faut cependant pas
            oublier que chaque piste au sein d'une liste bnficie d'un
            volume relatif dont on peut ou non tenir compte dans la mise 
            l'chelle des chantillons.

            Visuellement il est en gnral prfrable de laisser cette option
            inactive car les chantillons sont alors proportionnels au volume
            relatif dont le but est justement de ramener des pistes trop
            faibles ou trop bruyantes au mme niveau que les autres. Un
            volume relatif suprieur  100% peut cependant amplifier des
            chantillons hors des limites de l'chelle et provoquer une
            distorsion visuelle auquel cas l'on peut prfrer activer
            l'option.


                            Prfrences: chantillonneurs
                            

        Cette section permet de dfinir quel pilote d'chantillonnage le
        module DCDUtils doit utiliser afin de fournir des chantillons des
        sons produits aux plug-ins de visualisation.

        Le pilote d'chantillonnage  utiliser dpend de ce que vous tes en
        train de jouer. Ainsi les fichiers et radios Internet sont
        gnralement jous via les tampons plus ou moins interceptables du
        module SoundDMA  l'exception notable des fichiers MIDI. A moins de
        disposer d'un programme de synthse MIDI (tel que !Synth de ESP) ces
        derniers sont jous via une carte spcialise. Les CDs audio sont
        quant  eux jous via le matriel prsent dans le lecteur lui-mme.

        Tout les cas o les tampons SoundDMA ne sont pas utiliss, les
        chantillons du son ne peuvent tre obtenus que via un matriel
        spcialis compatible avec l'API du module SoundDriver.

        Par consquent vous devez configurer chacune des cibles suivantes:

           Fichier ou Radio    Tout type de fichiers sauf MIDI et radios
                                Internet.
           MIDI Fichiers de type MIDI.
           Lecteur CD n 0  x Chacun des lecteurs de CD de votre machine.

        avec l'un des pilotes d'chantillonnage suivants:

           None Aucun chantillon n'est pris (et les plug-ins ne peuvent
                 tre dmarrs).
           SoundDMA  Extraction a partir des tampons du module SoundDMA.
           Tout pilote SoundDriver prsent lorsque DigitalCD est dmarr (ou
            plus exactement le module DCDUtils).

        Plus spcifiquement lorsque vous choisirez un pilote SoundDriver il
        vaut faudra aussi choisir la configuration de ce pilote,  savoir:
        les sources utilises, le type d'chantillon et la frquence
        d'chantillonnage. Il est  noter que pour l'instant DCDUtils ne
        supporte que l'chantillonnage 'stro sign 16-bit'.


                                Prfrences: Fichiers
                                

        +   Utiliser le nom de fichier comme titre force les listes et la
            barre de titre du panneau de contrle  utiliser le nom du
            fichier en lieu et place du titre des fichiers musicaux.

        +   Dcharger le pilote en fin de piste force le dchargement du
            module RMA utilis pour jouer la piste lorsque celle-ci se
            termine.

        +   Actions de chargement de fichiers dtermine la faon dont
            DigitalCD gre le double-clique sur un fichier ou le lcher de
            fichiers sur certaines parties de l'application.

            Les actions possibles:
                Ignorer ignore compltement l'action.
                Ajouter  la file ajoute le fichier  la fin de la file de
                 fichiers.
                Ajouter  la file & Jouer ajoute le fichier  la fin de la
                 file de fichiers puis, si rien n'est actuellement jou,
                 commence  jouer le contenu de la file de fichiers.
                Ajouter  la liste ajoute le fichier  la fin de la liste
                 principale.
                Ajouter  la liste & Jouer ajoute le fichier  la fin de la
                 liste principale puis, si rien n'est actuellement jou,
                 commence  jouer le fichier insr.

            De plus:
                Ajouter  ... ouvre aussi la liste ouvre la liste dans
                 laquelle le fichier est ajout lorsque une action Ajouter 
                 ... est effectue.


                                  Prfrences: Types
                                  

        La liste prsente les types de fichiers accepts par DigitalCD et le
        nom du pilote utilis pour jouer chacun d'entre eux. La section types
        de fichiers accepts vous expliquera comment modifier cette liste.


                                Prfrences: AMPlayer
                                

        +   Le tampon anti-chocs dfinit la taille du tampon interne utilis
            par AMPlayer pour conserver en mmoire les sections dj dcodes
            de la piste qu'il est en train de lire. Au fur et  mesure que la
            piste progresse ce tampon se vide des sections joues tandis
            qu'il se r-emplit normalement avec de nouvelles sections
            dcodes. Une activit systme prolonge (oprations sur disques,
            SWIs) peut cependant empcher les r-emplissages de se produire 
            temps et provoquer ainsi une pause si le tampon se vide
            compltement. Un tampon plus important prendra plus de temps  se
            vider et par consquent le son sera moins sujet  des coupures.


                                  Prfrences: CDFS
                                  

        Lecteurs CD

        Les CD audios peuvent tre jous selon deux modes: soit l'ordinateur
        rcupre les "donnes" correspondant au son et l'envoie au systme
        audio de la machine (comme si il jouais un fichier WAVE), soit il
        demande au lecteur de jouer le son directement et de l'envoyer sur
        l'une de ses sorties (sortie digitale I2S ou sortie analoge stro).

        Les deux modes ne sont pas toujours possibles: les vieux lecteurs ne
        permettent pas de rcuprer les donnes audio, votre ordinateur peut
        ne pas disposer du connecteur I2S permettant de mixer le son du
        lecteur et de l'envoyer vers ses propres sorties, et certains
        lecteurs rcents ne prsentent aucune sortie audio. De plus, mme
        lorsque vous pouvez utiliser la seconde mthode, certains lecteurs
        prsentent des troubles qu'il faut contourner.

        Il est donc important de configurer le bon mode de lecture du lecteur.

        Les options si dessous s'ajustent sparment pour chaque lecteur CD
        de votre machine.

        +   Mode

            utilisez CD_ReadAudio afin de lire les donnes audio du CD et les
            jouer sur le systme sonore de la machine. Pro: les options de
            mixage (galiseur, ...). Con: utilise du CPU et n'est pas
            compatible avec les vieux lecteurs.

            utilisez CD_PlayAudio afin de demander au lecteur de jouer le son
            sur ses sorties audio. Pro: pas de CPU utilis. Con: ncessite un
            lien entre la sortie audio du lecteur et les enceintes ou la
            carte son de la machine.

            utilisez CD_PlayAudio (track by track), comme CD_PlayAudio mais
            en jouant uniquement jusqu' la fin de la piste et non du disque.
            Pro: compatible avec plus de lecteurs. Con: gnre une petite
            pause sonore entre les pistes.

            utilisez CD_PlayTrack, une mthode plus ancienne que
            CD_ReadAudio. Pro: compatible avec plus de lecteurs. Con: joue du
            dbut  la fin d'une piste sans possibilit de se positionner
            dans la piste.

        +   Pilote CD avec bogue des 150 trames

            Certaines versions des modules CDFSSoftxxxx contiennent un bogue
            dans leur code responsable d'une diffrence de 150 trames (2
            secondes) entre la spcification d'une nouvelle position de
            lecture et la valeur retourne par l'interface lors d'une demande
            de la position courante de lecture.

            tes-vous concerns par ce problme? Et bien, commencez  lire un
            CD et utilisez les boutons d'avance et de recul: normalement ces
            boutons vous dplacent d'une seconde en avant ou en arrire dans
            la piste. Si ce n'est pas le cas, par exemple si le bouton
            d'avance vous fait reculer dans la piste, activez cette option.

        +   Lire le CD une piste aprs l'autre est mon ancienne mthode pour
            lire les CDs et dtecter les changements de pistes. La nouvelle
            mthode vite les courtes pauses produite entre les pistes par
            l'ancienne mthode qui reste disponible (au cas o) pour raisons
            de compatibilit.

        +   Lire avec le SWI CD_PlayTrack est encore une autre manire de
            lire les CDs. Celle mthode semble accepte par plus de lecteurs
            que via le SWI CD_PlayAudio, l'inconvnient est que vous perdez
            ici toute possibilit de modifier la position dans la piste
            courante.

        +   Dcaler la taille du CD de permet de tenir compte du fait que
            certaines versions des diffrents modules CDFSSoftxxxx retournent
            des tailles de CD diffrant d'une trame. Il en rsulte que
            diffrents lecteurs peuvent retourner diffrentes identifications
            (voir la commande *Whichdisc) pour un mme CD et qu'en
            consquence DigitalCD ne peut retrouver la description de ce CD
            dans sa base de donnes. Si ceci vous arrive, notez la diffrence
            entre l'identification affiche par le panneau de contrle CD et
            l'identification stocke dans la base de donnes CD, ensuite
            ajustez ici la correction  apporter pour ce lecteur.

        Panneaux de contrle CD

        +   Le dlai de contrle est l'intervalle de temps minimum entre les
            rafrachissements de statut/position de vos panneaux de contrle
            CDs. Si vous constatez que le fait de jouer des CDs ralentit
            votre bureau, accroissez cet intervalle.

        +   Ne pas afficher le n du lecteur vous permet de cacher le numro
            de lecteur cd "< x >" affich avec le titre ou l'artiste du CD.


                                 Prfrences: AcornCD
                                 

        Introduire manuellement la description de vos CDs n'est pas une
        ncessit, il existe en effet sur Internet un ensemble de serveurs
        CDDB (un acronyme pour CD DataBase) contenant la description (titre
        et artiste de l'album, titres des pistes) de la plupart des CDs
        existant  ce jour.

        L'application AcornCD peut tre utilise pour lire les
        caractristiques du CD dans votre lecteur, rcuprer sa description
        sur l'un de ces serveurs et la transmettre  DigitalCD.

        +   L'option AcornCD autorise la demande de description  AcornCD
            pour tout CD non encore rpertori introduit dans votre lecteur.

        +   Autoriser la connexion  distance autorise AcornCD  se connecter
            sur des serveurs Internet afin de tenter de trouver toute
            description de CD qui ne figure pas dans sa base de donnes
            locale.

        +   Afficher l'tat de la requte fournit une indication visuelle
            signalant qu'une requte vers AcornCD est en cours.

        +   Chemin d'AcornCD doit contenir le chemin de AcornCD sur votre
            machine afin que DigitalCD soit en mesure de dmarrer cette
            application si elle n'est pas active. Dplacez simplement l'icne
            de !AcornCD depuis le rpertoire contenant l'application vers le
            champ de saisie afin de remplir automatiquement celui-ci.


                               Prfrences: DiskSample
                               

        +   Taille du tampon d'entre dfinit la taille du tampon interne
            utilis par DiskSample pour contenir en mmoire les prochaines
            sections  dcoder de la piste lue. Au fur et  mesure ce tampon
            se vide des sections dcodes tandis qu'il se r-emplit
            normalement avec de nouvelles sections  dcoder.  Une activit
            systme prolonge (oprations sur disques, SWIs) peut cependant
            empcher les r-emplissages de se produire  temps et provoquer
            ainsi une pause si le tampon se vide compltement. Un tampon plus
            important prendra plus de temps  se vider et par consquent le
            son sera moins sujet  des coupures.

        +   Taille du tampon de sortie dfinit la taille du tampon interne
            utilis par DiskSample pour contenir en mmoire les chantillons
            dj dcodes de la piste qu'il est en train de lire. Au fur et 
            mesure ce tampon se vide des chantillons joues tandis qu'il se
            r-emplit normalement avec de nouveaux chantillons dcods. Une
            activit systme prolonge (oprations sur disques, SWIs) peut
            cependant empcher les r-emplissages de se produire  temps et
            provoquer ainsi une pause si le tampon se vide compltement. Un
            tampon plus important prendra plus de temps  se vider et par
            consquent le son sera moins sujet  des coupures.

        +   Volume libre est reli  la procdure d'Automatic Gain Control
            lors du mixage. Celle-ci ramne le niveau sonore dans les limites
            du volume spcifi par l'utilisateur lorsque l'galiseur est
            actif avec pour effet une certaine rduction de la dynamique du
            son. L'option Volume libre force l'AGC  ne limiter le niveau
            sonore que lorsque celui-ci dpasse les 100% vous permettant de
            bnficier d'une dynamique maximale si vous rduisez le volume de
            lecture.

        +   Autoriser interruptions permet aux autres processus bass sur des
            interruptions, tel internet, d'oprer pendant le remplissage des
            tampons sonores (qui peut se rvler assez lent si trop de canaux
            sont mixs ou si l'galiseur est actif). L'inconvnient de cette
            option est de causer des perturbations dans le son si ces autres
            processus prennent trop de temps.


                                 Prfrences: PlayIt
                                 

        +   Taille du tampon dfinit la taille du tampon interne utilis par
            PlayIt pour contenir en mmoire les prochaines sections de la
            piste lue. Au fur et  mesure ce tampon se vide des sections
            joues tandis qu'il se r-emplit normalement avec de nouvelles
            sections  jouer.  Une activit systme prolonge (oprations sur
            disques, SWIs) peut cependant empcher les r-emplissages de se
            produire  temps et provoquer ainsi une pause si le tampon se
            vide compltement. Un tampon plus important prendra plus de temps
             se vider et par consquent le son sera moins sujet  des
            coupures.

        +   L'option Interprter un format inconnu en force PlayIt 
            interprter toute piste d'un format qui lui est inconnu suivant
            les paramtres (format, frquence et canaux) de votre choix au
            lieu de retourner une erreur. Il est  noter que seuls les types
            de fichiers associs  PlayIt (voir configuration des types de
            fichiers accepts) feront l'objet d'une telle interprtation.


                                Prfrences: TimPlayer
                                

        +   Polyphonie fixe la borne suprieure du nombre de notes joues
            simultanment. Le dfaut est de 64 et peut tre augment jusqu'
            128 mais ne vous emportez pas de trop (sous RPCEmu par exemple le
            son prsente des accros sous forte charge).

        +   Volume libre est reli  la procdure d'Automatic Gain Control
            lors du mixage. Celle-ci ramne le niveau sonore dans les limites
            du volume spcifi par l'utilisateur lorsque l'galiseur est
            actif (ou lorsque la pr-amplification en fonction du nombre de
            canaux est trop importante) avec pour effet une certaine
            rduction de la dynamique du son. L'option Volume libre force
            l'AGC  ne limiter le niveau sonore que lorsque celui-ci dpasse
            les 100% vous permettant de bnficier d'une dynamique maximale
            si vous rduisez le volume de lecture.

        +   Autoriser interruptions permet aux autres processus bass sur des
            interruptions, tel internet, d'oprer pendant le remplissage des
            tampons sonores (qui peut se rvler assez lent si trop de canaux
            sont mixs ou si l'galiseur est actif). L'inconvnient de cette
            option est de causer des perturbations dans le son si ces autres
            processus prennent trop de temps.


                                Prfrences: Internet
                                

        +   Utiliser un proxy signale  DigitalCD s'il doit tenter de
            rcuprer les flots HTTP des radios Internet en passant par un
            proxy. L'URL du proxy doit tre entr sous la forme
            http://[<utilisateur>[:<mot de passe>]@]<host>[:<port>]/ dans
            laquelle les parties entre [] sont optionnelles et les parties
            entre <> doivent tre remplace par le texte appropri, par
            exemple http://proxy.skynet.be:8080/.

        +   Slectionnez Solliciter mtadonnes Icy pour demander aux
            serveurs compatible Shoutcast de fournir des mtadonnes sur les
            titres jous.

            Attention: ces mtadonnes sont insres  intervalles rgulier
            dans le flot MP3, intervalles dfinis dans les en-ttes HTTP
            retourns par le serveur pour ce flot.  Si pour une raison
            quelconque ces en-ttes ne sont pas rcuprs, il devient
            impossible de sparer les mtadonnes du flot MP3 entranant des
            problmes de dcodage du MP3 et par l-mme des effets sonores
            rcurrents lors de l'coute.

            L'on peut penser que se problme ne devrait pas se poser,
            cependant les serveurs Shoutcast ne retournent pas d'en-ttes
            compatibles HTTP et ceci cause problme pour toute machine situe
            dans la chane de transmission entre le serveur et vous et qui
            manipule ces en-ttes. Les cas les plus courants sont les proxys
            HTTP qui vont alors remplacer ces en-ttes par des en-ttes par
            dfaut.

            Pour cette raison DigitalCD ignorera cette option si vous
            utilisez un proxy HTTP, cependant les proxys n'tant pas la seule
            source de ce problme si vous exprimentez ces effets sonores
            rguliers vous pouvez tenter de dsactiver cette option pour voir
            si cela fait une diffrence.

        +   Slectionnez Solliciter mtadonnes Audiocast pour demander aux
            serveurs compatible Audiocast (tels Icecast version 1) de fournir
            des mtadonnes sur les titres jous.

            Attention: ces mtadonnes sont rcupres en coutant sur un
            port UDP spar le plus souvent bloqu par des pare-feu  la fois
            cot serveur et cot client. De tels serveurs supportent
            cependant les mtadonnes Icy comme alternative aussi je
            conseille de laisser cette option non slectionne.

        +   Tampon permet de dfinir une dure minimale de donnes dcodes
            (dans les limites du tampon de sortie)  accumuler avant de
            commencer  jouer le son. Le but de cette rserve est d'viter au
            maximum les coupures de son dues aux alas de la transmission de
            donnes sur Internet.


                            Plug-ins de visualisation
                            

    Les plug-ins de visualisation sont des applications multitches utilises
    par DigitalCD pour afficher des reprsentations graphiques de sons en
    temps rel. Ils sont dmarrs  partir du panneau de contrle pendant
    qu'une piste est joue soit en choisissant Dmarrer plug-ins dans le
    sous-menu Divers ou en pressant Ctrl+K. Le ou les plug-ins configurs
    dans la fentre Prfrences, section Plug-Ins, seront alors dmarrs
    (pour autant qu'un chantillonneur appropri soit disponible pour
    capturer les sons produits).

    Les plug-ins sont de deux sortes:
       Les plug-ins plein-cran, qui comme leur nom le suggre, prennent le
        contrle de tout l'cran, voire mme changent la rsolution et le
        nombre de couleurs  l'cran pendant qu'ils tournent. Ces plug-ins
        redirigeront toutes les actions clavier qui ne les intressent pas
        vers le panneau de contrle qui les a lancs de manire  ce que
        puissiez manipuler celui-ci via ses raccourcis clavier.
       Les plug-ins de bureau, qui fonctionnent dans des fentres sur le
        bureau, s'attachent le plus souvent aux bords du panneau de contrle.
        Plusieurs d'entre eux peuvent tre utiliss  la fois.

    Installer des plug-ins

    Les plug-ins que vous recevez devront tre installs dans les rpertoires
    de ressources. Les plug-ins plein-cran seront copis dans
    !DCDRes.PlugIns.FullScreen et les plug-ins de bureau dans
    !DCDRes.PlugIns.Desktop. Lorsque vous installez de nouvelles versions de
    plug-ins existants, le plus courant est de supprimer l'ancienne version
    avant de copier la nouvelle mais vous devriez en premier lire les
    instructions d'installations fournies avec le plug-in.

                            Crer vos propres plug-ins
                              Problmes et solutions


                          Visualisation: Capture des sons
                          

      Les pilotes utiliss par DigitalCD pour jouer les pistes sonores
      travaillent tous sur des informations numriques. Celles-ci sont
      converties par le matriel de mixage de la carte son contenue dans
      votre machine en un signal analogique dirig soit vers les enceintes
      internes ou vers la sortie audio stro  l'arrire de votre machine.

      La manire dont ces informations sont fournies au matriel de mixage
      dpend de ce que vous tes en train de jouer. Ainsi les fichiers et
      radios Internet sont gnralement jous en interne via les tampons du
      module SoundDMA  l'exception notable des fichiers MIDI. A moins de
      disposer d'un programme de synthse MIDI (tel que !Synth de ESP) ces
      derniers sont jous via une carte spcialise. Les CDs audio sont quant
       eux jous via le matriel prsent dans le lecteur lui-mme.

      Et c'est ici que rside le problme: les PCs actuels disposent tous de
      cartes sonores quipes du matriel de capture ncessaire pour
      chantillonner les diffrentes sources sonores connectes  la carte
      ainsi que d'un support standardis au niveau de l'OS. Sous RISC OS rien
      de tout cela, d'o la ncessit de recourir  l'emploi de matriel
      spcialis supplmentaire et non-standardis. Afin de collecter les
      tampons d'chantillons  fournir aux plug-ins de visualisation
      DigitalCD intercepte d'une part les tampons du module SoundDMA pour les
      pilotes qui en font usage et d'autre part utilise l'API du module
      SoundDriver pour tenter de communiquer avec tout matriel de capture
      prsent.

      Quelles pistes peuvent tre visualises par DigitalCD?

      En standard, ainsi que cit prcdemment, tout fichier ou radio
      Internet dont le pilote utilise les tampons du module SoundDMA, c'est 
      dire tous sauf les fichiers MIDI du moins si vous utilisez une carte
      spcialise pour jouer ces derniers. 

      Enfin si vous disposez d'un matriel de capture compatible SoundDriver
      (en pratique je crois que cela se restreint aux possesseurs d'une carte
      DMI) vous pourrez capturer et visualiser les diffrentes sources
      accessibles tel que lecteurs CD, cartes MIDI voire mme le line-in ou
      votre micro.

       Assignation des chantillonneurs aux diffrents types de pistes 
       S'assurer du bon fonctionnement de SoundDriver 


                   Visualisation: Capture via le module SoundDriver
                   

        Pour ceux qui ne le savent pas, ESP (Expressive Software Projects) a
        dfini une interface standardise pour la capture du son sous la
        forme du module SoundDriver auquel viennent s'enregistrer les pilotes
        pour diffrents matriels de capture (en pratique cela se rsume  la
        carte DMI). Je ne possde pas de matriel adquat mais le module
        SharedSound fournit un pilote permettant de capturer le son produit
        en interne par la machine, aussi ESP m'a gentiment fourni une version
        du module SoundDriver afin que je puisse faire usage de cette
        interface pour permettre aux plug-ins de visualisation de DigitalCD
        d'afficher le son produit par les lecteurs CDs ou une carte MIDI.

        Avant tout usage si le module SoundDriver et les pilotes associs ne
        sont pas encore chargs en mmoire (ni dans la ROM d'une carte
        d'extension, ni chargs automatiquement au dmarrage de la machine),
        veuillez:

           Quitter toute application qui utilise le module DCDUtils telle
            que DigitalCD et certaines animations musicales utilises
            indpendamment (Spectrum, FireComet, ...).
           Tuer le module DCDUtils si prsent en mmoire (via un *RMKill
            DCDUtils.
           Dmarrer le module SoundDriver et les pilotes associs.
           Dmarrer DigitalCD.

        Lors du premier usage vous devez configurer DigitalCD afin de lui
        dire comment chantillonner les diffrents types de pistes sonores
        utiliss par DigitalCD. Pour cela, veuillez:

           Ouvrir la fentre Prfrences  la section
            Visualisation->Echantillonneurs. 
           Associer le pilote interne 'SoundDMA' avec le type de piste
            'Fichiers' (et avec le type 'MIDI' si vous utilisez le programme
            de synthse MIDI !Synth).
           Associer le pilote 'None' avec les types de pistes pour lesquels
            vous ne disposez d'aucune possibilit de capture du son.  
           Associer le pilote appropri pour les autres types, ensuite
            ajuster les sources gauches et droites, le type d'chantillon
            (seul sign 16-bit linaire est support pour l'instant) et la
            frquence d'chantillonnage (probablement 44100 Hz). 
           Sauver les nouvelles prfrences.

        Vous devriez alors pouvoir dmarrer les plug-ins pour toute piste
        sonore joue d'un type auquel vous avez associ un pilote.

        Si vous dsirez visualiser des sons non jous par DigitalCD tels que
        le line-in ou un autre programme, ouvrez le moniteur sonore,
        slectionnez le pilote  utiliser parmi la liste des pistes et
        dmarrer les plug-ins.

        Problmes connus:

           Seul l'chantillonnage linaire sign 16-bit stro est support.
           Le SWI SoundDriver_Record produit du texte  l'cran (j'espre
            sincrement que ceci ne se produit qu'avec la version du module
            que j'ai reu de ESP).


                                 Plug-ins: Cration
                                 

      Les plug-ins sont des applications multitches stockes soit dans
      !DCDRes.PlugIns.Desktop si elles tournent dans une fentre sur le
      bureau, soit dans !DCDRes.PlugIns.FullScreen si elles prennent le
      contrle de l'cran.

      Le plug-in comme toute autre application est un rpertoire contenant
      tous les fichiers ncessaire pour son fonctionnement mais,  moins de
      lui donner la capacit de fonctionner indpendamment de DigitalCD
      (comme !Spectrum), il n'est pas ncessaire de prfixer le rpertoire
      par "!" ni de fournir des fichiers !Boot et !Sprites.

      Le rpertoire peut contenir tous les fichiers que vous dsirez mais 3
      de ces fichiers (!Run, !Help et !SrvSetup) ont une fonction bien
      prcise. DigitalCD utilisera la commande Filer_Run pour dmarrer chacun
      de ceux-ci.

                        Fichiers ayant une fonction prcise
                           Ecrire le programme principal


                    Plug-ins: Fichiers ayant une fonction prcise
                    

           !Run est un fichier requis et sera utilis pour dmarrer le
            plug-in. Il s'agit du fichier Obey classique dans lequel vous
            initialisez quelques variables, la taille du wimpslot puis
            dmarrez le programme principal. DigitalCD utilisera Filer_Run
            pour lancer ce fichier avec comme unique paramtre la cl du
            lecteur que vous passerez au programme principal (Voir Ecrire le
            programme principal pour plus de dtails).

           !Help est un fichier optionnel et sera utilis pour fournir des
            informations sur le plug-in. Le plus souvent il s'agit d'un
            simple fichier texte.

           !SvrSetup est galement optionnel et sera utilis pour configurer
            le plug-in. Sa forme la plus probable est non pas un fichier mais
            le rpertoire d'une application (sans fichier !Boot ni !Sprites).

        Peut-tre avez-vous remarqu que j'ai utilis la mme convention de
        noms que pour les conomiseurs d'cran. C'est intentionnel car je me
        dis que vous pourriez envisager d'crire un plug-in capable de
        fonctionner en temps qu'conomiseur d'cran.


                       Plug-ins: crire le programme principal
                       

        Le programme principal est une application multitche qui reoit au
        moins un paramtre de votre fichier !Run. Ce paramtre est la cl du
        lecteur requise par le module DCDUtils lorsque vous enregistrez ou
        d-enregistrez votre plug-in et lorsque vous dsirez recevoir des
        tampons sonores ou des informations sur la piste joue par le lecteur.

        A partir d'ici vous pouvez:

                Lire attentivement le manuel DCDUtils qui explique le
                 protocole et les rgles  respecter par le plug-in ainsi
                 qu'une description complte des SWIs mis  votre disposition
                 par DCDUtils.
                Utiliser la librairie BASIC !DigitalCD.RMStore.DCDLib qui
                 fait le plus gros du travail requis pour un plug-in plein
                 cran vous laissant seulement la tche de remplir les trames
                 d'cran et d'interprter les touches clavier (telles que
                 fournies par l'vnement WIMP KeyPress). Audio16 et
                 FireComet sont deux exemples de plug-ins utilisant cette
                 librairie. Il est  noter que les programmes utilisant
                 DCDLib sont capables de fonctionner indpendamment de
                 DigitalCD (tant que vous n'oubliez pas d'effectuer un
                 RMEnsure du module DCDUtils dans votre fichier !Run).
            Consulter les sources en C contenues dans le plug-in de bureau
            !DigitalCD.Copy.PowerBars.

        Amusez-vous bien!


                                      Liste
                                      

    Une liste est reprsentation simple de donnes sous la forme d'une ou
    plusieurs colonnes d'lments slectionnables. Deux types de listes
    existent:
       Listes  slection simple o  tout moment un seul lment peut tre
        slectionn.
       Listes  slection multiple o plusieurs lments peuvent tre
        slectionns simultanment.

     Navigation au clavier
     Slection au clavier
     Slection/Edition via la souris


                            Liste: Navigation au clavier
                            

      Si la liste n'a pas le focus, cliquer dans la liste lui donne le focus
      et positionne le curseur se prsentant sous la forme d'un rectangle
      pointill entourant un lment de la liste. Dans le cas d'un clic avec
      SELECT sur un lment, celui-ci est slectionn en lieu et place de
      toute slection prexistante, dans les autres cas le curseur se
      repositionne simplement  sa dernire position connue.

      Utiliser les flches Haut/Bas (en combinaison possible avec Shift ou
      Ctrl) ou encore Page Up/Down vous permet de naviguer dans la liste
      comme dans n'importe quel document. En mode normal vous noterez que
      lorsque le curseur se dplace, la slection courante est  chaque fois
      remplace par l'lment dsign par le curseur tandis qu'en mode
      mouvement, la slection n'est pas affecte. Pressez la touche Insert
      pour basculer entre ces deux modes.


                     Liste: Slection d'lments via le clavier
                     

      Nous allons ici procder par un exemple et tenter de slectionner un
      ensemble d'lments formant une srie de blocs discontinus.

      Tout d'abord, nous allons slectionner un bloc d'lments incluant
      toutes les lments dsirs. Positionner le curseur sur le premier
      lment du premier bloc  slectionner, pressez Shift+Insert afin de
      marquer le dbut de la slection, dplacez le curseur vers la dernire
      rfrence du dernier bloc  slectionner et pressez  nouveau
      Shift+Insert pour marquer la fin de la slection. Notre bloc est
      slectionn.

      Maintenant nous allons dslectionner un sous-bloc au sein de notre
      bloc. Sachant que le dplacement normal du curseur rinitialise la
      slection il nous faut presser Insert afin de basculer du mode normal
      vers un mode dans lequel les mouvements du curseur n'affectent pas la
      slection.

      Vous pouvez ainsi dplacer le curseur vers le bloc  dslectionner.
      Pressez Ctrl+Insert, dplacer le curseur vers le dernier lment du
      bloc et pressez Ctrl+Insert  nouveau. Cette opration inverse l'tat
      de la slection des lments de ce bloc et donc dans ce cas ci retire
      les lments de la slection. La mme technique peut tre utilise pour
      ajouter d'autres lments  la slection.

      En guise de comparaison avec la slection via la souris, Shift+Insert
      se comporte comme une slection avec SELECT et Ctrl+Insert comme une
      slection avec ADJUST.

      Enfin vous pouvez aussi inverser l'tat de slection de l'lment
      dsign par le curseur en pressant Espace.


                 Liste: Slection/Edition d'lments via la souris
                 

      Cliquer SELECT en combinaison avec la touche Alt vous permet d'diter
      toute partie textuelle des lments modifiables.

      Les oprations de slection et de glissement d'lments avec la souris
      sont une adaptation du fonctionnement du Filer.

      Pour rfrence, dans le Filer vous faites glisser avec SELECT un
      rectangle autour des fichiers  slectionner, ensuite pour inverser la
      slection de certains fichiers sans perdre la slection courante, vous
      cliquez ou faites glisser un rectangle avec ADJUST. Une fois votre
      slection acheve vous pressez SELECT sur l'un des fichiers
      slectionns pour entamer le dplacement de la slection.

      Dans une liste vous faites glisser avec SELECT le pointeur de la souris
      du premier au dernier lment  slectionner, ensuite pour inverser
      l'tat de slection des lments sans perdre la slection courante vous
      cliquez ou faites glisser avec ADJUST. Si pendant le glissement vous
      positionnez le pointeur dans la fentre prs d'un de ses bords le
      contenu de la fentre se mettra  dfiler. Une fois votre slection
      acheve, pressez SELECT sur la slection pour entamer son dplacement.

      La diffrence avec le Filer est que vous ne pouvez cliquer entre les
      lments. Cela signifie que vous ne pouvez slectionner un lment non
      encore slectionn et le dplacer en une seule opration car on ne peut
      la distinguer d'une opration de slection d'un groupe. Vous tes
      oblig de cliquer sur l'lment, relcher le bouton pour marquer la fin
      du processus de slection et presser  nouveau le bouton pour entamer
      le dplacement.


                                 Vue arborescente
                                 

    Une vue arborescente est une prsentation hirarchique qui rassemble les
    donnes par groupes, voire sous-groupes. Chaque groupe peut contenir un
    ou plusieurs lments. Chaque lment est soit une donne simple soit un
    sous-groupe. Les sous-groupes peuvent contenir leurs propres sous-groupes
    et ainsi de suite.

    Dans ces vues plusieurs termes sont rgulirement utiliss:
       Parent: Le groupe qui contient l'lment en question.
       Frres: lments ayant le mme parent que l'lment en question.
       Enfants: Si l'lment est un groupe, les lments contenus dans ce
        groupe. Si l'lment n'est pas un groupe, il ne peut avoir d'enfants.

     Navigation au clavier
     Afficher/Cacher le contenu d'un groupe

    Les mcanismes de slection et d'dition d'lments sont identiques 
    ceux des listes.


                      Vue arborescente: Navigation au clavier
                      

      Si la vue n'a pas le focus, cliquer dans la vue lui donne le focus et
      positionne le curseur se prsentant sous la forme d'un rectangle
      pointill entourant un lment de la vue. Dans le cas d'un clic avec
      SELECT sur un lment, celui-ci est slectionn en lieu et place de
      toute slection prexistante, dans les autres cas le curseur se
      repositionne simplement  sa dernire position connue.

      Utiliser les flches Haut/Bas (en combinaison possible avec Shift ou
      Ctrl) ou encore Page Up/Down vous permet de naviguer dans la vue comme
      dans n'importe quel document. En mode normal vous noterez que lorsque
      le curseur se dplace, la slection courante est  chaque fois
      remplace par l'lment dsign par le curseur tandis qu'en mode
      mouvement, la slection n'est pas affecte. Pressez la touche Insert
      pour basculer entre ces deux modes.

      Les flches Gauche/Droite vous permettent de naviguer parmi des
      lments frres sans passer par leurs enfants.

      Shift+Gauche vous permet de vous dplacer directement vers le parent de
      l'lment courant.

      Shift+Droite vous permet de vous dplacer directement vers le frre
      successeur du parent l'lment courant.


             Vue arborescente: Afficher/cacher le contenu d'un groupe 
             

      La plupart du temps le contenu des groupes n'est pas visible par
      dfaut, il vous faut alors cliquer SELECT sur la petite boite avec un +
      devant le nom du groupe (ou presser Retour) afin d'taler son contenu.
      Le + sera alors remplac par un - et il vous suffira de cliquer SELECT
      sur ce - pour cacher  nouveau le contenu du groupe.

      Vous remarquerez qu'en cliquant SELECT sur le + un seul niveau de
      l'arborescence a t tal, le contenu des sous-groupes restant
      invisible. Afin d'taler en une seule fois toute l'arborescence,
      pressez Ctrl en mme temps que vous cliquez SELECT (ou pressez
      Ctrl+Retour).

      Enfin, sachez que lorsque vous cachez le contenu d'un groupe, l'tat de
      visibilit de toute l'arborescence quelle contient est mmorise. Si
      vous cliquez ds lors non pas SELECT mais ADJUST sur le + (ou pressez
      Shift+Retour) l'arborescence sera raffich telle qu'avant sa fermeture.


                              Problmes et solutions
                              

       Dmarrer DigitalCD 
       Lecteurs CDs
       Lecture de fichiers
       Radios Internet
       Plug-ins de visualisation
       Autres problmes


                           Problmes: Dmarrer DigitalCD
                           

      1)  Comment forcer DigitalCD  se charger lorsque je double-clique sur
          un fichier?

      Par dfaut, DigitalCD ne rpond qu'au type de fichier &155 (FileList).
      Ceci permet d'viter que DigitalCD n'aie la priorit sur les diteurs
      de fichiers sonores.

      Pour modifier ce comportement, rfrez vous aux sections Types de
      fichiers accepts et configuration,  et assurer vous que DigitalCD soit
      vu par le bureau au dmarrage de la machine.

      2)  Comment inclure DigitalCD dans ma squence de dmarrage de la
          machine pour qu'il ne rapporte pas l'erreur "Please locate !DCDRes"?

      Lors du boot de DigitalCD, le fichier !DCDRes.Setup est parcouru afin
      dterminer la liste des types de fichiers qu'il rclamera. (Voir
      ci-dessus). Cela signifie que DigitalCD doit connaitre lors de ce boot
      l'emplacement du dossier !DCDRes. Vous devez soit:

         Inclure !DCDRes avant !DigitalCD dans la liste des applications 
          booter dans votre squence de dmarrage.

         Vous assurer que !DCDRes se trouve l o !DigitalCD est capable de
          le localiser: soit dans le mme rpertoire que !DigitalCD, soit
          dans Boot:Resources.

      3)  DigitalCD bloque le systme ou ne fonctionne pas correctement
          lorsqu'il est dmarr lors de la squence de boot de RISC OS.

      Veuillez vous rfrer  la question 2 de problmes de lecteurs CDs.


                              Problmes: Lecteurs CDs
                              

      1)  Le CD semble tre jou normalement mais je n'entends aucun son.

      Le lecteur CD produit le son lui-mme indpendamment du systme sonore
      de l'ordinateur. Il existe trois manires d'couter le son produit:

         Si le lecteur le permet (lecteurs USB et autre lecteurs rcents),
          lire les donnes audio du CD et les jouer sur le systme sonore de
          la machine. Cessez de jouer le CD et ouvrez la fentre Prfrences,
          section Pilotes/CDFS. Slectionnez le numro de votre lecteur,
          choisir le mode 'utiliser CD_ReadAudio', validez en cliquant sur
          Sauver ou Appliquer et redmarrez la lecture du CD.
         Brancher vos couteurs ou vos enceintes dans le jack stro 3.5mm
          dans le panneau avant du lecteur CD.
         Utiliser un cble pour connecter la prise I2S  l'arrire du
          lecteur CD vers une carte de mixage. La fonction de la carte de
          mixage est de mixer les sons produits par le systme sonore avec
          une ou plusieurs autres sources sonores et d'envoyer le son
          rsultant vers le jack stro 3.5mm  l'arrire de l'ordinateur.
          Pour ceux qui ont remplac le systme sonore 8-bit prsent dans les
          plus anciennes cartes mres RISC PC avec une carte Mozart, je peux
          confirmer la prsence d'un tel mixeur sur la carte. Pour les autres
          je recommande de vous renseigner auprs de votre revendeur local.

      2)  DigitalCD bloque le systme ou ne fonctionne pas correctement
          lorsqu'il est dmarr lors de la squence de boot de RISC OS.

      Je n'en connais pas la cause exacte mais tant que le bureau n'est pas
      compltement initialis certains des appels systme pour CD effectus
      par DigitalCD ne fonctionnent pas correctement pour certaines machines.
      Pour certaines, ils bloquent le systme, pour d'autres ils considrent
      que le lecteur est vide mme lorsqu'un CD se trouve dans le lecteur.

      On m'a signal que le problme de lecteurs indiqu comme vide ne se
      produit jamais si l'on s'assure qu'aucun CD n'est prsent dans le
      lecteur pendant le Boot.

      3)  Le lecteur CD passe systmatiquement la premire piste ou encore
          passe des pistes lorsque l'on utilise les boutons Avancer/Reculer.

      Cessez de jouer le CD et ouvrez la fentre Prfrences, section
      Pilotes/CDFS. Slectionnez le numro de votre lecteur, inversez le
      statut de l'option 'Pilote CD avec bogue des 150 trames', validez en
      cliquant sur Sauver ou Appliquer et redmarrez la lecture du CD. Ce
      bogue est prsent sur presque tous les lecteurs SCSI ainsi que sur les
      lecteurs IDE contrls par d'anciennes versions du module CDFSSoftAtapi.

      4)  Le lecteur CD passe toutes les pistes ou ne fonctionne pas du tout.

      Cessez de jouer le CD et ouvrez la fentre Prfrences, section
      Pilotes/CDFS. Slectionnez le numro de votre lecteur, slectionnez
      l'option 'jouer avec SWI CD_PlayTrack', validez en cliquant sur Sauver
      ou Appliquer et redmarrez la lecture du CD. Il semble que cette
      mthode soit accepte par plus de lecteurs que le SWI CD_PlayAudio,
      toutefois elle prsente le dsavantage de ne pas permettre de changer
      la position au sein d'une piste.

      Si cette mthode ne fonctionne pas, et bien, je n'ai aucune solution.
      J'ai bien peur que d'une part CDFS et ses modules CDFSSoftxxx associs
      ne sont pas d'une qualit extraordinaire, et que d'autre part nombre de
      lecteurs ne sont totalement conformes aux standards ce qui peut donner
      d'tranges problmes tels par exemple CDFS signalant que le lecteur ne
      joue pas alors qu'il est actuellement en train de jouer une piste audio.

      Dans le but d'obtenir un peu plus d'informations, j'ai introduit un
      systme de journal qui enregistre les appels CDFS faits par DigitalCD
      dans un fichier Log qui apparatra dans le mme rpertoire que
      !DigitalCD. Pour gnrer un tel journal, modifiez dans !DigitalCD.!Run
      la ligne:

      Set DigitalCD$Logging 0

      en

      Set DigitalCD$Logging 1

      Vous pouvez alors redmarrer !DigitalCD, essayer de jouer un CD et
      m'envoyer le fichier Log gnr (ou le consulter par vous-mme si vous
      en connaissez suffisamment sur les SWIs de CDFS).

      5)  Je ne suis pas capable de sauver les informations du CD que j'ai
          entres  l'instant.

      La cause la plus probable est que le fichier !DCDRes.CDs est protg en
      criture. Il est possible que vous utilisez !DigitalCD et !DCDRes (voir
      Gestion des resources) depuis une archive protge en criture, voire
      un systme de fichiers ou un mdia utilisables en lecture seule (par
      exemple un CD). Notez que !SparkFS 1.33 ou plus ancien connait des
      problmes lorsqu'il essaye d'crire dans une archive protge en
      criture.


                                Problmes: Fichiers
                                

      1)  DigitalCD n'est pas dmarr lorsque je double-clique sur un fichier
          musical.

      Par dfaut, DigitalCD ne rpond qu'au type de fichier &155 (FileList).
      Ceci permet d'viter que DigitalCD n'aie la priorit sur les diteurs
      de fichiers sonores.

      Pour modifier ce comportement, rfrez vous aux sections Types de
      fichiers accepts et configuration,  et assurer vous que DigitalCD soit
      vu par le bureau au dmarrage de la machine.

      2)  DigitalCD ignore le fichier lorsque je le dpose sur une de ses
          listes.

      DigitalCD ne reprend que les fichiers dont le type RISC OS est repris
      dans un de ses fichiers de configuration. La raison en est simple,
      nombre de formats de fichiers musicaux supports par DigitalCD ne
      prsentent pas d'enttes permettant de les identifier clairement,
      l'utilisation du bon type de fichier est le seul moyen de slectionner
      bon pilote pour le dcodage du fichier.

      Si vous utilisez en exclusivit un certain type RISC OS pour un type de
      fichiers qu'un des pilotes de DigitalCD est capable de lire, rfrez
      vous  la page Types de fichiers accepts, configuration pour le
      rajouter  la liste.

      3)  Lorsque je joue des fichiers DigitalCD semble les jouer mais je
          n'entends aucun son ou celui-ci est trs faible.

      En temps normal un volume de 100% dans DigitalCD correspond au volume
      sonore systme (valeur configure via la barre de volume la section Son
      de votre configuration systme ou modifie via la commande CLI
      *volume). Corriger le volume sonore systme si celui-ci est trop faible
      ou activez l'option 'Ignorer le volume systme' dans la section
      Lecteurs de la fentre Prfrences.


                            Problmes: Accs  Internet
                            

      1)   Aucune entre n'est insre dans la liste de DigitalCD lorsque je
          fais glisser des listes de radios Internet (fichiers .m3u ou .pls)
          depuis mon navigateur Internet vers DigitalCD.

      En premier lieu vrifier que vous avez fait glisser les donnes vers la
      bonne liste de DigitalCD, des listes telles que la file de fichiers ou
      les listes-rpertoires n'acceptent pas les radios Internet.

      S'il s'avre toujours qu'aucune entre ne soit insre, veuillez  la
      place sauver ces listes de radios sur votre disque dur, puis:
         vrifiez que les fichiers .m3u ont un type de fichier AA7 et les
          fichiers .pls AA8. Si ce n'est pas le cas, ajustez leur type de
          fichier puis dposez  nouveau ces fichiers sur l'une des listes de
          DigitalCD.
         si le type de fichier est correct, vrifiez que le contenu du
          fichier lui-mme est correct. Les fichiers .m3u contiennent un
          simple url, tandis que les fichiers .pls contiennent une premire
          ligne "[playlist]" suivie d'au moins une ligne sous la forme
          "File<nr>=<url>".

      2)   DigitalCD n'arrive pas  tablir la connexion vers la radio
          Internet.

      Avant de pouvoir couter des radios Internet certaines oprations de
      configuration de votre machine et de DigitalCD sont indispensables.
      Elles sont dcrites ici; vrifier que vous les avez bien suivies.

      Si vous avez toujours le problme affichez les proprits de la radio
      (slectionner la radio dans la liste, ouvrez le menu de la liste et
      choisissez Proprits dans le sous-menu Radios Internet). Recopier
      l'URL de la radio dans votre navigateur Internet et essayez de vous
      connecter. Si vous y parvenez (si le navigateur vous propose de sauver
      ou d'ouvrir ce qu'il considre comme un fichier) comparez les
      prfrences de votre navigateur et de DigitalCD. Dans le cas contraire,
      la radio n'est simplement pas accessible.

      3)   La connexion vers la radio Internet est tablie, le modem indique
          que DigitalCD charge des donnes mais DigitalCD ne joue aucun son,
          le chrono ne bouge pas.

      J'ai remarqu que certaines radios, telles que France Inter,
      lorsqu'elles sont fermes continuent d'mettre des flots Ogg Vorbis
      constitus uniquement d'enttes Ogg rpts indfiniment. Cela signifie
      que DigitalCD perdra sont temps  charger des MB de donnes alors qu'il
      n'y a aucun son  dcoder (le chrono de DigitalCD restera  zro
      indfiniment).

      4)  Les performances Internet se dgradent lorsque je joue des fichiers
          MPEG Audio ou Ogg Vorbis (via DiskSample).

      Cette dgradation est cause par le temps pass par DiskSample dans les
      interruptions de remplissage des tampons SoundDMA, ce qui bloque le
      traitement des autres interruptions (port srie, rseau, ...) pendant
      ce temps. Cette dure de blocage peut devenir importante si trop de
      canaux sont mixs ou si l'galiseur est actif. Plusieurs solutions sont
      possibles:

         Ne pas utiliser l'galiseur pendant vos accs Internet afin de
          rduire drastiquement le temps pass  remplir les tampons SoundDMA.

         Ouvrir la fentre Prfrences, section Pilotes/DiskSample, et
          activer l'option Autorisez interruptions. Lorsque cette option est
          active, vous autorisez le traitement des autres interruptions
          pendant le remplissage des tampons SoundDMA, ce qui rsout votre
          problme mais peut avoir comme consquence d'empcher le
          remplissage  temps des tampons et causer des coupures dans le son
          (par exemple en cas d'accs disques).

      5)  Les performances Internet se dgradent lorsque je joue des fichiers
          trackers (MOD, S3M, etc).

      Cette dgradation, tout comme ci-dessus, est cause par le temps pass
      par TimPlayer dans les interruptions de remplissage des tampons
      SoundDMA, ce qui bloque le traitement des autres interruptions (port
      srie, rseau, ...) pendant ce temps.  Cette dure de blocage peut
      devenir importante si trop de canaux sont mixs ou si l'galiseur est
      actif. Comme TimPlayer mixe souvent bien plus de canaux que DiskSample,
      cette dgradation peut tre plus pousse. Plusieurs solutions sont
      possibles:

         Ne pas utiliser l'galiseur pendant vos accs Internet afin de
          rduire drastiquement le temps pass dans  remplir les tampons
          SoundDMA.

         Ouvrir la fentre Prfrences, section Pilotes/TimPlayer, et
          activer l'option Autorisez interruptions. Lorsque cette option est
          active, vous autorisez le traitement des autres interruptions
          pendant le remplissage des tampons SoundDMA, ce qui rsout votre
          problme mais peut avoir comme consquence d'empcher le
          remplissage  temps des tampons et causer des coupures dans le son
          (par exemple en cas d'accs disques).

          Faites galement attention au fait que TimPlayer surveille le temps
          utilis pour mixer les notes joues dans les tampons et peut
          dcider de limiter le nombre de notes joues simultanment
          (polyphonie) si il ne peut le faire en temps rel, ceci afin que
          votre machine continue de vous rpondre (certains fichiers  64
          canaux peuvent facilement ncessiter plus de 100% de CPU mme pour
          des processeurs StrongARM). Si vous autorisez les interruptions, le
          temps pass dans toute interruption traite pendant le mixage sera
          comptabilis par TimPlayer et pourra ds lors causer une rduction
          drastique de la polyphonie. Dans un tel cas, pauser la piste puis
          continuer permet de restaurer la polyphonie  sa valeur par dfaut.


                        Problmes: Plug-ins de visualisation
                        

      1)  Le lecteur joue une piste mais l'entre Dmarrer plug-in reste
          grise dans le menu.

      Le lecteur ne vous autorise pas  dmarrer de visualisation sonore si
      il ne lui est pas possible de capturer les sons produits par cette
      piste. Avant de tenter toute visualisation, vous devez ouvrir la
      fentre Prfrences, section chantillonneurs et associer les
      chantillonneurs appropris  chaque type de piste jouable. Notez que
      la plupart des machines utilisant RISC OS ne disposent d'aucun moyen de
      capturer les sons mis par les lecteurs CD.

      2)  Lorsque je dmarre un plug-in il me rapporte l'erreur "Mode d'cran
          non valide".

      Comme l'erreur le signale, le plug-in tente d'utiliser un mode d'cran
      qui n'est pas disponible sur votre machine. Ouvrez la fentre
      Prfrences, section Plug-ins et cliquez sur le bouton Info situ sous
      le nom du plug-in plein-cran. Aprs lecture de la documentation du
      plug-in, soit:

         Le plug-in peut tre configur pour utiliser un autre mode d'cran.

          Donc, dans la fentre des prfrences, cliquez sur le bouton Config
          situ sous le nom du plug-in plein-cran et suivez la documentation
          du plug-in pour slectionner le mode d'cran appropri.

         Le plug-in utilise un mode d'cran non prsent dans fichier de
          dfinition du moniteur (MDF) utilis par RISC OS pour contrler
          votre moniteur.

          Vous devez diter ce MDF avec l'outil appropri et dfinir ce mode
          d'cran dans le MDF. Si vous ne parvenez pas  trouver les
          paramtres corrects pour ce mode d'cran, ce qui vous arrivera
          certainement pour de faibles rsolutions car les moniteurs LCD ne
          supportent pas de rsolution infrieure  640 x 480, il vous reste
          la technique des bordures.

          Les bordures sont juste des lignes et pixels, habituellement en
          noir, insres par RISC OS autour de la zone d'affichage afin que
          le moniteur utilise une rsolution 'zone d'affichage + bordures',
          tandis que les applications fonctionnent avec une rsolution 'zone
          d'affichage'. Donc, il vous suffit de recopier une dfinition
          d'cran plus large et de transfrer les pixels de trop vers les
          bordures tout en maintenant inchange la rsolution vue par le
          moniteur. L'inconvnient de cette mthode est que l'image ne couvre
          qu'une partie de la surface totale du moniteur mais c'est toujours
          mieux que pas d'image du tout.

      3)  Le plug-in dmarre mais l'affichage ne s'anime pas.

      DigitalCD tente certainement de capturer les sons avec le mauvais
      chantillonneur. Ouvrez la fentre Prfrences, section
      chantillonneurs et associer les chantillonneurs appropris  chaque
      type de piste jouable. Notez que la plupart des machines utilisant RISC
      OS ne disposent d'aucun moyen de capturer les sons mis par les
      lecteurs CD.


                            Problmes: Problmes divers
                            

      1)  Lorsque je dmarre DigitalCD le message d'erreur "Le
          fichier/rpertoire '<MP3$Dir>' n'existe pas ou son accs est
          refus" s'affiche.

      Ceci se produit si votre liste principale contient une liste-rpertoire
      pointant vers le nom rpertoire par dfaut '<MP3$Dir>'. Lorsque
      DigitalCD dmarre il tente de dterminer le contenu des rpertoires
      associ  cette liste et rapporte l'erreur ci-dessus si ce rpertoire
      n'existe pas. Supprimez cette liste-rpertoire ou si vous l'utilisez de
      temps  autre, ditez ces proprits afin que la liste ne soit pas
      charge au dmarrage.

      2)  Cliquer MENU sur une liste ne fait pas apparatre de menu et aprs
          plusieurs tentatives DigitalCD se plante.

      J'ai identifi le problme et il se produit si DigitalCD reste en
      attente d'une rponse  un message demandant des informations sur le
      contenu du presse-papier (afin de pouvoir dterminer le statut de
      l'entre 'Coller' du menu). Ceci se produit si le programme
      actuellement en possession du presse-papier renvoie la rponse
      incorrectement vers un autre programme, auquel cas DigitalCD boucle car
      il ne reoit ni de rponse, ni d'accus de rception de la part du
      systme lui signalant l'absence de rponse. Localisez l'application
      dtenant le presse-papier et tachez d'obtenir une version corrige.

      3)  DigitalCD interrompt parfois sans raison apparente l'coute de la
          piste courante et se met  jouer la piste suivante.

      Plusieurs raisons sont possibles:

       +  Vous venez d'utiliser Ctrl+Gauche, Ctrl+Droite ou un autre
          raccourci clavier pendant que le panneau de contrle  encore le
          focus. Si vous trouvez ces raccourcis irritants, vous pouvez les
          dsactiver en dslectionnant 'Autoriser Raccourcis' dans la
          section 'Divers' du menu du panneau de contrle.

       +  Le fichier (de type Tracker) jou contient un marqueur de fin de
          squence ou un saut en arrire dans la squence des patterns et le
          fichier est alors considr comme compos de plusieurs sections.
          Les patterns qui suivent dans la squence forment soit des essais
          carts dans la version finale, soit d'autres pistes indpendantes
          (probablement pour un jeu tel que Lemmings par exemple).

          Si vous dsirez couter ces sections, placez-vous en mode 'piste en
          boucle' et pendant que vous jouez utilisez les boutons
          Reculer/Avancer pour vous dplacer vers cette partie de la piste.


                                    Appendices
                                    

    Adresse, site Internet et mailing liste
    Applications externes requises
    Mises  jour d'une ancienne version
    Mises  jour du fichier Mimemap
    Format des fichiers de type FileList (&155)
    Extracteurs de mtadonnes
    Gestion des ressources
    Licence
    Crdits
    Historique


                      Adresse, site Internet et mailing liste
                      

              DigitalCD est maintenu par Andr Timmermans

                                         fa044826@skynet.be

               Le redirecteur vers le site Internet de DigitalCD est

                            http://www.riscos-digitalcd.net/

                            et pointe actuellement vers

                        http://users.skynet.be/Andre.Timmermans/

        Afin de souscrire  la mailing liste de DigitalCD, envoyez un email
                             avec un petit mot sympa 

                          DigitalCD-subscribe@yahoogroups.com

      La souscription est soumise  mon approbation (afin d'viter les spams)
      et je n'ai pas souvent le temps de vrifier mon courrier aussi ne soyez
      pas surpris si cela prend plusieurs jours avant votre admission dans la
                                       liste.


                          Applications externes utilises
                          

         Play It de Rick Hudson version 1.67 ou suprieure devrait tre
          install sur vtre systme afin que DigitalCD puisse jouer des
          fichiers WAV ou d'autres fichiers d'chantillons.

         DigitalCD peut communiquer avec l'application AcornCD de John
          Beranek, version 0.19 ou suprieure, pourvu que vous configurez la
          section AcornCD dans la fentre Prfrences correctement. CDDB est
          un acronyme pour  CD DataBase: il s'agit d'un moyen de tlcharger
          les informations sur un CD depuis internet afin d'viter de taper
          la description de chacun de vos CDs. AcornCD va lire les
          caractristiques du CD dans votre lecteur et contacter un des
          serveurs CDDB sur le net afin de rcuprer sa description (nom de
          l'album et le titre des pistes). La page d'accueil d'AcornCD est
          http://acorncd.sourceforge.net/.


                         Mise  jour d'une ancienne version
                         

      Mise  jour des versions 2.44 et suprieures

      Lorsqu'une nouvelle version de DigitalCD est dmarre pour la premire
      fois elle efface automatiquement de !DCDRes les anciennes versions de
      ses skins et plug-ins de base et les remplace par de nouvelles
      versions, les autres ressources ne sont jamais modifies.

      Les fichiers !DCDRes.Setup et !DCDRes.Clues ne sont donc pas modifis
      afin d'viter de remplacer vos propres prfrences. Il serait cependant
      sage de vrifier si les versions par dfaut contenues dans
      !DigitalCD.Copy ne contiennent pas de mises  jour dans les types de
      fichiers ou les sprites proposs et de transposer ces changements dans
      vos propres versions.

      
      Mise  jour des versions 2.41  2.43

      DigitalCD stocke maintenant les skins, plug-ins et autre ressources
      dans le rpertoire !DCDRes afin de faciliter les mises  jours.

      Afin de rcuprer vos anciennes ressources, veuillez dplacer les
      fichiers et rpertoires suivant depuis votre ancienne version de
      !DigitalCD vers !DCDRes:

              le fichier CDs (base de donnes CD)
              le fichier Setup (associations entre type de fichiers et
               dcodeurs)
              le rpertoire Skins
              le rpertoire Plugins

      
      Mise  jour des versions antrieures  2.41

      DigitalCD stocke maintenant les skins, plug-ins et autre ressources
      dans le rpertoire !DCDRes afin de faciliter les mises  jours.

      Afin de rcuprer vos anciennes ressources, veuillez dplacer les
      fichiers et rpertoires suivant depuis votre ancienne version de
      !DigitalCD vers !DCDRes:

              le fichier CDs (base de donnes CD)
              le fichier Setup (associations entre type de fichiers et
               dcodeurs)
              le rpertoire Skins

      Dplacer vos plug-ins depuis l'ancien rpertoire !DigitalCD.PlugIns
      vers !DCDRes.PlugIns.FullScreen  l'exception de PowerBars pour lequel
      DigitalCD copiera une nouvelle version dans !DCDRes.PlugIns.Desktop.


                           Mise  jour du fichier MimeMap
                           

      Le fichier MimeMap dfinit les relations entre des types de contenu
      mime (Internet), des types de fichiers RISC OS ou Mac OS et des
      extensions de fichiers PC/Unix. Cliquez ici pour ouvrir le fichier dans
      votre diteur de texte favori.

      Les relations contenues dans ce fichier sont utilises dans plusieurs
      cas:
         chargement de fichiers depuis du matriel non-RISC OS tels que
          disques formats PC ou rseaux PC/Unix/Mac OS.
         chargement de fichiers depuis Internet (navigateur, FTP, ...).
         connexion  des radios Internet.

      Il est  noter que les anciennes versions des systmes de fichiers tels
      que CDFS, DOSFS, Win95FS, LanManFS, LanMan98FS, Samba voire SparkFS
      n'utilisent pas l'interface MimeMap mais bien leurs propres mcanismes
      de gestion de types de fichiers (*DOSMAP, !CDFix, ...). Veuillez vous
      rfrer aux manuels de ces applications pour de plus amples
      informations.

      Afin de vous assurer que DigitalCD et ses modules associs effectuent
      toutes ces actions correctement, vous devez intgrer les relations du
      fichier de rfrence dans votre fichier MimeMap.

      En effectuant cette action veuillez tenir compte des points suivants:
         Vrifiez non seulement si la relation existe dj mais aussi
          qu'elle est correcte. Par exemple les types de contenu mime
          "audio/mpeg" et "audio/x-mpeg" pointent souvent incorrectement vers
          MPEG bf8 qui est du MPEG vido.
         De mme, sur les versions de systme pr-Select, le processus de
          translation MimeMap s'arrte ds la premire correspondance trouve
          aussi veillez  insrer les relations dans le fichier devant les
          relations avec wildcard telles que "audio/*".
         Certaines versions de RISC OS peuvent ne pas supporter tous les
          attributs lists, en particulier:
          1)   Les types de fichiers Mac OS (inclus entre "") peuvent devoir
               tre retirs.
          2)   Les lignes utilisant "-" en guise de type de contenu mime
               dfinissent des relations pour lesquelles aucun type de
               contenu mime n'existe. Si celles-ci ne sont pas acceptes
               remplacez le "-" par un faux type de contenu mime tel que
               "audio/x-pctk".

      Une fois les modifications sauves, rebootez ou utilisez la commande
      CLI ReadMimeMap afin que le systme relise la nouvelle version du
      fichier (cette commande semble toutefois ne fonctionner correctement
      que sous Select). Enfin, vrifiez  l'aide de commandes CLI "MimeMap
      <mimetype>" que vos modifications ont t prises en compte correctement.

      Si DigitalCD rapporte une erreur similaire  "Type de fichier (<type de
      fichier>, <type mime>) ou sous-format non support", il est probable
      que le type de contenu ne soit pas list dans votre fichier MimeMap et
      que RISC OS drive son type de fichier d'une entre avec wildcard telle
      que "audio/*". Si il s'avre que le type de contenu mime correspond 
      un type de fichier RISC OS support par DigitalCD mais non repris dans
      la liste des relations, ajoutez-la  votre fichier MimeMap et n'hsitez
      pas  me contacter afin que je puisse mettre  jour le fichier de
      rfrence de DigitalCD.


                    Format des fichiers de type FileList (&155)
                    

      Le format de ces fichiers est purement textuel et peut tre dit  la
      main si ncessaire (par exemple si vous dplacez les fichiers vers un
      autre disque).

      Afin de compacter les fichiers au maximum des mcanismes de chemin
      courant et de prfixe sont employs dans l'algorithme suivant pour lire
      le fichier:

      chemin = ""
      prefixe = ""
      tant que d'autres lignes  lire
      \
        lire la ligne
        la ligne se dcompose en <nom> ou <nom>*<options>
        si le nom se termine par un point (le nom est un chemin)
        \
          si le nom commence par un point
            chemin = prefixe + nom
          sinon
            chemin = nom
        }
        sinon si premire ligne (le nom dfinit un prfixe)
        \
          prefixe = nom
          chemin = nom + "."
        }
        sinon (le nom dfinit un fichier/URL)
        \
          nom de fichier/URL = chemin + nom
          ajouter (nom de fichier/URL, options)  la liste
        }
      }

      Les options sont dans le format suivant:

      <nom><valeur>,...,<nom><valeur>

      o tout caractre "\" ou "," dans un nom ou une valeur sont prfixs
      par un "\" pour viter toute confusion.

      Les options actuellement dfinies sont:
          f    drapeaux (stocks au format dcimal)
               bits:     0x001     cette rfrence dj joue (fichiers ou
                                   radios)
                    0x002     cette rfrence n'a pu tre jou (fichiers ou
                              radios)
                    0x004     cette rfrence n'est actuellement pas  jouer
                    0x008     cette rfrence pointe vers une liste
                    0x010     cette rfrence pointe vers une liste-rpertoire
                    0x020     ne pas charger la liste pointe au dmarrage
                    0x040     cette rfrence ne doit jamais tre joue
                              (fichiers)
                    0x080     cette rfrence  t invalide
                    0x100     cette rfrence est un URL (radios)
                    0x200     
                    0x400     cette rfrence fait partie d'une compilation
                              (fichiers)
          a    nom de l'artiste (fichiers)/de la station de radio (radios)
          b    nom de l'album (fichiers)
          c    commentaire
          d    numro de section  jouer (fichiers)
          e    nom du collectif auquel l'artiste appartient (fichiers)
          g    nom du set auquel l'album appartient (fichiers)
          m    type mime (radios)
          o    numro d'ordre dans un album (fichiers)
          p    points, stocks au format dcimal (fichiers ou radios)
          r    dbit en kbps (radios)
          s    nom du tag visuel (fichiers ou radios)
          t    titre (fichiers)/nom de radio (radios)
          v    volume relatif en % (fichiers ou radios)
          y    date de sortie de l'album au format AAAA or AAAA-MM or
               AAAA-MM-JJ
          z    nom du scanneur de mtadonnes  utiliser (listes ou
               listes-rpertoires)

      Exemple:

      ADFS::HardDisc4.$.MultiMedia.Sound.Symphony.Songs
      .A.
      Anette*v250,f1
      ANewJack*tA new Jack,f1
      .B.
      Beams*tBeams of Light


                               Gestion des ressources
                               

      Toutes les ressources indpendantes de la version de DigitalCD sont
      stockes dans un rpertoire distinct de l'application principale et
      appel !DCDRes. Lors de la premire installation de DigitalCD, extrayez
      !DCDRes de l'archive, copiez-le vers un endroit appropri puis
      double-cliquer sur cette copie afin de vous assurer que celle-ci soit
      utilise et non la version de l'archive.

      Au dpart ce rpertoire ne contient que les fichiers !Boot, !Help,
      !Run, !Sprites. Lorsque vous excutez DigitalCD pour la toute premire
      fois, il dfinira les objets suivants pour vous:

         Un fichier CDs qui contiendra la description des CDs que vous
          introduirez via la fentre Base de donnes CD.
         Un fichier Setup contenant la liste des types de fichiers lisibles
          par DigitalCD et leur association avec les modules qui doivent les
          jouer. Ce fichier peut tre dit pour reflter vos propres
          besoins, par exemple pour forcer DigitalCD  se lancer
          automatiquement lorsque l'on double-clique sur certains types de
          fichiers.
         le fichier Clues contient de petits sprites pour tagger des
          rfrences dans vos listes. Vous pouvez ajouter vos propres sprites
          dans ce fichier ou remplacer certains dja prsents. Veuillez me
          contacter si vous voulez les partager avec d'autres utilisateurs
          les sprites que vous avez crs.
         le rpertoire Skins ou DigitalCD recopie la skin Default et o vous
          pourrez ajouter d'autres skins.
         le rpertoire Plugins subdivis en Plugins.Desktop et
          Plugins.FullScreen contenant les plug-ins de visualisation de base
          et o vous pourrez ajoutez d'autres plug-ins.

      Les fichiers Setup et Clues sont vos propres copies prives, et les
      futures versions de DigitalCD ne les modifieront jamais. Au contraire,
      les skins et plug-ins de base par contre seront de temps en temps
      remplaces par de nouvelles versions.


                                      Licence
                                      

      1.  Dfinitions

          Le Logiciel signifie l'application DigitalCD et les fichiers
          associs, c'est  dire le contenu des rpertoires !DigitalCD et
          !DCDRes.

          Les Dveloppeurs signifie les dveloppeurs du Logiciel ou leurs
          agents dsigns.

      2.  Garantie

          Le Logiciel est un logiciel gratuit (*). Vous l'utilisez  vos
          risques et prils et celui-ci n'est livr avec aucune garantie.

          [* sous les conditions dcrites ci-dessous.]

      3.  Copyright

          Le Logiciel est Copyright (C) les Dveloppeurs, et est disponible
          gratuitement sous les conditions dcrites ci-dessous.

      4.  Distribution

          Des distributions binaires seront offertes de temps en temps au
          public par les Dveloppeurs. Celles-ci seront nommes 'Official
          Binary Distributions' (OBDs).

          De plus, les Dveloppeurs pourront offrir de temps en temps des
          versions personnalises  des groupes de test. Celles-ci seront
          nommes 'Unofficial Binary Distributions' (UBDs) et ne peuvent en
          aucun cas tre redistribu  d'autres personnes.

          Aucun frais (autres que les cots de production du mdia) ne peut
          tre demand pour une distribution binaire et celle-ci ne peut
          faire l'objet d'aucune modification lors de la distribution.

          La permission de dlivrer des OBDs du Logiciel sur un quelconque
          mdia (disquettes, CDs, site Internet, ordinateurs, ...) est
          automatiquement accorde pour autant que le mdia en question ne
          prsente aucun contenu illgal, xnophobe ou religieux.

          Ceci signifie que quiconque dsirant distribuer le Logiciel (par
          exemple sur un CD dans un  magazine, ou avec leur propre
          Logiciel/hardware gratuit ou commercial) en accord avec ces
          conditions, doit seulement en informer les Dveloppeurs de ses
          intentions et ceci  titre de courtoisie.

          Quiconque dsirant distribuer le Logiciel en opposition avec ces
          conditions doit contacter les Dveloppeurs afin d'obtenir leur
          permission.
                    
          Quiconque ne respectant pas ces rgles de distribution accepte de
          payer 1 million d'Euros (ou une somme plus faible accepte par les
          Dveloppeurs)  un organisme de charit dsign par les
          Dveloppeurs.


                                      Crdits
                                      

      Merci aux auteurs des modules/applications suivantes:

      amp      AMPlayer             1.42    Thomas Olsson
      ds       DSymphonyPlayer      1.46    BASS 1991-1997, Freeware
      qtm      QTM Tracker          1.45    Steve Harrison
      trk      matrixTRK            0.89    Marko Lukat & Michael Pohle
      xpr      XprMod               1.10    Skoe of Expression
      tim      TimPlayer            1.27    Andr Timmermans
      smp      DiskSample           0.55    Andr Timmermans
               + AudioMPEG          0.33    Peter Teichmann
               + Vorbis             0.19    Andr Timmermans
               + AC3                0.06    Andr Timmermans
      playit   PlayIt               1.73    Rick Hudson & Christopher Martin
      mid      MIDIPlay             2.24    Expressive Software Projects,
                                             maintenu par Liquid Silicon

          DCDUtils   0.35    Andr Timmermans
          AcornCD    0.19    John Beranek


                                      History
                                      

      Topic    Info
      
      Version 3.16  2023-12-21
      Player   Shift+Rewind/Fast forward works with files containing
               sections/chapters (or CUE files) played by DiskSample v0.59
               and above.
      Misc     Prefill yellow page's URL with "http://dir.xiph.org/yp.xml"
               since it is the only one I know of.
      
      Version 3.15  2022-09-17
      Misc     Fix for occasional failure to convert yellow page from UTF-8
               to Latin1.
          Ignore yellow page entries with <listen_url> element not starting
          with 'http://' to avoid https or empty element (why are such
          entries allowed?).
      
      Version 3.14  2021-09-11
      Bug Fixes:
      CDs Real fix for "Could not handle CD drive x" errors at startup.
      Choices  Iconbar choice "File queue" was opening "CD database".
      Player   "Stopping after 3 consecutive tracks fails to start" was not
               working for tracks opening in state "not ready" and falling in
               error after a delay (radios, some mp3s).
      Misc     Fix "List index out of bounds" error at startup.
      Misc     Fix for lack of menus and inability to quit after sending
               clipboard release message.
      
      Version 3.13  2020-04-02
      Bug Fixes:
      List     Loading a truncated xiph yellow pages list crashed because the
               incomplete track was deleted but not removed from the list.
          Improve yellow pages server name extraction, add genre into track
          "Info" field.
      Player   Changed behaviour when "Stop playing on error" is not set.
               When a track could not be played DigitalCD already tried 3
               consecutives tracks before stopping (a few failures is ok,
               more and it is probable that the whole playlist cannot be
               played). The problem is that for radios, the track "starts"
               safely while the connection is attempted and fails in the
               background. DigitalCD then just reported the error and stopped
               playing, now instead it will attempt to play the next track.
      CDs Delayed CD player list initialisation till the CD player panel is
          shown to avoid "Could not handle CD drive x" errors when starting
          DigitalCD with a CDDrive configured but no present.
      
      Version 3.12  2019-08-26
      Changes:
      Player   Restore old behaviour of playing next track when deleting
               current track.

      Bug Fixes:
      Player   Deleting the current track from a full screen plug-in (Delete
               key) crashes DigitalCD.
      List     One should not be able to insert tracks in a search results
               list.
          The presence of background jobs (like 'Validate') were stopping the
          distribution of Null events and preventing toolbars to be updated.
          Add the pane flag to generated toolbars to prevent the list from
          being constantly brought to top while dragging the toolbar.
          Copied/exported tracks were missing the original TimPlayer
          compatibility flags.
          Play from the list caused another track than the selected one to be
          played if DigitalCD neede to change the "program mode" to play it.
          Creation of new playlist, new dirlist and new failed since a few
          versions.
      CDs Forgot to pass on the configured DiskSample options when playing a
          CD (CD_ReadAudio mode).
          Player was reporting 'No CD present in drive' when it should report
          'Not an audio CD' when a non-audio CD is present in the drive.
      DCDLib   Window covering screen had auto redraw flag set which could
               lead to a brief flash of a white background before the plug-in
               redraws the screen.
      
      Version 3.11  2018-08-16
      Bug Fixes:
      List     Fix ordering of flat lists due to uninitialized variable.
      Misc     Fix zero pain during caused by search with scope "All
               playlists".
      DCDLib   Addition of PROCApp_SwapBanksNoVSync and PROCApp_WaitVSync to
               allow for non-visual processing between banks swap and VSync.
      CD  Was not setting DiskSample options (like buffer sizes) when
          starting to play in CD_ReadAudio mode.
      
      Version 3.10  2017-06-06
      Changes:
      Errors   When full screen plug-in is active, send error as message to
               be reported by the plug-in instead of using the usual error
               box.

      Bug Fixes:
      DCDLib   Update FNApp_String(ptr%,len%) to cope with NULL ptr%. Fixes
               zero pains in some plug-ins.
      Misc     Fix some zero pains.
      
      Version 3.09  2016-06-09
      Changes:
      CDs You can now delete CD descriptions from the CD Database.

      Bug Fixes:
      Tracks   Metadata extraction was not working properly in 3.08 due to an
               incorrectly fixed ZeroPain report.
      CDs Modifying the display options of a search results window caused the
          window's content to vanish.
      
      Version 3.08  2016-05-08
      Changes:
      List     Allow modification/saving of M3U/PLS files.
          Validate now works in the background.
          Added Alt+Click renaming of items.
          Increased loading speed of large lists like the xiph yellow pages.
      Search   Modified search for unplayed tracks to ignore tracks set never
               to play.
      CDs Rewrote CD Database in playlist form.
          Enabled and set default play mode to CD_ReadAudio as all new
          machines support it.
          Set default driver to SoundDMA for sampler target CD as
          CD_ReadAudio is routed through SoundDMA.
      Icon bar Load M3U/PLS list dropped on the icon bar.
      Misc     F1 in a window will open the corresponding StrongHelp file
               section.
          When user attempts to quit but cancels because of unsaved
          documents, open those unsaved documents.

      Bug Fixes:
      List     Flat and hierarchical view modes now lists files in exactly
               the same order.
          State of buttons and menus was not updated in some circumstances.
          Dropping a list on File Queue should add only file tracks.
          Dropping a list on search results window should not add tracks to
          it.
      Player   Current position in list could sometimes been lost when
               switching between Queue and Main playlist.
          Fixes some incorrect behaviour with moving to next/previous track
          like in short lists with unplayable tracks.
          Fixes some refresh problem and speedup switching of control panel
          to a new player.
          Fixes null pointer access while updating metadata information.
          Control panels other than primaty one where not removed anymore
          when 'single panel mode' option is activated.
      Tracks   Name filter crashed when you attempted to filter by a given
               letter after you just deleted the first name starting with
               that letter from the collection.
      Misc     Do not try to restore caret to save as box when aborting drag
               with Esc (Wimp closes the box before we receive the Esc).
      
      Version 3.07  18 Aug 2014
      Changes:
      Mixing   Mixing can now use the nearest 1x or 2x the track sample rate
               as replay frequency instead of the configured frequency.
      Tracks   Files     Unspecified track and section numbers are now shown
                         as empty instead of "0" to facilitate editing.
               Most TimPlayer options were moved from global Choices settings
               to individual track settings. TimPlayer compatibility flags,
               including the new Ultimate Soudntracker one, are now listed
               there too.
               Extend metadata extraction from filename with "#variable" a
               "." limited version of "%variable".
      Misc     Sliders now make now use of wheel mouse if OS support is
               present.
      Plug-Ins Updated DCDLib to use wheel mouse if OS support is present.
          Now provides to DCDUtils the playing module's name and handle so
          that plug-ins are sure to extract module specific info from the
          correct source.
      Choices  Players   Added option to pre-load the next track to play in
                         order to minimise gaps.
          Mixing    Updated with new frequency options.
               'Ignore system volume' option was moved here.
               Balance and Stereo separation are now in new subsection
               'Stereo'.
          CDFS Reorganised playing mode selection as a popup menu.
          DiskSample     Increased input buffer size limit to match the
                         latest version of the module.

      Bug Fixes:
      Choices  When reading saved settings, sample rates were clipped to the
               reasonable range available from the RPC, i.e [5000, 50000].
               Changed to [5000, 200000] to cope with modern hardware.
      
      Version 3.06  16 Apr 2012
      Changes:
      List     Show "<title> [<section>]" as track title if the track
               specifies a section. This allows to distinguish between tracks
               representing different sections of a same file.

      Bug Fixes:
      List     Tweaked scroll bar handling to take into account the column
               headers.
          Tweaked selection with the mouse to behave better under heavy load.
      
      Version 3.05  05 Mar 2012

      Changes:
      DCDLib   Allow full-screen plug-ins using this library to control the
               player with the mouse (Play/Pause, Rewind/Forward, Prev/Next
               section/track, Relative/Main volume Up/Down).
          Actions are mapped on the SELECT/ADJUST buttons, you just rotate on
          the available pairs of actions by clicking MENU.

      Bug Fixes:
      Player   Remote control of actions handled by a specific player was not
               working.
      
      Version 3.04  30 Dec 2011

      Bug Fixes:
      List     Fix occasional crash when double-clicking.
      CDs Fixes crash while exiting DigitalCD when CD is still playing.
      
      Version 3.03  27 Aug 2011

      Changes:
      Player   Shuffling options are now only shows by pressing MENU on the
               shuffle icon, while clicking SELECT will just toggle on/off
               shuffle.

      Bug Fixes:
      List     Double-clicks failed to work when the item was not selected
               beforehand. This is due to using Wimp_DragBox to start the
               (multiple) selection on the first click: the system doesn't
               see the need to report the double-click afterward.
          Ensure restored size of directory lists is not reset to default
          size while its content is still loading.
      
      Version 3.02  21 Aug 2011

      Changes:
      List     Include album's date in sorting options.
          If a group is selected, all elements within the group are
          considered as part of the selection.
      Player   Added turning shuffle on/off without having to change the
               shuffling options.
          Include album's date in sorting options.
      Tracks   Files:    New property to play all sections of the file
                         instead of a single section.
               New property to enter the album's release date (yyyy, yyyy-mm,
               yyyy-mm-dd).
               Extended metadata extraction from filename to extract album's
               date.

      Bug Fixes:
      List     Position of directory list windows were not saved.
          Playlists could not be moved within main playlist
          (non-hierarchical, unsorted mode).
      Player   Shuffle didn't work with File Queue.
          Don't reset "next track" position to 0 anymore when finishing to
          play the list. After adding extra files to the list, play will then
          restart directly from the new tracks when no shuffling is active.
      XprMod   This module sets the DMA size to 400, so it's best not to mess
               with it or the sound gets weird.
      
      Version 3.01  23 Jan 2010

      Changes:
      Choices  Added 'Ignore system volume' in Players section.

      Bug Fixes:
      Lists    Crash with Array out of bounds after sequence: drag multiple
               tracks from a secondary playlist to the file queue, set cursor
               in File queue to last track, unload secondary list (file queue
               is emptied), double-click on a file with 'Add to queue & Play'
               option active.
      Player   Playing not starting after sequence: empty file queue, drag
               multiple tracks from a secondary playlist to the file queue,
               click on play button.
      
      Version 3.00  03 Dec 2009

      Changes:
      Tracks   Use separate Properties windows for each kind of track.
          Files:    Properties for hierarchical info: Collective -> Artist ->
                    Box -> Album -> Title.
               New compilation (multi-author) album flag: Box -> Album ->
               Collective -> Artist -> Title.
               New track number field.
          Radios:   Properties for hierarchical info: Name -> Rate ->
                    Broadcaster -> MimeType.
          Directory lists/Secondary lists:
               New user configurable system to extract metadata from the
               file's name and path.

      Playlists     New 'File queue' list, a temporary playlist where to drag
                    files from the Filer or from other playlists, emptied on
                    exit of DigitalCD.
          New 'Yellow pages' lists to download lists of Internet Radios from
          the Net.
          A lot of grouping/sorting options.
          New 'Hierarchical' tree view mode.
          New 'Flat' mode with resizable columns.
          Some actions now take place in the background such as the scanning
          of directories or the download of yellow pages.
          New 'Create Internet Radio' dialog to define an Internet Radio
          withou the help of .m3u files.
          Search window:
               New 'All playlists' scope to search in all loaded playlists.
               New 'List' action to list the results in a 'Search results'
               playlist.
               Simplified text searching (filename or metadatas).
          Track shortcut. Used in search results and file queue lists to
          refer to a track in another playlist. Changes to the shortcut
          (edition, metadata provided by player), will in actually change the
          original track.
          The properties of multiple tracks can now be edited in one go.

      Player   New single panel mode.
          The Previous/Next buttons now start playing the previous/next track
          even when the player is stopped.
          Option to use 'Remove Track' command as simple marking of track as
          'Never Play'.
          Internet radios are now handled by a separate 'Internet Radios'
          player.
          'Music file' player:
               Old 'Program' versus 'Single track' system of 'Music file'
               player replaced by 'Program' versus 'File Queue' system.
               Old 'Program off & play' file loading options replaced by 'Add
               to queue' and 'Add to queue & play' options.
               Removed 'Reenable program on Stop' option.
               A lot of grouping/sorting options.

      Mixing   New option to choose DMA sound buffer size setting for
               compatibility with other applications.

      DCDLib   New functions to change screen modes, manage screen banks
               (RISC OS 6 compliant) and manage messages/title changes sent
               by the player.
          Documentation for the library added to !DigitalCD.DCDGuide manual.

      Plug-ins Documentation for DigitalCD_Misc message added to
               !DigitalCD.DCDGuide manual.
          New messages to ask full-screen plug-ins to display a message on
          the behalf of DigitalCD or change the song's title (well more a
          rotation of title, album, artist, ...).

      Drivers  Didn't catch DiskSample's clearing of metadata.
          Retrieve more metadata (track number, ...) from some drivers.

      Misc     Added smpext loader to pass the filename's extension to
               DiskSample in order to identify the type of a raw stream.
          Convert spaces to hardspaces in all filename icons.

      Bug Fixes:
      Lists    Do not validate URLs as files.
      Misc     Take into account (when possible) changes in system volume and
               ensure that plug-in volume scaling is correct.
      Drivers  Ensure PlayIt Config bit 2 is always off because it makes a
               mess otherwise and take system volume into account.
      Lists    Properties window did not allow filename to be changed to
               another playlist.
      
                                   Older history


                                      History
                                      

                                More recent history
      Topic    Info
      
      Version 2.56  28 Sep 2003

      Changes:
      Internet Added configuration of minimal buffering to do before start to
               play sound.

      Bug Fixes:
      CDs Internal API changes introduced a bug triggered by data CDs.
      
      Version 2.55  22 Sep 2003

      Changes:
      Drivers  Support HTTP streaming through DiskSample, with a redesign of
               APIs for metadata, position and status handling.
      Player   Rewrite display of metadata and timing.
      Playlists     Saving of URLs, loading of .m3u and .pls playlists.

      Bug Fixes:
      PlayList Fixed lists refresh when changing "Use file name as track
               title" option. 
      Drivers  Fixed Midi rewind/forward.
      PlayLists     Stop the currently played file before trying to remove it
                    from the list or before deleting the file.
      
      Version 2.54  21 Mar 2003

      Changes:
      Players  Timing now reflects the target position while dragging the
               position button.
          Added 2 new time modes: duration and total duration.
          Timing info is now refreshed in case of track duration updates.
      Playlists     Added Play button. Play while a sublist is selected will
                    play first allowed reference in sublist.
          Support of directory lists, directory based list which will be
          scanned when loaded to form a new temporary playlist.
          Lists can now have a base dir used as base for the names of files
          in the list. The list takes up less memory and makes it easier to
          manage when moving files around your disc.
          Load/Unload lists from memory at will.
          Filename field of unloaded lists can be edited in property window,
          a file may be dropped on the field.
          Validate now simply marks the problematic references with a
          question mark.
      Setup    New official filetype allocations for Ogg Vorbis,
               ImpulseTracker, FastTracker2, ScreamTracker3 and other PC
               trackers in default Setup file.
      Tracks   Filename field can be edited in property window, file can be
               dropped on the field.
      Choices  Players:  Added Reshuffle option to reshuffle once all tracks
                         have been played so that tracks of CDs or short
                         playlists are not always played in the same order.
          Drivers:  new AMPlayer section for the anti-shock buffer size.
      Plug-Ins Several desktop plug-ins can be activated at once.
      Drivers  Use AMPlayer intances.

      Bug Fixes:
      Players  Full size docking info was saved for mini-bar.
      Playlists     Search Window: fixed inversion of Playable/Not playable
                    scope.
          Fixed several errors in RAM transfer of lists (used by Dragging,
          copy/paste, etc).
      Plug-ins Don't autostart plug-ins for closed control panels.
      Drivers  PlayIt Config bit 2 when set does the inverse of what I
               expected in term of volume rescaling. 
          Incorrect reserved string size could freeze the machine.
      
      Version 2.53  26 Nov 2001

      Changes:
      Playlists     Search Window: added a few search scopes, control panel
                    list of files to play was never updated for some actions.
      Drivers  Included latest version of several modules.

      Bug Fixes:
      Misc     Fixed launch of DigitalCD by double-click on a file.
      
      Version 2.52  18 Jul 2001

      Bug Fixes:
      Playlists     Fixed loading of multiple sublists from the same
                    directory.
      
      Version 2.51  15 Jul 2001

      Bug Fixes:
      Playlists     Fix saving of main playlist when none exists.
      
      Version 2.50  07 Jul 2001

      Changes:
      Playlists     Extended search window.
          Playlists window is replaced by a Main Playlist. The control panel
          now lists all ticked files from every ticked playlist.
      Tracks   Support for track sections (subsongs).
      CDs Added option to start new CDs as soon as they are inserted in the
          drive.
          CD options are now on a drive by drive basis and there is a new
          option to use SWI CD_PlayTrack for drives who dislike SWI
          CD_PlayAudio.
      Icon bar Allow more windows to be opened from the icon bar (see Icon
               bar section in Choices window).

      Bug Fixes:
      Playlists     Fixed Copy/Paste in playlist from references with visual
                    clue icon.
      Drivers  A few bug fixes in the AMPlayer support.
          Some buggy CD drivers write 12 bytes of info for CD_GetAudioParams,
          causing a stack corruption within DigitalCD.
          Fixed volume 0 exception when converting from linear to log volume
          for PlayIt.
      
      Version 2.49  01 Nov 2000

      Changes:
      Playlists     The filelist window and menu redesign is complete. Lots
                    of extras: a toolbar, markers, a search window.
      Drivers  Allows overal volume * track amplification to exceed 100% for
               modules which support it.
          MP3 drivers will reject files with RIFF headers other than WAVE
          type 0x55 so that if you map filetype &FB1 to "smp,playit" or
          "amp,playit", MP3s stored as WAVE will be corrrectly played as MP3
          while the other waves will continue to be played by PlayIt. Beware
          that some other non-WAVE files may use this filetype and may then
          be played as MP3, so if you can, alter the filetype of MP3s stored
          as WAVE to &1AD instead of using this solution.
      Choices  DiskSample buffer sizes can be configured.
      
      Version 2.48  17 Sep 2000

      Changes:
      Players  Now displays temporary messages on certain actions.
      Drivers  Uses the latest versions of some modules (TimPlayer,
               AudioMPEG, etc).
      Skins    Skin selection menu now comes with submenus to reflect the
               skin directory tree. Skins may also provide a help file (!Help
               or !ReadMe).
      Plug-ins Oscillo plug-in now make use of the new FFT code in DCDUtils
               (click adjust on Oscillo window).
      Setup    In !DCDRes.Setup, adding '!' to the front of a filetype will
               cause DigitalCD to auto-play files of that type when they are
               double-clicked. DigitalCD must have been booted for this to
               work.

      Bug Fixes:
      Drivers  Fixed initialisation of 'Interpret unknown as' in PlayIt
               section of choices.
      Plug-ins Fixed the problem of plug-ins directories prefixed with "!".
               !Spectrum therefore doesn't need to be renamed to Spectrum
               anymore.
      
      Version 2.47  03 Apr 2000

      Changes:
      Playlists     Changes for updated clipboard protocol.
          Added 'External Source' playlist.
      Tracks   File properties now allows to edit the title/author of the
               track played. Changes to track title/author/scale volume don't
               mark the playlist as modified but the changes are
               automatically saved in the playlist file on exit of DigitalCD.

      Bug Fixes:
      Choices  Bug fix for 8-bit hardware users in Output->Mixing section:
               the frequency menu will now appear.
      
      Version 2.46  31 Jan 2000

      Changes:
      Samplers SoundDriver support code is working.
      Skins    Rebuilding the list of skins before displaying it becomes
               slow, so it will only be done from now on if you click on the
               popup icon with the right mouse button.

      Bug Fixes:
      Drivers  Correction for AmpDriver in loop on track mode, on track
               restart I didn't wait till AmpDriver is ready (track may
               remain paused).
      Choices  Choices window didn't provide access anymore to full screen
               plug-in info and setup icons.
      Samplers Default sampler drivers for File and Midi changed from None to
               SoundDMA.
      
      Version 2.45  24 Jan 2000

      Changes:
      Drivers  Support for AMPlayer.
      Skins    Skins may have subdirectories for different packs
      Choices  New sections layout for Choices window, for future extras.

      Bug Fixes:
      CDs Modified "WhichDisc" equivalent code to avoid calling the SWI
          CD_ReadData on audio only discs as it hangs the machine for CD
          drives connected to APDL's Blitz interface instead of returning an
          error.
          Slight bug in CD code (which track by track option off) which can
          prevent track one to be played.
          Moving preference list window while not on top of window stack
          could make one of the lists disappear.
      Misc     Problem with exception handling detected and caused by a
               return within a try block.
      
      ...

      Version 2.00  01 Dec 1996
          First release ready version.



    +----------------------------------------------------------------------+
    |                                                                      |
    | This text file was converted from a StrongHelp manual on 21 Dec 2023 |
    |                                                                      |
    |          using !StHlp2Txt version 1.12 (29 September 2009)           |
    |                           by Chris Morison                           |
    |                                                                      |
    |               email: organizer@morison.net                           |
    |                 web: http://www.organizer.morison.net/               |
    |                                                                      |
    +----------------------------------------------------------------------+
