Sujet du TP : JDraw

L'objectif de ce TP est la réalisation d'une petite application de dessin : JDraw.

Au final, l'application permettra à l'utilisateur de créer des objets graphiques (points, segments, ovales, rectangles, zone de textes, ...), d'en modifier leur emplacement et propriétés par le biais de boîtes de dialogue et de sauvegarder puis relire dans un fichier les dessins créés.

Voici l'applet dont vous allez vous inspirer, l'interface étant des plus simples : le bouton gauche de la souris permet de déplacer les objets, un click droit fait apparaître une fenêtre de propriétés. Nous verrons plus tard comment ajouter des objets, etc.

                    

Plan de travail

• Parcourez une première fois cette page pour voir où sont les informations dont vous aurez besoin au fur et à mesure de votre progression.
• Récupérez 
  • Le source de la classe principale (jdraw.JDraw),
  • Le source du manager d'objets graphiques (jdraw.GraphicalObjectManager),
  • Les images du package jdraw.images,
  commentez ce qu'il faut pour pouvoir compiler, et démarrez l'implémentation du canevas.
• Créez progressivement les différents objets graphiques, sans vous soucier de la gestion des événements.
• Mettez en œuvre les fenêtres d'édition de propriétés (donc les événements).
• Ajoutez le support du drag-and-drop.
• Essayez d'optimiser le réaffichage en contrôlant les dirty areas.
• Proposez des fonctionnalités d'ajout d'objets graphiques (toolbar).
• Proposez des fonctionnalités d'ouverture et d'écriture de "dessins".
• A l'aide d'une JTable et de l'introspection, affichez une table des objets graphiques et leurs propriétés (sérialisation ou pas sérialisation ?).
• Ajoutez la possibilité de sélectionner des objets et des poignées pour les redimensionner.
• Fêtez vos 6 mois de travail sur ce projet et votre maîtrise du langage Java, des librairies graphiques AWT et Swing, ...
• Ajoutez la possibilité de construire de lier les objets entre eux par des points d'ancrages.
• Ajouter la possibilité de construire de nouveaux types d'objets par groupement d'autres et jetez xfig à la poubelle.
• Montez votre startup et concurrencez Microsoft et "son" produit Visio.

Arborescence des packages

Classes

Visualiser le diagramme de classe (2540*1340, 245Ko).

Propriétés des objets graphiques

• Tous les objets graphiques, dérivant de jdraw.graphicalobjects.GraphicalObject, ont les propriétés communes suivantes :
  • int x - l'abcisse
  • int y - l'ordonnée
  • java.awt.Color color - la couleur
  • java.awt.Cursor cursor - un curseur de souris (propriété en lecture-seule)
  • String friendlyname - un nom "à visage humain" utilisé comme titre des fenêtres d'édition des propriétés (propriété en lecture-seule)
  • java.awt.Rectangle boundingbox - les coordonnées du rectangle délimitant l'objet (propriété en lecture-seule)
• Les objets graphiques dérivant de jdraw.graphicalobjects.SizedGraphicalObject, ont les propriétés communes suivantes :
  • int width - la largeur
  • int height - la hauteur
• L'objet jdraw.graphicalobjects.TextArea a les propriétés supplémentaires suivantes :
  • String text - le texte
  • java.awt.Font font - la fonte
  • int alignment - l'alignement du texte rapport à la position de l'objet (SwingConstants.NORTH, SwingConstants.CENTER, ...)

Méthodes des objets graphiques

• Les méthodes d'accès à aux propriétés précédemment citées, les getters et setters (le cas échéant), sous forme des méthodes getXXX() et setXXX( ... ).
  Les setters sont disponible en deux version : une standard, qui émet les événements java.beans.PropertyChangeEvent correspondants, et une version "silencieuse" (dont l'identificateur est suffixé par _silent), qui n'émet pas ces événements (voir plus bas).
• Une méthode void paint( java.awt.Graphics ) d'affichage (invoquée par le manager d'objets graphiques, lorsque nécessaire).
• Une méthode int getDistanceSq( java.awt.Point ) indiquant le carré de la "distance" de l'objet au point spécifié.
• Les méthodes void addPropertyChangeListener( java.beans.PropertyChangeListener ) et void removePropertyChangeListener( java.beans.PropertyChangeListener ) de gestion des écouteurs de changements de propriétés.
• Une méthode GraphicalObjectProperties getPropertyDialog( Frame ) renvoyant la fenêtre de dialogue de changement de propriétés (voir plus bas).
• Une méthode void prepareBoudingBoxEvent() qui prépare l'événement de changement de bounding-box et void fireBoudingBoxChange() qui émet réellement cet événement.
• Les méthodes de gestion du drag and drop :
  • boolean isDragInProgress(), qui indique si un drag and drop est en cours.
  • void startDragAndDrop( int, int ), qui démarre un drag and drop à la position spécifiée
  • void drag( int, int ), qui poursuit le drag and drop.
  • void suspendDragAndDrop(), qui suspend le drag and drop en cours (lorsque l'on sort du canvas).
  • void commitDragAndDrop( int, int ), qui valide le drag and drop en cours à la position spécifiée.
  • void rollbackDragAndDrop(), qui annule le drag and drop en cours.

Evénements des objets graphiques

Pour informer les composants intéressés (les listeners) d'événements émis par les objets graphiques, nous utiliserons la classe d'événements java.beans.PropertyChangeEvent, et les listeners seront de type java.beans.PropertyChangeListener.
Dans une première approche, les objets graphiques n'émettrons que des changements de la propriété (en lecture-seule) "BoundingBox", qui doit déclencher un réaffichage adéquat.

Principes de mise en œuvre des fenêtres de propriétés

Il y a trois fenêtres de propriétés différentes :

• jdraw.ui.GraphicalObjectProperties pour les objets sans taille comme le point ;
• jdraw.ui.SizedGraphicalObjectProperties pour les objets ayant une taille comme l'ellipse, le rectangle ou le segment ;
• java.ui.TextAreaProperties pour les objets texte.

• La classe mère, jdraw.ui.GraphicalObjectProperties propose les méthodes suivantes :
  • void addPropertyGroup( JPanel ), qui ajoute le panneau spécifié
  • void loadValues(), invoquée lorsque les valeurs doivent être lues à partir de l'objet
  • void applyValues(), invoquée lorsque l'objet doit être mis à jour à partir des valeurs indiquées par l'utilisateur
• Chaque constructeur appele le constructeur père et ajoute ses propres panneaux, via void addPropertyGroup( JPanel )
• Chaque classe spécialise loadValues() et applyValues(), en appelant la version mère en premier lieu
• Chaque classe d'objets graphiques propose une méthode GraphicalObjectProperties getPropertyDialog( Frame ) qui renvoie une fenêtre prète à être rendue visible, fraîchement instanciée ou recyclée
• La classe jdraw.graphicalobjects.GraphicalObject propose une méthode void openPropertyDialog( Frame ) qui rend visible la fenêtre de propriété récupérée via getPropertyDialog(...).

Utilisation en application ou en applet

Voici deux notes pour que JDraw puisse fonctionner à la fois comme une application directement exécutable ou comme une applet dans une page web :

• Le constructeur de jdraw.graphicalobjects.ui.MainFrame (qui étend javax.swing.JFrame pour la version application) propose une méthode statique (initRootPaneContainer) qui initialise un javax.swing.RootPaneContainer spécifié.
  Ce RootPaneContainer sera :
  • celui de la MainFrame dans le cas d'une application, et donc cette méthode sera appelée par le constructeur de MainFrame ;
  • celui de JApplet (JApplet implémente initRootPaneContainer) dans le cas d'une applet, et donc cette méthode sera appelée par la méthode init de la classe principale.
• Pensez à utiliser la méthode getResource de java.lang.class (donc utilisable par n'importe quelle classe via le champ class), pour charger les images, ce qui fonctionne à la fois lors que ces images sont accessibles via le CLASSPATH ou dans l'archive .jar de l'applet.