.----------------------------------------------------------------------------.
|  Documentation: "Comment grer au mieux les capacits du Rippeur d'ADR ?"  |
'----------------------------------------------------------------------------' 
                            --== Version 1'05 ==--

  Matriel requis: moniteur couleur + 512 Ko minimum
  Mmoire conseille sur { ST: 1 Mga
                         { Falcon: 4 Megas

  Prvu  l'origine pour ne rechercher que des formats de musiques, le rippeur
d'ADRENALINE s'est petit  petit ouvert   de plus larges  domaines tel que la
gestion de l'image  et du dcompactage . Il vous est prsent dans sa dernire
version:

  Option chargement de fichiers ( touche 1 sur le pav numrique ):
  =============================
  
 - L'ancienne version du slecteur de fichier a t remplace par le slecteur
   de  fichier  du  GEM , cela  pour  vous   assurer  un  plus  grand  confort
   d'utilisation.
 - Il accepte de fonctionner avec  des Ram-Disk (tel que M-Disk 6)  et accepte
   aussi les slecteurs de fichiers performants (tel que UIS 3'3).
 
  Chercher tous les formats de musique ( touche 2 et 3 ):
  ====================================
  
 - Ces options  sont utiles    toute  personne  ne  sachant  pas  quel format
   spcifique ellle recherche . Cela permet aussi  d'viter une perte de temps
   apprciable.
 - La touche 2: un appuie sur cette touche entamera une recherche  de tous les
   formats de musiques soundchip . Un report est ffectu sur l'cran  chaque
   type de format.
 - La touche 3: presque  identique, sauf que  ce sont  des  formats de musique
   half-track   ou   soundtrack  qui  sont  recherchs . Ces  formats  offrent 
   gnralement un meilleur rendu sonore.     
 - Si une musique a t trouve  et  que vous dsirez continuer les recherches
   choisissez l'option "Search an other music".
 - Pour toutes musiques, un vu-metre est affich . Ceux  qui  n'aiment pas  le
   duochrome passeront leur chemin.
 - Certains formats tel que Veggy, Maestro et Ens sont reconnus par  le format
   Mad Max. 

  Recherche de samples ou digitalisations sonores ( touche 4 ):
  ===============================================
  
 - Contrairement aux autres formats, c'est   vous de  rechercher le sample en
   question  l'aide du curseur car ce format est difficilement identifiable. 
 - Premirement, il vous faut  savoir  si vous recherchez  un sample au format
   sign ou non . A titre indicatif, un module Amiga  contient  des samples au
   format sign, alors que des sons de ST Replay sont au format normal.
 - Pour changer de format, pressez la touche <*>.
 - Les touches du Curseur Haut et Bas permettent de choisir  l'adresse mmoire
   qui sera joue.
 - Les touches du Curseur Droit et Gauche permettent de slectionner la taille
   du sample  jouer . Si la taille est  nulle, pas  la peine de  slectionner
   l'option play.
 - la touche <SHIFT> additionne  aux touches du curseur  permet  d'obtenir un
   rglage beaucoup plus prcis.
 - La frquence peut etre modifie  partir des touches <+> et <->.
 - Pour stopper un sample en train d'etre jou, pressez <ESCAPE> ou <ESPACE>.   
 - Pressez <INSERT> pour reprendre la taille d'un fichier charg.
 - Dernirement, il vous  est possible  d'afficher le sample. Cela pourra vous
   etre utile dans vos recherches.

  Recherche de formats d'images ( touche 5 ):
  =============================
  
 - Une fois de plus, c'est  vous  de rechercher  les formats vous-meme . vous
   pouvez rcuprer les formats Degas Elite et Neochrome.
 - Pressez <ESPACE> pour afficher l'image . Une fois  cette touche presse, il
   vous sera permis d'utiliser les fonctions suivantes:
 - Les touches du  Curseur Haut et Bas  permettent de  dplacer l'cran  d'une
   ligne  chaque fois . En appuyant simultanment sur le curseur et la touche
   <SHIFT>, le scroll sera plus rapide.
 - Les touches du Curseur Droit et Gauche  permettent de dplacer l'image d'un
   plan . Utilisez cette fonction pour obtenir une image sans parasites.
 - Pour  modifier  la taille  de l'image, utilisez <-> et <+> . Cette fonction
   vous sera d'une grande utilit pour rcuprer des sprites.
 - Utiliser <INSERT> pour  prendre  la  palette  d'une  image  Degas Elite, et
   <CLR HOME> pour  prendre  une  palette Neochrome. <UNDO> sert   crer  une
   palette alatoire. 
 - Dernirement, il est  possible  d'utiliser  les parenthses <(> et <)> pour
   visionner la mmoire image par image.
 - Une nouvelle fonction vous permet d'afficher des images de n'importe quelle
   taille dans  n'importe quelle  rsolution. Pour cela, utilisez  les touches
   </> et <*>, qui correspondent  la fonction jump.
 - Les touches  de fonction <F1>  <F5> correspondent  l'utilisation de 1  8
   plans . Plus il y a de plans, plus  il y a de couleurs. Ces touches doivent
   etre presses lors de la visualisation de l'image.
 - Une fois  l'image slectionne, pressez <ESPACE> pour  revenir  au menu  de
   recherche de formats d'images. La, vous pourrez faire ceci:
 - Il est possible  d'utiliser  la basse  et la moyenne rsolution en pressant
   respectivement  les  touches <F1> et <F2> dans  le menu. Les  paramtres de
   l'image  seront  automatiquement  changs. Aussi  les  touches <F3> et <F4>
   permettent  d'utiliser  le  mode  256  couleurs  du  Falcon 030 , qui  sont
   respectivement le mode 40 colonnes et 80 colonnes.   
 - La  touche <*>  permet  d'utiliser  soit  le  mode  normal , soit  le  mode
   entrelac, ceci etant alternatif (sous reserve de disposer d'un Falcon). La
   rsolution  verticale  s'adaptera  automatiquement  aux capacits  de votre
   moniteur.
 - Si  vous  pressez <1>, la  recherche d'une  image  Degas Elite compacte en
   basse rsolution sera effectue.
 - Pour sauver  une image, pressez  la touche <2>. Attention, le rippeur prend
   en compte les changements de plans, de taille et de couleurs.

  Recherche de headers sur disk ( touche 6 ):
  =============================

 - Editeurs de disquettes, cette fonction vous concerne. En gnral, les dmos
   utilisent  un header pour vrifier qu'ils chargent les bons secteurs . Mais
   le probleme est qu'ils n'utilisent pas toujours  l'header du packer  qu'ils
   ont utilis . Cette fonction  vous permet de trouver  ces headers connus ou
   non et d'afficher leur nombre (seul les 20 premiers header sont affichs).
 - L'information est affiche  comme ci: d'abord, le header  est inscrit  sous
   forme hexadcimale, puis en code ASCII . Finalement, on trouve le nombre de
   fois qu'est trouv ce header en hexadcimal.
 - Pour modifier le nombre de pistes  lire, utilisez  le curseur gauche et le
   curseur droit . Le nombre de secteurs par piste  lire  peut etre modifi 
   l'aide du curseur haut et bas . Slectionnez la face  l'aide de  la touche
   <INSERT>.
 - Appuyez sur la touche <1> pour dmarrer les recherches. Toute erreur durant
   la lecture annulera les recherches.
 - La touche <HELP> permet  de  prendre  la  configuration  d'une  disquette 
   condition que ses valeurs soient cohrentes.
 - Pour  augmenter  la  puissance  de  cette  option , les  touches <+> et <-> 
   permettent de changer l'offset allant de 0  508.

  Recherche de donnes packes ( touche 7 ):
  ============================

 - Toutes les donnes packes ne  se  trouvent  pas  forcment au  dbut  d'un
   fichier.C'est pour cela que cette option a t rajoute pour vous permettre
   d'accroitre vos chances de trouver ce que vous cherchez.
 - Les packers les plus courants  seront  reconnus. Une  fois que  vous  aurez
   trouv des donnes packes, vous pourrez dcompacter, sauver le fichier tel
   quel, ou rechercher d'autres donnes packes. Si vous avez choisi  l'option
   dcompacter, il vous sera possible de  sauver les  donnes  dcompactes en
   passant par l'option prfrences.

  Editeur de mmoire ( touche 8 ):
  ==================
  
 - Que se soit pour modifier le contenu d'un fichier, observer ou  modifier la
   mmoire, cet diteur, d'apparence peu volue, permet d'accder  n'importe
   quelle position de la mmoire.
 - L'diteur est spar en 3 colonnes: l'adresse, les valeurs hxadcimales et
   les valeurs  ascii. Dans  les  valeurs  hxadcimales, un <**> est  affich
   lorsque  la valeur ne  peut etre lue. Dernire  prcision, l'affichage  est
   effectu  en temps  rel, ne  vous tonnez pas  de voir  une valeur changer
   constemment. 
 - La touche <A>  permet  d'entrer  l'adresse    laquelle  vous  voulez  vous
   positionner. Attention, la valeur attendue est une valeur hxadcimale.
 - Le Curseur ainsi que les touches <+> et <-> permettent de changer l'adresse
   sans avoir  entrer une  nouvelle adresse. En consquent, les  dplacements
   d'1, 16 et 256 octets sont possibles dans les deux sens.
 - L'diteur, accessible par la touche <E> permet de modifier n'importe quelle
   valeur hxadcimale ou ascii. Pour passer  de l'un   l'autre, appuyez  sur
   <Tab>. Il vous est permis de vous  deplacer   l'aide du  curseur sur  tout
   l'cran.
 - La recherche d'octets est possible en appuyant sur <S>. Vous aurez le choix
   entre la recherche Hxa et Ascii. On ne peut  rechercher au plus 4 octets 
    la fois. Si vous voulez continuer les recherches, appuyez sur <N>.

  Options ou prferences ( touche 9 ):
  ======================
  
 - Cette option est trs utile   des possesseurs de ST  avec des capacits de
   mmoire importantes.
 - Quand vous possdez 1 mga ou plus, et que  vous dsirez charger un fichier
   de moins de 300 Ko, il est  prferable de  rduire  l'espace  mmoire  dans
   lequel les recherches doivent etre effectues.
   Aussi, on peut dfinir la zone de recherche avec une prcision d'un octet. 
 - Une autre option permet de changer la frquence  de balayage de l'cran par
   l'intermdiaire de la touche <F> . Possesseurs de TT, attention !
 - Certains fichiers de donnes  utilisent volontairement  de  faux headers de
   packers, pour  parfaire   cela , vous  pouvez  dsactiver  le dcompactage
   automatique  l'aide de la touche <D>.
 - On peut aussi dsactiver  l'effacement automatique  du buffer de travail en
   pressant la touche <C> . Cela peut servir  si ce que vous devez  rechercher
   se situe dans le haut de la memoire par exemple.
 - Il  est  possible  de sauver les  fichiers dcompacts  en appuyant  sur la 
   touche <S> . Tout  les  fichiers  non  compacts  seront  sauvs  avec  les
   modifications faites dans l'diteur de mmoire.
 - La touche <E> permet d'effacer un fichier, permettant  ainsi de librer  de
   la place sur une disquette.
   
  Option Recherche d'un format de musique ( touche F1 )
  =======================================
  
 - Sur les versions prcdentes, le choix d'un format  de musique se faisait 
   l'aide de  toutes les  touches de  fonction. Mais  comme  les 20 touches de
   fonction ne me suffisaient plus, j'ai adopt cette mthode:
 - La musique  slectionne est  affiche en  inverse vido. Pour se  dplacer
   utilisez les touches du curseur.
 - Pour entamer la recherche, appuyez  sur la  barre d'espace. Par  contre, si
   vous dsirez quitter ce menu, appuyez sur <ESC>.
   
  Option Chargement de pistes ( touche F2 ):
  ===========================
  
 - Avant de vouloir charger en mmoire  quoi que ce soit, vrifiez ou  changez
   les paramtres suivants:
 - Le numro de piste de dpart se modifie  l'aide  des touches <F1> et <F2>.
   Pour le numro de piste de fin, ce sont les touches <F3> et <F4>.
 - Le nombre de secteurs par piste se change   l'aide des touches <+> et <->.
   Si vous choisissez  un nombre erronn, le chargement de  pistes ne se  fera
   pas.
 - Le numro de face se modifie  l'aide de la touche <F5>. Prenez  garde  ce
   que la face que vous voulez charger existe.
 - Si vous n'avez pas assez  de mmoire  pour charger  des pistes, diminuez le
   le nombre de pistes en modifiant le numro de piste de fin.

  Option Info & Greets ( touche HELP ):
  ====================

 - C'est dans cette option qu'il vous est indiqu la liste de tous les packers
   reconnus par le ripper.
 - On peut aussi y trouver  des remerciements, et  quelques salutations . Peut
   etre que  vous ferez  vous aussi parti de  cette liste,  moins que  vous y
   soyez dj.
 - Si vous dsirez me contacter, mon adresse se trouve dans cette option.

  Vous pouvez  quitter le rippeur en pressant <DELETE> (mais bon, quel interet
ce rippeur est trop cool pour qu'on le stoppe).

Conseils:
--------
Le rippeur  peut  rejouer toutes sortes  de musiques reloges  avec GSR 3'1, 
condition que le format ci-dessous soit utilis:
  - BRA **    relocation     \
  - BRA **    initialisation  | reste inchang
  - BRA **    routine vbl    /
  - BRA ++    restaure musique  \
  - BRA ++    initialise drums   | ordre des routines utilisateur 
  - BRA ++    restaure drums    /   
Comme  vous le voyez, la routine user 1  doit  etre utilise  pour restaurer la
musique . La  routine   user  2   doit  servir   pour  tout   ce  qui  concerne 
l'initialisation  de timers  pour  des musiques  digi-drums, la  routine user 3
servant  restaurer les timers utiliss par ces digi-drums. Attention, il n'est
pas necessaire d'utiliser  chaque fois ces routines utilisateurs, c'est  vous
de juger en fonction du player de musique d'origine. 

Avertissement:
-------------
  A titre  indicatif, ce rippeur  modifie  pas  mal  de vecteurs ! Il  est donc 
prfrable de n'avoir  aucun  autre programme rsidant  modifiant des vecteurs.
Aussi, je lance  un message  aux hackers: Ripper des zics  et des gfx, ca passe
mais  ripper  du code, c'est  aller  un peu  trop loin ! Aillez  un  minimum de
respect envers les programmes des autres.
Il est vivement  dconseill d'utiliser  ce rippeur avec des programmes tel que
Multi-Tos  car le rippeur ne respecte pas ce type de compatibilit, et que cela
vous fait perdre de la mmoire inutilement pour ce type d'application.
Pour toutes utilisations abusives de ce rippeur sur n'importe quel logiciel que
se soit, seul l'utilisateur peut etre tenu pour responsable.

Feedback:
--------
  Ce programme, ainsi que  les fichiers qui l'accompagnent  font toujours parti
du domaine publique. Mais, contrairement  aux autres versions, il n'est plus un
shareware, c'est dsormais  un Postcardware. Je ne demanderais plus d'argent en
retour, mais  simplement  une carte postale  sur laquelle  vous  donerez  votre
opinion  propos de  ce rippeur. Qu'est-ce compar  ce que demande les autres?
Je ne pense pas distribuer  d'autres versions,  moins  qu'il y ai  une demande
suffisante  de  votre  part. C'est cela, le feedback. Alors, si  vous  aimez ce
rippeur, faites  le moi savoir, cela  ne peut  vous etre  que  bnfique, ainsi
qu' moi.
  J'aimerais remercier  certains membres  d'Adrenaline pour  leur  aide (ils se
reconnaitront).

                                                    Dr Computer of ADRENALINE.