FAQ JavaFXConsultez toutes les FAQ

Un SceneGraph (litt�ralement, graphe de sc�ne) est une arborescence d'objets graphiques, des n�uds graphiques. Chaque n�ud disposant de ses propres propri�t�s graphiques (couleur, forme, position, etc.). Stocker ainsi les �l�ments � afficher permet de d�tecter plus facilement les zones de l��cran qui sont activ�es et doivent �tre rafraichies en cas de modification (d�placement, changement de couleur, etc. ) d'un noeud ou d'un groupe de n�uds. Il devient �galement plus facile d'arriver � d�terminer au-dessus de quel �l�ment se trouve le curseur de la souris et de r�agir en cons�quence en cas de clic ou de saisie tactile.

En JavaFX, le SceneGraph forme une API publique constitu�e de n�uds graphiques (rectangle, bouton, sph�re, etc.) ou des gestionnaires de mise en page que le programmeur peut manipuler pour composer l'interface graphique de son application. Modifier une propri�t� graphique d'un de ces n�uds provoquera automatiquement la r�actualisation de la partie de l'affichage concern�e sans que le programmeur ait besoin d'invoquer quoi que ce soit.

Derri�re le SceneGraph reposent le moteur de dessin Prism, le moteur de rendu Pisces et le moteur d'effets Decora auxquels le programmeur n'a pas directement acc�s. Le gestionnaire de fen�trage utilis� par JavaFX se nomme Glass tandis que le port de Glass pour syst�mes embarqu�s se nomme Monocle.

Un pulse (litt�ralement, une impulsion) est un �v�nement qui indique au SceneGraph qu'il doit se synchroniser avec le moteur de rendu sous-jacent Prism de mani�re � changer l'affichage � l��cran. En cas d'affichage passif, une impulsion a lieu quand un objet graphique voit une de ses propri�t�s visuelles modifi�e. A contrario, les impulsions ont lieu de mani�re continue lorsque des animations ont lieu ou lors de lecture de m�dias vid�o.

JavaFX essaie de cibler un taux d'impulsions constant d'au maximum 60 images par seconde (60fps), en cas d'animations.

Vous devez inclure un objet de type javafx.scene.Scene dans votre Stage. Vous placerez ensuite des objets de type javafx.scene.Node dans cette sc�ne pour cr�er votre interface graphique. Ces n�uds graphiques peuvent contenir du texte, des formes vectorielles, des images, des composants Swing, un design fait dans un logiciel externe�

Reprenons le code de notre application de base et ajoutons-y un contr�le :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
public class Main extends Application { 
  
    @Override 
    public void start(Stage primaryStage) { 
        final Button helloButton = new Button(); 
        helloButton.setText("Dire \"Bonjour le monde !\""); 
        helloButton.setOnAction(actionEvent -> System.out.println("Bonjour le monde !")); 
        final StackPane root = new StackPane(); 
        root.getChildren().add(helloButton); 
        final Scene scene = new Scene(root, 300, 250); 
        primaryStage.setTitle("Ma premi�re application JavaFX"); 
        primaryStage.setScene(scene); 
        primaryStage.show(); 
    } 
  
    public static void main(String[] args) { 
        launch(args); 
    } 
}

Si le Stage est une sc�ne d'une salle de th��tre (au sens de la zone physique sur laquelle se joue une pi�ce de th��tre), la Scene est quant � elle est la sc�ne du moment, l'action de la pi�ce qui est en train d��tre jou�e sur la sc�ne physique devant vos yeux et avec tous les d�cors, ainsi que les acteurs en train de r�citer leur texte du moment. L'agencement des d�cors, des acteurs et des accessoires forme le graphe de sc�ne (SceneGraph).

La sc�ne est donc l'objet qui est destin� � afficher (on dit aussi ��rendre��) le contenu du SceneGraph. G�n�ralement cet objet est attach� � une fen�tre (Stage, Window, etc.), mais ce n'est pas toujours le cas (par exemple, quand on imprime).

La sc�ne dispose d'un unique n�ud racine accessible par la propri�t� root. Cette propri�t� ne peut jamais avoir la valeur null. Pour construire une interface utilisateur, il suffit d'ajouter et de positionner des n�uds et contr�les dans cette racine.

Pour changer compl�tement et rapidement le contenu de la sc�ne, il suffit de changer son n�ud racine en rempla�ant l'ancienne racine par une nouvelle qui contient un tout autre graphe de sc�ne.

Une autre mani�re de changer l'affichage de la fen�tre est de remplacer la sc�ne par une nouvelle.

Attention : le code qui modifie le contenu de la sc�ne ou la sc�ne elle-m�me doit �tre ex�cut� sur le JavaFX Application Thread. Si un n�ud est rattach� � une sc�ne directement ou via l'arborescence de ses parents, veillez � ne pas le modifier dans des threads externes. Si vous ne respectez pas cette r�gle, des exceptions seront lev�es.

En th�orie, oui, il est possible de cr�er et manipuler des n�uds graphiques sur un thread autre que le JavaFX Application Thread. Cela permet entre autres de g�n�rer des n�uds graphiques complexes dans des t�ches de fond sans pour autant bloquer l'affichage.

MAIS, une fois que le n�ud a �t� attach� dans une arborescence qui fait partie d'une sc�ne, vous ne devez y acc�der que depuis le JavaFX Application Thread.

De plus, � l'heure actuelle (JDK8_u20), suite � des bogues dans l'API, certains n�uds qui g�rent leur affichage via des fen�tres popup secondaires (ex. : Tooltip) ne peuvent pas �tre instanci�s depuis d'autres threads.

Il est possible de savoir si votre code s�ex�cute dans le JavaFX Application Thread en invoquant la m�thode statique isFxApplicationThread() de la classe javafx.application.Platform.

Cette m�thode retourne true quand le code s�ex�cute dans le JavaFX Application Thread. Elle retourne false dans le cas contraire.

Par exemple :

1
2
3
if (Platform.isFxApplicationThread()) { 
    [...] 
}

Il est possible de forcer du code � s�ex�cuter dans le JavaFX Application Thread en invoquant la m�thode statique runLater() de la classe javafx.application.Platform et lui passant en param�tre un objet de type java.lang.Runnable.

Par exemple :

1
2
3
4
5
6
7
Platform.runLater(new Runnable() { 
  
    @Override 
    public void run() { 
        myButton.setText(text); 
    } 
});

Platform.runLater(() -> myButton.setText(text));

Oui, Jonathan Giles, de l��quipe de d�veloppement JavaFX chez Oracle, a mis � disposition l'outil Scenic View qui permet d'inspecter le contenu d'une sc�ne ou d'une arborescence SceneGraph.

Une fois le fichier JAR de Scenic View ajout� � votre projet, suivant les versions de l'outil, pour le lancer il faudra faire :

1
2
3
ScenicView.show(scene); 
// ou 
// ScenicView.show(unN�udParent);

1
2
3
ScenicViewBooter.show(scene); 
// ou 
// ScenicViewBooter.show(unN�udParent);