/[schmitzm]/trunk/src/skrueger/geotools/XMapPane.java

Diff of /trunk/src/skrueger/geotools/XMapPane.java

Parent Directory | Revision Log | View Patch Patch

-trunk/src/org/geotools/gui/swing/JMapPane.java
revision 207 by alfonx,
Thu Jul  9 20:14:21 2009 UTC
+branches/1.0-gt2-2.6/src/skrueger/geotools/XMapPane.java
revision 544 by alfonx,
Sat Nov 21 17:13:31 2009 UTC
 Line 1
- /*
+ package skrueger.geotools;
-  *    GeoTools - OpenSource mapping toolkit
-  *    http://geotools.org
-  *    (C) 2002-2006, GeoTools Project Managment Committee (PMC)
-  *
-  *    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;
-  *    version 2.1 of the License.
-  *
-  *    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 org.geotools.gui.swing;
- /**
-  * <b>Xulu:<br>
-  *    Code taken from gt-2.4.5 to make some changes (marked with {@code xulu}),
-  *    which can not be realized in a subclass:</b>
-  *    <ul>
-  *       <li>{@link #getMapArea()} declared as {@code final}<li>
-  *       <li>some variables declared as {@code protected}</li>
-  *       <li>minimal/maximal zoom scale</li>
-  *       <li>zoom in and zoom out via mouse click realized by setMapArea(..)</li>
-  *    </ul>
-  * <br><br>
-  * A simple map container that is a JPanel with a map in. provides simple
-  * pan,zoom, highlight and selection The mappane stores an image of the map
-  * (drawn from the context) and an image of the slected feature(s) to speed up
-  * rendering of the highlights. Thus the whole map is only redrawn when the bbox
-  * changes, selection is only redrawn when the selected feature changes.
-  *
-  *
-  * @author Ian Turton
-  *
-  */
  import java.awt.Color;
  import java.awt.Cursor;
+ import java.awt.Font;
  import java.awt.Graphics;
  import java.awt.Graphics2D;
- import java.awt.LayoutManager;
+ import java.awt.Image;
+ import java.awt.Point;
  import java.awt.Rectangle;
+ import java.awt.RenderingHints;
+ import java.awt.event.ActionEvent;
+ import java.awt.event.ActionListener;
+ import java.awt.event.ComponentAdapter;
+ import java.awt.event.ComponentEvent;
  import java.awt.event.InputEvent;
  import java.awt.event.MouseEvent;
  import java.awt.event.MouseListener;
- import java.awt.event.MouseMotionListener;
+ import java.awt.geom.AffineTransform;
+ import java.awt.geom.NoninvertibleTransformException;
+ import java.awt.geom.Point2D;
  import java.awt.image.BufferedImage;
- import java.beans.PropertyChangeEvent;
- import java.beans.PropertyChangeListener;
  import java.io.IOException;
- import java.util.Date;
+ import java.util.ArrayList;
  import java.util.HashMap;
  import java.util.Map;
+ import java.util.Vector;
- import javax.swing.JPanel;
+ import javax.swing.Timer;
  import org.apache.log4j.Logger;
  import org.geotools.feature.FeatureCollection;
- import org.geotools.filter.IllegalFilterException;
+ import org.geotools.geometry.Envelope2D;
- import org.geotools.gui.swing.event.HighlightChangeListener;
+ import org.geotools.geometry.jts.JTS;
- import org.geotools.gui.swing.event.HighlightChangedEvent;
+ import org.geotools.geometry.jts.ReferencedEnvelope;
- import org.geotools.gui.swing.event.SelectionChangeListener;
- import org.geotools.gui.swing.event.SelectionChangedEvent;
  import org.geotools.map.DefaultMapContext;
  import org.geotools.map.MapContext;
  import org.geotools.map.MapLayer;
+ import org.geotools.map.event.MapLayerEvent;
  import org.geotools.map.event.MapLayerListEvent;
  import org.geotools.map.event.MapLayerListListener;
- import org.geotools.referencing.crs.DefaultGeographicCRS;
+ import org.geotools.map.event.MapLayerListener;
+ import org.geotools.referencing.CRS;
  import org.geotools.renderer.GTRenderer;
+ import org.geotools.renderer.label.LabelCacheImpl;
  import org.geotools.renderer.lite.LabelCache;
- import org.geotools.renderer.lite.LabelCacheDefault;
+ import org.geotools.renderer.lite.RendererUtilities;
  import org.geotools.renderer.lite.StreamingRenderer;
- import org.geotools.styling.Graphic;
+ import org.geotools.swing.JMapPane;
- import org.geotools.styling.LineSymbolizer;
+ import org.geotools.swing.event.MapMouseEvent;
- import org.geotools.styling.Mark;
+ import org.geotools.swing.event.MapPaneEvent;
- import org.geotools.styling.PointSymbolizer;
+ import org.geotools.swing.event.MapPaneListener;
- import org.geotools.styling.PolygonSymbolizer;
+ import org.opengis.feature.simple.SimpleFeature;
- import org.geotools.styling.Style;
+ import org.opengis.feature.simple.SimpleFeatureType;
- import org.geotools.styling.StyleBuilder;
+ import org.opengis.referencing.FactoryException;
- import org.geotools.styling.StyleFactory;
- import org.opengis.filter.Filter;
- import org.opengis.filter.FilterFactory2;
  import org.opengis.referencing.crs.CoordinateReferenceSystem;
+ import org.opengis.referencing.operation.MathTransform;
+ import org.opengis.referencing.operation.TransformException;
+ import schmitzm.geotools.GTUtil;
+ import schmitzm.geotools.JTSUtil;
+ import schmitzm.geotools.gui.SelectableXMapPane;
+ import schmitzm.geotools.io.GeoImportUtil;
+ import schmitzm.geotools.map.event.JMapPaneListener;
+ import schmitzm.geotools.map.event.MapLayerAdapter;
+ import schmitzm.lang.LangUtil;
+ import schmitzm.swing.JPanel;
  import schmitzm.swing.SwingUtil;
  import com.vividsolutions.jts.geom.Coordinate;
  import com.vividsolutions.jts.geom.Envelope;
  import com.vividsolutions.jts.geom.Geometry;
- import com.vividsolutions.jts.geom.GeometryFactory;
- public class JMapPane extends JPanel implements MouseListener,
-                 MouseMotionListener, HighlightChangeListener, SelectionChangeListener,
-                 PropertyChangeListener, MapLayerListListener {
-         private static Logger LOGGER = Logger.getLogger(JMapPane.class.getName());
-         private static final long serialVersionUID = -8647971481359690499L;
+ /**
+  * The {@link XMapPane} class uses a Geotools {@link GTRenderer} to paint up to
+  * two {@link MapContext}s: a "local" {@link MapContext} and a "background"
+  * {@link MapContext}. The idea is, that rendering a background layer made up of
+  * e.g. OSM data, may take much longer than rendering local data.<br>
+  * Every {@link MapContext} is rendered on a {@link Thread} of it's own.
+  * Starting/ cancelling these threads is done by the {@link RenderingExecutor}.<br>
+  * <br>
+  * While the renderers are rending the map, a <br>
+  * The {@link XMapPane} is based on schmitzm {@link JPanel}, so
+  * {@link #print(Graphics)} will automatically set the background of components
+  * to pure white.
+  *
+  * The XMapPane has a {@link MouseListener} that manages zooming.<br>
+  * A logo/icon to float in the lower left corner may be set with
+  * {@link #setMapImage(BufferedImage)}<br>
+  *
+  * @see SelectableXMapPane - an extension of {@link XMapPane} that supports
+  *      selecting features.
+  *
+  * @author stefan
+  *
+  */
+ public class XMapPane extends JPanel {
-         public static final int Reset = 0;
+         private static final int IMAGETYPE = BufferedImage.TYPE_INT_RGB;
+         private static final int IMAGETYPE_withAlpha = BufferedImage.TYPE_INT_ARGB;
-         public static final int ZoomIn = 1;
+         private static Logger LOGGER = Logger.getLogger(XMapPane.class);
-         public static final int ZoomOut = 2;
+         private boolean acceptsRepaintCalls = true;
-         public static final int Pan = 3;
+         /**
+          * Main {@link MapContext} that holds all layers that are rendered into the
+          * {@link #localImage} by the {@link #localRenderer}
+          */
+         MapContext localContext;
-         public static final int Select = 4;
+         /**
+          * {@link MapContext} holding the background layers. Use it for layers that
+          * CAN take very long for rendering, like layer from the Internet: WMS, WFS,
+          * OSM...<br>
+          * <code>null</code> by default.
+          *
+          * @see #setBgContext(MapContext)
+          * @see #getBgContext()
+          */
+         MapContext bgContext;
-         private static final int POLYGON = 0;
+         /**
+          * While threads are working, calls {@link XMapPane#updateFinalImage()}
+          * regularly and {@link #repaint()}. This {@link Timer} is stopped when all
+          * renderers have finished.
+          *
+          * @see INITIAL_REPAINT_DELAYAL
+          * @see #REPEATING_REPAINT_DELAY
+          */
+         final private Timer repaintTimer;
-         private static final int LINE = 1;
+         /**
+          * The initial delay in milliseconds until the {@link #finalImage} is
+          * updated the first time.
+          */
+         public static final int INITIAL_REPAINT_DELAY = 1000;
-         private static final int POINT = 2;
+         /**
+          * While the {@link #bgExecuter} and {@link #localExecuter} are rendering,
+          * the {@link #repaintTimer} is regularly updating the {@link #finalImage}
+          * with previews.
+          */
+         public static final int REPEATING_REPAINT_DELAY = 500;
          /**
-          * what renders the map
+          * Default delay (milliseconds) before the map will be redrawn when resizing
+          * the pane. This is to avoid flickering while drag-resizing.
+          *
+          * @see #resizeTimer
           */
-         GTRenderer renderer;
+         public static final int DEFAULT_RESIZING_PAINT_DELAY = 600;
+         private final Timer resizeTimer;
-         private GTRenderer highlightRenderer, selectionRenderer;
+         public static final int NONE = -123;
          /**
-          * the map context to render
+          * Flag fuer Modus "Kartenausschnitt bewegen". Nicht fuer Window-Auswahl
+          * moeglich!
+          *
+          * @see #setState(int)
+          */
+         public static final int PAN = 1;
+         /**
+          * Flag fuer Modus "SimpleFeature-Auswahl auf allen (sichtbaren) Layern".
+          *
+          * @see #setState(int)
+          * @see #setState(int)
+          */
+         public static final int SELECT_ALL = 103;
+         /**
+          * Flag fuer Modus
+          * "Auswahl nur eines Features, das erste sichtbare von Oben".
+          *
+          * @see #setState(int)
+          * @see #setState(int)
+          */
+         public static final int SELECT_ONE_FROM_TOP = 104;
+         /**
+          * Flag fuer Modus
+          * "SimpleFeature-Auswahl auf dem obersten (sichtbaren) Layer".
+          *
+          * @see #setState(int)
+          * @see #setState(int)
           */
-         MapContext context;
+         public static final int SELECT_TOP = 4;
-         private MapContext selectionContext;
+         public static final Cursor WAIT_CURSOR = Cursor
+                         .getPredefinedCursor(Cursor.WAIT_CURSOR);
          /**
-          * the area of the map to draw
+          * {@link Font} used to paint the wait messages into the map
+          *
+          * @see #addGadgets(Graphics2D, boolean)
           */
-         // xulu.sc
+         final static Font waitFont = new Font("Arial", Font.BOLD, 30);
-         // Envelope mapArea;
-         protected Envelope mapArea;
-         // xulu.ec
          /**
-          * the size of the pane last time we drew
+          * {@link Font} used to paint error messages into the map
+          *
+          * @see #addGadgets(Graphics2D, boolean)
           */
-         // xulu.sc
+         final static Font errorFont = new Font("Arial", Font.BOLD, 13);
-         // private Rectangle oldRect = null;
-         protected Rectangle oldRect = null;
-         // xulu.ec
          /**
-          * the last map area drawn.
+          * The wait message painted into the map while rendering is going on on
+          * another thread.
+          *
+          * @see #addGadgets(Graphics2D, boolean)
           */
-         // xulu.sc
+         final String waitMsg = SwingUtil.R("WaitMess");
-         // private Envelope oldMapArea = null;
-         protected Envelope oldMapArea = null;
-         // xulu.ec
          /**
-          * the base image of the map
+          * Flag fuer Modus "Heran zoomen".
+          *
+          * @see #setState(int)
+          * @see #setState(int)
           */
-         protected BufferedImage baseImage, panningImage;
+         public static final int ZOOM_IN = 2;
-         // SK: private BufferedImage baseImage, panningImage;
          /**
-          * image of selection
+          * Flag fuer Modus "Heraus zoomen". Nicht fuer Window-Auswahl moeglich!
+          *
+          * @see #setState(int)
           */
-         private BufferedImage selectImage;
+         public static final int ZOOM_OUT = 3;
          /**
-          * style for selected items
+          * Konvertiert die Maus-Koordinaten (relativ zum <code>JMapPane</code>) in
+          * Karten-Koordinaten.
+          *
+          * @param e
+          *            Maus-Ereignis
           */
-         private Style selectionStyle;
+         public static Point2D getMapCoordinatesFromEvent(final MouseEvent e) {
+                 // aktuelle Geo-Position aus GeoMouseEvent ermitteln
+                 if (e != null && e instanceof MapMouseEvent)
+                         try {
+                                 return ((MapMouseEvent) e).getMapPosition().toPoint2D();
+                         } catch (final Exception err) {
+                                 LOGGER
+                                                 .error(
+                                                                 "return ((GeoMouseEvent) e).getMapCoordinate(null).toPoint2D();",
+                                                                 err);
+                         }
+                 // aktuelle Geo-Position ueber Transformation des JMapPane berechnen
+                 if (e != null && e.getSource() instanceof XMapPane) {
+                         final XMapPane xMapPane = (XMapPane) e.getSource();
+                         if (!xMapPane.isWellDefined())
+                                 return null;
+                         final AffineTransform at = xMapPane.getScreenToWorld();
+                         if (at != null)
+                                 return at.transform(e.getPoint(), null);
+                         return null;
+                 }
+                 throw new IllegalArgumentException(
+                                 "MouseEvent has to be of instance MapMouseEvent or come from an XMapPane");
+         }
          /**
-          * layer that selection works on
+          * Listens to changes of the "background" {@link MapContext} and triggers
+          * repaints where needed.
           */
-         private MapLayer selectionLayer;
+         private final MapLayerListListener bgContextListener = new MapLayerListListener() {
+                 @Override
+                 public void layerAdded(final MapLayerListEvent event) {
+                         MapLayer layer = event.getLayer();
+                         layer.addMapLayerListener(bgMapLayerListener);
+                         requestStartRendering();
+                 }
+                 @Override
+                 public void layerChanged(final MapLayerListEvent event) {
+                         requestStartRendering();
+                 }
+                 @Override
+                 public void layerMoved(final MapLayerListEvent event) {
+                         requestStartRendering();
+                 }
+                 @Override
+                 public void layerRemoved(final MapLayerListEvent event) {
+                         if (event.getLayer() != null)
+                                 event.getLayer().removeMapLayerListener(bgMapLayerListener);
+                         requestStartRendering();
+                 }
+         };
          /**
-          * layer that highlight works on
+          * This {@link RenderingExecutor} manages the creation and cancellation of
+          * up to one {@link Thread} for rendering the {@link #localContext}.
           */
-         private MapLayer highlightLayer;
+         private final RenderingExecutor localExecuter = new RenderingExecutor(this);
          /**
-          * the object which manages highlighting
+          * This {@link RenderingExecutor} manages the creation and cancellation of
+          * up to one {@link Thread} for rendering the {@link #bgContext}.
           */
-         private HighlightManager highlightManager;
+         protected RenderingExecutor bgExecuter;
          /**
-          * is highlighting on or off
+          * The {@link #localRenderer} for the {@link #localContext} uses this
+          * {@link Image}.
           */
-         private boolean highlight = true;
+         private BufferedImage localImage;
          /**
-          * a factory for filters
+          * The {@link #bgRenderer} for the {@link #bgContext} uses this
+          * {@link Image}.
           */
-         FilterFactory2 ff;
+         private BufferedImage bgImage;
          /**
-          * a factory for geometries
+          * This {@link Image} is a merge of the {@link #bgImage},
+          * {@link #localImage} and {@link #addGadgets(Graphics2D, boolean)}. It is
+          * updated with {@link #updateFinalImage()} and used for painting in
+          * {@link #paintComponent(Graphics)}
           */
-         GeometryFactory gf = new GeometryFactory(); // FactoryFinder.getGeometryFactory(null);
+         private BufferedImage finalImage;
+         /**
+          * Optionally a transparent image to paint over the map in the lower right
+          * corner.
+          *
+          * @see #addGadgets(Graphics2D)
+          * @see #setMapImage(BufferedImage)
+          **/
+         private BufferedImage mapImage = null;
          /**
-          * the collections of features to be selected or highlighted
+          * Listens to each layer in the local {@link MapContext} for changes and
+          * triggers repaints.
           */
-         FeatureCollection selection;
+         protected MapLayerListener bgMapLayerListener = new MapLayerAdapter() {
+                 @Override
+                 public void layerChanged(final MapLayerEvent event) {
+                         requestStartRendering();
+                 }
+                 @Override
+                 public void layerHidden(final MapLayerEvent event) {
+                         requestStartRendering();
+                 }
+                 @Override
+                 public void layerShown(final MapLayerEvent event) {
+                         requestStartRendering();
+                 }
+         };
+         /**
+          * A flag indicating if dispose() was already called. If true, then further
+          * use of this {@link SelectableXMapPane} is undefined.
+          */
+         private boolean disposed = false;
+         /**
+          * While dragging, the {@link #updateFinalImage()} method is translating the
+          * cached images while setting it together.
+          **/
+         Point imageOrigin = new Point(0, 0);
          /**
-          * the collections of features to be selected or highlighted
+          * For every rendering thread started,
+          * {@link GTUtil#createGTRenderer(MapContext)} is called to create a new
+          * renderer. These Java2D rendering hints are passed to the
+          * {@link GTRenderer}. The java2dHints are the same for all renderers (bg
+          * and local).
           */
-         FeatureCollection highlightFeature;
+         private RenderingHints java2dHints;
-         private int state = ZoomIn;
+         protected LabelCache labelCache = new LabelCacheImpl();
          /**
-          * how far to zoom in or out
+          * Listens to changes of the "local" {@link MapContext} and triggers
+          * repaints where needed.
           */
-         private double zoomFactor = 2.0;
+         private final MapLayerListListener localContextListener = new MapLayerListListener() {
+                 @Override
+                 public void layerAdded(final MapLayerListEvent event) {
+                         event.getLayer().addMapLayerListener(localMapLayerListener);
+                         localRenderer.setContext(getContext());
+                         requestStartRendering();
+                 }
-         Style lineHighlightStyle;
+                 @Override
+                 public void layerChanged(final MapLayerListEvent event) {
+                         localRenderer.setContext(getContext());
+                         requestStartRendering();
+                 }
-         Style pointHighlightStyle;
+                 @Override
+                 public void layerMoved(final MapLayerListEvent event) {
+                         localRenderer.setContext(getContext());
+                         requestStartRendering();
+                 }
-         Style polygonHighlightStyle;
+                 @Override
+                 public void layerRemoved(final MapLayerListEvent event) {
+                         if (event.getLayer() != null)
+                                 event.getLayer().removeMapLayerListener(localMapLayerListener);
+                         localRenderer.setContext(getContext());
+                         requestStartRendering();
+                 }
+         };
-         Style polygonSelectionStyle;
+         /**
+          * Listens to each layer in the local {@link MapContext} for changes and
+          * triggers repaints.
+          */
+         protected MapLayerListener localMapLayerListener = new MapLayerAdapter() {
-         Style pointSelectionStyle;
+                 @Override
+                 public void layerChanged(final MapLayerEvent event) {
+                         localRenderer.setContext(getContext()); // betters for SLD changes?!
+                         requestStartRendering();
+                 }
-         Style lineSelectionStyle;
+                 @Override
+                 public void layerHidden(final MapLayerEvent event) {
+                         requestStartRendering();
+                 }
-         boolean changed = true;
+                 @Override
+                 public void layerShown(final MapLayerEvent event) {
+                         requestStartRendering();
+                 }
+         };
-         LabelCache labelCache = new LabelCacheDefault();
+         private final GTRenderer localRenderer = GTUtil.createGTRenderer();
-         // xulu.sc
+         private final GTRenderer bgRenderer = GTUtil.createGTRenderer();
-         // private boolean reset = false;
-         protected boolean reset = false;
-         // xulu.ec
-         int startX;
+         /**
+          * the area of the map to draw
+          */
+         protected Envelope mapArea = null;
-         int startY;
+         /**
+          * A flag set it {@link #setMapArea(Envelope)} to indicated the
+          * {@link #paintComponent(Graphics)} method, that the image on-screen is
+          * associated with {@link #oldMapArea} and may hence be scaled for a quick
+          * preview.<br>
+          * The flag is reset
+          **/
+         private boolean mapAreaChanged = false;
-         private boolean clickable;
+         /**
+          * This color is used as the default background color when painting a map.
+          */
+         private Color mapBackgroundColor = Color.WHITE;
-         int lastX;
+         /**
+          * A flag indicating that the shown image is invalid and needs to be
+          * re-rendered.
+          */
+         protected boolean mapImageInvalid = true;
-         int lastY;
+         /**
+          * Holds a flag for each layer, whether it is regarded or ignored on
+          * {@link #SELECT_TOP}, {@link #SELECT_ALL} and {@link #SELECT_ONE_FROM_TOP}
+          * actions.
+          */
+         final protected HashMap<MapLayer, Boolean> mapLayerSelectable = new HashMap<MapLayer, Boolean>();
-         private SelectionManager selectionManager;
+         /**
-         // xulu.sn
+          * List of listeners of this {@link XMapPane}
+          */
+         protected Vector<JMapPaneListener> mapPaneListeners = new Vector<JMapPaneListener>();
+         /**
+          * If not <code>null</code>, the {@link XMapPane} will not allow to zoom/pan
+          * out of that area
+          **/
+         private Envelope maxExtend = null;
          private Double maxZoomScale = Double.MIN_VALUE;
          private Double minZoomScale = Double.MAX_VALUE;
-         // xulu.en
-         // sk.sn
          /**
-          * Wenn true, dann wurde PANNING via mouseDraged-Events begonnen. Dieses
+          * We store the old mapArea for a moment to use it for the
-          * Flag wird benutzt um nur einmal den passenden Cursor nur einmal zu
+          * "quick scaled preview" in case of ZoomOut
-          * setzen.
+          **/
+         protected Envelope oldMapArea = null;
+         /**
+          * We store the old transform for a moment to use it for the
+          * "quick scaled preview" in case of ZoomIn
+          **/
+         protected AffineTransform oldScreenToWorld = null;
+         /**
+          * A flag indicating, that the image size has changed and the buffered
+          * images are not big enough any more
+          **/
+         protected boolean paneResized = false;
+         private BufferedImage preFinalImage;
+         // if null, no quick preview will be shown
+         private int quickPreviewHint = 0;
+         private Map<Object, Object> rendererHints = GTUtil
+                         .getDefaultGTRendererHints(localRenderer);
+         /**
+          * If set to <code>true</code>, the {@link #startRenderThreadsTimer} will
+          * start rendering {@link Thread}s
+          **/
+         private volatile Boolean requestStartRendering = false;
+         /**
+          * Transformation zwischen Fenster-Koordinaten und Karten-Koordinaten
+          * (lat/lon)
           */
-         private boolean panning_started = false;
+         protected AffineTransform screenToWorld = null;
-         // sk.en
+         /**
+          * The flag {@link #requestStartRendering} can be set to true by events.
+          * This {@link Timer} checks the flag regularly and starts one renderer
+          * thread.
+          */
+         final private Timer startRenderThreadsTimer;
-         public JMapPane() {
+         /**
-                 this(null, true, null, null);
+          * The default state is ZOOM_IN, hence by default the
-         }
+          * {@link #zoomMapPaneMouseListener} is also enabled.
+          **/
+         private int state = ZOOM_IN;
          /**
-          * create a basic JMapPane
+          * Manuell gesetzter statischer Cursor, unabhaengig von der aktuellen
-          *
+          * MapPane-Funktion
-          * @param render
-          *            - how to draw the map
-          * @param context
-          *            - the map context to display
           */
-         public JMapPane(GTRenderer render, MapContext context) {
+         protected Cursor staticCursor = null;
-                 this(null, true, render, context);
+         private AffineTransform worldToScreen;
+         /**
+          * This {@link MouseListener} is managing all zoom related tasks
+          */
+         public final ZoomXMapPaneMouseListener zoomMapPaneMouseListener = new ZoomXMapPaneMouseListener(
+                         this);
+         /** Is set if a renderer has an error **/
+         protected ArrayList<Exception> renderingErrors = new ArrayList<Exception>();
+         // /** If {@link #getVisibleRect()} of this {@link JPanel} is not yet
+         // defined, but we are **/
+         // private Envelope mapAreaCondidate = null;
+         public XMapPane() {
+                 this(null, null);
          }
          /**
           * full constructor extending JPanel
           *
-          * @param layout
+          * @param rendererHints
-          *            - layout (probably shouldn't be set)
+          *            may be <code>null</code>. Otherwise a {@link Map<Object,
-          * @param isDoubleBuffered
+          *            Object>} of {@link RenderingHints} to override the default
-          *            - a Swing thing I don't really understand
+          *            from {@link GTUtil#getDefaultGTRendererHints(GTRenderer)}
-          * @param render
+          *
-          *            - what to draw the map with
+          * @param localContext
-          * @param context
+          *            The main {@link MapContext} to use. If <code>null</code>, an
-          *            - what to draw
+          *            empty {@link DefaultMapContext} will be created.
           */
-         public JMapPane(LayoutManager layout, boolean isDoubleBuffered,
+         public XMapPane(final MapContext localContext_,
-                         GTRenderer render, MapContext context) {
+                         final Map<Object, Object> rendererHints) {
-                 super(layout, isDoubleBuffered);
+                 super(true);
-                 ff = (FilterFactory2) org.geotools.factory.CommonFactoryFinder
+                 setRendererHints(rendererHints);
-                                 .getFilterFactory(null);
-                 setRenderer(render);
-                 setContext(context);
+                 setOpaque(true);
-                 this.addMouseListener(this);
+                 if (localContext_ != null)
-                 this.addMouseMotionListener(this);
+                         setLocalContext(localContext_);
-                 setHighlightManager(new HighlightManager(highlightLayer));
-                 setSelectionManager(new SelectionManager(selectionLayer));
-                 lineHighlightStyle = setupStyle(LINE, Color.red);
-                 pointHighlightStyle = setupStyle(POINT, Color.red);
+                 /**
+                  * Adding the #zoomMapPaneMouseListener
+                  */
+                 this.addMouseListener(zoomMapPaneMouseListener);
+                 this.addMouseMotionListener(zoomMapPaneMouseListener);
+                 this.addMouseWheelListener(zoomMapPaneMouseListener);
-                 polygonHighlightStyle = setupStyle(POLYGON, Color.red);
+                 /*
+                  * We use a Timer object to avoid rendering delays and flickering when
+                  * the user is drag-resizing the parent container of this map pane.
+                  *
+                  * Using a ComponentListener doesn't work because, unlike a JFrame, the
+                  * pane receives a stream of events during drag-resizing.
+                  */
+                 resizeTimer = new Timer(DEFAULT_RESIZING_PAINT_DELAY,
+                                 new ActionListener() {
-                 polygonSelectionStyle = setupStyle(POLYGON, Color.cyan);
+                                         public void actionPerformed(final ActionEvent e) {
+                                                 if (!isWellDefined())
+                                                         return;
+                                                 final Rectangle bounds = getVisibleRect();
+                                                 //
+                                                 // System.out.println("\n\ntimer performs with bounds = "
+                                                 // + bounds);
+                                                 final Envelope geoMapArea = tranformWindowToGeo(
+                                                                 bounds.x, bounds.y, bounds.x + bounds.width,
+                                                                 bounds.y + bounds.height);
+                                                 if (setMapArea(geoMapArea))
+                                                         paneResized = true;
+                                                 // else
+                                                 // syso
+                                         }
+                                 });
+                 resizeTimer.setRepeats(false);
+                 this.addComponentListener(new ComponentAdapter() {
+                         @Override
+                         public void componentResized(final ComponentEvent e) {
+                                 // Already cancel the tasks...
+                                 if (bgExecuter != null)
+                                         bgExecuter.cancelTask();
+                                 if (localExecuter != null)
+                                         localExecuter.cancelTask();
-                 pointSelectionStyle = setupStyle(POINT, Color.cyan);
+                                 resizeTimer.restart();
+                         }
+                 });
+                 /*
+                  * Setting up the repaintTimer. Not started automatically.
+                  */
+                 repaintTimer = new Timer(REPEATING_REPAINT_DELAY, new ActionListener() {
+                         @Override
+                         public void actionPerformed(final ActionEvent e) {
+                                 if ((localExecuter != null && !localExecuter.isRunning())
+                                                 && (bgExecuter != null && !bgExecuter.isRunning())) {
+                                         repaintTimer.stop();
+                                 } else {
+                                         updateFinalImage();
+                                         XMapPane.this.repaint(100);
+                                 }
+                         }
+                 });
+                 repaintTimer.setInitialDelay(INITIAL_REPAINT_DELAY);
+                 repaintTimer.setRepeats(true);
+                 /*
+                  * Setting up the startRenderThreadsTimer. This Timer starts
+                  * automatically.
+                  */
+                 startRenderThreadsTimer = new Timer(100, new ActionListener() {
+                         @Override
+                         public void actionPerformed(final ActionEvent e) {
+                                 synchronized (requestStartRendering) {
+                                         if (requestStartRendering && isWellDefined()) {
+                                                 if (localExecuter.isRunning()) {
+                                                         localExecuter.cancelTask();
+                                                 } else {
+                                                         // Stupidly, but we have to recheck the
+                                                         setMapArea(getMapArea());
+                                                         requestStartRendering = false;
+                                                         startRendering();
+                                                 }
+                                         }
+                                 }
+                         }
+                 });
+                 startRenderThreadsTimer.start();
-                 lineSelectionStyle = setupStyle(LINE, Color.cyan);
-                 setCursor(new Cursor(Cursor.CROSSHAIR_CURSOR));
          }
          /**
-          * get the renderer
+          * Fuegt der Map einen Listener hinzu.
+          *
+          * @param l
+          *            neuer Listener
           */
-         public GTRenderer getRenderer() {
+         public void addMapPaneListener(final JMapPaneListener l) {
-                 return renderer;
+                 mapPaneListeners.add(l);
          }
-         public void setRenderer(GTRenderer renderer) {
+         /**
-                 Map hints = new HashMap();
+          * Korrigiert den {@link Envelope} aka {@code mapArea} auf die beste
-                 if (renderer instanceof StreamingRenderer) {
+          * erlaubte Flaeche damit die Massstabsbeschaenkungen noch eingehalten
-                         hints = renderer.getRendererHints();
+          * werden, FALLS der uebergeben Envelope nicht schon gueltig sein sollte.<br>
-                         if (hints == null) {
+          * Since 21. April 09: Before thecalculation starts, the aspect ratio is
-                                 hints = new HashMap();
+          * corrected. This change implies, that setMapArea() will most of the time
+          * not allow setting to a wrong aspectRatio.
+          *
+          * @author <a href="mailto:[email protected]">Stefan Alfons
+          *         Kr&uuml;ger</a>
+          */
+         public ReferencedEnvelope bestAllowedMapArea(ReferencedEnvelope env) {
+                 if (getWidth() == 0)
+                         return env;
+                 if (env == null)
+                         return null;
+                 Envelope newArea = null;
+                 /**
+                  * Correct the aspect Ratio before we check the rest. Otherwise we might
+                  * easily fail. We allow to grow here, because we don't check against
+                  * the maxExtend
+                  */
+                 final Rectangle curPaintArea = getVisibleRect();
+                 env = JTSUtil.fixAspectRatio(curPaintArea, env, true);
+                 final double scale = env.getWidth() / getWidth();
+                 final double centerX = env.getMinX() + env.getWidth() / 2.;
+                 final double centerY = env.getMinY() + env.getHeight() / 2.;
+                 double newWidth2 = 0;
+                 double newHeight2 = 0;
+                 if (scale < getMaxZoomScale()) {
+                         // ****************************************************************************
+                         // Wir zoomen weiter rein als erlaubt => Anpassen des envelope
+                         // ****************************************************************************
+                         newWidth2 = getMaxZoomScale() * getWidth() / 2.;
+                         newHeight2 = getMaxZoomScale() * getHeight() / 2.;
+                 } else if (scale > getMinZoomScale()) {
+                         // ****************************************************************************
+                         // Wir zoomen weiter raus als erlaubt => Anpassen des envelope
+                         // ****************************************************************************
+                         newWidth2 = getMinZoomScale() * getWidth() / 2.;
+                         newHeight2 = getMinZoomScale() * getHeight() / 2.;
+                 } else {
+                         // ****************************************************************************
+                         // Die mapArea / der Envelope ist ist gueltig! Keine Aenderungen
+                         // ****************************************************************************
+                         newArea = env;
+                 }
+                 if (newArea == null) {
+                         final Coordinate ll = new Coordinate(centerX - newWidth2, centerY
+                                         - newHeight2);
+                         final Coordinate ur = new Coordinate(centerX + newWidth2, centerY
+                                         + newHeight2);
+                         newArea = new Envelope(ll, ur);
+                 }
+                 final Envelope maxAllowedExtend = getMaxExtend();
+                 while (maxAllowedExtend != null && !maxAllowedExtend.contains(newArea)
+                                 && newArea != null && !newArea.isNull()
+                                 && !Double.isNaN(newArea.getMinX())
+                                 && !Double.isNaN(newArea.getMaxX())
+                                 && !Double.isNaN(newArea.getMinY())
+                                 && !Double.isNaN(newArea.getMaxY())) {
+                         /*
+                          * If a maxExtend is set, we have to honour that...
+                          */
+                         // Exceeds top? Move down and maybe cut
+                         if (newArea.getMaxY() > maxAllowedExtend.getMaxY()) {
+                                 final double divY = newArea.getMaxY()
+                                                 - maxAllowedExtend.getMaxY();
+                                 // LOGGER.debug("Moving area down by " + divY);
+                                 newArea = new Envelope(new Coordinate(newArea.getMinX(),
+                                                 newArea.getMinY() - divY), new Coordinate(newArea
+                                                 .getMaxX(), newArea.getMaxY() - divY));
+                                 if (newArea.getMinY() < maxAllowedExtend.getMinY()) {
+                                         // LOGGER.debug("Now it exeeds the bottom border.. cut!");
+                                         // And cut the bottom if it moved out of the area
+                                         newArea = new Envelope(new Coordinate(newArea.getMinX(),
+                                                         maxAllowedExtend.getMinY()), new Coordinate(newArea
+                                                         .getMaxX(), newArea.getMaxY()));
+                                         // LOGGER.debug("and fix aspect ratio");
+                                         newArea = JTSUtil.fixAspectRatio(getVisibleRect(),
+                                                         new ReferencedEnvelope(newArea, env
+                                                                         .getCoordinateReferenceSystem()), false);
+                                 }
                          }
-                         if (hints.containsKey(StreamingRenderer.LABEL_CACHE_KEY)) {
-                                 labelCache = (LabelCache) hints
+                         // Exceeds bottom? Move up and maybe cut
-                                                 .get(StreamingRenderer.LABEL_CACHE_KEY);
+                         if (newArea.getMinY() < maxAllowedExtend.getMinY()) {
-                         } else {
+                                 final double divY = newArea.getMinY()
-                                 hints.put(StreamingRenderer.LABEL_CACHE_KEY, labelCache);
+                                                 - maxAllowedExtend.getMinY();
+                                 // LOGGER.debug("Moving area up by " + divY);
+                                 newArea = new Envelope(new Coordinate(newArea.getMinX(),
+                                                 newArea.getMinY() - divY), new Coordinate(newArea
+                                                 .getMaxX(), newArea.getMaxY() - divY));
+                                 if (newArea.getMaxY() > maxAllowedExtend.getMaxY()) {
+                                         // LOGGER.debug("Now it exeeds the top border.. cut!");
+                                         // And cut the bottom if it moved out of the area
+                                         newArea = new Envelope(new Coordinate(newArea.getMinX(),
+                                                         newArea.getMinY()), new Coordinate(newArea
+                                                         .getMaxX(), maxAllowedExtend.getMaxY()));
+                                         // LOGGER.debug("and fix aspect ratio");
+                                         newArea = JTSUtil.fixAspectRatio(getVisibleRect(),
+                                                         new ReferencedEnvelope(newArea, env
+                                                                         .getCoordinateReferenceSystem()), false);
+                                 }
                          }
-                         renderer.setRendererHints(hints);
-                 }
-                 this.renderer = renderer;
+                         // Exceeds to the right? move and maybe cut
- //              this.highlightRenderer = new StreamingRenderer();
+                         if (newArea.getMaxX() > maxAllowedExtend.getMaxX()) {
- //              this.selectionRenderer = new StreamingRenderer();
-                 hints.put("memoryPreloadingEnabled", Boolean.FALSE);
+                                 // Move left..
- //              highlightRenderer.setRendererHints(hints);
+                                 final double divX = newArea.getMaxX()
- //              selectionRenderer.setRendererHints(hints);
+                                                 - maxAllowedExtend.getMaxX();
+                                 // LOGGER.debug("Moving area left by " + divX);
+                                 newArea = new Envelope(new Coordinate(newArea.getMinX() - divX,
+                                                 newArea.getMinY()), new Coordinate(newArea.getMaxX()
+                                                 - divX, newArea.getMaxY()));
+                                 if (newArea.getMinX() < maxAllowedExtend.getMinX()) {
+                                         // LOGGER.debug("Now it exeeds the left border.. cut!");
+                                         // And cut the left if it moved out of the area
+                                         newArea = new Envelope(new Coordinate(maxAllowedExtend
+                                                         .getMinX(), newArea.getMinY()), new Coordinate(
+                                                         newArea.getMaxX(), newArea.getMaxY()));
+                                         // LOGGER.debug("and fix aspect ratio");
+                                         newArea = JTSUtil.fixAspectRatio(getVisibleRect(),
+                                                         new ReferencedEnvelope(newArea, env
+                                                                         .getCoordinateReferenceSystem()), false);
+                                 }
+                         }
+                         // Exceeds to the left? move and maybe cut
+                         if (newArea.getMinX() < maxAllowedExtend.getMinX()) {
-                 if (this.context != null) {
+                                 // Move right..
-                         this.renderer.setContext(this.context);
+                                 final double divX = newArea.getMinX()
+                                                 - maxAllowedExtend.getMinX();
+                                 // LOGGER.debug("Moving area right by " + divX);
+                                 newArea = new Envelope(new Coordinate(newArea.getMinX() - divX,
+                                                 newArea.getMinY()), new Coordinate(newArea.getMaxX()
+                                                 - divX, newArea.getMaxY()));
+                                 if (newArea.getMaxX() > maxAllowedExtend.getMaxX()) {
+                                         // LOGGER.debug("Now it exeeds the right border.. cut!");
+                                         // And cut the left if it moved out of the area
+                                         newArea = new Envelope(new Coordinate(newArea.getMinX(),
+                                                         newArea.getMinY()), new Coordinate(maxAllowedExtend
+                                                         .getMaxX(), newArea.getMaxY()));
+                                         // LOGGER.debug("and fix aspect ratio");
+                                         newArea = JTSUtil.fixAspectRatio(getVisibleRect(),
+                                                         new ReferencedEnvelope(newArea, env
+                                                                         .getCoordinateReferenceSystem()), false);
+                                 }
+                         }
                  }
-         }
-         public MapContext getContext() {
+                 return new ReferencedEnvelope(newArea, env
-                 return context;
+                                 .getCoordinateReferenceSystem());
          }
-         public void setContext(MapContext context) {
+         /**
-                 if (this.context != null) {
+          * Should be called when the {@link JMapPane} is not needed no more to help
-                         this.context.removeMapLayerListListener(this);
+          * the GarbageCollector
-                 }
+          *
+          * Removes all {@link JMapPaneListener}s that are registered
+          *
+          * @author <a href="mailto:[email protected]">Stefan Alfons
+          *         Kr&uuml;ger</a>
+          */
+         public void dispose() {
+                 if (isDisposed())
+                         return;
-                 this.context = context;
+                 setPainting(false);
-                 if (context != null) {
+                 resizeTimer.stop();
-                         this.context.addMapLayerListListener(this);
+                 startRenderThreadsTimer.stop();
+                 disposed = true;
+                 if (bgExecuter != null) {
+                         bgExecuter.cancelTask();
+                         bgExecuter.dispose();
                  }
-                 if (renderer != null) {
+                 if (localExecuter != null) {
-                         renderer.setContext(this.context);
+                         int i = 0;
+                         localExecuter.cancelTask();
+                         while (i++ < 10 && localExecuter.isRunning()) {
+                                 try {
+                                         Thread.sleep(200);
+                                 } catch (final InterruptedException e) {
+                                         LOGGER
+                                                         .warn(
+                                                                         "while XMapPane we are waiting for the localExcutor to stop",
+                                                                         e);
+                                 }
+                         }
+                         if (localExecuter.isRunning()) {
+                                 LOGGER
+                                                 .warn("localExecutor Thread still running after 2s! Continuing anyways...");
+                         }
+                         localExecuter.dispose();
                  }
-         }
-         public Envelope getMapArea() {
+                 disposeImages();
-                 return mapArea;
-         }
-         public void setMapArea(Envelope mapArea) {
+                 // Remove all mapPaneListeners that have registered with us
-                 this.mapArea = mapArea;
+                 mapPaneListeners.clear();
-         }
-         public int getState() {
+                 removeMouseMotionListener(zoomMapPaneMouseListener);
-                 return state;
+                 removeMouseListener(zoomMapPaneMouseListener);
-         }
-         public void setState(int state) {
+                 if (localContext != null)
-                 this.state = state;
+                         getContext().clearLayerList();
+                 if (bgContext != null)
+                         getBgContext().clearLayerList();
-                 // System.out.println("State: " + state);
+                 removeAll();
          }
-         public double getZoomFactor() {
+         /**
-                 return zoomFactor;
+          * Draws a rectangle in XOR mode from the origin at {@link #startPos} to the
-         }
+          * given point. All in screen coordinates.
+          */
+         protected void drawRectangle(final Graphics graphics, final Point startPos,
+                         final Point e) {
-         public void setZoomFactor(double zoomFactor) {
+                 if (!isWellDefined())
-                 this.zoomFactor = zoomFactor;
+                         return;
-         }
-         public MapLayer getSelectionLayer() {
+                 // undraw last box/draw new box
-                 return selectionLayer;
+                 final int left = Math.min(startPos.x, e.x);
-         }
+                 final int right = Math.max(startPos.x, e.x);
+                 final int top = Math.max(startPos.y, e.y);
+                 final int bottom = Math.min(startPos.y, e.y);
+                 final int width = right - left;
+                 final int height = top - bottom;
-         public void setSelectionLayer(MapLayer selectionLayer) {
+                 if (width == 0 && height == 0)
-                 this.selectionLayer = selectionLayer;
+                         return;
-                 if (selectionManager != null) {
-                         selectionManager.setSelectionLayer(selectionLayer);
-                 }
-         }
-         public boolean isHighlight() {
+                 graphics.setXORMode(Color.WHITE);
-                 return highlight;
+                 graphics.drawRect(left, bottom, width, height);
          }
-         public void setHighlight(boolean highlight) {
+         /**
-                 this.highlight = highlight;
+          * Diretly paints scaled preview into the {@link SelectableXMapPane}. Used
-         }
+          * to give the user something to look at while we are rendering. Method
+          * should be called after {@link #setMapArea(Envelope)} has been set to the
+          * new mapArea and transform has been reset.<br>
+          *
+          * @param g
+          *            Graphics2D to paint the preview into
+          *
+          * @param state
+          *            Max be {@link #ZOOM_IN} or {@link #ZOOM_OUT}
+          */
+         protected boolean drawScaledPreviewImage_Zoom(final Graphics2D graphics) {
-         public MapLayer getHighlightLayer() {
+                 // if (1 == 1)return false;
-                 return highlightLayer;
-         }
-         public void setHighlightLayer(MapLayer highlightLayer) {
+                 if (quickPreviewHint == 0)
-                 this.highlightLayer = highlightLayer;
+                         return false;
-                 if (highlightManager != null) {
+                 graphics.setRenderingHint(RenderingHints.KEY_INTERPOLATION,
-                         highlightManager.setHighlightLayer(highlightLayer);
+                                 RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR);
-                 }
+                 graphics.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
-         }
+                                 RenderingHints.VALUE_ANTIALIAS_OFF);
+                 graphics.setRenderingHint(RenderingHints.KEY_RENDERING,
+                                 RenderingHints.VALUE_RENDER_SPEED);
-         public HighlightManager getHighlightManager() {
+                 if (oldMapArea == null)
-                 return highlightManager;
+                         return false;
-         }
-         public void setHighlightManager(HighlightManager highlightManager) {
+                 final Rectangle visibleArea = getVisibleRect();
-                 this.highlightManager = highlightManager;
-                 this.highlightManager.addHighlightChangeListener(this);
-                 this.addMouseMotionListener(this.highlightManager);
-         }
-         public Style getLineHighlightStyle() {
+                 // Calculate the oldMapArea in the current WindowCoordinates:
-                 return lineHighlightStyle;
+                 final Envelope oldMapWindow = tranformGeoToWindow(oldMapArea.getMinX(),
-         }
+                                 oldMapArea.getMinY(), oldMapArea.getMaxX(), oldMapArea
+                                                 .getMaxY());
-         public void setLineHighlightStyle(Style lineHighlightStyle) {
+                 final int xx1 = (int) Math.round(oldMapWindow.getMinX());
-                 this.lineHighlightStyle = lineHighlightStyle;
+                 final int yy1 = (int) Math.round(oldMapWindow.getMinY());
-         }
+                 final int xx2 = (int) Math.round(oldMapWindow.getMaxX());
+                 final int yy2 = (int) Math.round(oldMapWindow.getMaxY());
-         public Style getLineSelectionStyle() {
+                 graphics.drawImage(getPreFinalImage(), xx1, yy1, xx2, yy2,
-                 return lineSelectionStyle;
+                                 (int) visibleArea.getMinX(), (int) visibleArea.getMinY(),
-         }
+                                 (int) visibleArea.getMaxX(), (int) visibleArea.getMaxY(),
+                                 getMapBackgroundColor(), null);
-         public void setLineSelectionStyle(Style lineSelectionStyle) {
+                 final Rectangle painedArea = new Rectangle(xx1, yy1, xx2 - xx1, yy2
-                 this.lineSelectionStyle = lineSelectionStyle;
+                                 - yy1);
-         }
-         public Style getPointHighlightStyle() {
+                 SwingUtil.clearAround(graphics, painedArea, visibleArea);
-                 return pointHighlightStyle;
-         }
-         public void setPointHighlightStyle(Style pointHighlightStyle) {
+                 addGadgets(graphics, true);
-                 this.pointHighlightStyle = pointHighlightStyle;
-         }
+                 quickPreviewHint = 0;
-         public Style getPointSelectionStyle() {
+                 repaintTimer.restart();
-                 return pointSelectionStyle;
+                 graphics.dispose();
+                 // Something has been drawn
+                 return true;
          }
-         public void setPointSelectionStyle(Style pointSelectionStyle) {
+         public MapContext getBgContext() {
-                 this.pointSelectionStyle = pointSelectionStyle;
+                 return bgContext;
          }
-         public Style getPolygonHighlightStyle() {
+         /**
-                 return polygonHighlightStyle;
+          * Lazyly initializes a {@link BufferedImage} for the background renderer.
+          */
+         private Image getBgImage() {
+                 //
+                 // if (bgImage == null) {
+                 // bgImage = createImage(getBounds().width, getBounds().height);
+                 // }
+                 return bgImage;
          }
-         public void setPolygonHighlightStyle(Style polygonHighlightStyle) {
+         public MapContext getContext() {
-                 this.polygonHighlightStyle = polygonHighlightStyle;
+                 if (localContext == null) {
+                         setLocalContext(new DefaultMapContext());
+                 }
+                 return localContext;
          }
-         public Style getPolygonSelectionStyle() {
+         private BufferedImage getFinalImage() {
-                 return polygonSelectionStyle;
+                 //
+                 if (finalImage == null) {
+                         // Rectangle curPaintArea = getVisibleRect();
+                         finalImage = new BufferedImage(getVisibleRect().width,
+                                         getVisibleRect().height, IMAGETYPE);
+                         requestStartRendering();
+                 }
+                 return finalImage;
          }
-         public void setPolygonSelectionStyle(Style polygonSelectionStyle) {
+         public RenderingHints getJava2dHints() {
-                 this.polygonSelectionStyle = polygonSelectionStyle;
+                 return java2dHints;
          }
-         protected void paintComponent(Graphics g) {
+         /**
-                 super.paintComponent(g);
+          * Lazyly initializes a {@link BufferedImage} for the background renderer.
+          */
+         private BufferedImage getLocalImage() {
-                 if ((renderer == null) || (mapArea == null)) {
+                 if (localImage == null) {
-                         return;
+                         localImage = new BufferedImage(getVisibleRect().width,
+                                         getVisibleRect().height, IMAGETYPE_withAlpha);
                  }
-                 Rectangle r = getBounds();
+                 return localImage;
-                 Rectangle dr = new Rectangle(r.width, r.height);
+         }
+         /**
+          * Returns a copy of the mapArea
+          *
+          * @return
+          */
+         public ReferencedEnvelope getMapArea() {
+                 if (mapArea == null) {
+                         ReferencedEnvelope mapArea_ = null;
+                         try {
+                                 mapArea_ = localContext.getLayerBounds();
+                         } catch (final IOException e) {
+                                 LOGGER.warn("localContext.getLayerBounds()", e);
+                         }
-                 if (!r.equals(oldRect) || reset) {
+                         if (mapArea_ == null && bgContext != null) {
-                         if (!r.equals(oldRect) && (mapArea == null)) {
                                  try {
-                                         mapArea = context.getLayerBounds();
+                                         mapArea_ = bgContext.getLayerBounds();
-                                 } catch (IOException e) {
+                                 } catch (final IOException e) {
-                                         // TODO Auto-generated catch block
+                                         LOGGER.warn("bgContext.getLayerBounds()", e);
-                                         e.printStackTrace();
                                  }
                          }
-                         if (mapArea != null) {
+                         if (mapArea_ != null) {
-                                 /* either the viewer size has changed or we've done a reset */
+                                 mapArea = bestAllowedMapArea(mapArea_);
-                                 changed = true; /* note we need to redraw */
+                                 requestStartRendering();
-                                 reset = false; /* forget about the reset */
-                                 oldRect = r; /* store what the current size is */
-                                 mapArea = fixAspectRatio(r, mapArea);
                          }
                  }
-                 if (!mapArea.equals(oldMapArea)) { /* did the map extent change? */
+                 if (mapArea == null)
-                         changed = true;
+                         return null;
-                         oldMapArea = mapArea;
-                         // when we tell the context that the bounds have changed WMSLayers
-                         // can refresh them selves
-                         context.setAreaOfInterest(mapArea, context
-                                         .getCoordinateReferenceSystem());
-                 }
-                 if (changed ) { /* if the map changed then redraw */
+                 // TODO is needed at all, this should go to setMapArea maybe
-                         changed = false;
+                 if (localContext.getCoordinateReferenceSystem() == null)
-                         baseImage = new BufferedImage(dr.width, dr.height,
+                         try {
-                                         BufferedImage.TYPE_INT_ARGB);
+                                 localContext.setCoordinateReferenceSystem(GeoImportUtil
+                                                 .getDefaultCRS());
+                         } catch (Exception e) {
+                                 throw new RuntimeException("setting context CRS:", e);
+                         }
-                         Graphics2D ig = baseImage.createGraphics();
+                 return new ReferencedEnvelope(mapArea, localContext
-                         /* System.out.println("rendering"); */
+                                 .getCoordinateReferenceSystem());
-                         renderer.setContext(context);
+         }
-                         labelCache.clear(); // work around anoying labelcache bug
-                         // draw the map
+         /**
-                         renderer.paint((Graphics2D) ig, dr, mapArea);
+          * Returns the background {@link Color} of the map pane. Default is white.
+          **/
+         public Color getMapBackgroundColor() {
+                 return mapBackgroundColor;
+         }
-                         // TODO nur machen, wenn panning beginnt
+         /**
-                         panningImage = new BufferedImage(dr.width, dr.height,
+          * Get the BufferedImage to use as a flaoting icon in the lower right
-                                         BufferedImage.TYPE_INT_RGB);
+          * corner.
+          *
+          * @return <code>null</code> if the feature is deactivated.
+          */
+         public BufferedImage getMapImage() {
+                 return mapImage;
+         }
-                 }
+         /**
+          * Returns the evelope of the viewable area. The JMapPane will never show
+          * anything outside of this extend. If this has been set to
+          * <code>null</code> via {@link #setMaxExtend(Envelope)}, it tries to return
+          * quickly the context's bounds. It it takes to long to determine the
+          * context bounds, <code>null</code> is returned.
+          *
+          * @param maxExtend
+          *            <code>null</code> to not have this restriction.
+          */
-                 ((Graphics2D) g).drawImage(baseImage, 0, 0, this);
+         public Envelope getMaxExtend() {
+                 if (maxExtend == null) {
+                         final ReferencedEnvelope layerBounds = GTUtil
+                                         .getVisibleLayoutBounds(localContext);
+                         if (layerBounds == null) {
+                                 // TODO Last fallback could be the CRS valid area
+                                 return null;
+                         }
-                 if ((selection != null) && (selection.size() > 0)) {
+                         // Kartenbereich um 10% vergroessern
-                         // paint selection
+                         return JTSUtil.fixAspectRatio(getVisibleRect(), JTSUtil
+                                         .expandEnvelope(layerBounds, 0.1), true);
+                 }
+                 return maxExtend;
+         }
-                         String type = selectionLayer.getFeatureSource().getSchema()
+         /**
-                                         .getDefaultGeometry().getType().getName();
+          * Retuns the maximum allowed zoom scale. This is the smaller number value
-                         /* String type = selection.getDefaultGeometry().getGeometryType(); */
+          * of the two. Defaults to {@link Double}.MIN_VALUE
-                         /* System.out.println(type); */
+          *
-                         if (type == null)
+          * @author <a href="mailto:[email protected]">Stefan Alfons
-                                 type = "polygon";
+          *         Kr&uuml;ger</a>
+          */
+         public Double getMaxZoomScale() {
+                 return maxZoomScale;
+         }
-                         /* String type = "point"; */
+         /**
+          * Retuns the minimum allowed zoom scale. This is the bigger number value of
+          * the two. Defaults to {@link Double}.MAX_VALUE
+          *
+          * @author <a href="mailto:[email protected]">Stefan Alfons
+          *         Kr&uuml;ger</a>
+          */
+         public Double getMinZoomScale() {
+                 return minZoomScale;
+         }
-                         if (type.toLowerCase().endsWith("polygon")) {
+         private Image getPreFinalImage() {
-                                 selectionStyle = polygonSelectionStyle;
+                 // if (preFinalImage == null) {
-                         } else if (type.toLowerCase().endsWith("point")) {
+                 //
-                                 selectionStyle = pointSelectionStyle;
+                 // // Rectangle curPaintArea = getVisibleRect();
-                         } else if (type.toLowerCase().endsWith("line")) {
+                 // // preFinalImage = new BufferedImage(curPaintArea.width,
-                                 selectionStyle = lineSelectionStyle;
+                 // // curPaintArea.height, BufferedImage.TYPE_INT_RGB);
-                         }
+                 //
+                 // preFinalImage = createImage(getBounds().width, getBounds().height);
+                 //
+                 // requestStartRendering();
+                 // }
+                 return preFinalImage;
+         }
+         public Map<Object, Object> getRendererHints() {
+                 // Clear label cache
+                 labelCache.clear();
+                 rendererHints.put(StreamingRenderer.LABEL_CACHE_KEY, labelCache);
-                         selectionContext = new DefaultMapContext(DefaultGeographicCRS.WGS84);
+                 return rendererHints;
+         }
-                         selectionContext.addLayer(selection, selectionStyle);
+         /**
-                         selectionRenderer.setContext(selectionContext);
+          * Liefert eine affine Transformation, um von den Fenster-Koordinaten in die
+          * Karten-Koordinaten (Lat/Lon) umzurechnen.
+          *
+          * @return eine Kopie der aktuellen Transformation; <code>null</code> wenn
+          *         noch keine Karte angezeigt wird
+          */
+         public AffineTransform getScreenToWorld() {
+                 if (screenToWorld == null)
+                         resetTransforms();
+                 // nur Kopie der Transformation zurueckgeben!
+                 if (screenToWorld == null)
+                         return null;
+                 return new AffineTransform(screenToWorld);
+         }
-                         selectImage = new BufferedImage(dr.width, dr.height,
+         public int getState() {
-                                         BufferedImage.TYPE_INT_ARGB);
+                 return state;
+         }
-                         Graphics2D ig = selectImage.createGraphics();
+         /**
-                         /* System.out.println("rendering selection"); */
+          * Liefert den statisch eingestellten Cursor, der unabhaengig von der
-                         selectionRenderer.paint((Graphics2D) ig, dr, mapArea);
+          * eingestellten MapPane-Aktion (Zoom, Auswahl, ...) verwendet wird.
+          *
+          * @return {@code null}, wenn kein statischer Cursor verwendet, sondern der
+          *         Cursor automatisch je nach MapPane-Aktion eingestellt wird.
+          */
+         public Cursor getStaticCursor() {
+                 return this.staticCursor;
+         }
-                         ((Graphics2D) g).drawImage(selectImage, 0, 0, this);
+         public AffineTransform getWorldToScreenTransform() {
+                 if (worldToScreen == null) {
+                         resetTransforms();
                  }
+                 // nur Kopie der Transformation zurueckgeben!
+                 return new AffineTransform(worldToScreen);
+         }
-                 if (highlight && (highlightFeature != null)
+         /**
-                                 && (highlightFeature.size() > 0)) {
+          * A flag indicating if dispose() has already been called. If true, then
-                         /*
+          * further use of this {@link SelectableXMapPane} is undefined.
-                          * String type = selection.getDefaultGeometry().getGeometryType();
+          */
-                          * System.out.println(type); if(type==null) type="polygon";
+         private boolean isDisposed() {
-                          */
+                 return disposed;
-                         String type = highlightLayer.getFeatureSource().getSchema()
+         }
-                                         .getDefaultGeometry().getType().getName();
-                         /* String type = selection.getDefaultGeometry().getGeometryType(); */
-                         // System.out.println(type);
-                         if (type == null)
-                                 type = "polygon";
-                         /* String type = "point"; */
-                         Style highlightStyle = null;
-                         if (type.toLowerCase().endsWith("polygon")) {
-                                 highlightStyle = polygonHighlightStyle;
-                         } else if (type.toLowerCase().endsWith("point")) {
-                                 highlightStyle = pointHighlightStyle;
-                         } else if (type.toLowerCase().endsWith("line")) {
-                                 highlightStyle = lineHighlightStyle;
-                         }
-                         MapContext highlightContext = new DefaultMapContext(
-                                         DefaultGeographicCRS.WGS84);
-                         highlightContext.addLayer(highlightFeature, highlightStyle);
-                         highlightRenderer.setContext(highlightContext);
-                         /* System.out.println("rendering highlight"); */
+         /**
-                         highlightRenderer.paint((Graphics2D) g, dr, mapArea);
+          * Returns whether a layer is regarded or ignored on {@link #SELECT_TOP},
-                 }
+          * {@link #SELECT_ALL} and {@link #SELECT_ONE_FROM_TOP} actions. Returns
+          * <code>true</code> if the selectability has not been defined.
+          *
+          * @param layer
+          *            a layer
+          */
+         public boolean isMapLayerSelectable(final MapLayer layer) {
+                 final Boolean selectable = mapLayerSelectable.get(layer);
+                 return selectable == null ? true : selectable;
          }
-         private Envelope fixAspectRatio(Rectangle r, Envelope mapArea) {
+         /**
+          * Return <code>true</code> if a CRS and a {@link #mapArea} are set and the
+          * {@link XMapPane} is visible and has bounds set.
+          */
+         public boolean isWellDefined() {
+                 try {
+                         if (getContext() == null)
+                                 return false;
+                         if (getContext().getLayerCount() <= 0)
+                                 return false;
+                         if (getVisibleRect().getWidth() == 0)
+                                 return false;
+                         if (getVisibleRect().getHeight() == 0)
+                                 return false;
+                         // if (getMapArea() == null)
+                         // return false;
+                 } catch (final Exception e) {
+                         return false;
+                 }
+                 return true;
+         }
-                 double mapWidth = mapArea.getWidth(); /* get the extent of the map */
+         public void mouseDragged(final Point startPos, final Point lastPos,
-                 double mapHeight = mapArea.getHeight();
+                         final MouseEvent event) {
-                 double scaleX = r.getWidth() / mapArea.getWidth(); /*
-                                                                                                                          * calculate the new
-                                                                                                                          * scale
-                                                                                                                          */
-                 double scaleY = r.getHeight() / mapArea.getHeight();
+                 if ((getState() == XMapPane.PAN)
-                 double scale = 1.0; // stupid compiler!
+                                 || ((event.getModifiersEx() & InputEvent.BUTTON3_DOWN_MASK) != 0)) {
-                 if (scaleX < scaleY) { /* pick the smaller scale */
+                         if (getCursor() != SwingUtil.PANNING_CURSOR) {
-                         scale = scaleX;
+                                 setCursor(SwingUtil.PANNING_CURSOR);
-                 } else {
-                         scale = scaleY;
-                 }
-                 /* calculate the difference in width and height of the new extent */
+                                 // While panning, we deactivate the rendering. So the tasts are
-                 double deltaX = /* Math.abs */((r.getWidth() / scale) - mapWidth);
+                                 // ready to start when the panning os done.
-                 double deltaY = /* Math.abs */((r.getHeight() / scale) - mapHeight);
+                                 if (bgExecuter != null)
+                                         bgExecuter.cancelTask();
+                                 if (localExecuter != null)
+                                         localExecuter.cancelTask();
+                         }
-                 /*
+                         if (lastPos.x > 0 && lastPos.y > 0) {
-                  * System.out.println("delta x " + deltaX);
+                                 final int dx = event.getX() - lastPos.x;
-                  * System.out.println("delta y " + deltaY);
+                                 final int dy = event.getY() - lastPos.y;
-                  */
+                                 // TODO Stop dragging when the drag would not be valid...
+                                 // boolean dragValid = true;
+                                 // // check if this panning results in a valid mapArea
+                                 // {
+                                 // Rectangle winBounds = xMapPane.getBounds();
+                                 // winBounds.translate(xMapPane.imageOrigin.x,
+                                 // -xMapPane.imageOrigin.y);
+                                 // Envelope newMapAreaBefore = xMapPane.tranformWindowToGeo(
+                                 // winBounds.x, winBounds.y, winBounds.x
+                                 // + winBounds.width, winBounds.y
+                                 // + winBounds.height);
+                                 //
+                                 //
+                                 // winBounds = xMapPane.getBounds();
+                                 // Point testIng = new Point(xMapPane.imageOrigin);
+                                 // testIng.translate(dx, dy);
+                                 // winBounds.translate(testIng.x, -testIng.y);
+                                 // Envelope newMapAreaAfter = xMapPane.tranformWindowToGeo(
+                                 // winBounds.x, winBounds.y, winBounds.x
+                                 // + winBounds.width, winBounds.y
+                                 // + winBounds.height);
+                                 //
+                                 // // If the last drag doesn't change the MapArea anymore cancel
+                                 // it.
+                                 // if (xMapPane.bestAllowedMapArea(newMapAreaAfter).equals(
+                                 // xMapPane.bestAllowedMapArea(newMapAreaBefore))){
+                                 // dragValid = false;
+                                 // return;
+                                 // }
+                                 // }
+                                 imageOrigin.translate(dx, dy);
+                                 updateFinalImage();
+                                 repaint();
+                         }
-                 /* create the new extent */
+                 } else if ((getState() == XMapPane.ZOOM_IN)
-                 Coordinate ll = new Coordinate(mapArea.getMinX() - (deltaX / 2.0),
+                                 || (getState() == XMapPane.ZOOM_OUT)
-                                 mapArea.getMinY() - (deltaY / 2.0));
+                                 || (getState() == XMapPane.SELECT_ALL)
-                 Coordinate ur = new Coordinate(mapArea.getMaxX() + (deltaX / 2.0),
+                                 || (getState() == XMapPane.SELECT_TOP)
-                                 mapArea.getMaxY() + (deltaY / 2.0));
+                 // || (getState() == XMapPane.SELECT_ONE_FROM_TOP)
+                 ) {
+                         final Graphics graphics = getGraphics();
-                 return new Envelope(ll, ur);
+                         drawRectangle(graphics, startPos, event.getPoint());
-         }
-         public void doSelection(double x, double y, MapLayer layer) {
+                         if ((lastPos.x > 0) && (lastPos.y > 0)) {
+                                 drawRectangle(graphics, startPos, lastPos);
+                         }
-                 Geometry geometry = gf.createPoint(new Coordinate(x, y));
+                         graphics.dispose();
-                 // org.opengis.geometry.Geometry geometry = new Point();
+                 }
-                 findFeature(geometry, layer);
+         }
+         /**
+          * Called by the {@link RenderingExecutor} when rendering was cancelled.
+          */
+         public void onRenderingCancelled() {
+                 LOGGER.debug("Rendering cancelled");
+                 repaintTimer.stop();
          }
          /**
-          * @param geometry
+          * Called by the {@link RenderingExecutor} when rendering has been
-          *            - a geometry to construct the filter with
+          * completed.
-          * @param i
-          *            - the index of the layer to search
-          * @throws IndexOutOfBoundsException
           */
-         private void findFeature(Geometry geometry, MapLayer layer)
+         public void onRenderingCompleted() {
-                         throws IndexOutOfBoundsException {
+                 repaintTimer.stop();
-                 org.opengis.filter.spatial.BinarySpatialOperator f = null;
+                 updateFinalImage();
+                 repaint();
+                 if (renderingErrors.size() > 0)
+                         renderingErrors.remove(0);
+         }
-                 if ((context == null) || (layer == null)) {
+         /**
-                         return;
+          * Called by the {@linkplain XMapPane.RenderingTask} when rendering failed.
-                 }
+          * Publishes a {@linkplain MapPaneEvent} of type {@code
+          * MapPaneEvent.Type.RENDERING_STOPPED} to listeners.
+          *
+          * @param renderingError
+          *            The error that occured during rendering
+          *
+          * @see MapPaneListener#onRenderingStopped(org.geotools.swing.event.MapPaneEvent)
+          */
+         public void onRenderingFailed(final Exception renderingError) {
+                 this.renderingErrors.add(renderingError);
+                 if (renderingErrors.size() > 3)
+                         renderingErrors.remove(0);
+                 repaintTimer.stop();
+                 LOGGER.warn("Rendering failed", renderingError);
+                 updateFinalImage();
+                 repaint();
-                 try {
+         }
-                         String name = layer.getFeatureSource().getSchema()
-                                         .getDefaultGeometry().getLocalName();
-                         if (name == "") {
+         public void onRenderingPending() {
-                                 name = "the_geom";
+                 // LOGGER.debug("Pending rendering updates the preview...");
-                         }
+                 updateFinalImage();
+                 repaint();
+         }
-                         try {
+         @Override
-                                 f = ff.contains(ff.property(name), ff.literal(geometry));
+         protected void paintComponent(final Graphics g) {
-                                 if (selectionManager != null) {
- //                                      System.out.println("selection changed");
-                                         selectionManager.selectionChanged(this, f);
-                                 }
+                 if (!acceptsRepaintCalls)
-                         } catch (IllegalFilterException e) {
+                         return;
-                                 // TODO Auto-generated catch block
-                                 e.printStackTrace();
-                         }
-                         /*
+                 // Maybe update the cursor and maybe stop the repainting timer
-                          * // f.addLeftGeometry(ff.property(name)); //
+                 updateCursor();
-                          * System.out.println("looking with " + f); FeatureCollection fc =
-                          * layer.getFeatureSource().getFeatures(f);
-                          *
-                          *
-                          *
-                          * if (fcol == null) { fcol = fc;
-                          *
-                          * // here we should set the defaultgeom type } else {
-                          * fcol.addAll(fc); }
-                          */
-                         /*
+                 // super.paintComponent(g); // candidate for removal
-                          * GeometryAttributeType gat =
-                          * layer.getFeatureSource().getSchema().getDefaultGeometry();
-                          * fcol.setDefaultGeometry((Geometry)gat.createDefaultValue());
-                          */
-                         /*
+                 boolean paintedSomething = false;
-                          * Iterator fi = fc.iterator(); while (fi.hasNext()) { Feature feat
-                          * = (Feature) fi.next(); System.out.println("selected " +
-                          * feat.getAttribute("STATE_NAME")); }
-                          */
-                 } catch (IllegalFilterException e) {
-                         // TODO Auto-generated catch block
-                         e.printStackTrace();
-                 }
-                 return;
-         }
-         public void mouseClicked(MouseEvent e) {
+                 if (mapImageInvalid) { /* if the map changed then redraw */
-                 if (mapArea == null) return;
-                 // System.out.println("before area "+mapArea+"\nw:"+mapArea.getWidth()+"
-                 // h:"+mapArea.getHeight());
-                 Rectangle bounds = this.getBounds();
-                 double x = (double) (e.getX());
-                 double y = (double) (e.getY());
-                 double width = mapArea.getWidth();
-                 double height = mapArea.getHeight();
-                 // xulu.sc
-                 // double width2 = mapArea.getWidth() / 2.0;
-                 // double height2 = mapArea.getHeight() / 2.0;
-                 double width2 = width / 2.0;
-                 double height2 = height / 2.0;
-                 // xulu.ec
-                 double mapX = ((x * width) / (double) bounds.width) + mapArea.getMinX();
-                 double mapY = (((bounds.getHeight() - y) * height) / (double) bounds.height)
-                                 + mapArea.getMinY();
-                 /*
+                         mapImageInvalid = false; // Reset for next round
-                  * System.out.println(""+x+"->"+mapX);
-                  * System.out.println(""+y+"->"+mapY);
-                  */
-                 /*
+                         // If the new mapArea and the oldMapArea intersect, we can draw some
-                  * Coordinate ll = new Coordinate(mapArea.getMinX(), mapArea.getMinY());
+                         // quick scaled preview to make the user feel that something is
-                  * Coordinate ur = new Coordinate(mapArea.getMaxX(), mapArea.getMaxY());
+                         // happening.
-                  */
+                         if (mapAreaChanged && oldMapArea != null
-                 double zlevel = 1.0;
+                                         && getMapArea().intersects(oldMapArea)
+                                         & !getMapArea().equals(oldMapArea) && !paneResized) {
-                 switch (state) {
+                                 mapAreaChanged = false;
-                 case Pan:
-                         zlevel = 1.0;
-                         // xulu.sc SK: return here.. a mouselistener is managing the PANNING
-                         // break;
-                         return;
-                         // xulu.ec
-                 case ZoomIn:
-                         zlevel = zoomFactor;
-                         break;
+                                 if (getMapArea().covers(oldMapArea)) {
+                                         setQuickPreviewHint(ZOOM_OUT);
+                                         paintedSomething = drawScaledPreviewImage_Zoom((Graphics2D) g);
+                                 } else if (oldMapArea.covers(getMapArea())) {
+                                         setQuickPreviewHint(ZOOM_IN);
+                                         paintedSomething = drawScaledPreviewImage_Zoom((Graphics2D) g);
+                                 }
-                 case ZoomOut:
+                         }
-                         zlevel = 1.0 / zoomFactor;
-                         break;
+                         // if (paneResized) {
+                         // paneResized = false;
+                         // disposeImages();
+                         // }
+                         //
+                         // // Start the Threads and Timers to render the image
+                         // requestStartRendering();
-                 case Select:
+                 }
-                         doSelection(mapX, mapY, selectionLayer);
-                         return;
+                 if (!paintedSomething) {
-                 default:
+                         g.drawImage(getFinalImage(), 0, 0, null);
-                         return;
-                 }
-                 Coordinate ll = new Coordinate(mapX - (width2 / zlevel), mapY
+                         g.dispose(); // cand. for removal
-                                 - (height2 / zlevel));
-                 Coordinate ur = new Coordinate(mapX + (width2 / zlevel), mapY
-                                 + (height2 / zlevel));
-                 // xulu.sc SK: Check for min/max scale
-                 // mapArea = new Envelope(ll, ur);
-                 final Envelope newMapArea = new Envelope(ll, ur);
-                 setMapArea(bestAllowedMapArea(newMapArea));
-                 // xulu.ec
-                 // sk.ec
+                         paintedSomething = true; // cand. for removal
+                 }
-                 // System.out.println("after area "+mapArea+"\nw:"+mapArea.getWidth()+"
-                 // h:"+mapArea.getHeight());
-                 repaint();
          }
-         public void mouseEntered(MouseEvent e) {
+         /**
-         }
+          * Heavily works on releasing all resources related to the four
+          * {@link Image}s used to cache the results of the different renderers.<br>
+          * In November 2009 i had some memory leaking problems with {@link XMapPane}
+          * . The resources of the buffered images were never released. It seem to be
+          * important to call the GC right after flushing the images.<br>
+          * Hence this method may take a while, because it calls the GC up to four
+          * times.
+          */
+         private void disposeImages() {
-         public void mouseExited(MouseEvent e) {
+                 // System.out.println("vorher = "
-         }
+                 // + new MbDecimalFormatter().format(LangUtil.gcTotal()));
+                 // bi.flush();
+                 // return bi = null;
+                 // System.out.println("nacher = "
+                 // + new MbDecimalFormatter().format(LangUtil.gcTotal()));
+                 //
+                 // System.out.println("\n");
+                 if (preFinalImage != null) {
+                         preFinalImage.flush();
+                         preFinalImage = null;
+                         LangUtil.gc();
+                 }
+                 if (finalImage != null) {
+                         finalImage.flush();
+                         finalImage = null;
+                         LangUtil.gc();
+                 }
+                 if (localImage != null) {
+                         localImage.flush();
+                         localImage = null;
+                         LangUtil.gc();
+                 }
+                 if (bgImage != null) {
+                         bgImage.flush();
+                         bgImage = null;
+                         LangUtil.gc();
+                 }
-         public void mousePressed(MouseEvent e) {
-                 startX = e.getX();
-                 startY = e.getY();
-                 lastX = 0;
-                 lastY = 0;
          }
-         public void mouseReleased(MouseEvent e) {
+         /**
-                 int endX = e.getX();
+          * Performs a {@value #PAN} action. During panning, the displacement is
-                 int endY = e.getY();
+          * stored in {@link #imageOrigin} object. Calling {@link #performPan()} will
+          * reset the offset and call {@link #setMapArea(Envelope)}.
+          */
+         public void performPan() {
-                 processDrag(startX, startY, endX, endY, e);
+                 Rectangle winBounds = getVisibleRect();
-                 lastX = 0;
-                 lastY = 0;
-                 /**
+                 winBounds.translate(-imageOrigin.x, -imageOrigin.y);
-                  * Es wird nicht (mehr) gepannt!
+                 final Envelope newMapArea = tranformWindowToGeo(winBounds.x,
-                  */
+                                 winBounds.y, winBounds.x + winBounds.width, winBounds.y
-                 panning_started = false;
+                                                 + winBounds.height);
-         }
-         public void mouseDragged(MouseEvent e) {
+                 imageOrigin.x = 0;
-                 Graphics graphics = this.getGraphics();
+                 imageOrigin.y = 0;
-                 int x = e.getX();
-                 int y = e.getY();
-                 if ((state == JMapPane.Pan)
+                 if (!setMapArea(newMapArea)) {
-                                 || ((e.getModifiersEx() & InputEvent.BUTTON3_DOWN_MASK) != 0)) {
                          /**
-                          * SK: Der Cursor wird auf PANNING gesetzt.
+                          * If setMapArea returns true, the finalImage is updated anyways.
+                          * This if-case exists to ensure that we repaint a correct image
+                          * even if the new panning area has been denied.
                           */
-                         if (panning_started == false) {
+                         updateFinalImage();
-                                 panning_started = true;
+                         repaint();
-                                 setCursor(SwingUtil.PANNING_CURSOR);
+                 }
-                         }
-                         // move the image with the mouse
+                 if (getCursor() == SwingUtil.PANNING_CURSOR)
-                         if ((lastX > 0) && (lastY > 0)) {
+                         setCursor(SwingUtil.PAN_CURSOR);
-                                 int dx = lastX - startX;
+         }
-                                 int dy = lastY - startY;
-                                 // System.out.println("translate "+dx+","+dy);
-                                 final Graphics2D g2 = panningImage.createGraphics();
-                                 g2.setBackground(new Color(240, 240, 240)); // TODO richtige
-                                                                                                                         // farbe? am besten
-                                                                                                                         // vom L&F die
-                                                                                                                         // hintergrundfarbe
-                                                                                                                         // auslesen...
-                                 g2.clearRect(0, 0, this.getWidth(), this.getHeight());
-                                 g2.drawImage(baseImage, dx, dy, this);
-                                 graphics.drawImage(panningImage, 0, 0, this);
-                         }
-                         lastX = x;
-                         lastY = y;
-                 } else
-                 if ((state == JMapPane.ZoomIn) || (state == JMapPane.ZoomOut)) {
-                         graphics.setXORMode(Color.WHITE);
-                         if ((lastX > 0) && (lastY > 0)) {
-                                 drawRectangle(graphics);
-                         }
-                         // draw new box
-                         lastX = x;
-                         lastY = y;
-                         drawRectangle(graphics);
-                 } else if (state == JMapPane.Select && selectionLayer != null) {
-                         // construct a new bbox filter
-                         Rectangle bounds = this.getBounds();
-                         double mapWidth = mapArea.getWidth();
-                         double mapHeight = mapArea.getHeight();
-                         double x1 = ((this.startX * mapWidth) / (double) bounds.width)
-                                         + mapArea.getMinX();
-                         double y1 = (((bounds.getHeight() - this.startY) * mapHeight) / (double) bounds.height)
-                                         + mapArea.getMinY();
-                         double x2 = ((x * mapWidth) / (double) bounds.width)
-                                         + mapArea.getMinX();
-                         double y2 = (((bounds.getHeight() - y) * mapHeight) / (double) bounds.height)
-                                         + mapArea.getMinY();
-                         double left = Math.min(x1, x2);
-                         double right = Math.max(x1, x2);
-                         double bottom = Math.min(y1, y2);
-                         double top = Math.max(y1, y2);
-                         String name = selectionLayer.getFeatureSource().getSchema()
-                                         .getDefaultGeometry().getName();
-                         if (name == "") {
-                                 name = "the_geom";
-                         }
-                         Filter bb = ff.bbox(ff.property(name), left, bottom, right, top,
-                                         getContext().getCoordinateReferenceSystem().toString());
-                         if (selectionManager != null) {
-                                 selectionManager.selectionChanged(this, bb);
-                         }
-                         graphics.setXORMode(Color.green);
+         //
+         // /**
+         // * Nuetzlich wenn die Componente gedruckt (z.B. wenn ein Screenshot
+         // gemacht
+         // * wird) wird. Dann werden wird der Hintergrund auf WEISS gesetzt.
+         // *
+         // * @author <a href="mailto:[email protected]">Stefan Alfons
+         // * Kr&uuml;ger</a>
+         // */
+         // @Override
+         // public void print(final Graphics g) {
+         // final Color orig = getBackground();
+         // setBackground(Color.WHITE);
+         //
+         // // wrap in try/finally so that we always restore the state
+         // try {
+         // super.print(g);
+         // } finally {
+         // setBackground(orig);
+         // }
+         // }
-                         /*
+         /**
-                          * if ((lastX > 0) && (lastY > 0)) { drawRectangle(graphics); }
+          * Entfernt einen Listener von der Map.
-                          */
+          *
+          * @param l
+          *            zu entfernender Listener
+          */
+         public void removeMapPaneListener(final JMapPaneListener l) {
+                 mapPaneListeners.remove(l);
+         }
-                         // draw new box
+         /**
-                         lastX = x;
+          * Cancels all running renderers and sets the flag to start new ones. <br>
-                         lastY = y;
+          *
-                         drawRectangle(graphics);
+          * @see #startRenderThreadsTimer
+          */
+         private void requestStartRendering() {
+                 if (bgExecuter != null)
+                         bgExecuter.cancelTask();
+                 if (localExecuter != null)
+                         localExecuter.cancelTask();
+                 mapImageInvalid = true;
+                 if (paneResized) {
+                         paneResized = false;
+                         disposeImages();
                  }
+                 requestStartRendering = true;
          }
-         // sk.cs
+         /**
-         // private void processDrag(int x1, int y1, int x2, int y2) {
+          * Calculate the affine transforms used to convert between world and pixel
-         // sk.ce
+          * coordinates. The calculations here are very basic and assume a cartesian
-         protected void processDrag(final int x1, final int y1, final int x2,
+          * reference system.
-                         final int y2, MouseEvent e) {
+          * <p>
+          * Tne transform is calculated such that {@code envelope} will be centred in
-                 /****
+          * the display
-                  * If no layer is availabe we dont want a NullPointerException
+          *
-                  */
+          * @param envelope
-                 if (mapArea == null)
+          *            the current map extent (world coordinates)
+          * @param paintArea
+          *            the current map pane extent (screen units)
+          */
+         private void resetTransforms() {
+                 ReferencedEnvelope refMapEnv = new ReferencedEnvelope(mapArea,
+                                 getContext().getCoordinateReferenceSystem());
+                 // System.out
+                 // .println("paintArea in resetTeansofrms = " + getVisibleRect());
+                 if (!isWellDefined())
                          return;
-                 // System.out.println("processing drag from " + x1 + "," + y1 + " -> "
+                 worldToScreen = RendererUtilities.worldToScreenTransform(refMapEnv,
-                 // + x2 + "," + y2);
+                                 getVisibleRect());
-                 if ((x1 == x2) && (y1 == y2)) {
-                         if (isClickable()) {
-                                 mouseClicked(new MouseEvent(this, 0, new Date().getTime(), 0,
-                                                 x1, y1, y2, false));
-                         }
-                         return;
+                 try {
+                         screenToWorld = worldToScreen.createInverse();
+                 } catch (NoninvertibleTransformException ex) {
+                         LOGGER
+                                         .error("can't invert worldToScreen to get screenToWorld!",
+                                                         ex);
                  }
+         }
-                 Rectangle bounds = this.getBounds();
+         public void setBgContext(final MapContext context) {
-                 double mapWidth = mapArea.getWidth();
+                 // Remove the default listener from the old context
-                 double mapHeight = mapArea.getHeight();
+                 if (this.bgContext != null) {
+                         this.bgContext.removeMapLayerListListener(bgContextListener);
-                 double startX = ((x1 * mapWidth) / (double) bounds.width)
+                         // adding listener to all layers
-                                 + mapArea.getMinX();
+                         for (final MapLayer mapLayer : bgContext.getLayers()) {
-                 double startY = (((bounds.getHeight() - y1) * mapHeight) / (double) bounds.height)
+                                 mapLayer.removeMapLayerListener(bgMapLayerListener);
-                                 + mapArea.getMinY();
-                 double endX = ((x2 * mapWidth) / (double) bounds.width)
-                                 + mapArea.getMinX();
-                 double endY = (((bounds.getHeight() - y2) * mapHeight) / (double) bounds.height)
-                                 + mapArea.getMinY();
-                 if ((state == JMapPane.Pan) || (e.getButton() == MouseEvent.BUTTON3)) {
-                         // move the image with the mouse
-                         // calculate X offsets from start point to the end Point
-                         double deltaX1 = endX - startX;
-                         // System.out.println("deltaX " + deltaX1);
-                         // new edges
-                         double left = mapArea.getMinX() - deltaX1;
-                         double right = mapArea.getMaxX() - deltaX1;
-                         // now for Y
-                         double deltaY1 = endY - startY;
-                         // System.out.println("deltaY " + deltaY1);
-                         double bottom = mapArea.getMinY() - deltaY1;
-                         double top = mapArea.getMaxY() - deltaY1;
-                         Coordinate ll = new Coordinate(left, bottom);
-                         Coordinate ur = new Coordinate(right, top);
-                         // xulu.sc
-                         // mapArea = fixAspectRatio(this.getBounds(), new Envelope(ll, ur));
-                         setMapArea(fixAspectRatio(this.getBounds(), new Envelope(ll, ur)));
-                         // xulu.ec
-                 } else if (state == JMapPane.ZoomIn) {
-                         // Zu kleine Flächen sollen nicht gezoomt werden.
-                         // sk.bc
-                         if ((Math.abs(x1 - x2) * Math.abs(y2 - y1)) < 150)
-                                 return;
-                         // sk.ec
-                         drawRectangle(this.getGraphics());
-                         // make the dragged rectangle (in map coords) the new BBOX
-                         double left = Math.min(startX, endX);
-                         double right = Math.max(startX, endX);
-                         double bottom = Math.min(startY, endY);
-                         double top = Math.max(startY, endY);
-                         Coordinate ll = new Coordinate(left, bottom);
-                         Coordinate ur = new Coordinate(right, top);
-                         // xulu.sc
-                         // mapArea = fixAspectRatio(this.getBounds(), new Envelope(ll, ur));
-                         setMapArea(bestAllowedMapArea(new Envelope(ll, ur)));
-                         // sk.sc
- //                      {
- //                      // SK tries to paint a preview of the zoom ;-9 aha.... well
- //                      Graphics2D graphics = (Graphics2D) JMapPane.this.getGraphics();
- //                      graphics.setRenderingHint(RenderingHints.KEY_INTERPOLATION,
- //                                      RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR);
- //                      graphics.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
- //                                      RenderingHints.VALUE_ANTIALIAS_OFF);
- //                      graphics.setRenderingHint(RenderingHints.KEY_RENDERING,
- //                                      RenderingHints.VALUE_RENDER_SPEED);
- //                      graphics.drawImage(baseImage, 0, 0, JMapPane.this.getWidth(),
- //                                      JMapPane.this.getHeight(), x1, y1, x2, y2, null);
- //                      }
-                         // xulu.ec
-                 } else if (state == JMapPane.ZoomOut) {
-                         drawRectangle(this.getGraphics());
-                         // make the dragged rectangle in screen coords the new map size?
-                         double left = Math.min(startX, endX);
-                         double right = Math.max(startX, endX);
-                         double bottom = Math.min(startY, endY);
-                         double top = Math.max(startY, endY);
-                         double nWidth = (mapWidth * mapWidth) / (right - left);
-                         double nHeight = (mapHeight * mapHeight) / (top - bottom);
-                         double deltaX1 = left - mapArea.getMinX();
-                         double nDeltaX1 = (deltaX1 * nWidth) / mapWidth;
-                         double deltaY1 = bottom - mapArea.getMinY();
-                         double nDeltaY1 = (deltaY1 * nHeight) / mapHeight;
-                         Coordinate ll = new Coordinate(mapArea.getMinX() - nDeltaX1,
-                                         mapArea.getMinY() - nDeltaY1);
-                         double deltaX2 = mapArea.getMaxX() - right;
-                         double nDeltaX2 = (deltaX2 * nWidth) / mapWidth;
-                         double deltaY2 = mapArea.getMaxY() - top;
-                         double nDeltaY2 = (deltaY2 * nHeight) / mapHeight;
-                         Coordinate ur = new Coordinate(mapArea.getMaxX() + nDeltaX2,
-                                         mapArea.getMaxY() + nDeltaY2);
-                         // xulu.sc
-                         // mapArea = fixAspectRatio(this.getBounds(), new Envelope(ll, ur));
-                         setMapArea(bestAllowedMapArea(new Envelope(ll, ur)));
-                         // xulu.ec
-                 } else if (state == JMapPane.Select && selectionLayer != null) {
-                         double left = Math.min(startX, endX);
-                         double right = Math.max(startX, endX);
-                         double bottom = Math.min(startY, endY);
-                         double top = Math.max(startY, endY);
-                         String name = selectionLayer.getFeatureSource().getSchema()
-                                         .getDefaultGeometry().getLocalName();
-                         if (name == "") {
-                                 name = "the_geom";
-                         }
-                         Filter bb = ff.bbox(ff.property(name), left, bottom, right, top,
-                                         getContext().getCoordinateReferenceSystem().toString());
-                         // System.out.println(bb.toString());
-                         if (selectionManager != null) {
-                                 selectionManager.selectionChanged(this, bb);
                          }
-                         /*
-                          * FeatureCollection fc; selection = null; try { fc =
-                          * selectionLayer.getFeatureSource().getFeatures(bb); selection =
-                          * fc; } catch (IOException e) { e.printStackTrace(); }
-                          */
                  }
-                 // xulu.so
+                 this.bgContext = context;
-                 // setMapArea(mapArea);
-                 // xulu.eo
+                 if (context != null) {
-                 repaint();
+                         // setMapArea(bgContext.getAreaOfInterest());
+                         this.bgContext.addMapLayerListListener(bgContextListener);
+                         // adding listener to all layers
+                         for (final MapLayer mapLayer : bgContext.getLayers()) {
+                                 mapLayer.addMapLayerListener(bgMapLayerListener);
+                         }
+                 }
+                 requestStartRendering();
          }
-         private boolean isClickable() {
+         public void setJava2dHints(final RenderingHints java2dHints) {
-                 return clickable;
+                 this.java2dHints = java2dHints;
          }
-         private org.geotools.styling.Style setupStyle(int type, Color color) {
+         public void setLocalContext(final MapContext context) {
-                 StyleFactory sf = org.geotools.factory.CommonFactoryFinder
+                 // Remove the default listener from the old context
-                                 .getStyleFactory(null);
+                 if (this.localContext != null) {
-                 StyleBuilder sb = new StyleBuilder();
+                         this.localContext.removeMapLayerListListener(localContextListener);
-                 org.geotools.styling.Style s = sf.createStyle();
+                         // adding listener to all layers
-                 s.setTitle("selection");
+                         for (final MapLayer mapLayer : localContext.getLayers()) {
+                                 mapLayer.removeMapLayerListener(localMapLayerListener);
+                         }
+                 }
-                 // TODO parameterise the color
+                 this.localContext = context;
-                 PolygonSymbolizer ps = sb.createPolygonSymbolizer(color);
-                 ps.setStroke(sb.createStroke(color));
-                 LineSymbolizer ls = sb.createLineSymbolizer(color);
+                 if (context != null) {
-                 Graphic h = sb.createGraphic();
-                 h.setMarks(new Mark[] { sb.createMark("square", color) });
-                 PointSymbolizer pts = sb.createPointSymbolizer(h);
+                         // setMapArea(localContext.getAreaOfInterest());
-                 // Rule r = sb.createRule(new Symbolizer[]{ps,ls,pts});
+                         localRenderer.setContext(localContext);
-                 switch (type) {
-                 case POLYGON:
-                         s = sb.createStyle(ps);
-                         break;
+                         this.localContext.addMapLayerListListener(localContextListener);
-                 case POINT:
+                         // adding listener to all layers
-                         s = sb.createStyle(pts);
+                         for (final MapLayer mapLayer : localContext.getLayers()) {
+                                 mapLayer.addMapLayerListener(localMapLayerListener);
+                         }
+                 }
-                         break;
+                 requestStartRendering();
-                 case LINE:
+         }
-                         s = sb.createStyle(ls);
-                 }
-                 return s;
+         public boolean setMapArea(final Envelope newMapArea) {
+                 return setMapArea(new ReferencedEnvelope(newMapArea, getContext()
+                                 .getCoordinateReferenceSystem()));
          }
-         public void highlightChanged(HighlightChangedEvent e) {
+         /**
-                 org.opengis.filter.Filter f = e.getFilter();
+          * @param newMapArea
+          * @return <code>true</code> if the mapArea has been changed and a repaint
+          *         has been triggered.
+          */
+         public boolean setMapArea(final ReferencedEnvelope newMapArea) {
+                 //
+                 // if (getVisibleRect().getWidth() == 0 || (!isVisible()) ||
+                 // getVisibleRect().getHeight() == 0) {
+                 // // The window is not yet defined.. so we can not really determine the
+                 // asepect ratio for the mapPane. We store this as a candidate mappane
+                 // and handle it when the component resizes or becomes visible)
+                 // mapAreaCondidate = newMapArea;
+                 // }
-                 try {
+                 if (newMapArea == null
-                         highlightFeature = highlightLayer.getFeatureSource().getFeatures(f);
+                                 || bestAllowedMapArea(newMapArea).equals(mapArea)) {
-                 } catch (IOException e1) {
+                         // No change.. no need to repaint
-                         // TODO Auto-generated catch block
+                         return false;
-                         e1.printStackTrace();
                  }
-                 repaint();
+                 // Testing, whether NaN or Infinity are used in the newMapArea
-         }
+                 if (newMapArea.isNull() || Double.isInfinite(newMapArea.getMaxX())
+                                 || Double.isInfinite(newMapArea.getMaxY())
-         public void propertyChange(PropertyChangeEvent evt) {
+                                 || Double.isInfinite(newMapArea.getMinX())
-                 String prop = evt.getPropertyName();
+                                 || Double.isInfinite(newMapArea.getMinY())) {
+                         // No change.. ugly new values
-                 if (prop.equalsIgnoreCase("crs")) {
+                         LOGGER.warn("setMapArea has been called with newArea = "
-                         context.setAreaOfInterest(context.getAreaOfInterest(),
+                                         + newMapArea);
-                                         (CoordinateReferenceSystem) evt.getNewValue());
+                         return false;
                  }
-         }
-         public boolean isReset() {
+                 final Envelope candNew = bestAllowedMapArea(newMapArea);
-                 return reset;
-         }
-         public void setReset(boolean reset) {
+                 // Testing, whether the difference if just minimal
-                 this.reset = reset;
+                 if (mapArea != null) {
-         }
+                         final double tolX = mapArea.getWidth() / 1000.;
+                         final double tolY = mapArea.getHeight() / 1000.;
+                         if ((candNew.getMinX() - tolX < mapArea.getMinX())
+                                         && (mapArea.getMinX() < candNew.getMinX() + tolX)
+                                         && (candNew.getMaxX() - tolX < mapArea.getMaxX())
+                                         && (mapArea.getMaxX() < candNew.getMaxX() + tolX)
-         public void layerAdded(MapLayerListEvent event) {
+                                         && (candNew.getMinY() - tolY < mapArea.getMinY())
-                 changed = true;
+                                         && (mapArea.getMinY() < candNew.getMinY() + tolY)
+                                         && (candNew.getMaxY() - tolY < mapArea.getMaxY())
+                                         && (mapArea.getMaxY() < candNew.getMaxY() + tolY)
-                 if (context.getLayers().length == 1) { // the first one
+                         ) {
+                                 // The two mapAreas only differ my 1/1000th.. ignore
-                         try {
+                                 return false;
-                                 // xulu.sc
-                                 // mapArea = context.getLayerBounds();
-                                 mapArea = context.getAreaOfInterest();
-                                 if (mapArea == null)
-                                         mapArea = context.getLayerBounds();
-                                 // xulu.ec
-                         } catch (IOException e) {
-                                 // TODO Auto-generated catch block
-                                 e.printStackTrace();
                          }
+                 }
-                         reset = true;
+                 // New map are is accepted:
+                 oldMapArea = mapArea;
+                 mapArea = candNew;
+                 resetTransforms();
+                 if (localContext != null) {
+                         localContext.setAreaOfInterest(mapArea, localContext
+                                         .getCoordinateReferenceSystem());
+                 }
+                 if (bgContext != null) {
+                         bgContext.setAreaOfInterest(mapArea, localContext
+                                         .getCoordinateReferenceSystem());
                  }
-                 repaint();
+                 mapAreaChanged = true;
-         }
-         public void layerRemoved(MapLayerListEvent event) {
+                 repaint(100);
-                 changed = true;
-                 repaint();
+                 requestStartRendering();
+                 return true;
          }
-         public void layerChanged(MapLayerListEvent event) {
+         /**
-                 changed = true;
+          * Set the background color of the map.
-                 // System.out.println("layer changed - repaint");
+          *
-                 repaint();
+          * @param if <code>null</code>, white is used.
+          */
+         public void setMapBackgroundColor(Color bgColor) {
+                 if (bgColor == null)
+                         bgColor = Color.WHITE;
+                 this.mapBackgroundColor = bgColor;
          }
-         public void layerMoved(MapLayerListEvent event) {
+         /**
-                 changed = true;
+          * Set the BufferedImage to use as a flaoting icon in the lower right corner
-                 repaint();
+          *
+          * @param mapImageIcon
+          *            <code>null</code> is allowed and deactivates this icon.
+          */
+         public void setMapImage(final BufferedImage mapImage) {
+                 this.mapImage = mapImage;
          }
-         protected void drawRectangle(Graphics graphics) {
+         /**
-                 // undraw last box/draw new box
+          * Sets whether a layer is regarded or ignored on {@link #SELECT_TOP},
-                 int left = Math.min(startX, lastX);
+          * {@link #SELECT_ALL} and {@link #SELECT_ONE_FROM_TOP} actions.
-                 int right = Math.max(startX, lastX);
+          *
-                 int top = Math.max(startY, lastY);
+          * @param layer
-                 int bottom = Math.min(startY, lastY);
+          *            a layer
-                 int width = right - left;
+          * @param selectable
-                 int height = top - bottom;
+          *            if {@code false} the layer is ignored during the upper
-                 // System.out.println("drawing rect("+left+","+bottom+","+ width+","+
+          *            mentioned actions. If <code>null</code>, the default (true)
-                 // height+")");
+          *            will be used.
-                 graphics.drawRect(left, bottom, width, height);
+          */
+         public void setMapLayerSelectable(final MapLayer layer,
+                         final Boolean selectable) {
+                 if (selectable == null)
+                         mapLayerSelectable.remove(layer);
+                 else
+                         mapLayerSelectable.put(layer, selectable);
          }
          /**
-          * if clickable is set to true then a single click on the map pane will zoom
+          * Defines an evelope of the viwable area. The JMapPane will never show
-          * or pan the map.
+          * anything outside of this extend.
           *
-          * @param clickable
+          * @param maxExtend
+          *            <code>null</code> to not have this restriction.
           */
-         public void setClickable(boolean clickable) {
+         public void setMaxExtend(final Envelope maxExtend) {
-                 this.clickable = clickable;
+                 this.maxExtend = maxExtend;
          }
-         public void mouseMoved(MouseEvent e) {
+         /**
+          * Set the maximum allowed zoom scale. This is the smaller number value of
+          * the two. If <code>null</code> is passed, Double.MINVALUE are used which
+          * mean there is no restriction.
+          *
+          * @author <a href="mailto:[email protected]">Stefan Alfons
+          *         Kr&uuml;ger</a>
+          */
+         public void setMaxZoomScale(final Double maxZoomScale) {
+                 this.maxZoomScale = maxZoomScale == null ? Double.MIN_VALUE
+                                 : maxZoomScale;
          }
-         public FeatureCollection getSelection() {
+         // /** Stored the time used for the last real rendering in ms. **/
-                 return selection;
+         // private long lastRenderingDuration = Long.MAX_VALUE;
-         }
-         public void setSelection(FeatureCollection selection) {
+         /**
-                 this.selection = selection;
+          * Set the minimum (nearest) allowed zoom scale. This is the bigger number
-                 repaint();
+          * value of the two. If <code>null</code> is passed, Double.MAXVALUE are
+          * used which mean there is no restriction.
+          *
+          *
+          * @author <a href="mailto:[email protected]">Stefan Alfons
+          *         Kr&uuml;ger</a>
+          */
+         public void setMinZoomScale(final Double minZoomScale) {
+                 this.minZoomScale = minZoomScale == null ? Double.MAX_VALUE
+                                 : minZoomScale;
          }
-         /*
+         /**
-          * (non-Javadoc)
           *
-          * @see
+          * @param b
-          * org.geotools.gui.swing.event.SelectionChangeListener#selectionChanged
-          * (org.geotools.gui.swing.event.SelectionChangedEvent)
           */
-         public void selectionChanged(SelectionChangedEvent e) {
+         public void setPainting(final boolean b) {
+                 acceptsRepaintCalls = b;
+         }
+         // /**
+         // * Returns in milli seconds the time the last rending of the
+         // * {@link SelectableXMapPane} took. #Long.MAX_VALUE if the JMapPane has
+         // not
+         // * been rendered yet.
+         // */
+         // public long getLastRenderingDuration() {
+         // return lastRenderingDuration;
+         // }
+         public void setQuickPreviewHint(final int quickPreviewHint) {
+                 this.quickPreviewHint = quickPreviewHint;
-                 try {
-                         selection = selectionLayer.getFeatureSource().getFeatures(
-                                         e.getFilter());
-                         repaint();
-                 } catch (IOException e1) {
-                         e1.printStackTrace();
-                 }
          }
-         public SelectionManager getSelectionManager() {
+         private void setRendererHints(final Map<Object, Object> rendererHints) {
-                 return selectionManager;
+                 if (rendererHints != null)
+                         this.rendererHints = rendererHints;
          }
-         public void setSelectionManager(SelectionManager selectionManager) {
+         /**
-                 this.selectionManager = selectionManager;
+          * Enables/Disables the ZOOM Mouse Listener. Upates the Cursor and stops the
-                 this.selectionManager.addSelectionChangeListener(this);
+          * repaint Timer if
+          *
+          * @param state
+          */
+         public void setState(final int state) {
+                 this.state = state;
+                 zoomMapPaneMouseListener.setEnabled((state == ZOOM_IN
+                                 || state == ZOOM_OUT || state == PAN));
+                 // Je nach Aktion den Cursor umsetzen
+                 updateCursor();
          }
-         // xulu.sn
          /**
-          * Korrigiert den {@link Envelope} aka {@code mapArea} auf die beste
+          * Standardmaessig wird der Cursor automatisch je nach MapPane-Aktion (Zoom,
-          * erlaubte Flaeche damit die Massstabsbeschaenkungen noch eingehalten
+          * Auswahl, ...) gesetzt. Mit dieser Methode kann ein statischer Cursor
-          * werden, FALLS der uebergeben Envelope nicht schon gueltig sein sollte.<br/>
+          * gesetzt werden, der unabhaengig von der aktuellen MapPanes-Aktion
-          * Since 21. April 09: Before thecalculation starts, the aspect ratio is
+          * beibehalten wird. Um diesen statischen Cursor wieder zu entfernen, kann
-          * corrected. This change implies, that setMapArea() will most of the time
+          * {@code null} als Parameter uebergeben werden
-          * not allow setting to a wrong aspectRatio.
           *
-          * @author <a href="mailto:[email protected]">Stefan Alfons
+          * @param cursor
-          *         Kr&uuml;ger</a>
+          *            Cursor
           */
-         public Envelope bestAllowedMapArea(Envelope env) {
+         public void setStaticCursor(final Cursor cursor) {
-                 if (getWidth() == 0)
+                 this.staticCursor = cursor;
-                         return env;
+                 if (cursor != null)
-                 if (env == null)
+                         super.setCursor(cursor);
-                         return env;
+         }
+         /**
+          * Starts rendering on one or two threads
+          */
+         private void startRendering() {
+                 if (!isWellDefined() || !acceptsRepaintCalls) {
+                         requestStartRendering = true;
+                         return;
+                 }
+                 if (bgExecuter != null) {
+                         // Stop all renderers
+                         bgExecuter.cancelTask();
+                 }
+                 if (localExecuter != null) {
+                         localExecuter.cancelTask();
+                 }
+                 final Rectangle curPaintArea = getVisibleRect();
                  /**
-                  * Correct the aspect Ratio before we check the rest. Otherwise we might
+                  * We have to set new renderer
-                  * easily fail.
                   */
-                 env = fixAspectRatio(this.getBounds(), env);
-                 double scale = env.getWidth() / getWidth();
+                 if (getBgContext() != null) {
-                 double centerX = env.getMinX() + env.getWidth() / 2.;
+                         bgRenderer.setJava2DHints(getJava2dHints());
-                 double centerY = env.getMinY() + env.getHeight() / 2.;
+                         bgRenderer.setRendererHints(getRendererHints());
-                 double newWidth2;
-                 double newHeight2;
+                         // bgExecuter = new RenderingExecutor();
-                 if (scale < getMaxZoomScale()) {
+                         // LOGGER.debug("starting bg renderer:");
-                         // ****************************************************************************
+                         // // /* System.out.println("rendering"); */
-                         // Wir zoomen weiter rein als erlaubt => Anpassen des envelope
+                         // final GTRenderer createGTRenderer = GTUtil.createGTRenderer(
-                         // ****************************************************************************
+                         // bgContext, getRendererHints());
-                         newWidth2 = getMaxZoomScale() * getWidth() / 2.;
+                         // createGTRenderer.setJava2DHints(getJava2dHints());
-                         newHeight2 = getMaxZoomScale() * getHeight() / 2.;
+                         // bgExecuter.submit(getBgContext().getAreaOfInterest(),
-                 } else if (scale > getMinZoomScale()) {
+                         // curPaintArea,
-                         // ****************************************************************************
+                         // (Graphics2D) getBgImage().getGraphics(), createGTRenderer);
-                         // Wir zoomen weiter raus als erlaubt => Anpassen des envelope
+                 }
-                         // ****************************************************************************
-                         newWidth2 = getMinZoomScale() * getWidth() / 2.;
+                 if (getContext() != null) {
-                         newHeight2 = getMinZoomScale() * getHeight() / 2.;
+                         // localExecuter = new RenderingExecutor(this, 150l);
+                         // LOGGER.debug("starting local renderer:");
+                         localRenderer.setJava2DHints(getJava2dHints());
+                         localRenderer.setRendererHints(getRendererHints());
+                         final boolean submitted = localExecuter.submit(getMapArea(),
+                                         curPaintArea, (Graphics2D) getLocalImage().getGraphics(),
+                                         localRenderer
+                         // , getWorldToScreenTransform()
+                                         );
+                         if (submitted)
+                                 repaintTimer.restart();
+                         else
+                                 requestStartRendering = true; // Try to start rendering
+                         // again in
+                         // a moment
+                 }
+                 updateCursor();
+         }
+         /**
+          * Transformiert einen Geo-Koordinaten-Bereich in Fenster-Koordinaten.
+          *
+          * @param ox
+          *            X-Koordinate der VON-Position
+          * @param oy
+          *            Y-Koordinate der VON-Position
+          * @param px
+          *            X-Koordinate der BIS-Position
+          * @param py
+          *            Y-Koordinate der BIS-Position
+          * @param winToGeotransform
+          *            Eine Window to Geo transform. If <code>null</code>,
+          *            {@link #getScreenToWorld()} is used.
+          */
+         public Envelope tranformGeoToWindow(final double ox, final double oy,
+                         final double px, final double py) {
+                 final AffineTransform at = getWorldToScreenTransform();
+                 Point2D geoO;
+                 // try {
+                 geoO = at.transform(new Point2D.Double(ox, oy), null);
+                 final Point2D geoP = at.transform(new Point2D.Double(px, py), null);
+                 return new Envelope(geoO.getX(), geoP.getX(), geoO.getY(), geoP.getY());
+                 // } catch (final NoninvertibleTransformException e) {
+                 // LOGGER.error(e);
+                 // return new Envelope(ox, oy, px, py);
+                 // }
+         }
+         /**
+          * Transformiert einen Fenster-Koordinaten-Bereich in Geo-Koordinaten.
+          *
+          * @param ox
+          *            X-Koordinate der VON-Position
+          * @param oy
+          *            Y-Koordinate der VON-Position
+          * @param px
+          *            X-Koordinate der BIS-Position
+          * @param py
+          *            Y-Koordinate der BIS-Position
+          */
+         public Envelope tranformWindowToGeo(final int ox, final int oy,
+                         final int px, final int py) {
+                 final AffineTransform at = getScreenToWorld();
+                 final Point2D geoO = at.transform(new Point2D.Double(ox, oy), null);
+                 final Point2D geoP = at.transform(new Point2D.Double(px, py), null);
+                 // Mmmmm... don't really understand why its x,x,y,y
+                 // return new Envelope(geoO.getX(), geoP.getX(), geoO.getY(),
+                 // geoP.getY());
+                 return new Envelope(new Coordinate(geoO.getX(), geoO.getY()),
+                                 new Coordinate(geoP.getX(), geoP.getY()));
+         }
+         /**
+          * Will update the cursor. If all rendering is finished also stops the
+          * {@link #repaintTimer}
+          */
+         public void updateCursor() {
+                 // if the renderers have stopped, also stop the timer that is updating
+                 // the final image
+                 if (bgExecuter != null && bgExecuter.isRunning()
+                                 || localExecuter != null && localExecuter.isRunning()) {
+                         setCursor(WAIT_CURSOR);
+                         return;
                  } else {
-                         // ****************************************************************************
+                         // Allow one last rendering
-                         // Die mapArea / der Envelope ist ist gueltig! Keine Aenderungen
+                         if (repaintTimer.isRunning()) {
-                         // ****************************************************************************
+                                 // System.out.println("one last rendering....");
-                         return env;
+                                 repaintTimer.stop();
+                                 updateFinalImage();
+                                 repaint();
+                         }
+                 }
+                 // wenn manueller Cursor gesetzt ist, dann diesen verwenden (unabhaengig
+                 // von der aktuellen Aktion
+                 if (this.staticCursor != null) {
+                         setCursor(staticCursor);
+                         return;
+                 }
+                 if (getCursor() == SwingUtil.PANNING_CURSOR) {
+                         // This cursor will reset itself
+                         return;
+                 }
+                 // Set the cursor depending on what tool is in use...
+                 switch (state) {
+                 case SELECT_TOP:
+                 case SELECT_ONE_FROM_TOP:
+                 case SELECT_ALL:
+                         setCursor(SwingUtil.CROSSHAIR_CURSOR);
+                         break;
+                 case ZOOM_IN:
+                         setCursor(SwingUtil.ZOOMIN_CURSOR);
+                         break;
+                 case ZOOM_OUT:
+                         setCursor(SwingUtil.ZOOMOUT_CURSOR);
+                         break;
+                 case PAN:
+                         setCursor(SwingUtil.PAN_CURSOR);
+                         break;
+                 default:
+                         setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR));
+                         break;
                  }
+         }
+         /**
+          * The renderers are all rendering into their own {@link Image}s. This
+          * method combines all images to one {@link #finalImage}. The
+          * {@link #repaintTimer} is calling this method regularely to update the
+          * {@link #finalImage} even if the renderers are still working.
+          */
+         synchronized protected Image updateFinalImage() {
+                 // Render the two map images first, into the preFinalImage
+                 if (bgExecuter != null) {
+                         final Graphics2D preFinalG = (Graphics2D) getPreFinalImage()
+                                         .getGraphics();
+                         preFinalG.setBackground(getMapBackgroundColor());
+                         preFinalG.drawImage(getBgImage(), 0, 0, getMapBackgroundColor(),
+                                         null);
+                         // // Draw the local layers image
+                         preFinalG.drawImage(getLocalImage(), 0, 0, null);
+                         preFinalG.dispose();
+                 } else {
+                         preFinalImage = getLocalImage();
+                 }
+                 final Graphics2D finalG = getFinalImage().createGraphics();
+                 finalG.setBackground(getMapBackgroundColor());
+                 finalG.drawImage(getPreFinalImage(), imageOrigin.x, imageOrigin.y,
+                                 getMapBackgroundColor(), null);
+                 final int finalImageHeight = getFinalImage().getHeight(null);
+                 final int finalImageWidth = getFinalImage().getWidth(null);
+                 final Rectangle painedArea = new Rectangle(imageOrigin.x,
+                                 imageOrigin.y, finalImageWidth, finalImageHeight);
+                 SwingUtil.clearAround(finalG, painedArea, getVisibleRect());
-                 Coordinate ll = new Coordinate(centerX - newWidth2, centerY
+                 addGadgets(finalG, false);
-                                 - newHeight2);
-                 Coordinate ur = new Coordinate(centerX + newWidth2, centerY
-                                 + newHeight2);
-                 return new Envelope(ll, ur);
+                 finalG.dispose();
+                 return finalImage;
          }
          /**
-          * Retuns the minimum allowed zoom scale. This is the bigger number value of
+          * Paints some optional stuff into the given {@link Graphics2D}. Usually
-          * the two. Defaults to {@link Double}.MAX_VALUE
+          * called as the last layer when {@link #updateFinalImage()}
           *
-          * @author <a href="mailto:[email protected]">Stefan Alfons
+          * @param forceWait
-          *         Kr&uuml;ger</a>
+          *            if <code>true</code>, a Wait-message will be painted even
+          *            though the rendering threads may not yet have started. If
+          *            <code>false</code>, it will only depend on
+          *            {@link #localExecuter.isRunning} and #bgExecuter.isRunning
           */
-         public Double getMinZoomScale() {
+         private void addGadgets(final Graphics2D graphics, boolean forceWait) {
-                 return minZoomScale;
+                 // Paint a logo to the bottom right if available
+                 if (mapImage != null) {
+                         Rectangle visibleRect = getVisibleRect();
+                         graphics.drawImage(mapImage, visibleRect.width
+                                         - mapImage.getWidth() - 10, getVisibleRect().height
+                                         - mapImage.getHeight() - 10, null);
+                 }
+                 int y = 17;
+                 // If the rendering process is still running, indicate this is the image
+                 if (forceWait || bgExecuter != null && bgExecuter.isRunning()
+                                 || localExecuter != null && localExecuter.isRunning()) {
+                         y += 8;
+                         final Color c = graphics.getColor();
+                         graphics.setFont(waitFont);
+                         graphics.setColor(getMapBackgroundColor());
+                         graphics.drawString(waitMsg, 5, y);
+                         graphics.setColor(getMapBackgroundColor());
+                         graphics.drawString(waitMsg, 7, y + 2);
+                         graphics.setColor(Color.BLACK);
+                         graphics.drawString(waitMsg, 6, y + 1);
+                         graphics.setColor(c);
+                         y += 24;
+                 }
+                 if (renderingErrors != null) {
+                         final Color c = graphics.getColor();
+                         graphics.setFont(errorFont);
+                         for (Exception ex : renderingErrors) {
+                                 if (ex instanceof java.lang.IllegalArgumentException
+                                                 && ex.getMessage().equals(
+                                                                 "Argument \"sourceCRS\" should not be null."))
+                                         continue;
+                                 String errStr = ex.getLocalizedMessage();
+                                 if (errStr == null)
+                                         errStr = ex.getMessage();
+                                 if (errStr == null)
+                                         errStr = "unknown error: " + ex.getClass().getSimpleName();
+                                 graphics.setColor(Color.WHITE);
+                                 graphics.drawString(errStr, 5, y);
+                                 graphics.setColor(Color.RED);
+                                 graphics.drawString(errStr, 6, y + 1);
+                                 y += 19;
+                         }
+                         graphics.setColor(c);
+                 }
          }
          /**
-          * Retuns the maximum allowed zoom scale. This is the smaller number value
+          * Sets the {@link #mapArea} to best possibly present the given features. If
-          * of the two. Defaults to {@link Double}.MIN_VALUE
+          * only one single point is given, the window is moved over the point.
           *
-          * @author <a href="mailto:[email protected]">Stefan Alfons
+          * @param features
-          *         Kr&uuml;ger</a>
+          *            if <code>null</code> or size==0, the function doesn nothing.
           */
-         public Double getMaxZoomScale() {
+         public void zoomTo(
-                 return maxZoomScale;
+                         final FeatureCollection<SimpleFeatureType, SimpleFeature> features) {
+                 final CoordinateReferenceSystem mapCRS = getContext()
+                                 .getCoordinateReferenceSystem();
+                 final CoordinateReferenceSystem fCRS = features.getSchema()
+                                 .getGeometryDescriptor().getCoordinateReferenceSystem();
+                 double width = mapArea.getWidth();
+                 double height = mapArea.getHeight();
+                 final double ratio = height / width;
+                 if (features == null || features.size() == 0) {
+                         // feature count == 0 Zoom to the full extend
+                         return;
+                 } else if (features.size() == 1) {
+                         // feature count == 1 Just move the window to the point and zoom 'a
+                         // bit'
+                         final SimpleFeature singleFeature = features.iterator().next();
+                         if (((Geometry) singleFeature.getDefaultGeometry())
+                                         .getCoordinates().length > 1) {
+                                 // System.out.println("Zoomed to only pne poylgon");
+                                 // Poly
+                                 // TODO max width vs. height
+                                 width = features.getBounds().getWidth() * 3;
+                                 height = ratio * width;
+                         } else {
+                                 // System.out.println("Zoomed in a bit becasue only one point");
+                                 // width *= .9;
+                                 // height *= .9;
+                         }
+                         Coordinate centre = features.getBounds().centre();
+                         if (!mapCRS.equals(fCRS)) {
+                                 // only to calculations if the CRS differ
+                                 try {
+                                         MathTransform fToMap;
+                                         fToMap = CRS.findMathTransform(fCRS, mapCRS);
+                                         // centre is transformed to the mapCRS
+                                         centre = JTS.transform(centre, null, fToMap);
+                                 } catch (final FactoryException e) {
+                                         LOGGER.error("Looking for a Math transform", e);
+                                 } catch (final TransformException e) {
+                                         LOGGER.error("Looking for a Math transform", e);
+                                 }
+                         }
+                         final Coordinate newLeftBottom = new Coordinate(centre.x - width
+                                         / 2., centre.y - height / 2.);
+                         final Coordinate newTopRight = new Coordinate(
+                                         centre.x + width / 2., centre.y + height / 2.);
+                         final Envelope newMapArea = new Envelope(newLeftBottom, newTopRight);
+                         setMapArea(newMapArea);
+                 } else {
+                         final ReferencedEnvelope fBounds = features.getBounds();
+                         Envelope bounds;
+                         if (!mapCRS.equals(fCRS)) {
+                                 bounds = JTSUtil.transformEnvelope(fBounds, fCRS, mapCRS);
+                         } else {
+                                 bounds = fBounds;
+                         }
+                         // BB umrechnen von Layer-CRS in Map-CRS
+                         // Expand a bit
+                         bounds.expandBy(bounds.getWidth() / 6., bounds.getHeight() / 6.);
+                         setMapArea(bounds);
+                 }
          }
          /**
-          * Set the maximum allowed zoom scale. This is the smaller number value of
+          * Zooms towards a point.
-          * the two.
           *
-          * @author <a href="mailto:[email protected]">Stefan Alfons
+          * @param center
-          *         Kr&uuml;ger</a>
+          *            position in window coordinates
+          * @param zoomFactor
+          *            > 1 for zoom in, < 1 for zoom out. Default is 1.33
           */
-         public void setMaxZoomScale(Double maxZoomScale) {
+         public void zoomTo(final Point center) {
-                 // System.out.println("setting max scale to "+maxZoomScale);
+                 zoomTo(center, null);
-                 this.maxZoomScale = maxZoomScale;
          }
          /**
-          * Set the minimum (nearest) allowed zoom scale. This is the bigger number
+          * Zooms towards a point.
-          * value of the two.
           *
-          * @author <a href="mailto:[email protected]">Stefan Alfons
+          * @param center
-          *         Kr&uuml;ger</a>
+          *            position in window coordinates
-          */
+          * @param zoomFaktor
-         public void setMinZoomScale(Double minZoomScale) {
+          *            > 1 for zoom in, < 1 for zoom out. Default is 1.33.
-                 this.minZoomScale = minZoomScale;
+          */
+         public void zoomTo(Point center, Double zoomFaktor) {
+                 if (zoomFaktor == null || zoomFaktor == 0.)
+                         zoomFaktor = 2.;
+                 final Point2D gcenter = getScreenToWorld().transform(center, null);
+                 center = null;
+                 if (Double.isNaN(gcenter.getX()) || Double.isNaN(gcenter.getY())
+                                 || Double.isInfinite(gcenter.getX())
+                                 || Double.isInfinite(gcenter.getY())
+                 ) {
+                         // Not inside valid CRS area! cancel
+                         return;
+                 }
+                 final Envelope mapArea = getMapArea();
+                 final Envelope newMapArea = new Envelope(mapArea);
+                 newMapArea.expandBy((mapArea.getWidth() * zoomFaktor - mapArea
+                                 .getWidth()) / 2., (mapArea.getHeight() * zoomFaktor - mapArea
+                                 .getHeight()) / 2.);
+                 // TODO we actually want that
+                 // // Move the newMapArea above the new center
+                 // newMapArea.translate(gcenter.getX() - mapArea.centre().x, gcenter
+                 // .getY()
+                 // - mapArea.centre().y);
+                 setMapArea(newMapArea);
          }
-         // xulu.en
  }

 Legend:



Removed from v.207
 


changed lines


 
Added in v.544
 Legend:



Removed from v.207
 


changed lines


 
Added in v.544
-Removed from v.207
+Added in v.544

[email protected]	ViewVC Help
Powered by ViewVC 1.1.26