Le tutorial de l`API Java 3D

Le Tutorial de Java 3D v1.5 (API Java 3D v1.1.2)
> traduction fr. version 0.1 <
Initiation à l’API
Java 3D™
Un tutorial pour les débutants
Chapitre 2
Création de géométries
Dennis J Bouvier / K Computing
Traduction Fortun Armel

2-i
Chapitre 2. Table des matièresInitiation à Java 3D
Le Tutorial de Java 3D
© 1999 Sun Microsystems, Inc.
2550 Garcia Avenue, Mountain View, California 94043-1100 U.S.A
All Rights Reserved.
The information contained in this document is subject to change without notice.
SUN MICROSYSTEMS PROVIDES THIS MATERIAL “AS IS” AND MAKES NO WARRANTY
OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. SUN
MICROSYSTEMS SHALL NOT BE LIABLE FOR ERRORS CONTAINED HEREIN OR FOR
INCIDENTAL OR CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS IN CONNECTION
WITH THE FURNISHING, PERFORMANCE OR USE OF THIS MATERIAL, WHETHER BASED
ON WARRANTY, CONTRACT, OR OTHER LEGAL THEORY).
THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL
ERRORS. CHANGES ARE PERIODICALLY MADE TO THE INFORMATION HEREIN; THESE
CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THE PUBLICATION. SUN
MICROSYSTEMS, INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE
PRODUCT(S) AND/OR PROGRAM(S) DESCRIBED IN THIS PUBLICATION AT ANY TIME.
Some states do not allow the exclusion of implied warranties or the limitations or exclusion of liability
for incidental or consequential damages, so the above limitations and exclusion may not apply to you.
This warranty gives you specific legal rights, and you also may have other rights which vary from state
to state.
Permission to use, copy, modify, and distribute this documentation for NON-COMMERCIAL purposes
and without fee is hereby granted provided that this copyright notice appears in all copies.
This documentation was prepared for Sun Microsystems by K Computing (530 Showers Drive, Suite 7-
225, Mountain View, CA 94040, 770-982-7881, www.kcomputing.com). For further information about
course development or course delivery, please contact either Sun Microsystems or K Computing.
Java, JavaScript, Java 3D, HotJava, Sun, Sun Microsystems, and the Sun logo are trademarks or registered
trademarks of Sun Microsystems, Inc. All other product names mentioned herein are the trademarks of
their respective owners.

2-ii
Chapitre 2. Table des matièresInitiation à Java 3D
Le Tutorial de Java 3D
Table des matières
CHAPITRE 2
CRÉATION DE LA GÉOMÉTRIE ..................................................................................................... 2-1
2-1 Le système de coordonnées de l’univers virtuel........................................................................... 2-1
2.2 Les bases de la définition d’un objet visuel ................................................................................. 2-2
2.2.1 Une instance de Shape3D définit un objet visuel .............................................................................. 2-2
2.2.2 Node Components (composants de nœud)......................................................................................... 2-4
2.2.3 Définition des classes d’objets visuels ............................................................................................... 2-5
2.3 Classes utilitaires de géométrie .................................................................................................... 2-7
2.3.1 Box....................................................................................................................................................... 2-8
2.3.2 Cone .................................................................................................................................................... 2-8
2.3.3 Cylinder............................................................................................................................................... 2-9
2.3.4 Sphere.................................................................................................................................................. 2-9
2.3.5 Plus de détails sur les primitives géométriques............................................................................... 2-10
2.3.6 ColorCube ......................................................................................................................................... 2-10
2.3.7 Exemple : création d’un simple Yo-Yo composé de deux Cones ...................................................... 2-11
2.3.8 Partie avancée: Primitive géometriques ......................................................................................... 2-15
2.4 Classes Mathématiques .............................................................................................................. 2-16
2.4.1 Les classes Point ............................................................................................................................... 2-18
2.4.2 Les classes Color .............................................................................................................................. 2-19
2.4.3 Les classes Vector ............................................................................................................................. 2-20
2.4.4Les classes TextCoord ........................................................................................................................ 2-21
2.5 Les classes Geometry.................................................................................................................. 2-21
2.5.1 La classe GeometryArray ................................................................................................................. 2-22
2.5.2 Les sous-classes de GeometryArray ................................................................................................. 2-26
2.5.3Sous-classes de GeometryStripArray................................................................................................ 2-28
2.5.4 Sous-classes de IndexedGeometryArray .......................................................................................... 2-32
2.5.5 Axis.java est un exemple d’IndexedGeometryArray ........................................................................ 2-35
2.6 Apparence et attributs................................................................................................................. 2-35
2.6.1 Le composant de nœud Appearance................................................................................................ 2-36
2.6.2 Partager les objets NodeComponent ............................................................................................... 2-37
2.6.3 Les classes d’Attribute...................................................................................................................... 2-37
2.6.4 Exemple: Élimination des faces arrières [back face culling] .......................................................... 2-42
2.7 Tests personnels.......................................................................................................................... 2-44

2-iii
Chapitre 2. Table des matièresInitiation à Java 3D
Le Tutorial de Java 3D
Blocs de références
Constructeurs du Shape3D....................................................................................................................... 2-3
Méthodes du Shape3D (liste partielle) .................................................................................................... 2-3
Aptitudes Shape3D................................................................................................................................... 2-4
Lecture de Blocs de référence .................................................................................................................. 2-4
Constructeurs de Box (liste partielle) ...................................................................................................... 2-8
Méthodes de Box, Cone, and Cylinder.................................................................................................... 2-8
Constructeurs du Cone (liste partielle) .................................................................................................... 2-9
Constructeurs du Cylinder (liste partielle)............................................................................................... 2-9
Constructeurs de Sphere (liste partielle)................................................................................................. 2-9
Méthodes de Sphere ............................................................................................................................... 2-10
Méthodes de Primitive (liste partielle) ................................................................................................... 2-15
Constructeurs de Tuple2f ....................................................................................................................... 2-17
Méthodes de Tuple2f (liste partiellle) .................................................................................................... 2-17
Methodes de Point3f (liste partielle)...................................................................................................... 2-19
ClassesColor*......................................................................................................................................... 2-20
Méthodes Vector3f (liste partielle)......................................................................................................... 2-20
Les méthodes de GeometryArray (liste partielle) ................................................................................... 2-24
Le méthodes de GeometryArray (liste partielle, prolongée)................................................................... 2-25
Constructeurs des sous-classes GeometryArray..................................................................................... 2-27
Constructeurs des sous-classes de IndexedGeometryStripArray ........................................................... 2-28
La classe Triangulator............................................................................................................................. 2-29
Résumé du Constructeur ........................................................................................................................ 2-29
Résumé de la méthode ............................................................................................................................ 2-29
Fragment de code 2-7 La méthode yoyoGeometry() créatrice de l’objet TriangleFanArray .................. 2-30
Fragment de code 2-8 méthode modifiée yoyoGeometry() ajout des couleurs ...................................... 2-31
Constructeurs de IndexedGeometryArray et des sous-classes ............................................................... 2-34
Constructeurs de IndexedGeometryArray et des sous-classes ............................................................... 2-34
Méthodes d’IndexedGeometryArray (liste partielle).............................................................................. 2-34
Le constructeur d’Appearance................................................................................................................ 2-36
Les méthodes d’Appearance (à l’exception de l’éclairage et du texturage) ........................................... 2-37
Les constructeurs de PointAttributes ..................................................................................................... 2-38
Les méthodes de PointAttributes ........................................................................................................... 2-38
Les constructeurs de LineAttributes....................................................................................................... 2-38
Les méthodes de LineAttributes ............................................................................................................. 2-38
Les constructeurs de PolygonAttributes................................................................................................. 2-39
Les méthodes de PolygonAttributes....................................................................................................... 2-39
Les constructeurs de ColoringAttributes................................................................................................ 2-40
Les méthodes de ColoringAttributes...................................................................................................... 2-40
Les Constructeurs de TransparencyAttributes........................................................................................ 2-40
Les méthodes de TransparencyAttributes ............................................................................................... 2-41
Les constructeurs des RenderingAttributes............................................................................................ 2-41
Les méthodes du RenderingAttributes .................................................................................................. 2-41

2-iv
Chapitre 2. Table des matièresInitiation à Java 3D
Le Tutorial de Java 3D
Figures et tableaux
Figure 2-1 Orientation des axes dans le monde virtuel........................................................................... 2-2
Figure 2-2 Un objet Shape3D définit un objet visuel dans le graphe scénique....................................... 2-3
Figure 2-3 Hiérarchie partielle des classes de l’API Java 3D présentant les sous-classes de NodeComponent. ...... 2-5
Figure 2-4 Hiérarchie de la classe d’utilitaires des primitives géométriques : Box, Cone, Cylinder, et Sphere ....... 2-7
Figure 2-5 Hiérarchie de la classe ColorCube, classe utilitaire de géométrie ....................................... 2-11
Figure 2-6 Graphe scénique pour ConeYoyoApp 6 ............................................................................... 2-12
Figure 2-7 Exception de parents multiples lors de la tentative de réutilisation d’un objet Cone ......... 2-13
Figure 2-8 Une image rendue par ConeYoyoApp.java ........................................................................... 2-13
Figure 2-9 Package des classes mathématiques et sa hiérarchie ............................................................ 2-16
Figure 2-10 Hiérarchie de classe Geometry ........................................................................................... 2-22
Figure 2-11 La classe Axis dans AxisApp.java crée ce graphe scénique............................................... 2-26
Figure 2-12 Sous-classes non-indexées GeometryArray........................................................................ 2-27
Figure 2-13 Sous-classes de GeometryArray ......................................................................................... 2-27
Figure 2-14 Sous-classes de GeometryStripArray ................................................................................. 2-28
Figure 2-15 Trois vues du Yo-yo ............................................................................................................ 2-29
Figure 2-16 Yo-yo avec des polygones pleins et colorés ....................................................................... 2-32
Figure 2-17 Tableaux d’index et de données pour un Cube .................................................................. 2-33
Figure 2-18 Sous-classes d’IndexedGeometryArray .............................................................................. 2-33
Figure 2-19 Un ensemble d’Appearence (appearence bundle)............................................................... 2-35
Figure 2-20 L’apparence bundle crée par le Fragment de code 2-9. ...................................................... 2-36
Figure 2-21 Plusieurs objets Appearance partageant un Node Component. ......................................... 2-37
Figure 2-22 Le bandeau tordu avec les faces arrières éliminées ............................................................ 2-42
Figure 2-23 Le ruban tordu sans élimination des faces arrières. ........................................................... 2-43
Figure 2-24 Détermination des faces avant de polygones et de bandeaux............................................. 2-44
Tableau 2-1 Valeurs par défaut d’Attribute ............................................................................................ 2-42