****************************************************************************
			DOCUMENTATION DE MP_STE.PRG
****************************************************************************


    Player de fichiers Quick Time (du Mac), AVI (du PC) images et sons,
    FLI/FLC/FLH, GIF (du PC), DL (?), SEQ, PI1+DLT, FLM/FLM ‚tendu et
			    CDH/CDL (de l'Atari).
		  Maker de fichiers MOV (images & son!)
		  Maker de fichiers MOV en QuickTime VR/1
		  Maker de fichiers AVI (images & son!)
	                  Maker de GIF anim‚s
	          Maker de fichiers FLM (images & son!)
          Convertisseur AVI/MOV/FLI/FLC/FLH en FLM sonoris‚s

Auteur:

TELLO Guillaume
240 rue Estienvrin
49260 Montreuil Bellay
	FRANCE

Email: gtello@wanadoo.fr
tel: (02) 41 38 71 48 (Filtrage d'appels).

******* Shareware **********

 	Pour vous enregistrer, un cheque de 50 francs (pour la France) ou
un billet de 50 francs dans une enveloppe (pas d'eurocheques, pas de
monnaies etrangeres: ma banque se sert un peu trop au passage).

	Limitations de la version Shareware:
	VOIR EN FIN DE DOCUMENT

****************************

		PRESENTATION GENERALE
		*********************

Possibilit‚s:
¹¹¹¹¹¹¹¹¹¹¹¹¹
	1) Permet de cr‚er une animation MOV (Quick Time) … partir d'une
s‚rie d'images, d'un son ‚ventuel et d'un fichier BATCH de commande:
		- images TGA2 24 ou 16 bits -> compress‚s en RLE16
		- images IMG ('ximg', 256 couleurs) -> en RLE8
		- sons AVR, 8/16 bits, mono/st‚r‚o
		- sons WAV, 8/16 bits, mono/st‚r‚o
		- extension QuickTime VR/1 pour Video Interactive.
	(voir fichiers BATCH, SLIDSHOW.FRA)

	2) Permet de cr‚er une animation AVI (Video for Windows) … partir
d'une s‚rie d'images, d'un son ‚ventuel et d'un fichier BATCH de commande:
		- images IMG ('ximg', 256 couleurs) -> en RLE8
		- sons AVR, 8/16 bits, mono/st‚r‚o
		- sons WAV, 8/16 bits, mono/st‚r‚o
	(voir fichiers BATCH, SLIDSHOW.FRA)

	3) Permet de cr‚er une animation GIF 89a … partir d'images GIF 87
ou 89 uniquement.
		- extension M_PLAYER pour le nombre d'images
		- extension DELAY pur le temps entre deux images
		- extension NETSCAPE pour la r‚p‚tition de l'animation
	(voir fichiers BATCH, SLIDSHOW.FRA)

	4) Permet de cr‚er une animation FLM ‚tendu … partir d'images ST
Basse et d'un son:
		- images DEGAS PI1: 320x200x16
		- images NEO: 320x200x16
		- son AVR ou WAV (fr‚quences DMA +/-2%, 8 bits mono/st‚r‚o)
	(voir fichiers BATCH, SLIDSHOW.FRA)

	--- EN ST Basse ---
	5) Permet de convertir une animation MOV/AVI avec le son ou
FLI/FLC/FLH en FLM ST Basse sonoris‚ pour un gain de vitesse consid‚rable
(puisque de toutes fa‡ons l'animation sera affich‚e en ST Basse, autant
qu'elle le soit par avance).
		- FLI/FLC/FLH sauv‚s avec leur synchro d'origine (ceci est
		d‚sactivalble)
		- MOV/AVI sauv‚s avec leur synchro et leur son d'origine
		(d‚sactivables ‚galement).

	--- EN ST Haute ---
	5bis) Permet de convertir une animation MOV/AVI avec le son ou
FLI/FLC/FLH en FLM ST Haute sonoris‚ pour un gain de vitesse consid‚rable
(puisque de toutes fa‡ons l'animation sera affich‚e en ST Haute!!)

	6) Rejoue 12 types d'animations:
	- *.MOV (Quick Time)
		- images compress‚es en:
			 CVID (yuv compress‚)
			 RLE1, RLE2 (gris et coul), RLE4 (gris et coul),
			 RLE8 (gris et coul), RLE16, RLE24, RLE32
			 SMC8 (gris et coul)
			 RAW1, RAW2 (gris et coul), RAW4 (gris et coul),
			 RAW8 (gris et coul), RAW16, RAW24, RAW32
			 RPZA (15 bits)
			 WRLE (256 couleurs)
			 MSVC8 (gris et coul), MSVC16
			 YUV2, YUV9, YVU9 (yuv non compress‚)
		- son mono/st‚r‚o en 8 ou 16 bits au format TWOS ou RAW
		- synchronisation image/son d‚sactivable
		- son d‚sactivable

	- *.AVI (Video for Windows)
		- images compress‚es en:
			 CVID
			 CRAM8, CRAM16
			 MSVC8, MSVC16
			 RLE8
			 RGB8
			 YUV9, YVU9
			 (Pas de IV32, la licence coute $5000 et appartient
			 … Intel, moins on s'en sert, mieux c'est!)
		- son mono/st‚r‚o en 8 ou 16 bits
		- synchronisation image/son d‚sactivable
		- son d‚sactivable

	- *.FLI/FLC/FLH (Autodesk Animator)
	- *.SEQ 	(Cyber Paint)		Pas en monochrome
	- *.PI1 + *.DLT	(Cyber)			Pas en monochrome
	- *.FLM		(Kinetic Microsystems)  Pas en monochrome
	- *.FLM		(Lexicor)
	- *.DL		(types 1 et 2)
		- images seulement
		- vitesse normale ou maxi
		(pour les PI1 + DLT, il faut choisir l'image PI1, ensuite,
		le fichier DLT doit avoir le meme nom et se trouver dans
		le meme r‚pertoire: c:\ESSAI.PI1 et c:\ESSAI.DLT)

	- *.FLM (version FLM Lexicor ‚tendue)
		- images 320x200x16, 640x480x16 ou 640x400x2
		- son DMA 8 bits mono/st‚r‚o … 12017, 25033 ou 50066 KHz
		- timing ind‚pendant de chaque image

	- *.FLM		(Video Master V1.0)	Pas en monochrome
		- images 160x100x16 (VMAS)
		- son 8 bits, mono, toutes fr‚quences

	- *.GIF	(Compuserve, 87a et 89a)
		- synchro ou non avec les delais (version GIF89a)
		- le nombre d'images n'est pas affich‚, sauf si
		l'animation contient l'extension M_PLAYER.

	- *.CDH/*.CDL (CD Stratos)		Pas en monochrome
		- images monochrome (CDH) tenant dans 640x400
		- images 16 gris (CDL) tenant dans 320x200
		- son DMA mono 8 bits 12516Hz

	- *.BAT (Batch Files pour slideshow):
		- langage trŠs simple permettant d'afficher une s‚rie
		d'images (boucles possibles)
		- formats reconnus:
			TGA2 non compress‚ (vos cr‚ations POV par exemple)
			IMG ('XIMG' et 256 couleurs)
			GIF (87a ou 89a, 256 couleurs maxi)
			PI1 (DEGAS 320x200x16)
			NEO (Neochrome 320x200x16)
		d'autres formats seront ajout‚s par la suite.
		(voir SLIDSHOW.FRA)


Mat‚riel requis:
¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹

	Machine
	~~~~~~~

	- STF/Mega STF:	le Yamaha est utilis‚ pour le son...
	- STE/Mega STE: le son est en DMA!
	- TT sans carte graphique: son DMA
	- Falcon en ST haute ou basse: son DMA
	- PC + PaCifiST (GRAND ‚mulateur ST sous DOS)

	(Pour le TT et le Falcon, la version 68030 M_PLAYER.PRG est plus
indiqu‚e puisqu'elle permet d'obtenir des affichages jusque dans le mode
High Color 16 bits).

	SystŠmes sonores support‚s:
	- Son DMA (TT,STE, Mega STE, Falcon)
	- Yamaha PSG (tout ST)
	- Cartes sons:
		* ST Replay 16
		* ST Replay 8
		* MV 16
	(Voir Ý 'Choix du systeme sonore')


	Affichage:
	~~~~~~~~~~

	MP_STE supporte les ‚crans monochrome ou couleur.

	--- En couleur ---
	Toutes les animations sont affich‚es en ST basse en utilisant 16
niveaux de gris pour les fichiers ayant plus de 16 couleurs (256, 32768,
65536 ou 16 millions) ou en utilisant 16 couleurs pour les autres
animations (SEQ, FLM, DLT, MOV-RAW4,RLE4).
	Le programme peut ˆtre lanc‚ dans un autre mode graphique pour peu
que la bascule vers 320x200x16 soit possible (par exemple en ST Moyenne
sur ST ou n'importe quelle resolution sur TT).
	Un mode de r‚duction de palette existe et permet d'afficher en 16
couleurs les animations dont la palette est de 256 couleurs. Voir le Ý
'Reduction de palette' (option absente dans la version d‚mo).

	--- En monochrome ---
	Toutes les animations ayant 256 couleurs minimum sont affich‚es en
ST Haute en utilisant un algorithme de dithering rapide. Celles ayant
moins de 256 couleurs ne sont pas support‚es pour l'instant (sauf le FLM
en ST Haute).

        M‚moire:
        ~~~~~~~~

        A priori un ST(E) avec 1Mo devrait ˆtre suffisant pour pas mal
d'animations, avec ceci que dans MP_STE, le son n'est pas en
direct-to-disk, il est charg‚ en entier avant le d‚but de l'affichage
(question de vitesse lors de l'animation). De ce fait, 2Mo me semblent
plus confortables pour les petites animations avec du son, mais 4Mo seront
les bien venus.

	Disques:
	~~~~~~~~

	Encore une fois, des disquettes sont suffisantes, mais sur presque
tous les formats les images sont charg‚es une … une lors de l'animation,
ce qui avec des disquettes ralentit consid‚rablement le programme. Donc un
disque dur est fortement conseill‚.


			M I S E   E N   M A R C H E
			***************************

Les fichiers
¹¹¹¹¹¹¹¹¹¹¹¹
	MP_STE.PRG	; le programme
	MP_STE.RSC	; son interface (… mettre dans le mˆme dossier!)
	MP_STE.FRA	; utile au moins une fois
	HISTORIC.TXT	; le journal du programmeur
	SLIDSHOW.FRA	; les fichiers batch, le MOV-Maker, le GIF-Maker
	COMMANDS.FRA	; les options de la ligne de commande (en mode TTP)
	FORMATS.FRA	; infos sur les extensions FLM et GIF

Lancement
¹¹¹¹¹¹¹¹¹

	Choisir le fichier … rejouer
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	MP_STE peut se lancer en programme (PRG) mais ‚galement en
accessoire, pour ceci il suffit de le renommer MP_STE.ACC et de le copier
dans la racine du disque de Boot. Dans tous les cas, MP_STE.RSC doit ˆtre
log‚ dans le mˆme r‚pertoire.
	Il peut ‚galement ˆtre lanc‚ en TTP ou GTP avec une ligne de
commande (voir COMMANDS.FRA).

	Le nom du fichier peut ˆtre un masque: *.MOV ou mˆme *.* pour
rejouer plusieurs animations du mˆme r‚pertoire.

	Infos de la premiŠre boite de dialogue
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	Elle indique le nom du fichier, les dimensions de l'animation (ou
'No Graphics found' si elle n'en contient pas) ainsi que le nombre
d'images (sauf sur les GIFs ou l'information n'est pas toujours
disponible).
	Elle indique ‚galement les paramŠtres du son (ou 'No sound' si il
n'y en a pas).

	Les graphiques ou les sons peuvent ˆtre 'Supported' (connus de
MP_STE) ou 'Unsupported' (inconnus, donc non rejouables). Ceci est
‚galement indiqu‚.

	R‚glages dans cette boŒte
	~~~~~~~~~~~~~~~~~~~~~~~~~

	Le bouton [R] en haut permet de rejouer l'animation en boucle
(avec ou sans le son).

	Pour les AVI/MOV/GIF/FLM sonores on obtient deux boutons:
	[] Play Sound
	[] Synchronise

	qui permettent de rejouer le son ou non, de synchroniser ou non
l'image avec la dur‚e pr‚vue par le cr‚ateur du fichier.
	Il faut savoir que la synchronisation conduit, sur des machines
lentes, … sauter des images pour suivre la cadence. Avec 8Mhz, il est
parfois pr‚f‚rable d'oter la synchro (l'image durera plus longtemps que le
son, mais l'affichage aura ‚t‚ de meilleure qualit‚). Ceci n'est plus vrai
avec les FLM sonoris‚s qui 'boostent'.

	Pour les autres on obtient deux radio-boutons:
	[] max speed
	[] xxx frames/sec

	Max speed permet de rejouer toutes les images sans d‚lai d'attente
entre elles. xxx frames/sec permet de limiter la vitesse … xxx images par
seconde, celle qui ‚tait pr‚vue par le cr‚ateur du fichier. Si la machine
est lente, ces deux options conduisent au mˆme r‚sultat puisqu'aucune
image n'est saut‚e.

	Lancer l'animation
	~~~~~~~~~~~~~~~~~~

	Le bouton 'GO!' lance l'animation avec les r‚glages demand‚s.
	Si le bouton affiche '(Alt) GO!', c'est qu'en maintenant Alt
appuy‚ en cliquant sur ce bouton on obtient une fonctions particuliŠre:
	Fichiers BATCH:
	- au lieu du SlideShow des images on cr‚e l'animation MOV ou GIF
	Fichiers MOV/AVI/FLI/FLC/FLH:
	- au lieu de l'animation, on lance une conversion de cette
	animation vers du FLM sonoris‚ ('Play Sound' permet d'ajouter ou non
	le son au FLM, 'Synchronize' ou 'xxx frames/sec' permettent de
	conserver les informations de timing dans le FLM).

	QuickTime VR/1
	~~~~~~~~~~~~~~

	Ces fichiers sont une s‚rie de plans dans lequelle on se d‚place …
l'aide des 4 flŠches du curseur: la boite de dialogue vous indique les
mouvements autoris‚s: verticalement, horizontalement ou les deux. Lors de
l'animation, l'appui simultan‚ de SHIFT et d'une flŠche acc‚lŠre le
mouvement.

	Fin de l'animation
	~~~~~~~~~~~~~~~~~~

	GIF: Control arrˆte l'animation, Shift arrˆte en fin de boucle une
	animation qui boucle.

	Autres: Control arrˆte l'animation.

	Infos de la deuxiŠme boŒte de dialogue
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	Ce sont des statistiques sur la vitesse d'affichage, le
pourcentage d'images r‚ellement affich‚es, le temps total:
	* Total frames:	nombre total d'images
	* Frames displayed: nombre d'images affich‚es (100% sans la synchro,
parfois moins si l'image a du suivre le son)
	* Total time: temps qu'a dur‚ l'animation (en secondes)
	* Average: nombre moyen d'images (frames) par seconde.

	Choix du systŠme sonore
	~~~~~~~~~~~~~~~~~~~~~~~

	Pour basculer dans la liste des systŠmes sonores support‚s, il faut
faire 'Shift' + Clic sur le bouton 'Info.../ ^ Sound' ou 'Shift' + Clic sur
la boŒte d'infos elle mˆme.
	Choisissez ensuite le systŠme dont vous disposez!
	Si l'un des systŠmes est d‚tect‚ comme absent (le DMA grƒce … son
cookie par exemple), l'option est gris‚e.

	Pour que votre systŠme sonore soit celui par d‚faut, il suffit de
cliquer sur 'Save and Exit' et le fichier RSC sera mis … jour avec votre
r‚glage.

	Le meilleur systŠme est le DMA (consomme 0% du temps de la machine),
ensuite on trouve les cartes son (26% du temps sur un STE 8MHz avec
ST_Replay_16), puis finalement le PSG Yamaha (35% du temps sur un STE 8Mhz).


Programm‚ en quoi?
¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹
	Le programme est entiŠrement en assembleur 68000, d‚velopp‚ avec
ASSEMBLE de chez Brainstorm. Ce programme est une traduction de
M_PLAYER.PRG qui est un player True color pour Falcon/TT+carte d‚velopp‚
en assembleur 68030.
	(M_Player s'est inspir‚ des sources en C de Dieter Fiebelkorn qui
lui mˆme s'est inspir‚ des sources en 'C' pour PC de XANIM de Mark
Podlipek).

Les limites de MP_STE
¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹

	Les fr‚quences des sons
	~~~~~~~~~~~~~~~~~~~~~~~

	Les fichiers PC ou MAC ont des fr‚quences qui sont souvent
11025Hz, 22050Hz et 44100Hz (ou … peu prŠs, j'ai tol‚r‚ un ‚cart de 2%).
Le DMA de l'Atari ne comprend que 12517Hz, 25033Hz et 50066Hz. A chaque
chargement du son je le convertis pour l'amener aux fr‚quences voulues (en
fait tous les 8 octets je r‚pŠte le 8Šme, avec la correspondance 8->9 on
obtient une trŠs bonne approximation des valeurs de l'Atari.
	Si il nexiste pas de circuit DMA, le son est rejou‚ syst‚matiquement
… 9,6KHz sous interruption (correspondance 8->7 depuis les sons PC) et
toujours en mono.
	Si un son n'est pas jou‚ (et pourtant 'Supported'), c'est un manque
de m‚moire. Le choix du Yamaha au lieu du son DMA est alors judicieux, par
exemple:
	DMA: 1 seconde en 8 bits stereo 25033Hz = 50066 octets
	PSG: 1 seconde en 8 bits mono et 9600Hz =  9600 octets!

	La taille des images en couleur
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	L'‚cran ‚tant en 320x200:
	- toute animation en dessous de 320x200 est affich‚e telle quelle
	- si la largeur est sup‚rieure … 320, elle est r‚duite de moiti‚
	dans la largeur ET la hauteur (pour compenser les proportions)
	- si la hauteur est sup‚rieure … 200, seule la partie centrale est
	affich‚e

	Exemples:
		320x240	-> on ne verra que les lignes 20 … 219
		640x400 -> un point sur deux et une ligne sur deux
		640x480 -> un point sur deux et une ligne sur deux entre
		les lignes 40 et 438

	Toute animation de taille jusqu'… 640x??? est affich‚e (toute ou
en partie), les autres ne permettent pas de pr‚voir le comportement de
MP_STE.

	La taille des images en monochrome
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	L'‚cran ‚tant en 640x400:
	- toute animation jusqu'… 640x400 est affich‚e telle quelle
	- si la hauteur est sup‚rieure … 400, seule la partie centrale est
	visible.

	Exceptions:
	* Fichiers DL: toujours doubl‚s … l'‚cran
	* Conversions vers FLM sonore: si l'anim est inf‚rieure … 320x200,
	elle est doubl‚e lors de la conversion.


	R‚duction de palette
	~~~~~~~~~~~~~~~~~~~~

	Par d‚faut, toute animation ayant plus de 16 couleurs est affich‚e
en 16 niveaux de gris. Pourtant, pour les animations ayant 256 couleurs, on
peut tenter de r‚duire la palette par un algorithme adapt‚.
	Les animations 'r‚ductibles' sont:
	MOV: RAW8, RLE8, MSVC8, WRLE, SMC
	AVI: RLE8, RGB8, CRAM8, MSVC8
	FLI, FLC
	DL

	Ceci est indiqu‚ … l'aide d'une flŠche dans le bouton 'Go!' qui
symbolise la touche shift. Ceci n'est pas possible sur ‚cran monochrome.

	Pour lancer la r‚duction, il faut maintenir Shift appuy‚ tout en
cliquant sur Go!. Toutes les images sont analys‚es et le nombre de couleurs
effectivement utilis‚ est affich‚. Les informations de cette analyse sont
conserv‚s en m‚moire et le resteront tant qu'une autre analyse n'a pas ‚t‚
lanc‚e.
	Ensuite, il faut relancer une deuxiŠme fois la mˆme animation en
maintenant toujours la touche Shift lors du clic sur Go!. Il y a un l‚ger
temps d'attente pendant lequel la nouvelle palette est calcul‚e, puis
l'affichage commence en couleurs.

	On peut combiner Shift et Alt lors du deuxiŠme lancement pour
sauvegarder au format FLM en couleurs!


Limitations de la version Shareware
¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹

	MOV et GIF maker
	~~~~~~~~~~~~~~~~

	Les animations cr‚es avec MP_STE contiennent une palette de gris
dans la version non enregistr‚e. Cela n'est pas gˆnant pour l'utilisation
avec MP_STE puisqu'elles seront rejou‚es en gris de toutes fa‡ons.
	Par contre, si vous comptez faire rejouer ces fichiers sur une
autre plateforme (TT+carte, Falcon, Mac, PC), vous obtiendrez encore des
niveaux de gris si le fichier a ‚t‚ cr‚‚ avec la version non enregistr‚e.
	Avec la version enregistr‚e, vos cr‚ation passeront en couleurs
sur une machine … l'affichage plus performant.

	FLM Maker
	~~~~~~~~~

	De mˆme, les animations cr‚‚es … partir d'images DEGAS ou
N‚ochrome contiennent une palette de gris dans la version non enregistr‚e.

	FLM avec son/Convertisseur de AVI et MOV
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	MP_STE d‚finit une extension du format FLM (trŠs rapide …
l'affichage) pour obtenir du son dans ces fichiers bien adapt‚s … l'Atari
ST(E). Le FLM est en ST Basse ou ST Haute selon le mode d'‚cran courant.
	On peut convertir n'importe quel AVI, MOV ou FLI/C/H en FLM
sonoris‚ pour obtenir un fichier Images et Son d'une grande fluidit‚.
	La version non enregistr‚e de MP_STE ne permet pas d'inclure les
sons dans les fichiers FLM.

	R‚duction de palette
	~~~~~~~~~~~~~~~~~~~~

	Cette option n'est pas pr‚sente dans la version demo. Il faut
s'enregistrer pour pouvoir profiter de la couleur sur les animations allant
jusqu'… 256 couleurs.

	O— trouver la derniere version?
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	Sur le WEB:
	http://perso.wanadoo.fr/gtello (page 'officielle')
	http://heml.passagen.se/atari/
	http://www.magmacom.com/~nima
	http://www.allatsea.demon.co.uk

	Site FTP:
	ftp://193.190.205.13/Archive/atari

	Les noms sont MP_STE.ZIP et M_PLAYER.ZIP (TT/Faclon).