  /---
  |
  |                    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
3. Informations techniques, bugs et limitations

=========| 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).
  Vous remarquerez qu'il est possible de (d)slectionner un bouton en face de
  "2nd init" et "2nd stop". Cela signifie que vous pouvez dcider de ne pas
  appeler l'un ou l'autre (ou les deux) de ces offsets. Ils sont surtout utili-
  ss pour les musiques digidrums.
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).
  - 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.
  - Options : permet d'avoir quelques informations utiles (type d'ordinateur au
  cas o vous utiliseriez un mulateur, mmoire disponible et occupe) ainsi que
  de paramtrer le logiciel. Vous pouvez faire en sorte que Sound Machine vous
  demande une confirmation avant de jouer tout type de musique qui soit inconnu.
  Il vaut mieux laisser cette option active si vous n'y connaissez rien en
  soundchips. La seconde option consiste  dfinir la taille de la mmoire r-
  serve pour le GEM. Cette dernire option ne sera bien sr active qu'au pro-
  chain dmarrage de Sound Machine, du moins si vous sauvegardez les options
  auparavant.
  - 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.

=========| Partie 3 |===========================================================

     Pour tre jou, un soundchip contient gnralement au dbut du fichier une
routine devant tre appele  chaque rafrachissement d'cran ( chaque VBL).
A chaque VBL, l'Atari va voir dans une liste quelles sont les routines  excu-
ter. Or, il ne peut y avoir que 8 routines au maximum. Ainsi, lorsque vous d-
marrez Sound Machine, il va scruter cette liste VBL et, s'il y a un emplacement
libre, il va le noter et s'en servir pour rejouer plus tard les soundchips. S'il
n'y a plus de place, vous retournerez au bureau GEM. Fates-y attention si vous
tenez  utiliser Sound Machine dans un environnement multitche.

     Un petit mot sur les bugs. J'ai programm la version 3.0 en reprenant les
procdures et les routines de la version prcdente (2.5). 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.
     J'ai rcemment remarqu que les musiques au format Millenium Brothers sont
un peu particulires... cliquez sur "Several musics in the file" avant de jouer
la musique, tapez sur "-" et enfin cliquez sur "Play". Autre problme, qui n'ap-
parat que sur Falcon avec Backward: aprs une musique Count Zero, votre machine
va planter si vous voulez charger un autre fichier ou quitter le logiciel. Je ne
sais pas  quoi est d ce bug...

     Quant aux limitations, on ne peut malheureusement pas lancer Sound Machine
en accessoire. Enfin si, vous pouvez thoriquement le faire, mais vous ne pour-
rez vous en servir qu'une seule fois car RIEN n'a t prvu pour. Impossible de
s'en servir en tche de fond puisque sa bote de dialogue bloquante empche tout
multitche. La raison  cela est qu'il s'agit de soundchips, dont la manipula-
tion doit tre faite avec le plus grand soin pour ne pas planter tout le systme
(contrairement aux samples et aux soundtracks).


                                                 Fin de la doc - Bon amusement !
