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);