*******************************************************************************
*									      *
*	      SSSS	  A	  M	M   PPPPP    L	     EEEEE	      *
*	     S		 A A	  MM   MM   P	 P   L	     E		      *
*	      SSSS	A   A	  M M M M   PPPPP    L	     EEE	      *
*		  S    A A A A	  M  M	M   P	     L	     E		      *
*	      SSSS    A       A   M	M   P	     LLLLL   EEEEE	      *
*									      *
*									      *
*		EEEEE	DDDDD	 IIIII	 TTTTT	  OOOO	  RRRRR 	      *
*		E	D    D	   I	   T	 O    O   R    R	      *
*		EEE	D    D	   I	   T	 O    O   RRRRR 	      *
*		E	D    D	   I	   T	 O    O   R   R 	      *
*		EEEEE	DDDDD	 IIIII	   T	  OOOO	  R    R	      *
*									      *
*									      *
*			V	V    2222	   3333 		      *
*			 V     V    2	 2	       3		      *
*			  V   V        22	    333 		      *
*			   V V	     22      ..        3		      *
*			    V	    222222   ..    3333 		      *
*									      *
*									      *
*******************************************************************************
*******************************************************************************
*									      *
*			 ( VERSION DE DEMONSTRATION )			      *
*									      *
*  Ce logiciel a ete programme avec: le GFABASIC v3.5e			      *
*				     l'assembleur DEVPAC v1.25  ( en DomPub ) *
*									      *
*									      *
*				Par DMVIOLATOR				      *
*									      *
*									      *
*			Ce programme est un SHAREWARE:			      *
*									      *
*      Vous pouvez le Copier, le Diffuser et le Telecharger GRATUITEMENT      *
*									      *
*			 AVEC cette DOCUMENTATION ...			      *
*									      *
*		      Il est INTERDIT de le Modifier ...		      *
*									      *
*   Si vous utilisez regulierement ce programme, versez moi une Donation ...  *
*									      *
*		Cette derniere remarque N'EST PAS FACULTATIVE !!!             *
*									      *
*******************************************************************************

QUELQUES GENERALITES:
*********************

1. STRUCTURE D'UN SAMPLE SUR ST:

Habituellement sur ST un sample  ( ou echantillon ou digitalisation )  est code
sur un octet ( 8 bits ) ce qui revient a dire qu'un sample est une variation de
volume sur 256 valeurs	( 2^8 ) a une certaine vitesse qui correspond a la fre-
quence d'echantillonnage.
Si par exemple vous echantillonez une musique de 25 secondes a une frequence de
50000 Hz, cela signifie que le volume varie 50000 fois par seconde  pendant une
duree  de 25 secondes, ce qui signifie aussi que 50000 x 25 = 1 250 000 octets,
c'est a dire 1.20 MegaOctets !! Donc, plus la frequence est elevee, plus le sam
ple est gourmand en mmoire.
Ce paragraphe paraitra peut-etre superflu pour	quelques-uns, mais il s'agit de
base elementaire !!


2. BUT DE CE PROGRAMME:

J'ai ecrit ce programme  dans le but de  " bidouiller "  les differents samples
provenant de jeux, de musique soundtrack ou de demos.
Ce programme  n'a pas du tout la pretention  de rivaliser avec ses semblabes du
commerce, mais il offre quand meme quelques options interressantes...


3. AVERTISSEMENT:

Ce programme sera toujours perfectible. Si vous avez des idees pour l'ameliorer
ou si vous  trouvez des bugs ou quoiquesoit, n'hesitez pas a  me contacter pour
faire part de vos critiques sur:     3614 TEASER Bal DMVIOLAT
				     3615 STMAG  Bal DMV ou DMVIOLATOR


DESCRIPTION DES COMMANDES DU PROGRAMME:
***************************************

Apres  avoir charge le programme, vous avez a l'ecran une page de presentation.
Pressez une touche ou cliquez pour en sortir.
L'ecran devient noir  ( Il en sera ensuite toujours ainsi  lorsque l'ordinateur
dessinera  l'ecran )  et l'ecran principal apparait.
Vous  pouvez  travailler  avec 9 samples  simultanements. Voici  les differents
elements presents a l'ecran:
. Le numero du Sample			 ( en Haut a Gauche )
. La representation du sample		 ( partie Superieure de l'ecran )
. La ligne d'information du sample       ( en dessous )
. La boite de communication		 ( partie Inferieure de l'ecran )

A tout moment, vous  pouvez:
. Quitter le programme			 ( ESC ou clic sur numero du sample )
. Changer de sample			 ( Pave numerique de 1 a 9 )
. Acceder au menu d'aide                 ( HELP )
. Voir les caracteristiques des samples  ( CONTROL )
. Rejouer les samples			 ( RETURN )
. Afficher/Effacer les boites d'icones   ( clic droit )
. Raccourci clavier			 ( touches de fonction F1 a F10)


INFO:				    ( F1 )
******************************************

Affiche les infos sur le programme


SOUS-MENU DISQUE:		    ( F2 )
******************************************

1. ACCESSOIRES: 	(F1)

Permet d'utiliser les accessoires presents en memoire

2. LOAD SAMPLE: 	(F2)

Permet de charger  un sample en memoire. S'il y  a deja un sample, le programme
vous propose soit de l'effacer soit de charger le nouveau sample  a la suite de
l'ancien  ( MERGE ).

Vous pouvez charger un sample de deux faons:
. Sous forme de fichier  ( c'est la facon la plus courante: 99% des cas )
. Sous forme de pistes

Je n'expliquerai pas la premiere  option, pour la bonne raison qu'il n'y a rien
expliquer !!
Examinons la deuxieme option: Imaginez qu'un programmeur de jeu ou de demo plu-
tot que de sauvegarder	un sample sous forme de fichier, le sauve sur une suite
de pistes.
Pour etre plus clair, prenons comme exemple  " LES VOYAGEURS DU TEMPS ", un jeu
carrement genial edite par  " DELPHINE SOFTWARE ". Les heureux possesseurs d'au
moins 1 Mega  de memoire et d'un STE peuvent  profiter de musiques digitalisees
pendant  le jeu. Ces musiques sont sauvegardees sur la deuxieme  face de chaque
disquette. Vous devez donc indiquer les parametres suivants:

	       . Nombre de secteurs par piste:	 10	 ( 1  11 )
	       . Nombre de face(s):		  1	 ( 1 ou 2 )
	       . Numro de face:		  1	 ( 0 ou 1 )
	       . Piste de depart:		  0	 ( 0  81 )
	       . Nombre de pistes:		 79	 ( 1  82 )

Et voila chargees les superbes musiques du jeu !!
Il faudra ensuite les signer, mais nous verrons cela plus loin...

3. MULTIPLE LOAD:	(F3)

Si vous voulez	charger plusieurs  samples dans les differents	buffers, prenez
cette option, selectionnez vos fichiers et terminez par ANNULER.

4. SAVE SAMPLE: 	(F4)

Cette option permet de sauvegarder le sample edite sur disquette.

5. MULTIPLE SAVE:	(F5)

Cette option sauvegarde  le contenu des 9 buffers ( ceux dont la taille est non
nulle ) avec leur nom et l'extension .SPL

6. SAVE ALL MEMORY:	(F6)

Imaginez qu'une erreur ce produise. Le systeme de gestion d'erreur du programme
va  vous demander si vous voulez quitter ou recommencer. Si  vous choisissez la
deuxieme  option, le programme reprendra depuis le  debut et reinitialisera les
tailles des 9 sample a 0 octets.
Si vous voulez quand meme recuperer le contenu des 9 buffers au moment du plan-
tage, cette option va sauvegarder TOUTE la memoire du programme dans un fichier
que vous pourrez ensuite recharger.
En effet, lorsque vous effacez un sample ou que le programme  plante et repart,
la memoire n'est jamais efface, seule les tailles  de sample sont modifiees. Il
y a donc de fortes chances  que vous puissiez recuperer des  samples avec cette
option.

7. DELETE FILE: 	(F7)

Cette option permet d'effacer un fichier.

8. FORMAT A DISK:	(F8)

Cette option permet de formater une disquette en double ou simple face et ecrit
un petit  texte dans le bootsecteur. Le bootsecteur produit n'est  ni un Virus,
ni un AntiVirus et n'est pas executable.
Une petite erreur se produit a la fin de la routine de formatage lors de l'ecri
ture des 2 FATs: il s'agit des caprices du BIOS. Lors de l'erreur, selectionnez
ABANDONNER et le formatage se terminera correctement.


SOUS-MENU OUTIL:		    ( F3 )
******************************************

1. SIGNER SAMPLE:	(F1)

Il existe deux facons  de stocker un sample en memoire: les octets peuvent etre
signes ou non, les variations de volume sont donc de 0  255 ou de -128  127.
Le STE et la routine pour STF utilisent des musiques signees. Donc, il faut con
vertir les samples sinon l'ecoute sera fortement parasitee.


2. MODIFIER FREQUENCE:	(F2)

Cette option permet de changer la frequence d'un sample  ( pour l'adapter a une
frequence STE par exemple ). Vous devez entrez la frequence de	depart et celle
de fin.
Un conseil: pour eviter de perdre de la qualite, la frequence de  fin doit etre
inferieure a la frequence de depart.


3. INVERSER SAMPLE:	(F3)

Cette option inverse le sample et vous permet de le sauver.


4. EFFACE SAMPLE:	(F4)

Cette option efface le sample edite ou tous les samples.


5. PREFERENCES: 	(F5)

Cette option permet de regler quelques gadgets.
Cliquez dans les differentes cases pour les activer.


6. LOAD MODULE: 	(F6)

Il s'agit d'une fonction tres interressante ( a mon avis )  qui permet de recu-
perer les samples de  musiques soundtrack sous forme de module. Les formats re-
connus sont:
		     . Les modules TCB TRACKER ( programme par AN COOL )
		     . Les modules AMIGA 15 instruments
		     . Les modules AMIGA 31 instruments

Apres avoir charge un module, vous pouvez  " zapper "  entre les differents sam
ples, les sauvegarder soit sur disquette, soit dans un des 9 buffers de sample.
En pressant la touche HELP vous obtenez la liste des samples.
Pour ecouter ces samples, ainsi que dans le menu BLOC, pour une question de pra
tique on peut rejouer les samples avec les touches:

PLAYBACK       de 1 a 16 kHz:  Q, S, D, F, G, H, J, K, W, X, C, V, B, N, ?, .

DMA STE:		 MONO	      STEREO
	     6258	 A	      T
	    12517	 Z	      Y
	    25033	 E	      U
	    50066	 R	      I


7. CHANGE NOM:		(F7)

Cette option permet de changer le nom du sample edite.


FONCTION BLOC:			    ( F4 )
******************************************

Certaines fonctions ne sont pas encore programmees...
Le principe  des blocs est simple: sur chaque  sample, vous pouvez definir deux
barres	de bloc, et  le bloc est la portion  de sample comprise  entre les deux
barres.
Pour changer la position des barres, vous avez deux possibilites:
  . Par les cases munies de fleches en bas de l'ecran: le pas d'incrementation
    est different selon le bouton de la souris utilise.
  . Si vous  rentrez dans le graphe, le curseur de la souris  se transforme en
    croix.Positionnez-vous sur l'une des deux barres: le curseur se transforme
    en main. Cliquez et  maintenant vous pouvez  diriger la barre a la souris.
    Pour fixer la barre, cliquez une deuxieme fois.
Pour rejouer les samples, vous pouvez presser RETURN, mais cette  methode etant
assez  lente, il est  aussi possible de rejouer directement les blocs  avec les
decrites dans la fonction 'LOAD MODULE'.
Les  autres fonctions de bloc sont  faciles a comprendre et je vous  laisse les
decouvrir par vous meme.


FONCTION CALEPIN:		    ( F5 )
******************************************

Elle permet de changer de sample comme les touches du pave numerique.


FONCTION REPLAY:		    ( F6 )
******************************************

Que de boutons me direz-vous en selectionnant ce sous-menu...
Il suffit de cliquer dans les differentes cases pour rejouer les samples.
Les routines PLAYBACK  ( ecrite par Tristan Hunting )  et DMA STE utilisent des
samples signes; alors que la routine de STREPLAY utilise des samples non signes
De plus, il  est impossible de	stopper la routine de STREPLAY une fois  que la
reproduction a commencee.
L'option  SIGNE  permet de signer le sample pour jongler d'un mode  de replay a
l'autre.

L'option BLOC permet de prendre en compte les barres de bloc.

Les options COUNTER et LOOP ne fonctionnent qu'en mode STE.


ETAT DES 9 BUFFERS:	       ( CONTROL )
******************************************

Sur STE l'ecran scrolle vers le bas; sur STF, l'ecran s'affiche directement.
Vous pouverz voir pour chaque sample:
   . son Nom
   . sa  Taille
   . son Adresse Memoire
Et en prime, la memoire libre...


ECRAN CACHE:			       ???
******************************************

A vous de trouver son emplacement et son contenu...


THE END:
******************************************

N'oubliez pas que je suis ouvert a toute critique ( constructive ), alors n'he-
sitez pas a me contacter...
J'espere que ce logiciel vous  satisfera; je pense que pour un logiciel  DomPub
il n'est vraiment pas mal et je vous laisse l'essayer en toute tranquilite...
N'oubliez pas de verser votre  contribution  ( meme modeste )  car ce programme
m'a demande beaucoup de travail...


PUBLICITE:
**********

Si vous recherchez des Logiciels, Demos ou Musiques en DomPub pour pas cher, je
tiens une mini Librairie DomPub avec des prix fous !!!
Vous pouvez composer  vos disquettes pour n'obtenir que les  logiciels qui vous
interressent  ( cela parait  normal mais apparemment  ca ne l'est  pas pour les
les autres distributeurs de DomPub ).
Chaque disquette coute 20 FF frais de port compris.

Pour me contacter:	   3614 TEASER Bal DMVIOLAT
			   3615 STMAG  Bal DMV ou DMVIOLATOR

			   DMVIOLATOR
			   29 Av REPUBLIQUE
			   37230 FONDETTES

****************************************** FIN DE TRANSMISSION ****************
