Jump to: navigation, search

Difference between revisions of "GEF/New and Noteworthy/3.7"

Line 6: Line 6:
 
== Draw2d==
 
== Draw2d==
  
=== Refactoring of Geometry API ===
+
=== Refactoring of Geometry API (M4) ===
 
Geometry API was refactored to guarantee consistency between integer-precision and double-precision version of <code>Point</code>/<code>PrecisionPoint</code>, <code>Dimension</code>/<code>PrecisionDimension</code>, and <code>Rectangle</code>/<code>PrecisionRectangle</code>. Synchronization between the still exposed integer-precision fields (x, y, width, height) and the no-longer exposed double-precision fields (preciseX, preciseY, preciseWidth, preciseHeight) is performed automatically by precision classes now, so clients may use the precision versions transparently, being no longer forced to perform a manual update of the respective fields. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=124904 124904], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=142628 142628], and [https://bugs.eclipse.org/bugs/show_bug.cgi?id=271235 271235] for details.
 
Geometry API was refactored to guarantee consistency between integer-precision and double-precision version of <code>Point</code>/<code>PrecisionPoint</code>, <code>Dimension</code>/<code>PrecisionDimension</code>, and <code>Rectangle</code>/<code>PrecisionRectangle</code>. Synchronization between the still exposed integer-precision fields (x, y, width, height) and the no-longer exposed double-precision fields (preciseX, preciseY, preciseWidth, preciseHeight) is performed automatically by precision classes now, so clients may use the precision versions transparently, being no longer forced to perform a manual update of the respective fields. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=124904 124904], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=142628 142628], and [https://bugs.eclipse.org/bugs/show_bug.cgi?id=271235 271235] for details.
 +
 +
=== Refactoring of FlowLayout and ToolbarLayout (M5) ===
 +
<code>FlowLayout</code> and <code>ToolbarLayout</code> were refactored by introducing <code>OrderedLayout</code> a common superclass. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=88884 88884] for details.
  
 
== GEF ==
 
== GEF ==
  
=== Refactoring of Layout Edit Policies ===
+
=== Refactoring of LayoutEditPolicy, ConstrainedLayoutEditPolicy, and XYLayoutEditPolicy (M4) ===
 
Layout edit policies have been refactored to remove duplicate code and allow better extensibility.
 
Layout edit policies have been refactored to remove duplicate code and allow better extensibility.
  
Line 29: Line 32:
 
See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=320852 320852] for details.
 
See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=320852 320852] for details.
  
=== Refactoring of Primary Drag Edit Policies ===
+
=== Refactoring of Primary Drag Edit Policies (M4) ===
 
Primary drag edit policies were refactored to allow clients to easier provide custom handles and related select/drag/resize trackers.
 
Primary drag edit policies were refactored to allow clients to easier provide custom handles and related select/drag/resize trackers.
  
Line 44: Line 47:
 
The refactoring was performed in combination with the enhancement of <code>ResizeTracker</code> and <code>CreationTool</code> with support for constraints on resize and size-on-drop. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=67541 67541] for details.
 
The refactoring was performed in combination with the enhancement of <code>ResizeTracker</code> and <code>CreationTool</code> with support for constraints on resize and size-on-drop. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=67541 67541] for details.
  
=== Enhancement of ResizeTracker and CreationTool ===
+
=== Enhancement of ResizeTracker and CreationTool (M4) ===
 
Extended <code>ResizeTracker</code> and <code>CreationTool</code> so that they now offer means to enforce certain constraints (by default, minimum and maximum size constraints) during resize as well as size-on-drop (dragging during creation). This was realized by adding methods to enforce size constraints:
 
Extended <code>ResizeTracker</code> and <code>CreationTool</code> so that they now offer means to enforce certain constraints (by default, minimum and maximum size constraints) during resize as well as size-on-drop (dragging during creation). This was realized by adding methods to enforce size constraints:
  
Line 61: Line 64:
 
The logic example was enhanced to demonstrate how the new features can be used. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=67541 67541] for details.
 
The logic example was enhanced to demonstrate how the new features can be used. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=67541 67541] for details.
  
=== MarqueeSelectionTool ===
+
=== MarqueeSelectionTool (M4) ===
 
<code>MarqueeSelectionTool</code> was enhanced to now offer the following default marquee behaviors:
 
<code>MarqueeSelectionTool</code> was enhanced to now offer the following default marquee behaviors:
 
* BEHAVIOR_CONNECTIONS_TOUCHED (supported since 3.1)
 
* BEHAVIOR_CONNECTIONS_TOUCHED (supported since 3.1)
Line 81: Line 84:
 
The logic example was enhanced to demonstrate all new marquee behaviors. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=67991 67991] for details.
 
The logic example was enhanced to demonstrate all new marquee behaviors. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=67991 67991] for details.
  
=== MarqueeToolEntry ===
+
=== MarqueeToolEntry (M4) ===
 
<code>MarqueeToolEntry</code> has been enhanced to use different icons dependent on the marquee behavior of the tool.
 
<code>MarqueeToolEntry</code> has been enhanced to use different icons dependent on the marquee behavior of the tool.
  
Line 90: Line 93:
 
See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=185960 185960] for details.
 
See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=185960 185960] for details.
  
=== MatchSizeAction ===
+
=== MatchSizeAction (M4) ===
 
Similar to <code>MatchWidthAction</code> and <code>MatchHeightAction</code>, a concrete <code>MatchSizeAction</code> [[Image:MatchSizeAction.png]] was now made available.  
 
Similar to <code>MatchWidthAction</code> and <code>MatchHeightAction</code>, a concrete <code>MatchSizeAction</code> [[Image:MatchSizeAction.png]] was now made available.  
  

Revision as of 11:13, 4 January 2011

Draw2d

Refactoring of Geometry API (M4)

Geometry API was refactored to guarantee consistency between integer-precision and double-precision version of Point/PrecisionPoint, Dimension/PrecisionDimension, and Rectangle/PrecisionRectangle. Synchronization between the still exposed integer-precision fields (x, y, width, height) and the no-longer exposed double-precision fields (preciseX, preciseY, preciseWidth, preciseHeight) is performed automatically by precision classes now, so clients may use the precision versions transparently, being no longer forced to perform a manual update of the respective fields. See 124904, 142628, and 271235 for details.

Refactoring of FlowLayout and ToolbarLayout (M5)

FlowLayout and ToolbarLayout were refactored by introducing OrderedLayout a common superclass. See 88884 for details.

GEF

Refactoring of LayoutEditPolicy, ConstrainedLayoutEditPolicy, and XYLayoutEditPolicy (M4)

Layout edit policies have been refactored to remove duplicate code and allow better extensibility.

  • LayoutEditPolicy was enhanced by adding methods relevant for translations, used in all layout edit policies (removed duplicate code from subclasses):
    • Added getLayoutOrigin()(pulled up from ConstrainedLayoutEditPolicy)
    • Added translateFromAbsoluteToLayoutRelative(Translatable t) (synthesized from duplicated code spread throughout different layout edit policies)
    • Added translateFromLayoutRelativeToAbsolute(Translatable t) (synthesized from duplicated code spread throughout different layout edit policies)
  • ConstrainedLayoutEditPolicy was changed as follows:
    • Added createAddCommand(ChangeBoundsRequest request, EditPart child, Object constraint) as a replacement for createAddCommand(EditPart child, Object constraint), which was in turn deprecated (this is now handled similar as in case of change constraint commands).
    • Made createChangeConstraintCommand(EditPart child, Object constraint) concrete (empty body) and deprecated it to indicate that clients should instead createChangeConstraintCommand(ChangeBoundsRequest request, EditPart child, Object constraint)
    • Added getConstraintFor(Request request, GraphicalEditPart child, Rectangle rectangle), which subsumes the duplicate code fragments located in getConstraintFor(ChangeBoundsRequest request, GraphicalEditPart child) and getConstraintFor(CreateRequest request) before (both of these methods now delegate to the new method).
  • XYLayoutEditPolicy was changed to overwrite the
    • Replaced overwritten version of getConstraintFor(ChangeBoundsRequest request, GraphicalEditPart child) with an overwritten version of the newly introduced getConstraintFor(Request request, GraphicalEditPart child, Rectangle rect).

See 320852 for details.

Refactoring of Primary Drag Edit Policies (M4)

Primary drag edit policies were refactored to allow clients to easier provide custom handles and related select/drag/resize trackers.

  • NonResizableEditPolicy was changed by introducing hook methods to allow clients to customize the creation of handles and drag/select trackers used by them:
    • Added createDragHandle(List handles, int direction)
    • Added createMoveHandle(List handles, int direction)
    • Added createDragTracker(), which is used by createDragHandle(List handles, int direction) to construct the drag tracker for the created drag handle.
    • Added createSelectTracker(), which is used by createMoveHandle(List handles, int direction) to construct the select tracker for the created move handle.
  • ResizableEditPolicy was similarly changed by introducing the following methods:
    • Added createResizeHandle(List handles, int direction)
    • Added createResizeTracker(int), which is used by createResizeHandle(List handles, int direction) to create the resize tracker for the constructed resize handle.

The refactoring was performed in combination with the enhancement of ResizeTracker and CreationTool with support for constraints on resize and size-on-drop. See 67541 for details.

Enhancement of ResizeTracker and CreationTool (M4)

Extended ResizeTracker and CreationTool so that they now offer means to enforce certain constraints (by default, minimum and maximum size constraints) during resize as well as size-on-drop (dragging during creation). This was realized by adding methods to enforce size constraints:

  • ResizeTracker#enforceConstraintsForResize(ChangeBoundsRequest)
  • CreationTool#enforceConstraintsForSizeOnDropCreate(CreateRequest)

which are called whenever the source respectively target request is updated. By default, both ensure that minimum and maximum size constraints, which are inferred via respective hook methods:

  • ResizeTracker#getMaximumSizeFor(ChangeBoundsRequest)
  • ResizeTracker#getMinimumSizeFor(ChangeBoundsRequest)
  • CreationTool#getMaximumSizeFor(CreateRequest)
  • CreationTool#getMinimumSizeFor(CreateRequest)

Clients may overwrite the respective hook methods to infer maximum and minimum sizes for certain requests, or overwrite and adjust the enforcement of constraints as a whole (in case additional constraints have to be ensured). While the CreationTool could already be easily exchanged with a customized subclass by specifying a tool class upon construction of a CreationToolEntry, the ResizableEditPolicy was now enhanced to allow clients to specify a custom ResizeTracker as well, which will be used for all resize handles.

The logic example was enhanced to demonstrate how the new features can be used. See 67541 for details.

MarqueeSelectionTool (M4)

MarqueeSelectionTool was enhanced to now offer the following default marquee behaviors:

  • BEHAVIOR_CONNECTIONS_TOUCHED (supported since 3.1)
  • BEHAVIOR_CONNECTIONS_CONTAINED
  • BEHAVIOR_NODES_TOUCHED
  • BEHAVIOR_NODES_CONTAINED (supported since 3.1, default behavior)
  • BEHAVIOR_NODES_TOUCHED_AND_RELATED_CONNECTIONS
  • BEHAVIOR_NODES_CONTAINED_AND_RELATED_CONNECTIONS (supported since 3.1, formerly known as BEHAVIOR_NODES_AND_CONNECTIONS, which was in turn deprecated).

It was furthermore refactored to allow clients to customize marquee selection behavior via subclassing and overwriting one or more of the following methods:

  • performMarqueeSelect()
  • calculateMarqueeSelectedEditParts()
  • isMarqueeSelectable(EditPart)

The following methods are now also exposed (protected visibility) so clients can use access the current tool mode and the selection rectangle in their customization code:

  • getCurrentMarqueeSelectionRectangle()
  • getCurrentSelectionMode()

The logic example was enhanced to demonstrate all new marquee behaviors. See 67991 for details.

MarqueeToolEntry (M4)

MarqueeToolEntry has been enhanced to use different icons dependent on the marquee behavior of the tool.

  • MarqueeEntry Nodes.png BEHAVIOR_NODE_TOUCHED and BEHAVIOR_NODES_CONTAINED
  • MarqueeEntry Connections.png BEHAVIOR_CONNECTIONS_TOUCHED and BEHAVIOR_CONNECTIONS_CONTAINED
  • MarqueeEntry Nodes and Connections.png BEHAVIOR_NODES_TOUCHED_AND_RELATED_CONNECTIONS and BEHAVIOR_NODES_CONTAINED_AND_RELATED_CONNECTIONS

See 185960 for details.

MatchSizeAction (M4)

Similar to MatchWidthAction and MatchHeightAction, a concrete MatchSizeAction MatchSizeAction.png was now made available.

The logic example was enhanced to demonstrate use of the new action. See 107916 for details.

Additional Documentation Links