blob: 4981dc245dbd7d9838e67f309eb5aec9be567f92 [file] [log] [blame]
mwenz682b1492010-12-15 07:42:58 +00001<?xml version="1.0" encoding="iso-8859-1"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4<html xmlns="http://www.w3.org/1999/xhtml">
5<head>
6<meta http-equiv="Content-Language" content="en-us" />
7<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
mwenz4ed2fa22011-02-01 13:05:06 +00008<title>Graphiti &quot;New and Noteworthy&quot;</title>
mwenz682b1492010-12-15 07:42:58 +00009</head>
10<body>
mwenz2371bdf2011-09-05 13:11:29 +020011 <h1>Graphiti &quot;New and Noteworthy&quot; for Indigo</h1>
mwenzfb3d8902012-01-12 15:01:55 +010012 <p>Last revised January 12, 2012</p>
mwenz60416b62011-09-12 12:27:11 +020013 <p>This document describes the new development topics and bug fixes
mwenzfb3d8902012-01-12 15:01:55 +010014 that were adressed during a milestone towards the release 0.8.2 within
mwenz60416b62011-09-12 12:27:11 +020015 the Indigo release train.</p>
mwenz682b1492010-12-15 07:42:58 +000016
mwenz2371bdf2011-09-05 13:11:29 +020017 <table border="0" width="80%" cellpadding="10" cellspacing="0">
18 <tr>
19 <td colspan="2">
20 <hr style="color: grey; height: 5px" />
21 <h2>
mwenzfb3d8902012-01-12 15:01:55 +010022 <b>SR2</b>
23 </h2>
24 <hr />
25 </td>
26 </tr>
27 <tr id="Bugfixes">
28 <td width="30%" valign="top" align="left"><b>The following
29 bugs were fixed for the Indigo SR2 release of Graphiti (version
30 number is 0.8.2)</b></td>
31 <td width="70%" valign="top"><ul>
32 <li><a
33 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=357764">Bug
34 357764</a> - IndexOutOfBoundsException when creating new
35 ContainerShape inside existing one</li>
36 <li><a
37 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=365169">Bug
38 365169</a> - DiagramEditorInternal's selectionChanged() method
39 doesn't support FormEditor-based multipage editors</li>
40 <li><a
41 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=359217">Bug
42 359217</a> - Documentation: Plugin-In structure page missing some plugins</li>
43 <li><a
44 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=359526">Bug
45 359526</a> - NPE in DomainModelWorkspaceSynchronizerDelegate</li>
mwenz04c30362012-01-23 16:57:44 +010046 <li><a
47 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=368146">Bug
48 368146</a> - RuntimeException during SVG export</li>
mwenzfb3d8902012-01-12 15:01:55 +010049 </ul></td>
50 </tr>
51 <tr>
52 <td colspan="2">
53 <hr style="color: grey; height: 5px" />
54 <h2>
mwenz2371bdf2011-09-05 13:11:29 +020055 <b>SR1</b>
56 </h2>
mwenzfb3d8902012-01-12 15:01:55 +010057 <hr />
58 </td>
mwenz2371bdf2011-09-05 13:11:29 +020059 </tr>
60 <tr id="Bugfixes">
61 <td width="30%" valign="top" align="left"><b>The following
mwenz60416b62011-09-12 12:27:11 +020062 bugs were fixed for the Indigo SR1 release of Graphiti (version
mwenzfb3d8902012-01-12 15:01:55 +010063 number is 0.8.1)</b></td>
mwenz2371bdf2011-09-05 13:11:29 +020064 <td width="70%" valign="top"><ul>
65 <li><a
mwenz60416b62011-09-12 12:27:11 +020066 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=355347">Bug
67 355347</a> - Depreciate and finally remove setters of Graphiti's Font
68 Interface</li>
69 <li><a
mwenz2371bdf2011-09-05 13:11:29 +020070 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=352709">Bug
71 352709</a> - Invalid image provider id crashes diagram editor</li>
72 <li><a
73 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=351053">Bug
74 351053</a> - Check the need for WorkspaceCommandStackImpl</li>
75 <li><a
76 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348662">Bug
77 348662</a> - Setting tooltip to null in tool behavior provider
78 doesn't clear up tooltip</li>
79 <li><a
80 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348637">Bug
81 348637</a> - Direct-editing box for connection text decorator has
82 size issues</li>
83 <li><a
84 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348634">Bug
85 348634</a> - Direct-editing invoked again after user clicks away from
86 the label and moves back</li>
mwenzfb3d8902012-01-12 15:01:55 +010087 </ul></td>
mwenz2371bdf2011-09-05 13:11:29 +020088 </tr>
89 <tr>
90 <td colspan="2">
91 <hr style="color: grey; height: 5px" />
92 <h2>
93 <b>M7</b>
94 </h2>
mwenzfb3d8902012-01-12 15:01:55 +010095 <hr />
96 </td>
mwenz2371bdf2011-09-05 13:11:29 +020097 </tr>
98 <tr id="bug 324859">
99 <td width="30%" valign="top" align="left"><b>Undo/Redo
mwenzfb3d8902012-01-12 15:01:55 +0100100 support for Non-EMF domain models</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200101 <td width="70%" valign="top">It is now possible to provide
102 undo/redo functionality for operations on non-EMF domain models. In
103 order to implement this, users of the Graphiti framework can
104 implement the new interface <i>ICustomUndoableFeature</i> with their
105 features or the new interface <i>ICustomUndoablePattern</i> with
106 their patterns. If they do so, the feature or pattern will be called
107 as soon as an undo or redo is performed for this feature. For
108 details on this new possibility see <a
109 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=324859">Bugzilla
mwenzfb3d8902012-01-12 15:01:55 +0100110 324859</a>.
111 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200112 </tr>
113 <tr>
114 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100115 <hr />
116 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200117 </tr>
118 <tr id="bug 324058">
119 <td width="30%" valign="top" align="left"><b>User selection
mwenzfb3d8902012-01-12 15:01:55 +0100120 context in IDirectEditing APIs</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200121 <td width="70%" valign="top">So far the direct editing
122 functionality in Graphiti was purely String-based. Entries in the
123 drop down or for code completion could only be identified by the
124 String they were also represented in the UI to the user. Now it is
125 possible to define and provide a proposal support class based on the
126 new interface <i>IProposalSupport</i> based on additional
127 information, e.g placed in the direct editing context. This can
128 serve e.g. tool builders having to deal with different objects that
129 have the name, like classes with the same name residing in different
130 packages. For details on this new possibility see <a
131 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=324058">Bugzilla
mwenzfb3d8902012-01-12 15:01:55 +0100132 324058</a>.
133 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200134 </tr>
135 <tr>
136 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100137 <hr />
138 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200139 </tr>
140 <tr id="bug 340708">
141 <td width="30%" valign="top" align="left"><b>Double click
mwenzfb3d8902012-01-12 15:01:55 +0100142 for connections</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200143 <td width="70%" valign="top">It is now possible to register A
144 feature that will be executed on double click on a connection. This
145 was so far only possible for shapes.</td>
146 </tr>
147 <tr>
148 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100149 <hr />
150 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200151 </tr>
152 <tr id="bugfixing and round-offs">
153 <td width="30%" valign="top" align="left"><b>Round-offs and
mwenzfb3d8902012-01-12 15:01:55 +0100154 bugfixes</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200155 <td width="70%" valign="top">Several smaller round-offs have
156 been implemented:
157 <ul>
158 <li>Visualization during direct editing now completely
159 fulfills the usability specification.</li>
160 <li>Opening a user-contributed editor within <i>AbstractDrillDownFeature</i>
161 has been made easier by providing a protected method to open and a
mwenzfb3d8902012-01-12 15:01:55 +0100162 specific editor for a given diagram.
163 </li>
mwenz2371bdf2011-09-05 13:11:29 +0200164 <li>The framework is now prepared for users to deal with EMF
165 objects that are equal in the sense of <i>EMFUtil.equals</i> but
166 are not identical. For details on this new possibility see <a
167 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=335828">Bugzilla
mwenzfb3d8902012-01-12 15:01:55 +0100168 335828</a>.
169 </li>
170 </ul> Besides several bugs within the framework have been fixed.
171 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200172 </tr>
173 <tr>
174 <td colspan="2">
175 <hr style="color: grey; height: 5px" />
176 <h2>
177 <b>M6</b>
178 </h2>
mwenzfb3d8902012-01-12 15:01:55 +0100179 <hr />
180 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200181 </tr>
182 <tr id="bug 326396">
183 <td width="30%" valign="top" align="left"><b>Connections on
mwenzfb3d8902012-01-12 15:01:55 +0100184 Connections</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200185 <td width="70%" valign="top">It is now possible to attach
186 connections to other connections. The Graphiti metamodel offered
187 this possibility already but the framework support for this was
188 still lacking. Now, one can define so-called connection points to
189 actually split existing connections. Technically these connection
190 points are possibly active shapes that can be selected, moved or
191 deleted as any other shape. As a tool builder you need to allow this
192 new behavior when the user tries to drop a connection either via a <i>CreateConnectionFeature</i>
193 or a <i>ReconnectConnectionFeature</i>. Example implementations are
194 available in the Sketch testtool in the tests folder in the Graphiti
195 CVS. <img src="images/NaNW-Indigo-M6-Connection.jpg" />
196 </td>
197 </tr>
198 <tr>
199 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100200 <hr />
201 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200202 </tr>
203 <tr id="bug 323358">
204 <td width="30%" valign="top" align="left"><b>Font Management</b>
205 </td>
206 <td width="70%" valign="top">Graphiti now manages the fonts that
207 are used inside a diagram just the way it was already done for
208 colors. This feature was introduced in order to improve the graphics
209 handles usage and number of classes instantiated; multiple uses of
210 the same font will now lead to only one instance of that font
211 existing inside the diagram. Just as the colors fonts are now
212 managed at Diagram level and no longer on the individual graphical
213 elements. <b>Note: this is an minor incompatible change in the
214 Graphiti API you will need to adapt to!</b> There are no font creation
215 methods any more, instead you will need to call manageFont on the
216 diagram. <b>Besides diagrams that were created using Graphiti
217 versions before 0.8.0 M6 will need a migration</b> if tool defined
218 fonts are used. The Graphiti framework provides a small migration
219 utility that can be triggered at an appropriate time by the tool. We
220 decided explicitly against triggering the migration from the
221 framework, because there will definitely by different requirements
222 on the time of triggering in the various tool scenarios. Besides
223 there will be tools that will need no migration at all and would be
224 only suffer a time penalty from that check and migration being done
225 in the framework. More details on the API change and the migrator
226 can be found in the Bugzilla <a
mwenzfb3d8902012-01-12 15:01:55 +0100227 href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=323358">323358</a>.
228 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200229 </tr>
230 <tr>
231 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100232 <hr />
233 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200234 </tr>
235 <tr id="bug 336075">
236 <td width="30%" valign="top" align="left"><b>URIEditorInput</b>
237 </td>
238 <td width="70%" valign="top">The Graphiti DiagramEditor now
239 accepts <i>URIEditorInput</i> objects. They can be created outside
240 the editor and the editor will care about opening the corresponding
mwenzfb3d8902012-01-12 15:01:55 +0100241 diagram.
242 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200243 </tr>
244 <tr>
245 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100246 <hr />
247 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200248 </tr>
249 <tr id="bug 329523">
250 <td width="30%" valign="top" align="left"><b>Resource Saved
mwenzfb3d8902012-01-12 15:01:55 +0100251 Hook</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200252 <td width="70%" valign="top">A new hook <i>resourcesSaved()</i>
253 has been introduced in the diagram type provider. It will be called
mwenzfb3d8902012-01-12 15:01:55 +0100254 by the framework right after a diagram has been saved.
255 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200256 </tr>
257 <tr>
258 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100259 <hr />
260 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200261 </tr>
262 <tr id="bug 336828">
263 <td width="30%" valign="top" align="left"><b>Pattern
mwenzfb3d8902012-01-12 15:01:55 +0100264 Enhancements</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200265 <td width="70%" valign="top">Graphiti patterns now allow the
266 integration of delete, remove and direct editing features. These
267 functionalities before had to be implemented within separate
268 features. Besides the patterns now easily allow to prevent that a
269 creation tool entry is created for them in the editor palette.</td>
270 </tr>
271 <tr>
272 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100273 <hr />
274 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200275 </tr>
276 <tr id="bug 323155">
277 <td width="30%" valign="top" align="left"><b>Printing and
mwenzfb3d8902012-01-12 15:01:55 +0100278 Saving as Image</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200279 <td width="70%" valign="top">Graphiti supports printing and
280 saving a diagram to an image. There have always been hooks were the
281 user can influence the default behaviors for these operations.
282 Nevertheless it was not clear if the way this was enabled was really
283 feasible. An investigation of the two features that exist for those
284 purposes (<i>DefaultPrintFeature</i> and <i>DefaultSaveImageFeature</i>)
285 showed that tool builders can rudimentary implement behavioral
286 changes to those features (like changing the selection in the
287 editor), so it makes sense to keep the implementations available.
288 The existing state was documented in the JavaDoc at the appropriate
289 classes and methods and a not used property in the save context was
290 removed. This functionality might be subject to further enhancement
mwenzfb3d8902012-01-12 15:01:55 +0100291 request as tools need more possibilities to influence the behavior.
292 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200293 </tr>
294 <tr>
295 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100296 <hr />
297 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200298 </tr>
299 <tr id="bugfixing">
300 <td width="30%" valign="top" align="left"><b>Fixing of Bugs</b>
301 </td>
302 <td width="70%" valign="top">Some bugs in the area of anchor
303 handling and drill down features were fixed. Also, the used SUA was
304 updated to the newest Indigo version.</td>
305 </tr>
mwenz40f21712011-03-15 10:13:27 +0000306
307
mwenz2371bdf2011-09-05 13:11:29 +0200308 <tr>
309 <td colspan="2">
310 <hr style="color: grey; height: 5px" />
311 <h2>
312 <b>M5</b>
313 </h2>
mwenzfb3d8902012-01-12 15:01:55 +0100314 <hr />
315 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200316 </tr>
317 <tr id="bug 323359">
mwenzfb3d8902012-01-12 15:01:55 +0100318 <td width="30%" valign="top" align="left"><b>Globalization</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200319 <td width="70%" valign="top">Graphiti now uses resource bundles
320 for all its texts and is ready to be translated.</td>
321 </tr>
322 <tr>
323 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100324 <hr />
325 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200326 </tr>
327 <tr id="bug 327669">
mwenzfb3d8902012-01-12 15:01:55 +0100328 <td width="30%" valign="top" align="left"><b>API Usages</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200329 <td width="70%" valign="top">Graphiti now uses other projects
330 only via their public APIs. Usages of GEF internal stuff has been
331 removed.</td>
332 </tr>
333 <tr>
334 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100335 <hr />
336 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200337 </tr>
338 <tr id="bug 332704">
mwenzfb3d8902012-01-12 15:01:55 +0100339 <td width="30%" valign="top" align="left"><b>Accessibility</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200340 <td width="70%" valign="top">Graphiti now fully supports themes
341 like the high contrast mode to enable Accessibility for disabled
342 users. Some gaps in presenting selections and gradients were closed.</td>
343 </tr>
344 <tr>
345 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100346 <hr />
347 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200348 </tr>
349 <tr id="bug 326993">
350 <td width="30%" valign="top" align="left"><b>Prevent
mwenzfb3d8902012-01-12 15:01:55 +0100351 Multiple Popups</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200352 <td width="70%" valign="top">When deleting more than one object
353 a confirmation popup for each of the objects was presented to the
354 user. This has been improved so that the user has the option "Yes
355 for all" available.</td>
356 </tr>
357 <tr>
358 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100359 <hr />
360 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200361 </tr>
362 <tr id="bugfixing">
363 <td width="30%" valign="top" align="left"><b>Fixing of Bugs</b>
364 </td>
365 <td width="70%" valign="top">Some bugs especially in the area of
366 the zoom animation, ContextButtonPadData and grid alignment were
367 fixed.</td>
368 </tr>
mwenz40f21712011-03-15 10:13:27 +0000369
370
mwenz2371bdf2011-09-05 13:11:29 +0200371 <tr>
372 <td colspan="2">
373 <hr style="color: grey; height: 5px" />
374 <h2>
375 <b>M4</b>
376 </h2>
mwenzfb3d8902012-01-12 15:01:55 +0100377 <hr />
378 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200379 </tr>
380 <tr id="bug 330230">
381 <td width="30%" valign="top" align="left"><b>Indigo Release
mwenzfb3d8902012-01-12 15:01:55 +0100382 Train</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200383 <td width="70%" valign="top">Graphiti declared its participation
384 in the Indigo release train. All project metadata settings were done
385 and the project update site is aggregated into the common Indigo
386 milestones update site.</td>
387 </tr>
388 <tr>
389 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100390 <hr />
391 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200392 </tr>
393 <tr id="bug 330218">
394 <td width="30%" valign="top" align="left"><b>Vector Graphics
mwenzfb3d8902012-01-12 15:01:55 +0100395 Export</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200396 <td width="70%" valign="top">Diagrams can now be exported also
397 in vector graphics format (SVG). This is available from the save as
398 dialog of a diagram editor besides the traditional save as JPG, BMP
399 etc.</td>
400 </tr>
401 <tr>
402 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100403 <hr />
404 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200405 </tr>
406 <tr id="FillGaps">
407 <td width="30%" valign="top" align="left"><b>Filling of
mwenzfb3d8902012-01-12 15:01:55 +0100408 functional gaps</b></td>
mwenz2371bdf2011-09-05 13:11:29 +0200409 <td width="70%" valign="top">Some functional gaps like missing
410 services, automated resizing for combo boxes, creation of color
411 constants from RGB string etc. were filled.</td>
412 </tr>
413 <tr>
414 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100415 <hr />
416 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200417 </tr>
418 <tr id="BugFixing">
419 <td width="30%" valign="top" align="left"><b>Fixing of bugs</b>
420 </td>
421 <td width="70%" valign="top">Some bugs (especially in the area
422 of refreshing the diagram were fixed.</td>
423 </tr>
424 <tr>
425 <td colspan="2">
mwenzfb3d8902012-01-12 15:01:55 +0100426 <hr />
427 </td>
mwenz2371bdf2011-09-05 13:11:29 +0200428 </tr>
429 </table>
mwenz682b1492010-12-15 07:42:58 +0000430</body>
431</html>