JAXenter

Diese beiden ersten Schritte sind relativ einfach. Schwieriger wird es nun bei der Modifikation der EditParts. Hierzu greifen wir nun auf Borg-Technologie zurück, also auf die BorgEditPartFactory (Listing 2).

Listing 2

1. protected BorgEditPartFactory createBorgFactory(
2. EditPartFactory originalFactory) {
3. BorgEditPartFactory borgFactory = new BorgEditPartFactory(originalFactory);
5. // replace diagram edit part
6. borgFactory.addAssimilator(new EditPartReplacer(GraphEditPart.class,
7. GraphEditPart3D.class));
9. // modify diagram edit part's policies
10. borgFactory.addAssimilator(new AbstractPolicyModifier() {
12. public boolean match(EditPart part) {
13. return part instanceof GraphEditPart3D;
14. }
16. public void modifyPolicies(EditPart io_editpart) {
17. // feedback when creating a node:
18. io_editpart.installEditPolicy(
19. ShowLayoutFeedbackEditPolicy3D.ROLE,
20. new ShowLayoutFeedbackEditPolicy3D());
21. // handles and feedback when moving or resizing a node
22. io_editpart.installEditPolicy(
23. Handles3DEditPolicy.CHILD_DECORATOR,
24. new Handles3DEditPolicy());
25. }
26. });
28. // modify node edit part's policies
29. borgFactory.addAssimilator(new IAssimilator.InstanceOf<EditPart>(
30. NodeEditPart.class) {
32. public EditPart assimilate(EditPart io_editpart) {
33. // feedback when drawing a connection
34. io_editpart.installEditPolicy(
35. ShowSourceFeedback3DEditPolicy.ROLE,
36. new ShowSourceFeedback3DEditPolicy());
37. return io_editpart;
38. }
40. });
41. return borgFactory;
42. }

Der Code ist fast selbsterklärend. Zunächst wird die eigentliche Factory in der BorgEditPartFactory versteckt. Dann werden geeignete Assimilatoren installiert. Hier ist das zunächst ein EditPartReplacer, der einfach alle erzeugten Objekte vom Typ GraphEditPart gegen Instanzen vom Typ GraphEditPart3D austauscht. Der zweite Assimilator, ein AbstractPolicyModifier, ändert den EditPart selbst nicht, sondern installiert zwei neue Policies: ShowLayoutFeedbackEditPolicy3D zur Darstellung einer Feedback-Figur beim Erzeugen von Elementen sowie Handles3DEditPolicy, die dafür sorgt, dass später im Editor passende 3D-Handles und Feedback-Figuren bei der Bewegung von Knoten erzeugt werden. Der dritte Assimilator installiert ebenfalls eine neue Policy, ShowSourceFeedback3DEditPolicy. In diesem Fall wird eine Policy bei den VertexEditParts installiert, um eine Feedback-Figur bei der Erzeugung von Kanten anzuzeigen. Der Vollständigkeit halber hier noch die Funktion, um die BorgEditPartFactory gegen die originale Factory auszutauschen und einen speziellen RootEditPart zu setzen, der für den 3D-Editor benötigt wird:

1. protected void configureGraphicalViewer() {
2. super.configureGraphicalViewer();
3. EditPartFactory originalFactory =
4. getGraphicalViewer().getEditPartFactory();
5. BorgEditPartFactory borgFactory = createBorgFactory(originalFactory);
6. getGraphicalViewer().setEditPartFactory(borgFactory);
8. ScalableFreeformRootEditPart root = new ScalableFreeformRootEditPart3D();
9. getGraphicalViewer().setRootEditPart(root);
10. }

Das waren tatsächlich alle Änderungen – der 3D-Editor ist fertig. Er muss jetzt nur noch über einen geeigneten Extension Point bei Eclipse registriert werden und kann dann die gleichen Diagramme öffnen und bearbeiten wie die 2D-Version.

Fazit

Wie das kleine Beispiel gezeigt hat, ist die Entwicklung von 3D-Editoren mit GEF3D überraschend einfach. Allerdings ist GEF3D zurzeit noch nicht vollkommen ausgereift. Näheres zu aktuellen Einschränkungen findet sich im Kasten "Incubator". Durch die einfache Portierung vorhandener Editoren fällt der Einstieg in die 3D-Welt leicht. Mit GEF3D ist aber auch die Umsetzung "echter" 3D-Editoren möglich. Dabei bietet sich GEF3D vor allem dann an, wenn nicht einzelne Elemente gezeichnet werden sollen (wie bei CAD-Programmen), sondern vorgefertigte Elemente in Beziehung zueinander gesetzt werden sollen. Im Fokus der Entwicklung von GEF3D steht momentan jedoch vor allem die 3D-fizierung von 2D-Editoren, da diese gerade im Umfeld modellgetriebener Verfahren interessant ist. Im zweiten Teil der Artikelserie zu GEF3D (zu lesen in Eclipse Magazin 1.10) werden wir auf weitere Features eingehen wie die Anzeige mehrerer Diagramme in einer 3D-Szene sowie die Anpassung von GMF-basierten Editoren.

Links & Literatur

1. Voormann, H.: "Quo vadis Eclipse?"
2. Eclipse GEF3D
3. Jacobson, I.: Object-Oriented Software Engineering: A Use Case Driven Approach. Addison-Wesley Professional, 1992 (acm press)
4. Eclipse GEF
5. Eclipse GMF
6. Eclipse Modeling Framework Technology (EMFT)
7. Eclipse Model Development Tools (MDT)
8. Eclipse EMF
9. Bokowski, B.; Gerhardt, F.: GEF: Maßgeschneiderte grafische Editoren selbst erstellen. In: Eclipse Magazin 2.05
10. Lighweight Java Game Library (LWJGL)
11. Java Bindings for OpenGL API (JOGL)
12. Subversion Repository
13. LWJGL-Update-Seite
14. GEF3D-Wiki