Skip to main content
Jump to: navigation, search

GEF/New and Noteworthy/4.0

< GEF‎ | New and Noteworthy
Revision as of 12:55, 18 May 2016 by Nyssen.itemis.com (Talk | contribs) (GEF4 MVC (1.0.0))

General

The GEF 4.0.0 (Neon) release provides minor revisions of the maintenance components Draw2d 3.x (3.11.0), GEF (MVC) 3.x (3.11.0), and Zest 1.x (1.7.0), as well as major revisions of the new GEF4 components (1.0.0).

As declared in the project plan, the decision about contributing GEF4 in version 1.0.0 (instead of 0.3.0) and an overall 4.0.0 release (instead of 3.11.0) was postponed up to M5. That is, Bugzilla entries commented before Neon M6 will refer to a 3.11.0 release and milestone contributions (including M5) include GEF4 components in version 0.3.0.

Please note that several incompatible changes to the (up to 0.2.0 provisional) API of GEF4 were made. The list of added and removed classes can be found at [1]. The most notable API changes are outlined below.


GEF4 Common (1.0.0)

  • #484774 As outlined in detail in 'GEF4 Collections and Properties - Guava goes FX' the property notification support provided by GEF4 Common has been replaced with JavaFX observable collections and properties. In this turn, the GEF4 Common component has been augmented to provide observable collections and related collection properties for Guava's SetMultimap and Multiset, as well as replacements for the ObservableSet, ObservableList, and ObservableMap collections and related collection properties provided by JavaFX.
  • #482972 Furthermore, the adapter map injection support, described in detail in Adaptable - 'GEF4's interpretation of a classic', has been updated to ensure that adapter can always been retrieved via their actual runtime type, as well as been augmented with support for role-based adapter injection, i.e. adapter bindings can be specified for an adaptable of a certain role (see #481677 for details).

GEF4 FX (1.0.0)

The GEF4 FX component has undergone a significant revision:

  • Connection does now support routers (straight and orthogonal) and interpolators (polyline, poly-bezier), proper clipping of start and end decoration, as well as replacement of the visual curve node. Furthermore support for a 'clickable' area has been added, which can e.g. be used to expand the mouse-sensitive area when zooming.

ConnectionSnippet.jpg

(Most) Significant API Changes

We have not only renamed all contained classes to get rid of the 'FX' prefix, but as indicated above, several changes (including breaking API changes) compared to 0.2.0 have been incorporated. In the following, the most notable ones are listed:

  • #471154 Renamed FX.UI module into FX.SWT module and added FXColorPicker, FXSimpleLinearGradientPicker, and FXAdvancedLinearGradientPicker, which were provided by MVC.FX.UI module before (refactored from AbstractFXColorPicker, FXColorPicker, FXSimpleGradientPicker, and FXAdvancedGradientPicker). Introduced new FX.JFace module, which provides FXPaintCellEditor and FXPaintSelectionDialog, which were provided by MVC.FX.UI module before (refactored from FXFillCellEditor and FXFillSelectionDialog).
  • #479395 Merged ScrollPaneEx and FXGridCanvas into InfiniteCanvas. The FXGridLayer has been removed and its functionality was moved to the newly created InfiniteCanvas. The InfiniteCanvas does now allow to insert visuals at different "positions" inside of the InfiniteCanvas: underlay group, scrolled underlay group, content group, scrolled overlay group, overlay group.
  • #454681 Added support to Connection for having a clickable area that is thicker than the connection stroke and allows to select also very thin connections. Its width is exposed by a property of Connection, so it can be bound (e.g. to adjust the width of the clickable area dependent on the scaling). Enhance the MVC logo example to demonstrate example usage of this feature.
  • Added support for proper clipping of decorations
  • Ensured that the curve node of a connection can be replaced
  • #488356 Introduced support for orthogonal routing, including support for start and end point hints.
  • Separated routing (manipulation of control points) from interpolating (visual appearance)
  • Exposed all relevant properties as (observable) properties, so it can be better used in a pure JavaFX environment.
  • Revised DynamicAnchor and its IComputationStrategy to be comparable to a JavaFX binding, where the resulting position value is based on observable computation parameters that might depend on the anchorage (static) or anchored visual (dynamic).
  • #443954 GeometryNode has been revised to extend Region instead of Parent, so it no longer relies on overriding the deprecated impl_computeLayoutBounds() method that is deprecated and announced to be removed in future JavaFX releases. The API of GeometryNode was enhanced so that it does now allow to use relocate(double, double) and resize(double, double) to update the layout bounds (including layoutX and layoutY) while relocateGeometry(double, double) and resizeGeometry(double, double) can be used to update the geometric bounds. The layout bounds (and layoutX, layoutY) resemble the geometric bounds, expanded by a stroke offset (dependent on stroke width and type) and border insets.

GEF4 MVC (1.0.0)

  • Support for orthogonal routing
  • Palette for MVC Logo example

(Most) Significant API Changes

  • #471154 Refactored AbstractFXColorPicker, FXColorPicker, FXSimpleGradientPicker, and FXAdvancedGradientPicker and moved them into FX.SWT (renamed from FX.UI). Refactored FXFillCellEditor and FXFillSelectionDialog and moved them into FX.JFace.
  • #477352 The FXTransformPolicy now provides an API for the creation and manipulation of transformation matrices. These matrices are then concatenated, together with the initial host transformation matrix, to yield the new host transformation matrix. Therefore, complex transformations can be set up properly at one point, and the important values can be changed later on, e.g. during user interaction. Moreover, the related policies (FXRelocateConnectionPolicy, FXRelocateOnDragPolicy, FXResizeRelocateOnHandleDragPolicy, FXResizeRelocatePolicy, FXRotatePolicy, FXRotateSelectedOnHandleDragPolicy, FXRotateSelectedOnRotatePolicy, FXScaleRelocateOnHandleDragPolicy, and FXScaleRelocatePolicy) have been renamed to express the actual transformation (e.g. "translate" instead of "relocate"). Additionally, the intermediate FXResizeRelocatePolicy, FXRotatePolicy, and FXScaleRelocatePolicy have been removed. The policies that were dependent on those intermediate policies are now directly using the FXTransformPolicy.
  • #479612 Cleaned up ContentPolicy to only provide operations related to the content of the respective host part. It is intended to be registered at each IContentPart. Moved all "higher-level" operations into CreationPolicy and DeletionPolicy, which are to be registered at the IRootPart alone.
  • #480875 Updating the selection, hover, and focus models is now handled within the CreationPolicy and the DeletionPolicy and the ClearHoverFocusSelectionOperation has been removed. The CreationPolicy selects and focusses a newly created part. The DeletionPolicy removes the deleted parts from the selection and focus models. Moreover, the CreationPolicy creates the IContentPart before executing operations on the history. Therefore, the content part can be used for live feedback even though the creation is not yet committed.
  • #481292 Renamed accessor methods provided by SelectionModel to be more concise. Especially clarified via names, whether an operation appends, prepends, or sets the selection.
  • #481600 Changed the implementation of ContentBehavior to ensure that deactivation does not remove children of its host. This way, deactivation of an FXViewer can now be temporarily applied (to disable all listeners) without loosing the content of the viewer.
  • #493553 Changed that Domain now only executes ITransactionalOperations. Added means so that filtering of operations can be performed to control, which should be undoable. This can be used to e.g. filter out non content-related operations (like selection of focus change).

GEF4 Layout (1.0.0)

The GEF4 Layout component has been partially revised.

  • #491097 The LayoutContext now uses a GEF4 Graph data model as input and output model for layout calculations instead of its own layout interface abstractions.

GEF4 Graph (1.0.0)

  • #480293 Enhanced the builder API so that graph-, node-, and edge-builders can be chained appropriately. Node-builders can now be provided with an Object-key, that can be referred to by edge-builders.
  • #484774 Adopted API to expose all relevant properties through JavaFx observable collections/properties.

GEF4 Zest (1.0.0)

  • #470636 Separated out the Zest JFace-API into an own module (Zest.FX.JFace), so it can be consumed without introducing dependencies on the Eclipse Workbench UI.
  • #478944 Removed IEdgeDecorationProvider from Zest.FX.Jface. Respective ZestProperties.EDGE_SOURCE_DECORATION and ZestProperties.EDGE_TARGET_DECORATION attributes may be provided via IGraphNodeLabelProvider#getEdgeAttributes() instead.

GEF4 DOT (1.0.0)

The GEF4 DOT component has been completely revised and has made significant progress towards a full DOT authoring environment.

  • #446639 A preference page has been added, via which the path to the native dot executable can be specified. In addition to image export, it is now also employed by the DOT Graph view to enable layouting in native mode in addition to the already provided emulated mode (based on matching GEF4 Layout algorithms).
  • #477980 The DOT Graph view now also provides additional rendering capabilities, including edge decorations, splines, as well as all available kind of labels (for edges and nodes).
  • The DOT editor has been enhanced with additional validation support for arrowtype, point, splinetype, shape, and style attribute values.

Back to the top