home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / maj / 2399 / modm.doc < prev    next >
Text File  |  1994-06-01  |  22KB  |  505 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │ ███▀▀██▀▀██            ██     ███▀▀██▀▀██ ▄▄▄▄▄▄ ▄▄▄▄▄▄ ███   ▄▄▄▄▄▄ ▄▄▄▄▄▄ │
  3. │ ███  ██  ██ ██▀▀██ ██▀▀██     ███  ██  ██ ▄▄▄▄██ ███▄▄▄ ███▀▀ ██▄▄██ ███ ▀▀ │
  4. │ ███  ██  ██ ██▄▄██ ██▄▄██     ███  ██  ██ ██▄▄██ ▄▄▄▄██ ███▄▄ ██▄▄▄▄ ███    │
  5. │                                                                             │
  6. │                               - VERSION 2.0 -                               │
  7. │                                                                             │
  8. │                  (c) 1994 Freddy VETELE & Fabrice COUTEAU                   │
  9. └─────────────────────────────────────────────────────────────────────────────┘
  10.  
  11.  
  12.    Comme son nom l'indique, Mod Master permet de jouer les fichiers de
  13.    musique Amiga MOD, mais aussi les fichiers au format NST, WOW, STM et
  14.    Fast Tracker 6 et 8 voies.
  15.  
  16.    Si vous désirez utiliser Mod Master sans plus attendre, lancez le programme
  17.    MODM et réglez le type de sortie sonore que vous voulez. Cela dit, si vous
  18.    possédez une carte Sound Blaster ou Sound Blaster Pro, elle sera
  19.    automatiquement détectée et sélectionnée.
  20.  
  21.    Lorsque vous quittez Mod Master, votre configuration personnalisée est
  22.    sauvegardée dans le fichier MODM.CFG.
  23.  
  24.  
  25.    Configuration minimale:    Un compatible PC/XT 8 MHz
  26.    ~~~~~~~~~~~~~~~~~~~~~~~    512 Ko de RAM
  27.                               Un écran CGA couleur.
  28.  
  29.       Pour ce type de configuration, il n'est pas possible d'écouter des
  30.        modules 6 ou 8 voies et la qualité sonore est plus que médiocre
  31.        (sauf si vous possédez une carte sonore).
  32.  
  33.  
  34.    Configuration conseillée:  Un AT 386 16 MHz
  35.    ~~~~~~~~~~~~~~~~~~~~~~~~~  1 Mo de RAM
  36.                               Une carte sonore compatible Sound Blaster
  37.                               Un écran VGA couleur.
  38.  
  39.  
  40.  
  41.  I. Description du programme
  42.  ═══════════════════════════
  43.  
  44.      Mod Master v2.0 se présente en trois parties:
  45.  
  46.        1) L'interface pour les réglages et le choix des modules.
  47.        2) L'écran en mode texte pendant l'écoute.
  48.        3) L'écran en mode graphique (VGA) pendant l'écoute.
  49.  
  50.  
  51.    1) Réglages et choix des modules
  52.    ────────────────────────────────
  53.  
  54.       Cette interface est très simple d'utilisation:
  55.  
  56.       - sur la gauche, l'ascenseur permet de choisir un module seul (avec
  57.         la touche Entrée ou le bouton gauche de la souris) ou de sélectionner
  58.         une liste de modules pour constituer un programme (touche Espace ou
  59.         bouton droit de la souris).
  60.  
  61.       - sur la droite, un certain nombre de boutons dont voici l'effet:
  62.  
  63.          Réglages: affiche une fenêtre dans laquelle vous pouvez choisir:
  64.         -----------
  65.  
  66.              a) La sortie sonore dans la liste suivante:
  67.  
  68.                    Haut-parleur interne (arg!)
  69.                    Convertisseur numérique-analogique sur port LPT1 ou LPT2
  70.                    Sound Blaster 2.0
  71.                    Sound Blaster Pro (Mono ou Stéréo)
  72.                    Sound Master (carte compatible Adlib)
  73.                    Disney Sound Source (sur port LPT1 ou LPT2)
  74.  
  75.              b) La fréquence de sortie: de 5000 Hz à 44100 Hz, selon le type
  76.                 de sortie sonore choisie, la puissance de votre PC et le
  77.                 nombre de voies du module (de 4 à 8).
  78.  
  79.              c) Le volume général: de 1 à 100%, il est utile de l'augmenter
  80.                 pour entendre correctement des modules à faible volume.
  81.                 Comme chaque échantillon est numérisé sur 8 bits (valeurs de 0
  82.                 à 255), la technique utilisée pour restituer 4 instruments en
  83.                 même temps est de diviser l'amplitude de chaque instrument par
  84.                 4 (avec 4 voies, on obtient des valeurs de 0 à 1023, qui se
  85.                 codent donc sur 10 bits).
  86.                 En fait, le volume général est le coefficient appliqué sur
  87.                 chaque échantillon, on peut ainsi ajuster au mieux l'amplitude
  88.                 de chaque instrument pour garder le maximum de précision dans
  89.                 les calculs. Ce coefficient est supérieur à 1/4, car il est rare
  90.                 de trouver des modules dont le volume est proche du maximum
  91.                 admissible sur 8 bits.
  92.  
  93.                  Remarque: pour la stéréo, le volume général est automatique-
  94.                             ment multiplié par 2, ce qui augmente la qualité
  95.                             sonore (les calculs sont sur au moins 9 bits).
  96.  
  97.                 Attention! Si le volume général est trop fort, vous entendrez
  98.                 ~~~~~~~~~~ des craquements très désagréables dans le son,
  99.                            à cause de dépassements de capacité.
  100.  
  101.                 Le volume général par défaut (≈40%) est prévu pour qu'il ne se
  102.                 produise aucun craquement avec la plupart des modules.
  103.  
  104.              d) La durée IntroScan: de 2 à 30 secondes.
  105.  
  106.  
  107.            Si vous possédez une carte compatible Sound Blaster ou SB Pro, vous
  108.            pouvez, grâce au bouton Options, accéder aux réglages suivants:
  109.  
  110.                 - Sortie sonore par le DMA ou par interruption Timer:
  111.  
  112.                       La sortie par le DMA (défaut) est conseillée pour obtenir
  113.                       une meilleure qualité sonore à une fréquence plus
  114.                       élevée que la sortie par interruption Timer.
  115.  
  116.                 - Numéro de l'interruption (si DMA): 2, 5 ou 7.
  117.  
  118.                 - Mono ou Stéréo (pour la Sound Blaster Pro seulement!)
  119.  
  120.                 - Stéréo avec mixage:
  121.  
  122.                      Sans mixage, les voies d'un module 4 voies (par exemple)
  123.                       sont réparties comme suit:
  124.                       2 voies sur le canal gauche et 2 voies sur le canal droit,
  125.                       avec le même coefficient affecté pour chaque canal.
  126.  
  127.                      Avec mixage, les 2 voies qui sont envoyées sur le canal
  128.                       gauche sont également envoyées sur le canal droit, mais
  129.                       avec un coefficient plus faible. Idem pour le canal droit.
  130.  
  131.                    Cette option est pratique pour écouter le son sur un casque
  132.                    ou une chaîne hifi (meilleure répartition).
  133.  
  134.                 - Filtre des aigus (pour la Sound Blaster Pro seulement!)
  135.  
  136.                 - Volumes séparés canal gauche/canal droit (SB Pro).
  137.  
  138.  
  139.          IntroScan:
  140.         ------------
  141.  
  142.              Bien connue des audiophiles, cette fonction permet d'entendre les
  143.              premières secondes de plusieurs modules.
  144.              S'il n'y a pas de programme, tous les modules sont sélectionnés,
  145.              sinon la fonction s'applique seulement sur le programme.
  146.              Pendant l'écoute d'un module, vous pouvez désactiver cette fonction
  147.              en appuyant sur 'I', vous entendrez ainsi le module entièrement.
  148.  
  149.  
  150.          Shuffle:
  151.         ----------
  152.  
  153.              C'est aussi une fonction classique que l'on trouve sur la plupart
  154.              des lecteurs de CD: elle permet de jouer aléatoirement un
  155.              programme ou la totalité des modules.
  156.              S'il n'y a pas de programme, tous les modules sont sélectionnés,
  157.              sinon la fonction s'applique seulement sur le programme.
  158.  
  159.  
  160.          Gestion des programmes: Lecture, Tout, Efface, Charge, Sauve.
  161.         ---------------------------------------------------------------
  162.  
  163.              On vous laisse deviner le rôle de ces boutons!
  164.  
  165.    
  166.          Aide: Affiche un bref résumé des fonctions de l'interface.
  167.         -------
  168.  
  169.  
  170.          Quitte: A utiliser le moins possible, ce bouton quitte Mod Master!
  171.         ---------
  172.  
  173.  
  174.  
  175.    2) L'écran en mode texte pendant l'écoute
  176.    ─────────────────────────────────────────
  177.  
  178.     - En haut, première ligne:
  179.        Le nom du module (éventuellement son ordre dans un programme), sa durée
  180.        totale (exacte!) et le temps d'écoute (chronomètre ou compte à rebours).
  181.  
  182.     - En haut, au milieu:
  183.        Le titre du module, le nombre d'instruments qu'il contient, le nombre
  184.        de voies, la position courante et le nombre de positions, le numéro de
  185.        la note dans le pattern (pardon M. Toubon) et le volume.
  186.  
  187.     - En haut, à gauche:
  188.        Les barres de volume pour chaque voie (4 voies simultanément).
  189.  
  190.     - En haut, à droite:
  191.        Les barres de période (note) pour chaque voie (4 voies simultanément).
  192.  
  193.     - En bas:
  194.        Vous avez le choix entre afficher la liste des instruments
  195.        ou la partition (4 voies simultanément).
  196.  
  197.         La partition affiche pour chaque voie:
  198.          - le numéro de l'instrument,
  199.          - la note (Française, Anglaise ou période Amiga),
  200.          - l'effet et son paramètre.
  201.  
  202.         Les effets gérés par Mod Master v2.0 sont:
  203.  
  204.           0: Arpeggio
  205.           1: Portamento Up
  206.           2: Portamento Down
  207.           3: Tone Portamento
  208.           4: Vibrato
  209.           5: Tone Portamento + Volume Slide
  210.           6: Vibrato + Volume Slide
  211.           A: Volume Slide
  212.           B: Jump Pattern
  213.           C: Set Volume
  214.           D: Pattern Break (s'exécute seulement si le bouclage(*) est activé)
  215.           F: Set Tempo
  216.  
  217.     - Pendant l'écoute, vous pouvez afficher une page d'aide en appuyant sur F1,
  218.       et permuter les écrans texte et graphique en appuyant sur F6.
  219.  
  220.  
  221.    3) L'écran en mode graphique pendant l'écoute
  222.    ─────────────────────────────────────────────
  223.  
  224.      Si vous êtes l'heureux possesseur d'une carte VGA couleur, vous pourrez
  225.      profiter de cette nouveauté qu'on vous laisse découvrir!
  226.  
  227.  
  228.     (*) bouclage: Pendant l'écoute d'un module, vous pouvez activer/désactiver
  229.                   cette option en appuyant sur 'R' ('Repeat' est affiché en mode
  230.                   texte et un symbole est allumé en mode graphique).
  231.                   Si le bouclage est activé, le module boucle sur lui-même quand
  232.                   il se termine (la musique reprend soit au début, soit à une
  233.                   autre position dépendant du module), et les sauts ('PosJmp'
  234.                   dans la partition) en avant et en arrière sont autorisés.
  235.                                                                  
  236.  
  237.  
  238.  II. Lancement du programme avec une ligne de commande
  239.  ═════════════════════════════════════════════════════
  240.  
  241.      Les différentes syntaxes sont:
  242.                                                                                 
  243.         MODM nom_module[.MOD]      Joue le module MOD spécifié (par défaut)
  244.         MODM nom_module.ext        Joue le module NST, WOW ou STM spécifié
  245.         MODM nom_programme[.PRG]   Joue le programme spécifié
  246.  
  247.      Si vous avez un doute, tapez MODM ?
  248.                                                                           
  249.  
  250.  
  251.  III. Compatibilité et performances
  252.  ══════════════════════════════════
  253.  
  254.      Mod Master v2.0 a été testé sur les machines suivantes:
  255.  
  256.       - Amstrad PC 1512 (5400 Hz sur Sound Blaster, par interruption et 4 voies)
  257.       - AT 286: Bull Micral 45 (17000 Hz pour 4 voies, 10000 Hz pour 8 voies)
  258.       - AT 386DX/40 (44100 Hz sur Sound Blaster Pro, par le DMA et 8 voies)
  259.       - AT 486SX/25 (idem)
  260.       - AT 486DX/33 et 40 (idem)
  261.       - AT 486DX2/66 (idem)
  262.  
  263.      Sorties sonores testées:
  264.  
  265.       - Haut-parleur interne (pas longtemps...)
  266.       - Convertisseur N/A sur port parallèle (celui présenté plus loin)
  267.       - Sound Blaster 2.0
  268.       - Sound Blaster Pro 2.0
  269.       - Sound Galaxy NX
  270.       - Sound Galaxy NX Pro
  271.       - Sound Master Boomer
  272.       - Sound Master
  273.       - Audio Sound 16
  274.       - Melody PC
  275.  
  276.  
  277.  
  278.  IV. Améliorations depuis la version 1.0
  279.  ═══════════════════════════════════════
  280.  
  281.       - interface en mode texte avec ascenseur, fenêtres, boutons...
  282.       - support de la souris (2 boutons),
  283.       - amélioration de l'écran pendant l'écoute (texte et graphique),
  284.       - possibilité de jouer des programmes,
  285.       - reconnaît les formats WOW, STM et MOD 6 et 8 voies,
  286.       - sorties sonores plus nombreuses (dont la Sound Blaster Pro),
  287.       - utilise le DMA en Mono ou Stéréo jusqu'à 44kHz,
  288.       - auto-détection du port de la Sound Blaster (220h, 230h, ...),
  289.       - correction des effets Arpeggio et Tone Portamento + Volume Slide,
  290.       - affichage de la partition avec choix du type de note,
  291.       - calcul de la durée exacte du module.
  292.  
  293.  
  294.  
  295.  V. Problèmes, causes et solutions
  296.  ═════════════════════════════════
  297.  
  298.      Problème: Je lance la lecture d'un module et mon PC ralentit ou plante.
  299.      ─────────
  300.  
  301.      Causes & solutions:
  302.      ───────────────────
  303.  
  304.         1) La fréquence de sortie est trop élevée pour votre PC.
  305.            -> Diminuez la fréquence de quelques kHz.
  306.  
  307.         2) Vous essayez d'exécuter Mod Master sous Windows.
  308.            -> Il est déconseillé de lancer Mod Master sous Windows, car les
  309.               conflits de mémoire ou de DMA engendrent des ralentissements
  310.               ou des comportements étranges. Revenez donc sous DOS!
  311.  
  312.         3) Votre PC est relativement lent, et vous utilisez de l'EMS.
  313.            -> Sur un PC assez lent (386 SX), la gestion de la mémoire EMS
  314.               ralentit nettement le traitement du programme en premier plan.
  315.               Enlevez le gestionnaire EMM386 (ou équivalent) de votre fichier
  316.               CONFIG.SYS, puis relancez le système.
  317.  
  318.         4) Le numéro d'interruption est incorrect (avec le DMA seulement).
  319.            -> Vérifiez si le numéro d'interruption (IRQ) indiqué dans la
  320.               fenêtre Réglages/Options correspond à celui que votre carte
  321.               sonore utilise.
  322.  
  323.      ----------------------------------------------------------------------
  324.  
  325.      Problème: J'entends des craquements pendant la lecture du module.
  326.      ─────────
  327.  
  328.      Cause & solution: 
  329.      ─────────────────
  330.  
  331.            Le volume général est trop important.
  332.            -> Réduisez le volume général (≈40% est une valeur moyenne).
  333.  
  334.      ----------------------------------------------------------------------
  335.  
  336.      Problème: Il y a des parasites dans l'écran graphique ('neige').
  337.      ─────────
  338.  
  339.      Cause & solution:
  340.      ─────────────────
  341.  
  342.            Vous écoutez un module par interruption Timer.
  343.            -> Lorsque la sortie sonore ne se fait pas par le DMA, l'affichage
  344.               en mode graphique est plus lent qu'en mode texte, à cause des
  345.               boucles qui sont faites périodiquement pour éviter le phénomène
  346.               de 'neige' lors des changements de couleurs.
  347.               Repassez en mode texte!
  348.  
  349.      ----------------------------------------------------------------------
  350.  
  351.      Problème: Votre lecteur contenant les modules n'est pas reconnu.
  352.      ─────────
  353.  
  354.      Cause & solution:
  355.      ─────────────────
  356.  
  357.            Mod Master ne reconnaît pas encore les unités logiques installées.
  358.            -> Les unités logiques peuvent être: un disque dur compacté en
  359.               partie (Stacker, Double Space, ...), un disque RAM ou encore
  360.               un lecteur de CD-ROM. Lancez Mod Master à partir de ces lecteurs.
  361.  
  362.      ----------------------------------------------------------------------
  363.  
  364.  
  365.  
  366.  VI. Renseignements et divers
  367.  ════════════════════════════
  368.  
  369.         1) Qui sommes-nous?
  370.         ───────────────────
  371.  
  372.                 - Freddy Vételé: j'ai 20 ans, je suis étudiant dans une école
  373.                         d'ingénieur (électronique et informatique) à Angers.
  374.                         J'ai fait mes débuts en informatique sur une machine
  375.                         préhistorique: le TI 99 (Texas Instruments), puis je
  376.                         me suis acheté un PC 1512 (Amstrad), sur lequel j'ai
  377.                         programmé la version 1.0 de Mod Master. Aujourd'hui,
  378.                         je passe une grande partie de mon temps sur un 486DX/33,
  379.                         ce qui m'a permis de réaliser cette nouvelle version.
  380.                         J'ai mis au point les routines de calcul du son, les
  381.                         routines de sorties sonores, en fait, tout ce qui touche
  382.                         à la musique!
  383.                         
  384.                 - Fabrice Couteau: j'ai 21 ans, étudiant dans la même école que
  385.                         Freddy (!). J'ai découvert les joies de l'informatique
  386.                         en 1987 sur un PC 1512 (encore!), puis j'ai opté pour
  387.                         un 486DX/40 il y a quelques mois.
  388.                         Freddy m'a demandé d'améliorer l'interface de Mod Master
  389.                         (en effet, celle de la version 1.0 était assez pauvre!),
  390.                         ce que j'ai fait en ajoutant le support de la souris,
  391.                         l'utilisation de fenêtres, boutons, ascenseurs... dans
  392.                         le menu. J'ai également retouché les deux écrans (texte
  393.                         et graphique) affichés pendant l'écoute d'un module.
  394.  
  395.  
  396.         2) Mod Master en chiffres
  397.         ─────────────────────────
  398.  
  399.                 - plus d'un an de programmation (avec des pauses!)
  400.                 - 7200 lignes de source Assembleur (compilées avec TASM 3.2)
  401.                 - 2800 lignes de source Turbo-Pascal (compilées avec TP 7.0)
  402.  
  403.  
  404.         3) Remerciements
  405.         ────────────────
  406.  
  407.              Nous tenons à remercier tous ceux qui nous aidés, par leurs
  408.              informations ou leurs critiques, à mener ce projet à son terme:
  409.  
  410.              Richard Perdriau, Vincent Grenier, Vincent Piocel,
  411.              Denis Panaget, Nicolas Rocher, Romaric Maillard.
  412.  
  413.  
  414.         4) Shareware
  415.         ────────────
  416.  
  417.              Mod Master v2.0 est distribué en shareware, par conséquent, vous
  418.              devez vous faire enregistrer si vous le conservez et l'utilisez
  419.              souvent. Pour cela, imprimez le formulaire MODM.FRM (ou envoyez une
  420.              lettre) avec votre règlement de 50 FRF à:
  421.  
  422.                         Freddy Vételé
  423.                         La Pohuère
  424.                         49530 Bouzillé
  425.                         FRANCE
  426.  
  427.              En vous faisant enregistrer, vous recevrez une disquette 3"½ ou 5"¼
  428.              contenant la dernière version de Mod Master (avec des nouveautés et
  429.              quelques modules) et vous serez affranchi de payer celle-ci.
  430.  
  431.              Si vous avez des remarques à propos de Mod Master (si vous trouvez
  432.              des bugs, par exemple!), ou si vous avez des informations utiles à
  433.              nous fournir (formats de modules -modules compactés ou non-,
  434.              programmation de nouvelles cartes sonores -Sound Blaster 16 ASP,
  435.              Gravis Ultra Sound-, ...), n'hésitez pas à m'écrire à l'adresse
  436.              ci-dessus!
  437.  
  438.  
  439.         5) Fichiers fournis avec Mod Master
  440.         ───────────────────────────────────
  441.  
  442.               - MODM.DOC ············ ce fichier!
  443.               - MODM.EXE ············ Mod Master v2.0 en Français
  444.               - MODM.FRM ············ le formulaire d'enregistrement en Français
  445.               - MODM_ENG.DOC ········ la documentation en Anglais
  446.               - MODM_ENG.EXE ········ Mod Master v2.0 en Anglais
  447.               - MODM_ENG.FRM ········ le formulaire d'enregistrement en Anglais
  448.               - ATOMIC2.MOD ········· un module 8 voies
  449.               - ROTATE.STM ·········· un module au format STM
  450.               - FILE_ID.DIZ ········· une description rapide du programme
  451.  
  452.  
  453.         6) License et garantie
  454.         ──────────────────────
  455.  
  456.              Vous pouvez copier et distribuer librement Mod Master, à condition
  457.               de ne rien modifier dans les fichiers fournis (DOC, EXE, FRM).
  458.              Nous ne serions pas responsables d'éventuels dommages provoqués
  459.               par de telles modifications...
  460.  
  461.  
  462.         7) Convertisseur numérique-analogique
  463.         ─────────────────────────────────────
  464.  
  465.             Nous vous donnons le circuit d'un convertisseur N/A très simple et
  466.             très bon marché, qui se branche sur le port parallèle et que vous
  467.             devrez relier à l'entrée d'un amplificateur.
  468.             Vous avez besoin de 18 résistances (tolérance: 1% de préférence,
  469.             5% au maximum), 2 condensateurs, un connecteur D-25 mâle et une
  470.             prise jack femelle (ou deux prises CINCH ou RCA mâles, si votre
  471.             amplificateur possède deux entrées séparées).
  472.  
  473.  
  474.           Port parallèle
  475.  
  476.           signal   broche
  477.                               20kΩ   20kΩ
  478.           D0       2      >───████─┬─████── 0 Volt (GND, broche 20)
  479.                               20kΩ █ 10kΩ
  480.           D1       3      >───████─┤
  481.                               20kΩ █ 10kΩ
  482.           D2       4      >───████─┤
  483.                               20kΩ █ 10kΩ
  484.           D3       5      >───████─┤
  485.                               20kΩ █ 10kΩ
  486.           D4       6      >───████─┤
  487.                               20kΩ █ 10kΩ
  488.           D5       7      >───████─┤
  489.                               20kΩ █ 10kΩ
  490.           D6       8      >───████─┤
  491.                               20kΩ █ 10kΩ
  492.           D7       9      >───████─┤
  493.                               20kΩ █ 10kΩ  100nF
  494.                                    ├────────┤├──┬───────> Vers l'amplificateur
  495.                                    │            │
  496.                                    █ 10kΩ      ─┴─ 10nF
  497.                                    │           ─┬─
  498.           GND      20     >────────┼────────────┴───────> Masse
  499.                                    0 Volt
  500.  
  501.  
  502. Ce circuit a été emprunté dans le fichier DOC de Visual Player 2.0 (un excellent
  503. logiciel, d'ailleurs!), donc nous remercions son créateur: Luis Ubeda.
  504.  
  505.