Package diva.canvas.interactor

The library of interactors and other interaction support.

See:
Description

Interface Summary

Geometry	Geometry is an interface that captures the concept of an abstract figure geometry.
GrabHandle	A grab handle for manipulating figures and so on.
GrabHandleFactory	A factory so that a client can create grab handles without knowing anything about their implementation.
Interactor	An object that encapsulate the interaction that a figure plays in an interactive application.
PointConstraint	An interface implemented by classes that can constrain a point to lie within a certain set of values.
SelectionListener	A model for graph selections which can be listened to.
SelectionModel	A model for graph selections.
SelectionRenderer	An interface that defines rendering for selections.
ShapedFigure	An interface that defines the setShape() method.

Class Summary

AbstractInteractor	An abstract class that implements Interactor.
ActionInteractor	An interactor that fires an Action when a mouse pressed event occurs.
BasicGrabHandle	A basic rectangle grab-handle implementation.
BasicGrabHandleFactory	A factory that creates basic grab-handles.
BasicSelectionModel	A basic implementation of the SelectionModel interface.
BasicSelectionRenderer	A basic implementation of a selection renderer.
BoundedDragInteractor	An interactor that drags its target only within a given rectangular region.
BoundsConstraint	Keep a point within a given rectangular bounds.
BoundsGeometry	BoundsGeometry is a class that provides support for manipulating the bounds of a figure.
BoundsManipulator	A manipulator which attaches grab handles to the bounds of the child figure.
CircleGeometry	A class that provides support for manipulating the bounds of a figure.
CircleManipulator	A manipulator which attaches a grab handles to one of the bounds of the child figure.
CircleManipulator.Resizer	An interactor class that changes the bounds of the child figure and triggers a repaint.
CompositeInteractor	An interactor that forwards events to other interactors.
DragInteractor	An interactor that responds to mouse drag events.
Manipulator	A Manipulator is an object that decorates some figure, and generally paint grab-handles or some other stuff to the figure to that it can be resized and manipulated.
MoveHandle	A grab-handle that is intended for acting as a "move me" handle.
PathGeometry	PathGeometry represents a path.
PathManipulator	A manipulator which attaches grab handles to the sites of the child figure.
PathManipulator.Resizer	An interactor class that changes a vertex of the child figure and triggers a repaint.
QuadrantConstraint	Keep a point within one of the four quadrants relative to some reference point.
SelectionDragger	A class that implements rubber-banding on a canvas.
SelectionEvent	An event representing a change in the graph selection model.
SelectionInteractor	A SelectionInteractor is attached to an object that can be put into and out of a selection.

Package diva.canvas.interactor Description

The library of interactors and other interaction support. This package is built on top of the basic event-handling provided by diva.canvas.event.

An interactor is an object that captures the notion of the interaction that a figure performs. For example, in a simple graph editor I might create two interactors: one for edges and one for nodes. Each edge object has a pointer to the edge interactor (using the method setInteractor()), and the nodes similarly have pointers to the node interactor.

This means several things. First, we have a clear way to make all edges and nodes (for example) behave in the same way. Second, we can change the behaviour of all nodes or edges by modifying the one interactor. Third, we can build re-usable interaction styles as interactors.