Package selector

Class PointToPointSelectionModel

java.lang.Object
selector.SelectionModel
selector.PointToPointSelectionModel
public class PointToPointSelectionModel extends SelectionModel
Models a selection tool that connects each added point with a straight line.

  • Constructor Details

    • PointToPointSelectionModel

      public PointToPointSelectionModel(boolean notifyOnEdt)
      Create a model instance with no selection and no image. If `notifyOnEdt` is true, property change listeners will be notified on Swing's Event Dispatch thread, regardless of which thread the event was fired from.

    • PointToPointSelectionModel

      public PointToPointSelectionModel(SelectionModel copy)
      Create a model instance with the same image and event notification policy as `copy`, and attempt to preserve `copy`'s selection if it can be represented without violating the invariants of this class.

  • Method Details

    • state

      public SelectionModel.SelectionState state()
      Description copied from class: SelectionModel
      Return the status of this model's current selection.
      Specified by:
      state in class SelectionModel

    • liveWire

      public PolyLine liveWire(Point p)
      Return a straight line segment from our last point to `p`.
      Specified by:
      liveWire in class SelectionModel

    • appendToSelection

      protected void appendToSelection(Point p)
      Add `p` as the next control point of our selection, extending our selection with a straight line segment from the end of the current selection path to `p`.
      Specified by:
      appendToSelection in class SelectionModel

    • movePoint

      public void movePoint(int index, Point newPos)
      Move the control point with index `index` to `newPos`. The segment that previously terminated at the point should be replaced with a straight line connecting the previous point to `newPos`, and the segment that previously started from the point should be replaced with a straight line connecting `newPos` to the next point (where "next" and "previous" wrap around as necessary). Notify listeners that the "selection" property has changed.
      Specified by:
      movePoint in class SelectionModel

    • finishSelection

      public void finishSelection()
      Description copied from class: SelectionModel
      Close the current selection path by connecting the last segment to the starting point and transitioning to a "finished" state. If no segments have been added yet, reset this selection instead. Listeners will be notified if the "state" or "selection" properties are changed. Throws an `IllegalStateException` if the selection is already finished or cannot be finished.
      Specified by:
      finishSelection in class SelectionModel

    • reset

      public void reset()
      Description copied from class: SelectionModel
      Clear the current selection path and any starting point. Listeners will be notified if the "state" or "selection" properties are changed. Subclasses should override this method in order to transition to an empty state.
      Overrides:
      reset in class SelectionModel

    • startSelection

      protected void startSelection(Point start)
      Description copied from class: SelectionModel
      When no selection has yet been started, set our first control point to `start` and transition to the appropriate state. Listeners will be notified that the "state" property has changed. Throws an `IllegalStateException` if our state is not empty.

      The default implementation checks that the state is empty and adds the control point. Subclasses must override this method in order to perform the state transition and notify listeners.

      Overrides:
      startSelection in class SelectionModel

    • undoPoint

      protected void undoPoint()
      Description copied from class: SelectionModel
      Remove the last control point from our selection. Listeners will be notified if the "state" or "selection" properties are changed.
      Specified by:
      undoPoint in class SelectionModel