                                *************************
                               * RIM Fractales & Rosaces *
                                *************************

------------ English follows french part ----------------------------------->

	Vous avez entre les mains la version dmo du 14/04/97 de ces modules 
destins au dossier PARX.SYS.

I Installation:
~~~~~~~~~~~~~~~
	Copier les fichiers RIM dans le dossier RIM du PARX.SYS utilis par 
vos logiciels M&E.

II Utilisation:
~~~~~~~~~~~~~~~
	L'usage de ces modules ncessite un logiciel M&E compatible (D2M, 
Dform, Piccolo, Bv4, ...). Il suffit de choisir l'option "acquisition" puis 
un des 4 modules du pack:
	Gnration fractales 1 DEMO
	Gnration fractales 2 DEMO
	Gnration fractales 3 DEMO
	Gnration rosaces DEMO  EDC

  1) Modules Fractales.
	Ils prsentent une interface commune qui s'adapte automatiquement  la 
rsolution courante. Un minimum de 420 pixels de large permet d'accder au 
formulaire le plus confortable. Le mode 65000 couleurs du Falcon permet la 
prvisualisation couleur au lieu du mode monochrome.

	Usage du formulaire:
"x0","y0","x1","y1": coordonnes de la fentre image.

"Nb": nombre d'itrations.

"Seuil": Seuil  partir duquel on considre que la suite diverge.

"Julia": Si ce bouton est coch on utilise la constante situe en dessous afin 
d'obtenir l'ensemble de Julia. Sinon on trace l'ensemble de Mandelbrot qui 
utilise comme constante le point courant du calcul.

"Re","Im": dfinissent la constante complexe utilise pour le calcul d'un 
ensemble de Julia (c=Re+iIm). Typiquement -2<Re<2, -2<Im<2.

Shift+ Flches Haut,Bas,Droite,Gauche: dplacement d'un quart de page dans la 
direction correspondante.
       Flches Haut,Bas,Droite,Gauche: dplacement d'une demi page dans la 
direction correspondante.
Cnt+   Flches Haut,Bas,Droite,Gauche: dplacement d'une page dans la 
direction correspondante.

Shift+ "+","-": zoom in,out (*1.5, /1.5)
       "+","-": zoom in,out (*2,   /2)
Cnt+   "+","-": zoom in,out (*4,   /4)

On peut choisir entre 5 palettes en cliquant sur la boite sous Julia pour la 
reprsentation de l'extrieur de l'ensemble.

La deuxime palette permet, lorsqu'on clique dessus, de cycler parmi les 5 
palettes par dfaut ou le noir (plus rapide) pour le remplissage de la surface 
fractale. 

"Ok": lance le calcul sur la taille d'image impose par la version dmo.
"Test" ou clic sur l'image: calcule un apercu en 2 passes avec indicateur de 
progression (interruption possible par Undo ou Esc).
"Exemple": cycle parmi la douzaine de paramtres d'exemple.
"Annuler": sort en erreur sans rien faire.

Fractale I
	Ce module calcule l'ensemble de Mandelbrot "classique".
^2,^3,^4: fractale du 2nd degr (les plus connues) ou cubique ou quartique.

Fractale II:
	Ce module implmente 3 nouvelles fractales: Octo,Barnsley,Phoenix.

Fractale III:
	Ce module calcule, pour chaque point, le nombre d'itrations 
ncessaires pour rsoudre z^n+c=0 par la mthode de Newton-Raphson.

n est rglable entre 3 et 5 "Newton^3","Newton^4","Newton^5".
c correspond  la constante de Julia si elle est valide.

  2) Module Rosaces.
Ce module permet,  partir de 2 paramtres, de dessiner des rosaces:
    "k": indice d'chelle ditable.
 "INC": incrment d'angle en degr ditable.

Il prsente cinq commandes:
 "Hasard": Tire les paramtres au hasard.
"Exemple": Cycle parmi une quinzaine d'exemples.
"Annuler"/"Ok": Sortent en erreur sur la version dmo.
"Test" ou cliquer sur le carr de prvisualisation: calcule un aperu de 
l'image dfinitive.

III Limitations de la dmo:
~~~~~~~~~~~~~~~~~~~~~~~~~~~
	- Les modules fractales gnrent une image de taille fixe et de 
qualit dgrade (il manque la dernire passe de calcul c'est pour cela que la 
progression s'arrte aux 3/4 ...).
	- Le module rosace ne gnre que la prvisualisation de la rosace et 
pas son calcul effectif.
	- Les versions dmos correspondent  des versions ou les calculs ne 
sont pas optimiss. Les versions commerciales sont au moins 10  20% plus 
rapides. De plus sont livres des versions spcifiques 68030 (pour Atari F030, 
C-LAB MK ou carte PAK3) encore 10% plus rapide ainsi que des versions FPU 
(pour les Atari TT et F030 dots d'un coprocesseur arithmtique (68881 ou 
68882)) de 2  10 fois plus rapides !
	- Ce descriptif est un rsum de la mini-doc fournie ;-)

IV Copyright & co:
~~~~~~~~~~~~~~~~~~~
	Tous les modules prsents dans cette archive sont des modules dmo, 
leur diffusion est libre sur tout support tant que cette documentation les 
accompagne. A part l'utilisation du principe M&E ils n'ont aucun rapport avec 
la socit PARX. Toutes les marques cites sont dposes par leurs 
propritaires respectifs.

	Pour recevoir la version complte de ces modules, envoyez un chque de 
100FF libell  Da Cunha Eric en prcisant "Pack Fractals et Rosaces" et le 
type d'Atari possd :

	   Da Cunha Eric
	 86 Rue de l'AVENIR
	21850 St Apollinaire.

	Pour tout renseignement complmentaire vous pouvez galement me 
contacter par E-mail: da-cun_e@epita.fr 

------------ Fin de la partie franaise ------------------------------------>
------------ Beginning of English part ------------------------------------->

	This is the demo version dated 97/04/14 of those modules for PARX.SYS 
folder.

I Installation:
~~~~~~~~~~~~~~~
	Copy all RIM files in the sub-folder RIM of the PARX.SYS folder used 
by your M&E programs.

II Use:
~~~~~~~
	You need a compatible M&E program (D2M, Dform, Piccolo, Bv4, ...). 
Then, choose "Acquire" and select one of the following:
	Gnration fractales 1 DEMO    - Fractals maker DEMO 1
	Gnration fractales 2 DEMO
	Gnration fractales 3 DEMO
	Gnration rosaces DEMO  EDC  - Rose Maker

I can't find a proper translation for "rosaces". The nearest I've thought 
about is [ceiling] rose so I'll use this word. Forgive me if it's inadequate 
and mail me the correct name if you can ;-)

  1) Fractals makers.
  	They share a common form which automatically fits to the screen 
resolution. 420 pixels wide is required for the more comfortable use. Falcon's 
TC16 mode (65000 colors) allows color preview instead of mono.

	A quick description:
"x0","y0","x1","y1": coordinates of graphical window.

"Nb": number of iterations.

"Seuil": "Thresold": defines when the series is diverging.

"Julia": If it's on, the following constant is used to get a Julia set. If not
the mandelbrot uses current pixel coordinates for calculus.

"Re","Im": Real and imaginary part for Julia constant (c=Re+iIm). 
Typically -2<Re<2, -2<Im<2.

Shift+ Up, Down, Right, Left arrow: moves graphical window one fourth in this 
direction.
       Up, Down, Right, Left arrow: moves graphical window half a page in this 
direction.
Cnt+   Up, Down, Right, Left arrow: moves graphical window one page in this 
direction.

Shift+ "+","-": zooms in,out (*1.5, /1.5)
       "+","-": zooms in,out (*2,   /2)
Cnt+   "+","-": zooms in,out (*4,   /4)

You can select one among 5 palettes for the outside of the fractal set by 
clicking under Julia box. The second palette (rightmost) selects one among 5 
or black (quickest to render) for the inside.

"Ok": renders the set with the size forced by this demo.
"Test" or clic on preview box: renders a 2 pass preview. 
(Undo or Esc to cancel).
"Exemple": automatically fills the form with one among twelve examples worth 
seeing.
"Annuler": "Cancel": does nothing and exits with an error.

Fractal I
	This module renders the ultra-famous Mandelbrot & Julia sets. But you 
can choose another power than 2 to get cubic or quadradic sets.

Fractal II:
	This module renders 3 different sets: Octo,Barnsley,Phoenix.

Fractal III:
	This module calculates for each point the number of iteration needed 
for solving z^n+c=0 by Newton-Raphson algorithm.

n can be choosen between 3 and 5: "Newton^3","Newton^4","Newton^5".
c is the julia constant if it's turned on.

  2) Rose maker.
This module draws roses with 2 parameters:
    "k": is the scaling factor.
 "INC": is the angle increment in degree.

There are 5 commands:
 "Hasard": "Random": choose parameters randomly.
"Exemple": "Example": automatically fills the form with one among 15 examples.
"Annuler"/"Ok": "Cancel"/"Ok": Both exits with an error on this demo.
"Test" or click in preview box: renders a preview with current settings.

III Demo limitations:
~~~~~~~~~~~~~~~~~~~~~
	- Fractals makers render a fixed size picture with a lesser quality 
(the last pass is missing what's why the progress indicator stops around 75% ...)
	- Rose maker only draws preview and not the final picture.
	- Calculations are not optimised in those demo versions. Real modules 
are at least 10% quicker. And there are also specific versions for 68030 (for 
Atari F030, C-LAB MK or PAK3 card) 20% quicker and FPU versions (for Atari TT 
and F030 with a floating point unit (68881 ou 68882)) twice or ten times 
quicker !
	- This notice is a quick summary of the small manual issued ;-)

IV Copyright & co:
~~~~~~~~~~~~~~~~~~
	All modules in this pack are demo versions and you're free to copy 
them while this documentation is included. Except the use of "M&E" they have 
no link with PARX firm. All trade marks are quoted as examples only.

	To reveive your personnalised unlimited copy of those modules, send a 
cheque of 100FF payable to Da Cunha Eric, add the mention "Fractals and Roses 
Pack (English version)" and the type of Atari you have, and send it to:

	   Da Cunha Eric
	 86 Rue de l'AVENIR
	21850 St Apollinaire.
		France

	You can also contact me by E-mail da-cun_e@epita.fr for any 
informations.
