Anfy Texturemapped 3d Cube - Copyright © Fabio Ciucci 1997-99.


L'applet "Texturemapped 3d Cube" permet d'afficher un cube dont les
faces sont texturées avec une images au format "GIF" ou "JPEG".

Cet applet contient du code écrit par Cristiano Tagliamonte et Martin
Zettergren, code qui est utilisé sous licence.

L'animation contenue dans le fichier "jnn.gif" a été gracieusement
offerte par "mstanya@bigfoot.com".

Cet applet est entièrement configurable, aussi pouvez-vous modifier
la taille et le mouvement du cube.

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

FICHIERS INDISPENSABLES.

Les 3 fichiers suivants, dont l'extension est ".class", doivent
obligatoirement être enregistrés sur le serveur hébergeant votre site :
"TmapCube.class",
"Lware.class",
"anfy.class".

Notez que le fichier compressé "TmapCube.jar" permet d'obtenir des temps
de téléchargement réduits avec les navigateurs les plus récents.

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

EXEMPLE.

Insérez comme suit la balise "<applet>" dans votre document HTML afin
d'ajouter l'applet "Life2d" à votre page
(les commentaires, situés après le symbole ";", ne sont que des
explications concernant le code Java ou les plages de valeurs pouvant
être affectées aux variables correspondantes. Ils ne font pas partie
des paramètres transmis à l'applet) :

<applet archive="TmapCube.jar" code="TmapCube.class" width="256" height="256">

<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="Texturemapped 3d Cube applet">
; Message affiché dans la barre d'état.

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

<param name="image1" value="face1.gif">
; Face 1.

<param name="image2" value="face1.jpg">
; Face 2.

<param name="image3" value="face2.gif">
; Face 3.

<param name="image4" value="face2.jpg">
; Face 4.

<param name="image5" value="face3.jpg">
; Face 5.

<param name="image6" value="face3.jpg">
; Face 6.

<param name="interactive" value="YES">
; Mode Interactif ("YES", "NO").

<param name="lightsourced" value="YES">
; Eclairage ("YES", "NO").

<param name="lightpower" value=95>
; Puissance de l'éclairage (1..100).

<param name="lightmin" value="10">
; Puissance minimum de l'éclairage (1..511).

<param name="lightmax" value="500">
; Puissance maximum de l'éclairage (1..511).

<param name="rotx" value="4">
; Vitesse de rotation autour de l'axe des abscisses (X).

<param name="roty" value="6">
; Vitesse de rotation autour de l'axe des ordonnées (Y).

<param name="rotz" value="8">
; Vitesse de rotation autour de l'axe de la profondeur (Z).

<param name="backimage" value="NO"> 
; Image facultative affichée à l'arrière plan.

<param name="backr" value="64">
; Composante "rouge" de la couleur affichée à l'arrière plan (codage RGB décimal : 0 .. 255).

<param name="backg" value="96">
; Composante "vert" de la couleur affichée à l'arrière plan (codage RGB décimal : 0 .. 255).

<param name="backb" value="160">
; Composante "bleu" de la couleur affichée à l'arrière plan (codage RGB décimal : 0 .. 255).

<param name="clearback" value="YES">
; Effacer l'arrière plan ou pas ("YES", "NO")

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

<param name="overimgX" value="0">
; Abscisse du coin supérieur gauche de l'image superposée à l'effet graphique (l'origine du repère est le coin supérieur gauche de la zone occupée par l'applet).

<param name="overimgY" value="0">
; Ordonnée du coin supérieur gauche de l'image superposée à l'effet graphique (l'origine du repère est le coin supérieur gauche de la zone occupée par l'applet).

<param name="memdelay" value="1000">
; Libération de la mémoire (délai : 0..9999).

<param name="priority" value="3">
; Priorité accordé à la tâche (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 décrivent la façon de modifier les paramètres.

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

Afin d'activer les paramètres "regcode", "reglink" et "regnewframe", lisez
les notes expliquant la façon de vous enregistrer auprès 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 héberge votre
site, vous pouvez utiliser les paramètres "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 fenêtre 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 fenêtre 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 fenêtre du navigateur qui contient l'applet, en éliminant tous les cadres (frames).
Vous pouvez aussi indiquer le nom d'un cadre (frame) spécifique, comme par exemple "moncadre1".

Grâce à la variable "overimg", vous êtes en mesure de préciser le nom du fichier
contenant l'image qui sera superposée à 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 affichée qu'avec
les derniers navigateurs (Netscape Navigator ou Internet Explorer en version 4 ou supérieure).
Grâce aux variables "overimgX" et "overimgY", vous pouvez positionner précisément
l'image à l'intérieur de la zone occupée par l'applet.

Vous pouvez charger jusqu'à 6 images afin de les afficher sur les faces du cube.
Si vous affectez le nom d'un même fichier au format "GIF" ou "JPEG" aux variables
correspondant aux faces du cube, chacune d'elles sera texturée avec la même image. Dans le cas contraire vous pouvez afficher 2, 3, 4, 5 ou 6 images différentes. Le meilleur choix se situe souvent entre 3 et 6 images. 

Avec 3 images différentes présentées dans le même ordre que celui indiqué ci-dessus,
il n'y a pas d'images dupliquées à l'écran à un momment donné, tout en n'ayant que
3 images à charger. Si vous désirez texturer chaque face du cube avec une image différente,
il est possible de le faire mais le temps de téléchargement de l'applet sera alors
considérablement augmenté.

Les images au format "GIF" ou "JPEG" doivent être toutes soit de 256x256 pixels,
soit de 128x128 pixels. Aucune autre dimension n'est autorisée et vous ne pouvez
pas mélanger des images de 128x128 pixels et des images de
256x256 pixels à l'intérieur d'un même applet de type "Texturemapped 3d Cube".
L'utilisation des textures de 256x256 pixels est seulement utile lorsque la taille
de la zone occupée par l'applet est supérieure à 150 pixels.

Vous pouvez mélanger des images au format "GIF" et "JPEG" dans un même cube;
ce que vous ne pouvez pas mélanger, c'est seulement les tailles des images.

"Res" détermine la résolution de l'effet. Res=1 entraîne l'utilisation de pixels
de taille normale, res=2 double la taille des pixels, etc.. Avec res = 1, la qualité
de l'image est la meilleure mais l'animation est parfois lente ; avec res = 2 ou 3,
la vitesse de l'animation sera augmentée mais au prix de la qualité de l'image.

Vous pouvez activer ou désactiver le mode interactif grâce à la variable "interactive" :
si la valeur "YES" est affecté à cette variable, les utilisateurs peuvent contrôler les
mouvements du cube grâce au pointeur de la souris.

Affecter la valeur "YES" à la variable "lightsourced" activera l'éclairage des faces
du cube ; affecter la valeur "NO" à cette variable désactivera cette fonction et les
faces seront affichées normalement.

Grâce à la variable "lightpower", vous pouvez choisir l'intensité de la source
d'éclairage, valeur à choisir entre entre 1 et 100.
Grâce aux variables "lightmin" et "lightmax", vous pouvez choisir les valeurs de
l'éclairage minimum et maximum qui sera appliqué au faces du cube, valeurs à choisir
entre 1 et 511.

Les variables "rotx", "roty" et "rotz", permettent de contrôler la vitesse de rotation
du cube.

Les variables "backr", "backg" et "backb", permettent de contrôler les composantes
"rouge", "vert" et "bleu" de la couleur affichée à l'arrière plan.

Vous pouvez afficher une image à l'arrière plan en affectant le nom du fichier
contenant l'image en question à la variable "backimage". Cette image doit être de
la même taille que celle de l'applet si res=1, la moitié de la taille de l'applet
si res=2 et ainsi de suite.

Vous pouvez désactiver la routine de rafraîchissement de l'arrière plan en affectant
la valeur "NO" à la variable "clearback".