skrueger/geotools/MouseSelectionTracker.java

// Migration process to Geotools 2.6:
//    Because not included in gt2-2.6-M2 this class is taken 1:1
//    from Geotools 2.4.5 and made public.
//    TODO: It should be removed or included in SCHMITZM.

/*
 *    GeoTools - OpenSource mapping toolkit
 *    http://geotools.org
 *    (C) 2003-2006, Geotools Project Managment Committee (PMC)
 *    (C) 2001, Institut de Recherche pour le D�veloppement
 *
 *    This library is free software; you can redistribute it and/or
 *    modify it under the terms of the GNU Lesser General Public
 *    License as published by the Free Software Foundation; either
 *    version 2.1 of the License, or (at your option) any later version.
 *
 *    This library is distributed in the hope that it will be useful,
 *    but WITHOUT ANY WARRANTY; without even the implied warranty of
 *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *    Lesser General Public License for more details.
 */
package gtmig.org.geotools.gui.swing;

// Geometry
import java.awt.Shape;
import java.awt.Rectangle;
import java.awt.geom.Line2D;
import java.awt.geom.Point2D;
import java.awt.geom.Ellipse2D;
import java.awt.geom.Rectangle2D;
import java.awt.geom.RoundRectangle2D;
import java.awt.geom.RectangularShape;
import java.awt.geom.AffineTransform;
import java.awt.geom.NoninvertibleTransformException;

// Graphics
import java.awt.Color;
import java.awt.Component;
import java.awt.Graphics2D;

// Events
import java.awt.event.MouseEvent;
import javax.swing.event.MouseInputAdapter;


/**
 * Controller which allows the user to select a region of a component. The user must click on a
 * point in the component, then drag the mouse pointer whilst keeping the button pressed. During
 * the dragging, the shape which is drawn will normally be a rectangle.  Other shapes could always
 * be used such as, for example, an ellipse. To use this class, it is necessary to create a derived
 * class which defines the following methods:
 *
 * <ul>
 *   <li>{@link #selectionPerformed} (obligatory)</li>
 *   <li>{@link #getModel} (optional)</li>
 * </ul>
 *
 * This controller should then be registered with one, and only one, component
 * using the following syntax:
 *
 * <blockquote><pre>
 * {@link Component} component=...
 * MouseSelectionTracker control=...
 * component.addMouseListener(control);
 * </pre></blockquote>
 *
 * @since 2.0
 * @source $URL: http://svn.geotools.org/tags/2.4.5/modules/extension/widgets-swing/src/main/java/org/geotools/gui/swing/MouseSelectionTracker.java $
 * @version $Id: MouseSelectionTracker.java 22482 2006-10-31 02:58:00Z desruisseaux $
 * @author Martin Desruisseaux
 */
public abstract class MouseSelectionTracker extends MouseInputAdapter {
    /**
     * Stippled rectangle representing the region which the user is currently
     * selecting.  This rectangle can be empty.  These coordinates are only
     * significant in the period between the user pressing the mouse button
     * and then releasing it to outline a region. Conventionally, the
     * {@code null} value indicates that a line should be used instead of
     * a rectangular shape.  The coordinates are always expressed in pixels.
     */
    private transient RectangularShape mouseSelectedArea;

    /**
     * Colour to replace during XOR drawings on a graphic.
     * This colour is specified in {@link Graphics2D#setColor}.
     */
    private Color backXORColor = Color.white;

    /**
     * Colour to replace with during the XOR drawings on a graphic.
     * This colour is specified in {@link Graphics2D#setXORMode}.
     */
    private Color lineXORColor = Color.black;

    /**
     * <var>x</var> coordinate of the mouse when the button is pressed.
     */
    private transient int ox;

    /**
     * <var>y</var> coordinate of the mouse when the button is pressed.
     */
    private transient int oy;

    /**
     * <var>x</var> coordinate of the mouse during the last drag.
     */
    private transient int px;

    /**
     * <var>y</var> coordinate of the mouse during the last drag.
     */
    private transient int py;

    /**
     * Indicates whether a selection is underway.
     */
    private transient boolean isDragging;

    /**
     * Constructs an object which will allow rectangular regions to be selected using the mouse.
     */
    public MouseSelectionTracker() {
    }

    /**
     * Specifies the colours to be used for drawing the outline of a box when
     * the user selects a region.  All {@code a} colours will be replaced
     * by {@code b} colours and vice versa.
     */
    public void setXORColors(final Color a, final Color b) {
        backXORColor = a;
        lineXORColor = b;
    }

    /**
     * Returns the geometric shape to use for marking the boundaries of a region.  This shape is
     * normally a rectangle but could also be an ellipse, an arrow or even other shapes. The
     * coordinates of the returned shape will not be taken into account. In fact, these coordinates
     * will regularly be discarded. Only the class of the returned shape will count (for example,
     * {@link java.awt.geom.Ellipse2D} vs {@link java.awt.geom.Rectangle2D}) and their parameters
     * which are not linked to their position (for example, the rounding of a rectangle's
     * corners).
     * <p>
     * The shape returned will normally be from a class derived from {@link RectangularShape},
     * but could also be from the {@link Line2D} class. <strong>Any other class risks throwing a
     * {@link ClassCastException} when executed</strong>.
     *
     * The default implementation always returns an object {@link Rectangle}.
     *
     * @param  event Mouse coordinate when the button is pressed.  This information can be used by
     *         the derived classes which like to be informed of the position of the mouse before
     *         chosing a geometric shape.
     * @return Shape from the class {link RectangularShape} or {link Line2D}, or {@code null}
     *         to indicate that we do not want to make a selection.
     */
    protected Shape getModel(final MouseEvent event) {
        return new Rectangle();
    }

    /**
     * Method which is automatically called after the user selects a region with the mouse.
     * All coordinates passed in as parameters are expressed in pixels.
     *
     * @param ox <var>x</var> coordinate of the mouse when the user pressed the mouse button.
     * @param oy <var>y</var> coordinate of the mouse when the user pressed the mouse button.
     * @param px <var>x</var> coordinate of the mouse when the user released the mouse button.
     * @param py <var>y</var> coordinate of the mouse when the user released the mouse button.
     */
    protected abstract void selectionPerformed(int ox, int oy, int px, int py);

    /**
     * Returns the geometric shape surrounding the last region to be selected by the user. An
     * optional affine transform can be specified to convert the region selected by the user
     * into logical coordinates. The class of the shape returned depends on the model returned by
     * {@link #getModel}:
     *
     * <ul>
     *   <li>If the model is null (which means that this {@code MouseSelectionTracker} object only
     *       draws a line between points), the object returned will belong to the {@link Line2D}
     *       class.</li>
     *   <li>If the model is not null, the object returned can be from the same class (most often
     *       {@link java.awt.geom.Rectangle2D}). There could always be situations where the object
     *       returned is from another class, for example if the affine transform carries out a
     *       rotation.</li>
     * </ul>
     *
     * @param  transform Affine transform which converts logical coordinates into pixel coordinates.
     *         It is usually an affine transform which is used in a {@code paint(...)} method to
     *         draw shapes expressed in logical coordinates.
     * @return A geometric shape enclosing the last region to be selected by the user, or
     *         {@code null} if no selection has yet been made.
     * @throws NoninvertibleTransformException If the affine transform can't be inverted.
     */
    public Shape getSelectedArea(final AffineTransform transform) throws NoninvertibleTransformException {
        if (ox == px && oy == py) {
            return null;
        }
        RectangularShape shape = mouseSelectedArea;
        if (transform != null && !transform.isIdentity()) {
            if (shape == null) {
                final Point2D.Float po = new Point2D.Float(ox, oy);
                final Point2D.Float pp = new Point2D.Float(px, py);
                transform.inverseTransform(po, po);
                transform.inverseTransform(pp, pp);
                return new Line2D.Float(po, pp);
            } else {
                if (canReshape(shape, transform)) {
                    final Point2D.Double point = new Point2D.Double();
                    double xmin = Double.POSITIVE_INFINITY;
                    double ymin = Double.POSITIVE_INFINITY;
                    double xmax = Double.NEGATIVE_INFINITY;
                    double ymax = Double.NEGATIVE_INFINITY;
                    for (int i = 0; i < 4; i++) {
                        point.x = (i&1) == 0 ? shape.getMinX() : shape.getMaxX();
                        point.y = (i&2) == 0 ? shape.getMinY() : shape.getMaxY();
                        transform.inverseTransform(point, point);
                        if (point.x < xmin) xmin = point.x;
                        if (point.x > xmax) xmax = point.x;
                        if (point.y < ymin) ymin = point.y;
                        if (point.y > ymax) ymax = point.y;
                    }
                    if (shape instanceof Rectangle) {
                        return new Rectangle2D.Float((float) xmin,
                                                     (float) ymin,
                                                     (float) (xmax - xmin),
                                                     (float) (ymax - ymin));
                    } else {
                        shape = (RectangularShape) shape.clone();
                        shape.setFrame(xmin, ymin, xmax - xmin, ymax - ymin);
                        return shape;
                    }
                }
                else {
                    return transform.createInverse().createTransformedShape(shape);
                }
            }
        }
        else {
            return (shape != null) ? (Shape) shape.clone() : new Line2D.Float(ox, oy, px, py);
        }
    }

    /**
     * Indicates whether we can transform {@code shape} simply by calling its
     * {@code shape.setFrame(...)} method rather than by using the heavy artillery
     * that is the {@code transform.createTransformedShape(shape)} method.
     */
    private static boolean canReshape(final RectangularShape shape,
                                      final AffineTransform transform) {
        final int type=transform.getType();
        if ((type & AffineTransform.TYPE_GENERAL_TRANSFORM) != 0) return false;
        if ((type & AffineTransform.TYPE_MASK_ROTATION)     != 0) return false;
        if ((type & AffineTransform.TYPE_FLIP)              != 0) {
            if (shape instanceof Rectangle2D)      return true;
            if (shape instanceof Ellipse2D)        return true;
            if (shape instanceof RoundRectangle2D) return true;
            return false;
        }
        return true;
    }

    /**
     * Returns a {@link Graphics2D} object to be used for drawing in the specified component. We
     * must not forget to call {@link Graphics2D#dispose} when the graphics object is no longer
     * needed.
     */
    private Graphics2D getGraphics(final Component c) {
        final Graphics2D graphics = (Graphics2D) c.getGraphics();
        graphics.setXORMode(lineXORColor);
        graphics.setColor  (backXORColor);
        return graphics;
    }

    /**
     * Informs this controller that the mouse button has been pressed.
     * The default implementation retains the mouse coordinate (which will
     * become one of the corners of the future rectangle to be drawn) 
     * and prepares {@code this} to observe the mouse movements.
     *
     * @throws ClassCastException if {@link #getModel} doesn't return a shape
     *         from the class {link RectangularShape} or {link Line2D}.
     */
    public void mousePressed(final MouseEvent event) throws ClassCastException {
        if (!event.isConsumed() && (event.getModifiers() & MouseEvent.BUTTON1_MASK) != 0) {
            final Component source = event.getComponent();
            if (source != null) {
                Shape model = getModel(event);
                if (model != null) {
                    isDragging = true;
                    ox = px = event.getX();
                    oy = py = event.getY();
                    if (model instanceof Line2D) {
                        model = null;
                    }
                    mouseSelectedArea = (RectangularShape) model;
                    if (mouseSelectedArea != null) {
                        mouseSelectedArea.setFrame(ox, oy, 0, 0);
                    }
                    source.addMouseMotionListener(this);
                }
                source.requestFocus();
                event.consume();
            }
        }
    }

    /**
     * Informs this controller that the mouse has been dragged.  The default
     * implementation uses this to move a corner of the rectangle used to
     * select the region. The other corner remains fixed at the point
     * where the mouse was at the moment its button was pressed..
     */
    public void mouseDragged(final MouseEvent event) {
        if (isDragging) {
            final Graphics2D graphics = getGraphics(event.getComponent());
            if (mouseSelectedArea == null) {
                graphics.drawLine(ox, oy, px, py);
                px = event.getX();
                py = event.getY();
                graphics.drawLine(ox, oy, px, py);
            } else {
                graphics.draw(mouseSelectedArea);
                int xmin = this.ox;
                int ymin = this.oy;
                int xmax = px = event.getX();
                int ymax = py = event.getY();
                if (xmin > xmax) {
                    final int xtmp = xmin;
                    xmin = xmax; xmax = xtmp;
                }
                if (ymin > ymax) {
                    final int ytmp = ymin;
                    ymin = ymax; ymax = ytmp;
                }
                mouseSelectedArea.setFrame(xmin, ymin, xmax - xmin, ymax - ymin);
                graphics.draw(mouseSelectedArea);
            }
            graphics.dispose();
            event.consume();
        }
    }

    /**
     * Informs this controller that the mouse button has been released.
     * The default implementation calls {@link #selectionPerformed} with
     * the bounds of the selected region as parameters.
     */
    public void mouseReleased(final MouseEvent event) {
        if (isDragging && (event.getModifiers() & MouseEvent.BUTTON1_MASK) != 0) {
            isDragging = false;
            final Component component = event.getComponent();
            component.removeMouseMotionListener(this);

            final Graphics2D graphics = getGraphics(event.getComponent());
            if (mouseSelectedArea == null) {
                graphics.drawLine(ox, oy, px, py);
            } else {
                graphics.draw(mouseSelectedArea);
            }
            graphics.dispose();
            px = event.getX();
            py = event.getY();
            selectionPerformed(ox, oy, px, py);
            event.consume();
        }
    }

    /**
     * Informs this controller that the mouse has been moved but not as a
     * result of the user selecting a region.  The default implementation
     * signals to the source component that {@code this} is no longer
     * interested in being informed about mouse movements.
     */
    public void mouseMoved(final MouseEvent event) {
        // Normally not necessary, but it seems that this "listener"
        // sometimes stays in place when it shouldn't.
        event.getComponent().removeMouseMotionListener(this);
    }
}
1	// Migration process to Geotools 2.6:
2	// Because not included in gt2-2.6-M2 this class is taken 1:1
3	// from Geotools 2.4.5 and made public.
4	// TODO: It should be removed or included in SCHMITZM.
5
6	/*
7	* GeoTools - OpenSource mapping toolkit
8	* http://geotools.org
9	* (C) 2003-2006, Geotools Project Managment Committee (PMC)
10	* (C) 2001, Institut de Recherche pour le D�veloppement
11	*
12	* This library is free software; you can redistribute it and/or
13	* modify it under the terms of the GNU Lesser General Public
14	* License as published by the Free Software Foundation; either
15	* version 2.1 of the License, or (at your option) any later version.
16	*
17	* This library is distributed in the hope that it will be useful,
18	* but WITHOUT ANY WARRANTY; without even the implied warranty of
19	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20	* Lesser General Public License for more details.
21	*/
22	package gtmig.org.geotools.gui.swing;
23
24	// Geometry
25	import java.awt.Shape;
26	import java.awt.Rectangle;
27	import java.awt.geom.Line2D;
28	import java.awt.geom.Point2D;
29	import java.awt.geom.Ellipse2D;
30	import java.awt.geom.Rectangle2D;
31	import java.awt.geom.RoundRectangle2D;
32	import java.awt.geom.RectangularShape;
33	import java.awt.geom.AffineTransform;
34	import java.awt.geom.NoninvertibleTransformException;
35
36	// Graphics
37	import java.awt.Color;
38	import java.awt.Component;
39	import java.awt.Graphics2D;
40
41	// Events
42	import java.awt.event.MouseEvent;
43	import javax.swing.event.MouseInputAdapter;
44
45
46	/**
47	* Controller which allows the user to select a region of a component. The user must click on a
48	* point in the component, then drag the mouse pointer whilst keeping the button pressed. During
49	* the dragging, the shape which is drawn will normally be a rectangle. Other shapes could always
50	* be used such as, for example, an ellipse. To use this class, it is necessary to create a derived
51	* class which defines the following methods:
52	*
53	* <ul>
54	* <li>{@link #selectionPerformed} (obligatory)</li>
55	* <li>{@link #getModel} (optional)</li>
56	* </ul>
57	*
58	* This controller should then be registered with one, and only one, component
59	* using the following syntax:
60	*
61	* <blockquote><pre>
62	* {@link Component} component=...
63	* MouseSelectionTracker control=...
64	* component.addMouseListener(control);
65	* </pre></blockquote>
66	*
67	* @since 2.0
68	* @source $URL: http://svn.geotools.org/tags/2.4.5/modules/extension/widgets-swing/src/main/java/org/geotools/gui/swing/MouseSelectionTracker.java $
69	* @version $Id: MouseSelectionTracker.java 22482 2006-10-31 02:58:00Z desruisseaux $
70	* @author Martin Desruisseaux
71	*/
72	public abstract class MouseSelectionTracker extends MouseInputAdapter {
73	/**
74	* Stippled rectangle representing the region which the user is currently
75	* selecting. This rectangle can be empty. These coordinates are only
76	* significant in the period between the user pressing the mouse button
77	* and then releasing it to outline a region. Conventionally, the
78	* {@code null} value indicates that a line should be used instead of
79	* a rectangular shape. The coordinates are always expressed in pixels.
80	*/
81	private transient RectangularShape mouseSelectedArea;
82
83	/**
84	* Colour to replace during XOR drawings on a graphic.
85	* This colour is specified in {@link Graphics2D#setColor}.
86	*/
87	private Color backXORColor = Color.white;
88
89	/**
90	* Colour to replace with during the XOR drawings on a graphic.
91	* This colour is specified in {@link Graphics2D#setXORMode}.
92	*/
93	private Color lineXORColor = Color.black;
94
95	/**
96	* <var>x</var> coordinate of the mouse when the button is pressed.
97	*/
98	private transient int ox;
99
100	/**
101	* <var>y</var> coordinate of the mouse when the button is pressed.
102	*/
103	private transient int oy;
104
105	/**
106	* <var>x</var> coordinate of the mouse during the last drag.
107	*/
108	private transient int px;
109
110	/**
111	* <var>y</var> coordinate of the mouse during the last drag.
112	*/
113	private transient int py;
114
115	/**
116	* Indicates whether a selection is underway.
117	*/
118	private transient boolean isDragging;
119
120	/**
121	* Constructs an object which will allow rectangular regions to be selected using the mouse.
122	*/
123	public MouseSelectionTracker() {
124	}
125
126	/**
127	* Specifies the colours to be used for drawing the outline of a box when
128	* the user selects a region. All {@code a} colours will be replaced
129	* by {@code b} colours and vice versa.
130	*/
131	public void setXORColors(final Color a, final Color b) {
132	backXORColor = a;
133	lineXORColor = b;
134	}
135
136	/**
137	* Returns the geometric shape to use for marking the boundaries of a region. This shape is
138	* normally a rectangle but could also be an ellipse, an arrow or even other shapes. The
139	* coordinates of the returned shape will not be taken into account. In fact, these coordinates
140	* will regularly be discarded. Only the class of the returned shape will count (for example,
141	* {@link java.awt.geom.Ellipse2D} vs {@link java.awt.geom.Rectangle2D}) and their parameters
142	* which are not linked to their position (for example, the rounding of a rectangle's
143	* corners).
144	* <p>
145	* The shape returned will normally be from a class derived from {@link RectangularShape},
146	* but could also be from the {@link Line2D} class. <strong>Any other class risks throwing a
147	* {@link ClassCastException} when executed</strong>.
148	*
149	* The default implementation always returns an object {@link Rectangle}.
150	*
151	* @param event Mouse coordinate when the button is pressed. This information can be used by
152	* the derived classes which like to be informed of the position of the mouse before
153	* chosing a geometric shape.
154	* @return Shape from the class {link RectangularShape} or {link Line2D}, or {@code null}
155	* to indicate that we do not want to make a selection.
156	*/
157	protected Shape getModel(final MouseEvent event) {
158	return new Rectangle();
159	}
160
161	/**
162	* Method which is automatically called after the user selects a region with the mouse.
163	* All coordinates passed in as parameters are expressed in pixels.
164	*
165	* @param ox <var>x</var> coordinate of the mouse when the user pressed the mouse button.
166	* @param oy <var>y</var> coordinate of the mouse when the user pressed the mouse button.
167	* @param px <var>x</var> coordinate of the mouse when the user released the mouse button.
168	* @param py <var>y</var> coordinate of the mouse when the user released the mouse button.
169	*/
170	protected abstract void selectionPerformed(int ox, int oy, int px, int py);
171
172	/**
173	* Returns the geometric shape surrounding the last region to be selected by the user. An
174	* optional affine transform can be specified to convert the region selected by the user
175	* into logical coordinates. The class of the shape returned depends on the model returned by
176	* {@link #getModel}:
177	*
178	* <ul>
179	* <li>If the model is null (which means that this {@code MouseSelectionTracker} object only
180	* draws a line between points), the object returned will belong to the {@link Line2D}
181	* class.</li>
182	* <li>If the model is not null, the object returned can be from the same class (most often
183	* {@link java.awt.geom.Rectangle2D}). There could always be situations where the object
184	* returned is from another class, for example if the affine transform carries out a
185	* rotation.</li>
186	* </ul>
187	*
188	* @param transform Affine transform which converts logical coordinates into pixel coordinates.
189	* It is usually an affine transform which is used in a {@code paint(...)} method to
190	* draw shapes expressed in logical coordinates.
191	* @return A geometric shape enclosing the last region to be selected by the user, or
192	* {@code null} if no selection has yet been made.
193	* @throws NoninvertibleTransformException If the affine transform can't be inverted.
194	*/
195	public Shape getSelectedArea(final AffineTransform transform) throws NoninvertibleTransformException {
196	if (ox == px && oy == py) {
197	return null;
198	}
199	RectangularShape shape = mouseSelectedArea;
200	if (transform != null && !transform.isIdentity()) {
201	if (shape == null) {
202	final Point2D.Float po = new Point2D.Float(ox, oy);
203	final Point2D.Float pp = new Point2D.Float(px, py);
204	transform.inverseTransform(po, po);
205	transform.inverseTransform(pp, pp);
206	return new Line2D.Float(po, pp);
207	} else {
208	if (canReshape(shape, transform)) {
209	final Point2D.Double point = new Point2D.Double();
210	double xmin = Double.POSITIVE_INFINITY;
211	double ymin = Double.POSITIVE_INFINITY;
212	double xmax = Double.NEGATIVE_INFINITY;
213	double ymax = Double.NEGATIVE_INFINITY;
214	for (int i = 0; i < 4; i++) {
215	point.x = (i&1) == 0 ? shape.getMinX() : shape.getMaxX();
216	point.y = (i&2) == 0 ? shape.getMinY() : shape.getMaxY();
217	transform.inverseTransform(point, point);
218	if (point.x < xmin) xmin = point.x;
219	if (point.x > xmax) xmax = point.x;
220	if (point.y < ymin) ymin = point.y;
221	if (point.y > ymax) ymax = point.y;
222	}
223	if (shape instanceof Rectangle) {
224	return new Rectangle2D.Float((float) xmin,
225	(float) ymin,
226	(float) (xmax - xmin),
227	(float) (ymax - ymin));
228	} else {
229	shape = (RectangularShape) shape.clone();
230	shape.setFrame(xmin, ymin, xmax - xmin, ymax - ymin);
231	return shape;
232	}
233	}
234	else {
235	return transform.createInverse().createTransformedShape(shape);
236	}
237	}
238	}
239	else {
240	return (shape != null) ? (Shape) shape.clone() : new Line2D.Float(ox, oy, px, py);
241	}
242	}
243
244	/**
245	* Indicates whether we can transform {@code shape} simply by calling its
246	* {@code shape.setFrame(...)} method rather than by using the heavy artillery
247	* that is the {@code transform.createTransformedShape(shape)} method.
248	*/
249	private static boolean canReshape(final RectangularShape shape,
250	final AffineTransform transform) {
251	final int type=transform.getType();
252	if ((type & AffineTransform.TYPE_GENERAL_TRANSFORM) != 0) return false;
253	if ((type & AffineTransform.TYPE_MASK_ROTATION) != 0) return false;
254	if ((type & AffineTransform.TYPE_FLIP) != 0) {
255	if (shape instanceof Rectangle2D) return true;
256	if (shape instanceof Ellipse2D) return true;
257	if (shape instanceof RoundRectangle2D) return true;
258	return false;
259	}
260	return true;
261	}
262
263	/**
264	* Returns a {@link Graphics2D} object to be used for drawing in the specified component. We
265	* must not forget to call {@link Graphics2D#dispose} when the graphics object is no longer
266	* needed.
267	*/
268	private Graphics2D getGraphics(final Component c) {
269	final Graphics2D graphics = (Graphics2D) c.getGraphics();
270	graphics.setXORMode(lineXORColor);
271	graphics.setColor (backXORColor);
272	return graphics;
273	}
274
275	/**
276	* Informs this controller that the mouse button has been pressed.
277	* The default implementation retains the mouse coordinate (which will
278	* become one of the corners of the future rectangle to be drawn)
279	* and prepares {@code this} to observe the mouse movements.
280	*
281	* @throws ClassCastException if {@link #getModel} doesn't return a shape
282	* from the class {link RectangularShape} or {link Line2D}.
283	*/
284	public void mousePressed(final MouseEvent event) throws ClassCastException {
285	if (!event.isConsumed() && (event.getModifiers() & MouseEvent.BUTTON1_MASK) != 0) {
286	final Component source = event.getComponent();
287	if (source != null) {
288	Shape model = getModel(event);
289	if (model != null) {
290	isDragging = true;
291	ox = px = event.getX();
292	oy = py = event.getY();
293	if (model instanceof Line2D) {
294	model = null;
295	}
296	mouseSelectedArea = (RectangularShape) model;
297	if (mouseSelectedArea != null) {
298	mouseSelectedArea.setFrame(ox, oy, 0, 0);
299	}
300	source.addMouseMotionListener(this);
301	}
302	source.requestFocus();
303	event.consume();
304	}
305	}
306	}
307
308	/**
309	* Informs this controller that the mouse has been dragged. The default
310	* implementation uses this to move a corner of the rectangle used to
311	* select the region. The other corner remains fixed at the point
312	* where the mouse was at the moment its button was pressed..
313	*/
314	public void mouseDragged(final MouseEvent event) {
315	if (isDragging) {
316	final Graphics2D graphics = getGraphics(event.getComponent());
317	if (mouseSelectedArea == null) {
318	graphics.drawLine(ox, oy, px, py);
319	px = event.getX();
320	py = event.getY();
321	graphics.drawLine(ox, oy, px, py);
322	} else {
323	graphics.draw(mouseSelectedArea);
324	int xmin = this.ox;
325	int ymin = this.oy;
326	int xmax = px = event.getX();
327	int ymax = py = event.getY();
328	if (xmin > xmax) {
329	final int xtmp = xmin;
330	xmin = xmax; xmax = xtmp;
331	}
332	if (ymin > ymax) {
333	final int ytmp = ymin;
334	ymin = ymax; ymax = ytmp;
335	}
336	mouseSelectedArea.setFrame(xmin, ymin, xmax - xmin, ymax - ymin);
337	graphics.draw(mouseSelectedArea);
338	}
339	graphics.dispose();
340	event.consume();
341	}
342	}
343
344	/**
345	* Informs this controller that the mouse button has been released.
346	* The default implementation calls {@link #selectionPerformed} with
347	* the bounds of the selected region as parameters.
348	*/
349	public void mouseReleased(final MouseEvent event) {
350	if (isDragging && (event.getModifiers() & MouseEvent.BUTTON1_MASK) != 0) {
351	isDragging = false;
352	final Component component = event.getComponent();
353	component.removeMouseMotionListener(this);
354
355	final Graphics2D graphics = getGraphics(event.getComponent());
356	if (mouseSelectedArea == null) {
357	graphics.drawLine(ox, oy, px, py);
358	} else {
359	graphics.draw(mouseSelectedArea);
360	}
361	graphics.dispose();
362	px = event.getX();
363	py = event.getY();
364	selectionPerformed(ox, oy, px, py);
365	event.consume();
366	}
367	}
368
369	/**
370	* Informs this controller that the mouse has been moved but not as a
371	* result of the user selecting a region. The default implementation
372	* signals to the source component that {@code this} is no longer
373	* interested in being informed about mouse movements.
374	*/
375	public void mouseMoved(final MouseEvent event) {
376	// Normally not necessary, but it seems that this "listener"
377	// sometimes stays in place when it shouldn't.
378	event.getComponent().removeMouseMotionListener(this);
379	}
380	}