logo

› Paramètres

Documentation de JMath3D

Paramètres de l'applet - options de rendu

Paramètres obligatoires

Le paramètre le plus important est model dont la valeur est le nom du fichier (.obj ou autre) à afficher.
Fixer ensuite la taille de l'applet à l'écran. Par défaut, la vue est dirigée vers l'objet, dont les dimensions sont ajustées pour qu'il puisse occuper toute la place en pivotant. En pivotant autour du centre fixe, les points de l'objet décrivent des sphères, donc l'affichage se fait mieux dans une applet carrée. Cependant rien n'interdit d'utiliser une applet rectangulaire et d'avoir un affichage panoramique par exemple.

Paramètres facultatifs

Ces paramètres permettent de modifier l'apparence d'une figure. C'est surtout utile pour les figures au format .obj. Les autres formats de fichiers sont plus riches et permettent de changer directement l'apparence des figures sans passer par les paramètrs de l'applet.

On peut essayer différents paramètres dans la galerie en cliquant sur le nom des figures, par exemple pour un icosaèdre.

Position de l'observateur

nom du paramètrevaleurpar défauteffetexemple
echellenombre positif1facteur d'échelle à l'affichage <param name="echelle" value="0.8" />
azimutnombre entre -π et π≈ π/8  <param name="azimut" value="-1.5" />
elevationnombre entre -π/2 et π/2≈ π/8  <param name="elevation" value="0.2" />
rotationproprenombre entre -π et π0 Pivote la caméra sur elle-même. <param name="rotationpropre" value="1.57" />
debugn'importe quoi, même vide Affiche en temps réel les 3 angles de position. <param name="debug" value="" />

azimut élévation Azimut et élévation. Cliquer sur l'image pour manipuler l'objet en 3D.

Affichage

nom du paramètrevaleurpar défauteffetexemples
nomspointsauto ou une liste de noms séparés par des espacesaucun Les noms sont affectés aux points dans l'ordre de leur déclaration dans le fichier .obj . Un caractère . permet de ne pas donner de nom à un point.
Avec auto, les points sont nommés dans l'ordre A, B, C...
<param name="nomspoints" value="auto" />
<param name="nomspoints" value=". A1 A2 B . C" />
taillepoliceentier positif12pour les noms de points <param name="taillepolice" value="20" />
epaisseurnombre positif, pas nécessairement entier
ou 2 nombres séparés par un espace
1 Épaisseur des traits en pixels. 0 pour ne pas les afficher.
Si on donne deux nombres, le 1er concerne les traits visibles (pleins), le second les traits cachés (pointillés).
<param name="epaisseur" value="2.5" />
<param name="epaisseur" value="1 0" />
couleurfondcode de couleur HTML : #RRVVBBblanc (#ffffff) Ne pas mettre un fond trop foncé, les traits et noms de points étant toujours noirs. <param name="couleurfond" value="#8080ff" />
patronnombre entre 0 et 1 inclus, précédé éventuellement
du mot-clé ligne ou etoile et suivi éventuellement
du mot-clé curseur
etoile Prépare le dépliement de l'objet. On peut obtenir deux types de patrons, soit en etoile soit en ligne. Donner le coefficient d'ouverture : de 0 pour fermé à 1 pour ouvert. <param name="patron" value=".5" />
<param name="patron" value="ligne .5 curseur" />
animation2 ou 3 nombres entre -0.1 et 0.1 environ Le 1er nombre fait tourner l'objet vers la gauche (la droite s'il est négatif).
Le second fait tourner l'objet vers l'arrière (l'avant s'il est négatif).
Choisir des nombres assez petits, de l'ordre de 0.03.
Le troisième commande l'ouverture du patron. Il n'est pris en compte que si le paramètre patron a été utilisé. ±0.03 est une bonne vitesse.
<param name="animation" value="0.01 0" />

Couleur des faces

Par défaut les faces sont blanches transparentes, mais on a souvent besoin de mettre certaines faces en évidence.
Le paramètre à utiliser est couleursfaces. Sa valeur consiste en une suite de déclarations, qui affectent chacune une couleur à une ou plusieurs faces (une plage en fait) :
<param name="couleursfaces" value="plage:couleur plage:couleur plage:couleur ..." />

Les plages peuvent être :

La couleur est donnée par son code HTML, le signe # (dièse) suivi de 6 chiffres hexadécimaux. On peut préciser une opacité entre 0.0 inclus et 1 exclus (1 = opaque qui est la valeur par défaut).
Les définitions de couleurs sont appliquées dans l'ordre, donc pour une face donnée seule la dernière couleur la concernant comptera.

Quelques exemples de définitions de couleurs :

1:#d0d0d0La première face gris clair opaque
toutes:#d0d0d0,0.8Toutes les faces gris clair, légèrement transparentes
toutes:#d0d0d0 1:#ff0000Toutes les faces gris clair sauf la première qui sera rouge
1:#ff0000 toutes:#d0d0d0Toutes les faces gris clair, y compris la première : pour que le rouge soit pris en compte il doit être placé à la fin.
9:#ff0000 1à5:#d0d0d0 6à8:#8080ffLes 5 premières faces en gris clair, les faces 6 à 8 en bleu clair, la 9 en rouge
1à5,7à9:#ff0000 6,10à13:#00ff00Les faces 1, 2, 3, 4, 5, 7, 8 et 9 en rouge, les faces 6, 7, 8, 9, 10 et 13 en vert