JMath3D peut afficher divers types de fichiers. Certains comme les fichiers .obj ne contiennent que la géométrie des objets et pas d'information de mise en forme. Quand on insère l'applet dans une page web, on peut lui communiquer des paramètres de rendu.
Le paramètre le plus important est model dont la valeur est le nom du fichier à afficher. Fixer ensuite la taille de l'applet à l'écran.
Si le fichier ne contient pas d'information sur le point de vue, 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.
Code minimal sans option :
<script src="http://jmath3d.aspirine.org/download/deployJMath3D.js"></script>
<script>
var parametres = { model:"nom_fichier.obj" };
deployJMath3D.runApplet(500, 400, parametres);
</script>
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ètres de l'applet.
| nom du paramètre | valeur | par défaut | effet | exemple |
| echelle | nombre positif | 1 | facteur d'échelle à l'affichage | var parametres = { model:"nom_fichier.obj", echelle:0.8 } |
| azimut | nombre entre -π et π | ≈ π/8 | var parametres = { model:"nom_fichier.obj", echelle:"0.8", azimut:"-1.5" }; | |
| elevation | nombre entre -π/2 et π/2 | ≈ π/8 | var parametres = { model:"nom_fichier.obj", echelle:"0.8", azimut:"-1.5", elevation:"0.2" }; | |
| rotationpropre | nombre entre -π et π | 0 | Pivote la caméra sur elle-même. | var parametres = { model:"nom_fichier.obj", rotationpropre:"1.57" }; |
Azimut et élévation. Cliquer sur l'image pour manipuler l'objet en 3D.
| nom du paramètre | valeur | par défaut | effet | exemples (à insérer dans les paramètres de l'applet) |
| nomspoints | auto ou une liste de noms séparés par des espaces | aucun |
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... |
nomspoints:"auto" nomspoints:". A1 A2 B . C" |
| taillepolice | entier positif | 12 | pour les noms de points | taillepolice:"20" |
| epaisseur | nombre 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). |
epaisseur:"2.5" epaisseur:"1 0" |
| couleurfond | code de couleur HTML : #RRVVBB | blanc (#ffffff) | Ne pas mettre un fond trop foncé, les traits et noms de points étant toujours noirs. | couleurfond:"#8080ff" |
| patron | nombre entre 0 et 1 inclus,
suivi éventuellement du mot-clé curseur |
Prépare le dépliement de l'objet. Donner le coefficient d'ouverture : de 0 pour fermé à 1 pour ouvert. |
patron:".5" patron:".5 curseur" |
|
| animation | 2 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. |
animation:"0.01 0" |
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) :
couleursfaces:"plage:couleur plage:couleur plage:couleur ..."
Les plages peuvent être :
Quelques exemples de définitions de couleurs :
| 1:#d0d0d0 | La première face gris clair opaque |
| toutes:#d0d0d0,0.8 | Toutes les faces gris clair, légèrement transparentes |
| toutes:#d0d0d0 1:#ff0000 | Toutes les faces gris clair sauf la première qui sera rouge |
| 1:#ff0000 toutes:#d0d0d0 | Toutes 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:#8080ff | Les 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:#00ff00 | Les faces 1, 2, 3, 4, 5, 7, 8 et 9 en rouge, les faces 6, 7, 8, 9, 10 et 13 en vert |