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 3
Création facile de volumes
Dennis J Bouvier / K Computing
Traduction Fortun Armel

3-i
Chapitre 3. 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.

3-ii
Chapitre 3. Table des matièresInitiation à Java 3D
Le Tutorial de Java 3D
Table des matières
CHAPITRE 3
CRÉATION FACILE DE VOLUMES ................................................................................................ 3-1
3.1 Contenu de ce chapitre ................................................................................................................. 3-1
3.2 Les chargeurs ................................................................................................................................ 3-2
3.2.1 Exemple simple d’utilisation d’un chargeur. ..................................................................................... 3-2
3.2.2 Chargeurs du domaine publique........................................................................................................ 3-4
3.2.3 Interfaces du package Loader et classes de base .............................................................................. 3-5
3.2.4 Écriture d’un Loader .......................................................................................................................... 3-7
3.3 GeometryInfo ................................................................................................................................ 3-8
3.3.1 Exemple de GeometryInfo simple ....................................................................................................... 3-9
3.3.2 Classes pour GeometryInfo.............................................................................................................. 3-10
3.4 Text2D ........................................................................................................................................ 3-14
3.4.1 Exemple simple de Text2D ................................................................................................................ 3-15
3.4.2 Les classes utilisés dans la création d’objets Text2D...................................................................... 3-16
3.5 Text3D ........................................................................................................................................ 3-17
3.5.1 Exemple de simple Text3D ................................................................................................................ 3-17
3.5.2 Les classes utilisées dans la création d’objets Text3D .................................................................... 3-20
3.6 Background................................................................................................................................. 3-24
3.6.1 Exemples de Background .................................................................................................................. 3-25
3.6.2 La classe Background....................................................................................................................... 3-26
3.7 BoundingLeaf (terminaison de limitation) ................................................................................. 3-28
3.7.1 Classe BoundingLeaf........................................................................................................................ 3-30
3.8 User Data .................................................................................................................................... 3-30
3.9 Résumé du chapitre. ................................................................................................................... 3-31
3.10 Tests personnel ......................................................................................................................... 3-31

3-iii
Chapitre 3. Table des matièresInitiation à Java 3D
Le Tutorial de Java 3D
Blocs de références
La classe ObjectFile ................................................................................................................................. 3-3
Résumé de l’Interface com.sun.j3d.loaders.............................................................................................. 3-5
Résumé des classes de com.sun.j3d.loaders............................................................................................. 3-5
Résumé des méthodes de l’interface de Loader ....................................................................................... 3-5
Résumé des constructeurs de LoaderBase................................................................................................ 3-6
Résumé des méthodes de SceneBase (liste partielle : méthodes pour l’utilisateur de chargeur) ............ 3-7
Résumé du constructeur de SceneBase .................................................................................................... 3-8
Résumé des constructeurs de GeometryInfo ......................................................................................... 3-11
Résumé des méthodes de GeometryInfo (liste partielle) ........................................................................ 3-12
Résumé du constructeur Triangulator .................................................................................................... 3-13
Résumé de la méthode de Triangulator .................................................................................................. 3-13
Résumé du constructeur de Stripifier..................................................................................................... 3-13
Résumé de la méthode Stripifier ............................................................................................................ 3-13
Résumé des constructeurs de NormalGenerator..................................................................................... 3-14
Résumé des méthodes de NormalGenerator ........................................................................................... 3-14
Résumé du constructeur de Text2D........................................................................................................ 3-17
Résumé de la méthode de Text2D .......................................................................................................... 3-17
Résumé des constructeurs de Text3D..................................................................................................... 3-20
Résumé des méthodes de Text3D ........................................................................................................... 3-21
Résume des aptitudes de Text3D ........................................................................................................... 3-22
Résumé des constructeurs de Font3D .................................................................................................... 3-22
Résumé des méthodes de Font3D .......................................................................................................... 3-23
Résume du constructeur de Font (liste partielle) ................................................................................... 3-23
Résumé des constructeurs de FontExtrusion ......................................................................................... 3-23
Résume des Méthodes de FontExtrusion............................................................................................... 3-24
Résume des constructeurs de Background ............................................................................................. 3-27
Résume des Méthodes de Background .................................................................................................. 3-27
Résume des aptitudes de Background.................................................................................................... 3-27
Résume des constructeurs de BoundingLeaf ......................................................................................... 3-30
Résume des Méthodes de BoundingLeaf ............................................................................................... 3-30
Méthodes de SceneGraphObject (Liste partielle - Méthodes d’User Data) ......................................... 3-31

3-iv
Chapitre 3. Table des matièresInitiation à Java 3D
Le Tutorial de Java 3D
Figures et tableaux
Figure 3-1 Recette pour l’usage d’un chargeur. ....................................................................................... 3-3
Figure 3-2 Un polygone GeometryInfo et une triangulation possible...................................................... 3-8
Figure 3-3 Deux rendus de la voiture (présentés dans des directions opposées) crées en utilisant GeometryInfo.
........................................................................................................................................................3-9
Figure 3-4 Hiérarchie de classe de la classe utilitaire GeometryInfo, et des classes apparentées. ........ 3-10
Figure 3-5 La recette de Text2D............................................................................................................. 3-15
Figure 3-6 Image de Text2DApp.java..................................................................................................... 3-16
Figure 3-7 Hiérarchie de la classe Text2D. ............................................................................................ 3-16
Figure 3-8 Recette pour la création d’un objet Text3D. ........................................................................ 3-17
Figure 3-9 Le points de référence et l’extrusion par défaut pour un objet 3DText. .............................. 3-18
Figure 3-10 Hiérarchie des classes pour Text3D. .................................................................................. 3-20
Figure 3-11 Recette pour les Backgrounds. ........................................................................................... 3-24
Figure 3-12 Vue de la « Constellation » dans l’arrière-plan de BackgroundApp.java. ......................... 3-26
Figure 3-13 Hiérarchie de classe pour Background. .............................................................................. 3-26
Figure 3-14 Un BoundingLeaf de déplaçant avec un objet visuel et indépendamment d’une source de lu-
mière ......................................................................................................................................................3-28
Figure 3-15 Hiérarchie de la classe BoundingLeaf de l’API Java 3D.................................................... 3-30
Tableau 3-1 Chargeurs Java 3D publiques disponibles. .......................................................................... 3-4
Tableau 3-2 L’orientation du texte et le positionnement du point de référence par les combinaisons de
chemins et d’alignement de Text3D. ...................................................................................................... 3-19