sub_arctic.input
Interface move_drag_filter

All Known Implementing Classes:
base_interactor

public abstract interface move_drag_filter

Interface for objects that filter and transform points for purposes of limiting or transforming the action of a move-drag. This interface provides a simple API with one method which takes a point and returns a transformed point.

See Also:
move_draggable, move_drag_focus_agent

Method Summary
 java.awt.Point filter_pt(java.awt.Point original_pt, interactor drag_obj, java.awt.Point feature_pt)
          Filter a single point.
 

Method Detail

filter_pt

public java.awt.Point filter_pt(java.awt.Point original_pt,
                                interactor drag_obj,
                                java.awt.Point feature_pt)
Filter a single point. This is done for move-dragging of an object. In addition to the point being filtered (which is expressed in the parent coordinates of the object being dragged), this takes a reference to the object being dragged, and the current feature point of that object (expressed in the local coordinates of the object). The feature point represents the position within the object that is being filtered or limited (this typically defaults to the top-left corner, for example).
Parameters:
original_pt - the point to be filtered (in parent's coords)
drag_obj - the object being dragged
feature_pt - the feature point within the object being dragged that is being filtered (in object's coords)
Returns:
the location of the filtered point