MGSDRV version 3.20+	Copyright(c) 1991-94 par Ain
			Copyright(c) 1997-2001 GIGAMIX
			Modifi par Goripon & Influenza (GIGAMIX)
			Spcial merci  Masaki Kiyono


* Prface *

 MGSDRV est un pilote qui permet de jouer des musiques (jusqu' 17 voix) sur
 les ordinateurs MSX munis des gnrateurs sonores suivants.

  - PSG
  - FM (MSX-MUSIC, YM-2413/OPLL)
  - SCC
   
 MGSDRV utilise l'interruption VBLANK pour jouer la musique en parallle des
 autres traitements qu'effectue le MSX.

 Ce pilote est un logiciel libre. Tout le monde peut en profiter gratuitement.

 Il taient trs rpandu sur les rseaux japonais dans les annes '80, de
 nombreuses musiques ont t dveloppes dans ce format.
 
 MGSDRV a t dvelopp par Ain et continu par Gigamix.

 Notes:
 - La puce SCC est un gnrateur d'onde sonore conu par Konami Corporation.
 - Pour toute question sur MGSDRV, posez-les  Gigamix.


* Environnement requis *

 - MSX1 (avec 64Ko ou plus), MSX2, MSX2+ ou MSX turbo R
 - MSX-DOS 2 ou Nextor DOS


* Mthode d'utilisation *

 MGSDRV (MGSDRV.COM) fonctionne sous MSX-DOS 2.
 Les fichiers MGS pour le pilote v2.xx n'ont pas le mme format,
 ils ne sont pas compatibles.

 Sous DOS1, le pilote ne peut pas tre rsidant. Un programme annexe (MGSEL,
 MGSC, etc.) ne peut tre lanc qu'en le spcifiant au lancement (tant que
 le numro de version n'est pas vrifi).
 Sous DOS2, vous pouvez utiliser les toutes options suivantes.

  /Z .... Installe ou retire le pilote. L'installation n'est possible que
          si le Memory Mapper principal a 2 pages de libre. Vous pouvez
          spcifier une commande du DOS juste derrire cette option.
          Par dfaut, ce sera le fichier batch REBOOT.BAT. Il sera excut
          juste aprs l'installation ou la dsinstallation.
          Comme les options sont interprtes et excutes de gauche 
          droite, veuillez spcifier cette option derrire les autres.

  /Dx ... Spcifie le disque de dmarrage. Ce paramtre est pris en compte
          non seulement lorsque MGSDRV redmarre le DOS, mais aussi aprs
          un redmarrage du DOS (par exemple, lorsque _SYSTEM est excut
          sous BASIC). x dsigne le nom du lecteur de dmarrage (A  H).

  /Sx  .. Spcifie le numro de Slot dans lequel la SCC doit tre utilise.
          La valeur doit tre spcifie en hexadcimal. Elle se calcule de la
          faon suivante : Numro du Slot tendu (0 si il ne l'est pas) x 4 +
          numro du Slot primaire. Si vous vous trompez de Slot, il sera
          quand mme traite comme si il y avait une SCC. Ce qui causera des
          bugs, voir mme un plantage. Le Slot de l'SCC est auto-dtect par
          dfaut.

  /Bx  .. Rserve des pages dans le Memory Mapper principal pour y charger
          les donnes musicales. Vous pouvez rserver jusqu' 10 pages (x=0~9).
          Si vous spcifiez /B3, 4 pages seront rserves. Si vous
          spcifiez /B9 (le maximum), 10 pages seront rserves car il rserve
          forcment une page pour le programme. Il est donc possible de
          rserver 176ko maximum. (Ce qui est trop pour un FS-A1ST non modifi)

  /Kx ... Spcifie la touche  presser en mme temps qu'une touche du pav
          numrique pour jouer la musique, rgler le volume, etc. Par dfaut,
          ce sera la touche [CTRL]. Vous pouvez spcifier les trois valeurs
          suivantes. 1 pour SHIFT, 2 pour CTRL, 3 pour GRAPH et 0 pour
          sans effet.


Exemple d'utilisation :

 - MGSDRV /Z          Installe ou retire le pilote MGSDRV.
 - MGSDRV /ZAUTOEXE2  Installe ou retire MGSDRV puis excute AUTOEXE2.
 - MGSDRV /DC /Z      Spcifie le disque C comme disque de dmarrage, installe
                      MGSDRV puis excute REBOOT.BAT du mme disque.
 - MGSDRV /S5 /Z      Spcifie que la SCC se trouve dans le Slot 1-2 et
                      installe MGSDRV.
 - MGSDRV /DB:        Spcifie le disque B comme disque de dmarrage sans
                      installer MGSDRV.
 - MGSDRV /B4 /Z      Alloue 5 pages pour les donnes musicales et installe
                      MGSDRV.


* Fonctions des touches du pav numrique *

 En pressant la touche spcifie par l'option /K avec une touches du pav
 numrique, vous aurez accs aux fonctions suivantes.

  /    ... Pause
  *    ... Jouer la musique
  -    ... Baisser le volume
  +    ... Augmenter le volume
  .    ... Stopper la musique
  ,    ... Rejouer la musique
  0~9  ... Changement de pages rserves par l'option /B

 Etant donn que ces processus sont effectus par les interruptions,
 certains programmes peuvent ne pas fonctionner ou causer des dsagrments
 lorsqu'ils sont excuts en mme temps qu'une musique est joue.
 Le traitement est particulirement plus lourd au dbut de la musique. Par
 exemple, cela peut provoquer une perte de caractres avec un logiciel de
 communication. Gardez a  l'esprit lorsqu'un programme est en cours
 d'excution.

 Lorsque vous pressez une touche de 0  9, vous changer de page, c'est 
 dire la zone de stockage des donnes musicales. Si plusieurs pages ont t
 rservs et que vous avez charg des donnes dans chacune de ces pages,
 vous pourrez en changer librement (chaque changement stoppera la musique).
 Si vous slectionnez une page non valide (une page qui n'a pas t alloue),
 le changement ne s'effectuera pas, la musique sera stoppe. Ne changez pas
 de page lorsqu'un programme en cours d'excution utilise les mmes touches
 que celles pour changer de page car la plupart des programmes ne tiennent
 pas compte des changements de page effectus par MGSDRV.


 Exemple d'utilisation avec MGSQC :

 A>mgsdrv /b3 /z	<- Installe MGSDRV avec 4 pages rserves
   (Pressez [CTRL]+[0])
 A>mgsqc ys200		<- Charge YS200.MGS dans la premire page rserve
   (Pressez [CTRL]+[1])
 A>mgsqc ys201		<- Charge YS201.MGS dans la seconde page rserve
   (Pressez [CTRL]+[2])
 A>mgsqc ys202		<- Charge YS202.MGS dans la troisime page rserve
   (Pressez [CTRL]+[3])
 A>mgsqc ys203		<- Charge YS203.MGS dans la quatrime page rserve

 Ds lors, la page contenant ys200 peut tre slectionne en pressant
 [CTRL]+[0]. Pressez [CTRL]+[1] pour slectionner la page contenant ys201,
 [CTRL]+[2] pour la page contenant ys202 et, [CTRL]+[3] pour la page de ys203.
  
 Pressez [CTRL]+[*] pour jouer la musique de la page slectionne.

 Note : MGSQC est un logiciel libre cr par Iita.


* Important *

 - Cette version supporte les modes turbo tel que le mode R800 et le mode
   5,37MHz des MSX2+ Panasonic. C'est  dire que les musiques sont jouables
   dans ces modes. Pour activer un de ces modes, utilisez un logiciel prvu 
   pour.
 - Si vous spcifiez un disque de dmarrage, celui-ci doit contenir les fichiers
   MSXDOS2.SYS et COMMAND2.COM. Sinon le dmarrage ne se fera pas sur ce
   disque mais sur le disque par dfaut.
 - Les interruptions sont utilises pour jouer les musiques, donc si les
   interruptions sont coupes trop longtemps (par exemple pendant les accs
    un disque), la musique joue sera saccade, ce qui est normal.


* Limitations du mode 5,37MHz *

 Les MSX2+ Panasonic disposent d'un mode Turbo  5,37MHz activable par
 logiciel. (Ce mode est diffrent de celui du Victor HC-90/95).
 Dans ce mode, la frquence de fonctionnement du CPU est 1,5 fois plus rapide,
 mais comme l'horloge du PSG ne change pas, le son devient 1,5 fois plus
 aigu et le rglage de la priode de l'enveloppe dure 1/1,5 fois la priode
 normale.

 Par consquent, MGSDRV modifie automatiquement les valeurs des registres du
 PSG afin que la musique soit joue correctement dans le mode  5,37 MHz de
 ces MSX2+. Aucune modification de donnes n'est donc ncessaires. Cependant,
  cause des calculs de correction, la gamme du PSG est moins large que la
 normale et il y aura les restrictions suivantes.

 - Les sons infrieurs  #O1D ne se reproduiront pas normalement.
   (La frquence restera  environ 40,97Hz)

 - Les valeurs suprieures  21 de la commande N produiront un bruit anormal.
   (Un bruit quivalent  "N21" sera mis)

 - Les valeurs suprieures  43690 de la commande M ne pourront pas dfinir
   le cycle de l'enveloppe matrielle correctement.
   (Un cycle d'enveloppe quivalent  "M43690" sera dfini)

 En outre, la musique risquera de ne plus tre joue correctement si vous
 changez de mode (passage du mode 5,37MHz au mode normal  3,58MHz ou
 inversement) en cours de lecture. Evitez de le faire autant que possible.


* Historique des versions *

v3.20+
 - Compatible avec les MSX1. (corrig par gdx)
v3.20
 - Correction du bug dans le support du mode 5.37MHz
 - Changement du copyright affich au dmarrage qui tait encore l'ancien
 - Correction des inexactitudes du document
v3.19
 - Ajout du support du mode 5.37MHz des Panasonic FS-A1FX/WX/WSX
   (Merci  M. Masaki Seino)
 - Correction de ce qui ne correspond pas  la description du document
v3.18A
 - Correction du numro de version qui tait 3.17
v3.18
 - Correction d'un bug qui empchait la SCC de fonctionner dans certains Slots
 - Correction du traitement de la valeur de l'option /Sx
 - Le dveloppement de MGSDRV est dsormais confi  Gigamix


* A propos de la copie et de la distribution *

 Vous pouvez copier et distribuer librement, mais ne changez pas le contenu de
 l'archive. Si vous avez des questions, veuillez me contacter aux coordonnes
 suivante.


* Coordonnes *

Twitter :
https://twitter.com/nf_ban

Page WEB Gigamix :
http://www.gigamix.jp/

E-mail :
nf_ban@gigamix.jp

[eof]
