  /---
  |
  |                    S o u n d   M a c h i n e   I I I

                          -thenewgenerationofplayerzz-                      |
                                                                            |
                                                                         ---/

=========| Sommaire |===========================================================

1. Rapide description de Sound Machine III
2. Prsentation de la bote de dialogue principale

=========| Partie 1 |===========================================================

     Sound Machine est un player de soundchips. Il devrait fonctionner sur tous
types d'Atari (sur les 520 STF/STE, il est prfrable de dmarrer l'ordinateur
avec le moins de logiciels possible en mmoire). Ce logiciel a t test sur un
STE gonfl  4 Mo ainsi que sur un Falcon 030 en mode VGA. Il fonctionnera sans
doute sur STF, Mega ST et Mega STE. Le TT ainsi que les clnes peuvent poser des
problmes avec les formats de musique qui ne marchent pas sur Falcon.

     Encore un autre player ? Oui, mais celui-ci est diffrent. Tout d'abord, il
utilise l'environnement GEM, ce qui le rend utilisable dans toutes les rsolu-
tions et dans tous les systmes d'exploitation monotche (et non pas multitche
 cause d'un bug du GFA). Il est particulirement ergonomique et simple d'emploi
mme pour une personne qui ne connat pas grand chose aux soundchips. De plus,
Sound Machine est le seul logiciel qui permet de jouer des soundchips dont
l'origine est inconnue en ajustant les diffrents paramtres. Bien entendu, il
est possible de sauvegarder ces musiques inconnues dans un format directement
lisible par Sound Machine. Sound Machine III est entirement compatible avec les
fichiers gnrs par son prdcesseur Sound Machine 2.5. Et ce n'est qu'une
partie des possibilits de Sound Machine.

     Qu'est-ce qu'un soundchip ? Il s'agit d'une musique utilisant les sons syn-
thtiques du coprocesseur sonore Yamaha, sur 3 voies. Certaines musiques utili-
sent des sons digitaliss, pour la batterie par exemple : ce sont des digidrums
(ou halftracks). D'autres musiques reprennent la particularit sonore du C 64 :
ce sont des musiques Sid-Voice.

=========| Partie 2 |===========================================================

     La bote de dialogue principale peut tre divise en 3 partie : les infor-
mations sur les fichiers, les paramtres et les boutons.

* Les 3 premires lignes donnent quelques informations utiles comme le nom du
fichier ou encore sa taille. En dessous, vous trouverez une courte description
d'une ou deux lignes sur le fichier ventuellement charg en mmoire (format,
auteur, infos complmentaires, etc.).

* Les paramtres sont nombreux, je vais les dtailler un par un :
  - 1st init : il s'agit du premier offset pour initialiser les musiques.
  - 2nd init : un second offset pour les ventuelles musiques digidrums.
  - Play : l'offset principal qui va jouer la musique  chaque appel VBL.
  - 1st stop : le premier offset pour arrter la musique.
  - 2nd stop : le second pour arrter les musiques digidrums (facultatif).
IMPORTANT : si vous n'y connaissez rien, vitez de trop changer ces paramtres
sous peine de faire planter Sound Machine.
  - Music number at the beginning : il arrive d'un fichier comporte plusieurs
  musiques. Les valeurs acceptes vont de -1  15.
  - Music number at the end : lorsqu'une musique se termine, il arrive que la
  routine aie besoin d'un numro de musique particulier (exemple : -1 pour le
  format Lotus).
  - Use the second stop offset : il est possible de ne pas appeler le second
  offset d'arrt lorsqu'on arrte de jouer une musique. En gnral, seuls les
  digidrums ncessite un second offset.
  - Several musics in the file : comme il a t vu prcdemment, un fichier peut
  trs bien comporter plusieurs musiques. Si cette option est active, il vous
  sera possible d'appuyer sur les boutons "+" et "-" lorsque la musique jouera
  pour changer de mlodie. Bon nombre de formats n'acceptent pas cette possibi-
  lit et plantent, fates l aussi attention. A noter qu'avec les touches "+"
  et "-", vous pourrez cette fois aller de 0  31. Attention aux plantages !
  - This music should run on Falcon : si vous avez un ST, laissez cette option
  dsactive. Si vous avez un Falcon, n'activez cette option que si vous tes
  sr et certain que la musique en mmoire va fonctionner dessus. De toutes fa-
  ons,  chaque fois qu'un fichier est charg, Sound Machine va vrifier si la
  musique en question va effectivement tourner sur Falcon.

* Les boutons sont eux aussi nombreux :
  - LOAD : tout simplement pour charger un fichier en mmoire. Sound Machine va
  tenter d'identifier le format du fichier d'aprs 70 formats reconnus. S'il le
  reconnat, il va afficher les paramtres de ce dernier dans la bote de dialo-
  gue principale afin de les modifier ventuellement.
  - PLAY : permet de jouer la musique. Si le format est inconnu, Sound Machine
  vous demande si vous voulez jouer la musique d'aprs les paramtres prsents
  dans la bote de dialogue principale. Si vous possdez un Falcon et que la
  musique ne peut pas tre joue dessus, vous aurez tout de mme la possibilit
  de forcer l'excution de la musique (si, par exemple, vous utilisez Backward).
  De plus, tous les formats reconnus ne seront pas forcment jous, c'est le cas
  notament des soundtracks et des samples. En effet, Sound Machine a t pro-
  gramm en GFA et il existe de bien meilleurs players pour ces fichiers (le
  MegaTracker Player ou Paula pour les soundtracks, BackGround Player ou SAM
  pour les samples).
  - SAVE : le fichier en mmoire va tre sauv.
  - See header : permet de voir les 200 premiers octets du fichier en mmoire.
  - Convert & save : le fichier actuellement en mmoire va tre converti au
  format Sound Machine III puis sauvegard sur disque.
  - About : quelques informations sur le programme.
  - System info : permet d'avoir quelques informations utiles (type d'ordina-
  teur au cas o vous utiliseriez un mulateur, mmoire disponible et occupe).
  - Extract & save : lorsque Sound Machine convertit une musique au format
  interne, il se contente de rajouter quelques octets au fichier d'origine.
  Cette option va vous permettre de faire l'inverse et va donc enlever ces
  octets et sauvegarder le fichier ainsi obtenu.
  - Exit : pour quitter le logiciel. Aucune confirmation ne sera demande.

     Un petit mot sur les bugs et les limitations. J'ai programm cette version
en reprenant les procdures et les fonctions de la version prcdente. Bien que
j'ai t trs vigilant, il se peut qu'il y ait quelques bugs, d'autant plus que
tout a t torch en quelques soires... Si vous en trouvez, merci de me dire
comment cela s'est droul. Quant aux limitations, on ne peut malheureusement
pas lancer Sound Machine en accessoire ou en tche de fond (sa bote de dialogue
bloquante empche tout multitche), du moins pour l'instant...


(Putain les gars, j'ai jamais crit une doc aussi courte... 8-) !!)
