
          AnfyPlasma - Copyright  Fabio Ciucci 1996-2000


L'applet "AnfyPlasma" permet de crer et d'animer en temps rel
un effet de plasma, souvent utilis par les crateurs de dmos.
Cet applet est entirement configurable, aussi pouvez-vous crer
de nombreux types d'effets de plasma.

L'image au format "GIF transparent" contenue dans le fichier "gun.gif"
nous a t gracieusement offerte par Lone Star Posse Prod. Inc..

*************************************************************************

FICHIERS INDISPENSABLES.

Les 3 fichiers suivants, dont l'extension est ".class", doivent
obligatoirement tre enregistrs sur le serveur hbergeant votre site :
"Plasma3.class",
"Lware.class",
"anfy.class".

Notez que le fichier compress "Plasma3.jar" permet d'obtenir des temps
de tlchargement rduits avec les navigateurs les plus rcents.

*************************************************************************

EXEMPLE.

Insrez comme suit la balise "<applet>" dans votre document HTML afin
d'ajouter l'applet "Life2d"  votre page
(les commentaires, situs aprs le symbole ";", ne sont que des explications
concernant le code Java ou les plages de valeurs pouvant tre affectes aux
variables correspondantes. Ils ne font pas partie des paramtres transmis  l'applet) :

<applet archive="Plasma3.jar" code="Plasma3.class" width="192" height="192">

<param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">

<param name="regcode" value="NO">
; Code d'enregistrement (si vous vous tes enregistr indiquez le code. Dans le cas contraire indiquez "NO").

<param name="reglink" value="NO">
; Utilisation ou non d'un lien hypertexte, optionnel, activ lors d'un clic sur l'applet ("YES", "NO").

<param name="regnewframe" value="YES">
; La page correspondant au lien hypertexte "reglink" doit-elle tre ouverte dans un nouveau cadre (frame) du navigateur ("YES", "NO") ?

<param name="regframename" value="_blank">
; Nom du cadre (frame) accueillant la page correspondant au lien hypertexte "reglink" (cf. valeurs possibles dans le chapitre "INSTRUCTIONS").

<param name="statusmsg" value="Plasma applet">
; Message affich dans la barre d'tat.

<param name="res" value="2">
; Rsolution de l'effet (1-8).

<param name="gen1" value="43">
; Gnrateur 1 (8-2000).

<param name="gen2" value="31">
; Gnrateur 2 (3-256).

<param name="gen3" value="36">
; Gnerateur 3 (3-256).

<param name="red1" value="0">
; Rouge 1 (0-255).

<param name="red2" value="127">
; Rouge 2 (0-255).

<param name="red3" value="1">
; Rouge 3 (1-8).

<param name="green1" value="127">
; Vert 1 (0-255)

<param name="green2" value="127">
; Vert 2 (0-255).

<param name="green3" value="2">
; Vert 3 (1-8).

<param name="blue1" value="127">
; Bleu 1 (0-255).

<param name="blue2" value="127">
; Bleu 2 (0-255).

<param name="blue3" value="1">
; Bleu 3 (1-8).

<param name="speed" value="1">
; Vitesse (1-8).

<param name="overimg" value="NO">
; Image facultative pouvant tre superpose  l'effet graphique (nom du fichier ou NO).

<param name="overimgX" value="0">
; Abscisse du coin suprieur gauche de l'image superpose  l'effet graphique (l'origine du repre est le coin suprieur gauche de la zone occupe par l'applet).

<param name="overimgY" value="0">
; Ordonne du coin suprieur gauche de l'image superpose  l'effet graphique (l'origine du repre est le coin suprieur gauche de la zone occupe par l'applet).

<param name="memdelay" value="1000">
; Libration de la mmoire (dlai : 0..9999).

<param name="priority" value="3">
; Priorit accord  la tche (1..10).

<param name="MinSYNC" value="10">
; Synchronisation (nombre minimum de millisecondes par image : 0..999).

Your browser doesn't support Java.
; Message pour les navigateurs ne supportant pas Java.

</applet>
; Fin de la balise concernant l'applet.

***************************************************************************

INSTRUCTIONS.

Les instructions suivantes dcrivent la faon de modifier les paramtres.

Si vous tentez de modifier la valeur de la variable "credits", l'applet
sera dsactiv.

Afin d'activer les paramtres "regcode", "reglink" et "regnewframe", lisez
les notes expliquant la faon de vous enregistrer auprs de l'auteur, qui a
choisi de distribuer son logiciel en shareware.

Affectez  la variable "regcode" le code d'enregistrement qui vous a t
communiqu par l'auteur lors de votre enregistrement. Si ce code est valide,
c'est  dire s'il correspond au nom de domaine du serveur qui hberge votre
site, vous pouvez utiliser les paramtres "reglink" et "regnewframe" afin
d'ouvrir une nouvelle page lorsque l'utilisateur clique sur l'applet.

Si vous affectez la valeur "YES"  la variable "regnewframe", vous pouvez
indiquer une fentre ou un cadre (frame) pour accueillir la page correspondant
au lien hypertexte affect  la variable "reglink".
Valeurs possibles :
"_blank"  : Pour afficher la page dans une nouvelle fentre du navigateur.
"_self"   : Pour afficher la page dans le cadre (frame) dans lequel se trouve l'applet.
"_parent" : Pour afficher la page dans le cadre (frame) parent de celui dans lequel se trouve l'applet.
"_top"    : Pour afficher la page dans la fentre du navigateur qui contient l'applet, en liminant tous les cadres (frames).
Vous pouvez aussi indiquer le nom d'un cadre (frame) spcifique, comme par exemple "moncadre1".

Grce  la variable "overimg", vous tes en mesure de prciser le nom du
fichier contenant l'image qui sera
superpose  l'effet graphique produit par l'applet. Cette image est facultative.
Quant au format du fichier en question, la meilleure solution est d'utiliser
le format "GIF transparent".
Le format "GIF anim" est support, mais l'animation ne sera affiche qu'avec
les derniers navigateurs (Netscape Navigator ou Internet Explorer en version 4 ou suprieure).
Grce aux variables "overimgX" et "overimgY", vous pouvez positionner prcisment
l'image  l'intrieur de la zone occupe par l'applet.

La taille de l'applet est dtermine par les paramtres "width" et "height" de
la balise "<applet>".

La variable "res" dtermine la rsolution de l'effet graphique : avec la valeur 1
les pixels sont petits mais l'animation est assez lente. Avec la valeur 8 les pixels
sont trs gros mais l'animation est plus rapide.
Le meilleur choix se situe souvent entre 2 et 4.

A propos du gnrateur de plasma.
Grosso modo, la valeur "gen1" permet de configurer la douceur de l'effet : la valeur
minimale est 8 (effet trs doux, comme du brouillard) et la valeur maximale est 2000,
(effet psychdlique, peut-tre trop d'ailleurs !).
"Gen2" et "Gen3" dfinissent la dimension respectivement horizontale et verticale
des courbes. Les valeurs peuvent tre comprises entre 3 (nombreuses petites courbes)
 256 (une seule grande courbe).

A propos de la palette.
Il y a 3 variables pour chaque couleur code en RGB (Rouge, Vert, Bleu).
Ceci est sans doute lgrement plus compliqu qu'une seule variable mais cela vous
confre plus de flexibilit (et aussi la possibilit de crer de nombreuses palettes "bogues")
Les variables "Red1", "green1", "blue1" (RGB dcimal : 0-255) contrlent la multiplication de l'ensemble.
Les variables "Red2", "green2", "blue2" (RGB dcimal : 0-255) sont les valeurs fixes additionnes de l'ensemble.
Les variables "Red3", "green3", "blue3" (RGB dcimal : 0-255) contrlent le lissage de l'ensemble.
Ceci signifie que si red1=0 alors la variable "green3" n'a plus d'effet et toutes
les 256 couleurs auront en commun la composante "red2".

Vous pouvez exprimenter diffrents effets avec ces variables mais certaines
combinaisons dbouchent sur des palettes rellement horribles. Pour ceux qui
comprennent le mode de fonctionnement de ces palettes, voici la formule utilise
pour fabriquer une palette (r prend les valeurs comprises entre 0 et 255) :
      rouge =  (sin(r*PI*2/(256/red3  ))*red1  )+red2
      vert  =  (sin(r*PI*2/(256/green3))*green1)+green2
      bleu  =  (sin(r*PI*2/(256/blue3 ))*blue1 )+blue2

Dans tous les cas, aucune valeur de composante de couleur dpassera 255.

La vitesse, dont la valeur varie de 1  8, est utile lorsque vous crez des effets
de plasma de grandes dimensions. Dans ce cas, vous pouvez lgrement augmenter
cette valeur mais l'effet de plasma ne sera pas rellement plus rapide ; il "sautera"
seulement quelques images.

Ceci entrane parfois l'apparition de clignotements et une diminution de l'effet
de lissage appliqu  l'animation (pour les machines les plus rapides). Aussi utilisez
la valeur 1 lorsque c'est possible et ne dpassez pas la valeur 4.
