FAQ JavaFXConsultez toutes les FAQ

Pour tester si la 3D est supportée par votre plateforme, vous pouvez invoquer la méthode isSupported() de la classe javafx.application.Platform en lui passant en paramètre la valeur javafx.application.ConditionalFeature.SCENE3D :

Platform.isSupported(ConditionalFeature.SCENE3D);

Vous pouvez afficher de la 3D de deux manières :

• dans la scène : dans ce cas l’intégralité de votre affichage sera en 3D ;
• dans une sous-scène : un nœud graphique de type javafx.scene.SubScene. Utiliser un tel objet permet par exemple d'avoir une IU 2D classique avec une vue 3D dans une partie de l'affichage.
  

La scène supporte de base le positionnement dans l'espace 3D, ce qui veut dire que vous pouvez d'ores et déjà commencer à disposer vos nœuds graphiques dans l'espace. Cependant, par défaut, la scène utilise une caméra parallèle (javafx.scene.ParallelCamera), c'est-à-dire une caméra qui ne permet pas de voir l'effet de profondeur, car l'axe Z est perpendiculaire à la surface de l’écran (le plan XY) en tout point de cette surface.

Pour activer l'effet de profondeur, il faut placer sur la scène une caméra de perspective en créant une instance de la classe javafx.scene.PerspectiveCamera :

scene.setCamera(new PerspectiveCamera());

Vous pouvez placer n'importe quel type de nœud dans une scène 3D : formes géométriques 2D, contrôles, groupes et gestionnaires de mise en page, graphiques de données statistiques, vues sur image, médias ou web, et bien sûr des primitives 3D ou des sources d’éclairage 3D.

Cependant, certaines fonctionnalités propres à la 3d, telles que l'ombrage ou la coloration dues aux sources d’éclairage ne seront pas opérantes sur les formes 2D ou les contrôles.

Les primitives 3D sont des classes qui héritent toutes de la classe abstraite javafx.scene.shape.Shape3D. Ces objets sont des nœuds graphiques, il est donc possible de les positionner et de les manipuler, de leur faire subir des effets ou transformations comme n'importe quel autre nœud de SceneGraph.

Il actuellement existe quatre types de primitives 3D :

• Box - une brique ou une boite définie par ses dimensions width sur l'axe X, height sur l'axe Y et depth sur l'axe Z. Peut servir à créer des cubes si les trois valeurs sont identiques. Le centre de la boite réside en (0, 0, 0) ;
• Sphere - une sphère définie par son rayon radius. Le centre de la sphère réside en (0, 0, 0) ;
• Cylinder - un cylindre défini par son rayon radius dans le plan Z ainsi que sa hauteur height suivant l'axe Y et le nombre de facettes divisions. Le nombre de facettes n'est pas modifiable après création et sa valeur minimale est de 3, sa valeur par défaut de 15. Le centre du cylindre réside en (0, 0, 0) ;
• MeshView - une vue sur un objet de type Mesh qui représente une surface 3D crée à partir d'un nuage de points et de coordonnées de texture.
  

Des exemples de filtres d'importation de modèles 3D aux formats Obj, Maya, 3D Studio Max et Collada sont fournis dans les exemples et démos de JavaFX disponibles, tout comme les exemples du JDK, en tant que téléchargements annexes du JDK chez Oracle.

Des filtres d'importation de modèles 3D en Mesh sont disponibles gratuitement pour une utilisation éducative, commerciale ou personnelle sur le site InteractiveMesh.org d'Impressum.

Il est possible de positionner des sources d’éclairage dans la scène. Ces objets héritent de la classe abstraite javafx.scene.LightBase. Ces objets sont des nœuds graphiques, il est donc possible de les positionner et de les manipuler, de leur faire subir des effets ou transformations comme n'importe quel autre nœud de SceneGraph.

Il existe deux types de sources de lumière :

• AmbientLight - une lumière ambiante qui baigne toute la scène d'une lumière provenant de toutes les directions à la fois éclairant toutes les faces de tous les objets ;
• PointLight - une source d'éclairage ponctuelle qui émet des rayons de lumière dans toutes les directions à partir de cette position. Les faces qui ne sont pas exposées à cette source de lumière ne sont pas éclairées.
  

Il est possible de changer la couleur d'une source de lumière en changeant la valeur de sa propriété color.

Par exemple :

light1.setColor(Color.BLUE);

Il est possible d'activer ou de désactiver une source de lumière en changeant la valeur de sa propriété lightOn.

Par exemple :

light1.setLightOn(false);

Le code suivant crée un cube et le positionne dans la scène :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
public class Main extends Application { 
  
    @Override 
    public void start(Stage primaryStage) { 
        // Création du cube. 
        final int size = 75; 
        final Box cube = new Box(size, size, size); 
        cube.setTranslateX(175); 
        cube.setTranslateY(150); 
        // Configuration du nœuds racine. 
        final Pane root = new Pane(); 
        root.setStyle("-fx-background-color: black;"); 
        root.getChildren().setAll(cube); 
        // Configuration de la scène. 
        final Scene scene = new Scene(root, 350, 300, false, SceneAntialiasing.BALANCED); 
        scene.setCamera(new PerspectiveCamera()); 
        // Configuration de la fenêtre. 
        primaryStage.setTitle("Test d'affichage 3D"); 
        primaryStage.setScene(scene); 
        primaryStage.show(); 
    } 
  
    public static void main(String[] args) { 
        launch(args); 
    } 
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
final TranslateTransition translateTransition = new TranslateTransition(Duration.seconds(10), cube); 
translateTransition.setInterpolator(Interpolator.LINEAR); 
translateTransition.setAutoReverse(true); 
translateTransition.setCycleCount(TranslateTransition.INDEFINITE); 
translateTransition.setFromY(0); 
translateTransition.setToY(300); 
final RotateTransition rotateTransition = new RotateTransition(Duration.seconds(5), cube); 
rotateTransition.setInterpolator(Interpolator.LINEAR); 
rotateTransition.setCycleCount(TranslateTransition.INDEFINITE); 
rotateTransition.setByAngle(360); 
rotateTransition.setAxis(Rotate.Y_AXIS); 
final ParallelTransition animation = new ParallelTransition(translateTransition, rotateTransition); 
animation.jumpTo(Duration.seconds(5)); 
animation.play();

1
2
3
final AmbientLight ambientLight = new AmbientLight(Color.WHITE.deriveColor(0, 0, 0.25, 0)); 
ambientLight.getScope().add(cube); 
root.getChildren().add(ambientLight);

1
2
3
4
5
6
final PointLight pointLight = new PointLight(Color.ORANGE); 
pointLight.setTranslateX(300); 
pointLight.setTranslateY(300); 
pointLight.setTranslateZ(-300); 
pointLight.getScope().add(cube); 
root.getChildren().addAll(pointLight);

Il est possible d'activer le mode rendu fil de fer (wireframe) sur un nœud 3D en modifiant la valeur de sa propriété drawMode.

Par exemple :

cube.setDrawMode(DrawMode.LINE);

Il est possible de modifier le mode d'occultation des faces d'un nœud 3D en modifiant la valeur de sa propriété cullFace.

Par exemple :

cube.setCullFace(CullFace.FRONT);

• CullFace.BACK - la valeur par défaut. Les faces qui ne sont pas dirigées vers l'utilisateur ne sont pas visibles ;
• CullFace.FRONT - les faces du cube dirigées vers l'utilisateur sont occultées ; on voit l’intérieur des objets ;
• CullFace.NONE - aucune occultation ; on voit un peu un mélange de toutes les faces.
  

Un matériau est un objet de type javafx.scene.paint.Material qui permet d'appliquer des propriétés visuelles sur les faces d'un nœud 3D, par exemple sa couleur diffuse (sa couleur de base), sa texture, son taux spéculaire (combien il réfléchit de lumière reçue), etc. À l'heure actuelle, la seule implémentation présente dans l'API est la classe javafx.scene.paint.PhongMaterial.

Il est possible de spécifier le matériau d'un nœud 3D en changeant la valeur de sa propriété material.

Pour spécifier une couleur unie sur un objet (sa couleur diffuse), il suffit de créer une instance de type PhongMaterial avec la couleur donnée et de l'appliquer à la propriété material de notre nœud 3D.

Par exemple :

1
2
final PhongMaterial material = new PhongMaterial(Color.CYAN); 
cube.setMaterial(material);

Pour spécifier une texture sur un objet (sa diffuse map), il suffit de créer une instance de type PhongMaterial avec une Image contenant la texture choisie et de l'appliquer à la propriété material de notre nœud 3D.

Par exemple :

1
2
3
final Image diffuseMap = new Image(getClass().getResource("1-Marble-Texture-1.jpg").toExternalForm()); 
final PhongMaterial material = new PhongMaterial(Color.WHITE, diffuseMap, null, null, null);  
cube.setMaterial(material);

L'image utilisée pour la texture provient du site Naldz Graphic

Pour spécifier la couleur spéculaire d'un objet (la couleur qui est émise par la lumière qui se réfléchit sur la surface de l'objet comme sur une couche de vernis), il suffit de créer une instance de type PhongMaterial et de modifier sa propriété specularColor en lui donnant comme valeur la couleur désirée.

Par exemple :

material.setSpecularColor(Color.RED);

material.setSpecularPower(50);