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.swing;

// Geometry
import java.awt.Color;
import java.awt.Component;
import java.awt.Graphics2D;
import java.awt.Rectangle;
import java.awt.Shape;
import java.awt.event.MouseEvent;
import java.awt.geom.AffineTransform;
import java.awt.geom.Ellipse2D;
import java.awt.geom.Line2D;
import java.awt.geom.NoninvertibleTransformException;
import java.awt.geom.Point2D;
import java.awt.geom.Rectangle2D;
import java.awt.geom.RectangularShape;
import java.awt.geom.RoundRectangle2D;

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