1 |
package skrueger.geotools; |
/******************************************************************************* |
2 |
|
* Copyright (c) 2009 Martin O. J. Schmitz. |
3 |
import java.awt.BorderLayout; |
* |
4 |
import java.awt.Window; |
* This file is part of the SCHMITZM library - a collection of utility |
5 |
|
* classes based on Java 1.6, focusing (not only) on Java Swing |
6 |
import javax.swing.BorderFactory; |
* and the Geotools library. |
7 |
import javax.swing.JComponent; |
* |
8 |
import javax.swing.JPanel; |
* The SCHMITZM project is hosted at: |
9 |
import javax.swing.JSplitPane; |
* http://wald.intevation.org/projects/schmitzm/ |
10 |
|
* |
11 |
import org.apache.log4j.Logger; |
* This program is free software; you can redistribute it and/or |
12 |
import org.geotools.renderer.lite.StreamingRenderer; |
* modify it under the terms of the GNU Lesser General Public License |
13 |
|
* as published by the Free Software Foundation; either version 3 |
14 |
import schmitzm.geotools.gui.GeoMapPane; |
* of the License, or (at your option) any later version. |
15 |
import schmitzm.geotools.gui.JMapPane; |
* |
16 |
import schmitzm.geotools.gui.MapContextControlPane; |
* This program is distributed in the hope that it will be useful, |
17 |
import schmitzm.geotools.gui.MapPaneStatusBar; |
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
18 |
import schmitzm.geotools.styling.ColorMapManager; |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
19 |
|
* GNU General Public License for more details. |
20 |
/** |
* |
21 |
* Achtung! Dieser code ist verwuestet |
* You should have received a copy of the GNU Lesser General Public License (license.txt) |
22 |
* TODO DOKU und initialize schöner machen. SK |
* along with this program; if not, write to the Free Software |
23 |
*/ |
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. |
24 |
public class MapView extends JPanel { |
* or try this link: http://www.gnu.org/licenses/lgpl.html |
25 |
private static final Logger LOGGER = Logger.getLogger(MapView.class); |
* |
26 |
|
* Contributors: |
27 |
private final JSplitPane splitPane = new JSplitPane( |
* Martin O. J. Schmitz - initial API and implementation |
28 |
JSplitPane.HORIZONTAL_SPLIT); |
* Stefan A. Krüger - additional utility classes |
29 |
|
******************************************************************************/ |
30 |
protected MapPaneStatusBar statusBar = null; |
package skrueger.geotools; |
31 |
|
|
32 |
/** |
import java.awt.BorderLayout; |
33 |
* Komponente, in der die Karten, der Massstab und das Koordinaten-Raster |
import java.awt.Component; |
34 |
* dargestellt werden. |
|
35 |
*/ |
import javax.swing.BorderFactory; |
36 |
|
import javax.swing.JComponent; |
37 |
/** |
import javax.swing.JPanel; |
38 |
* SK: 21.6.09: ShapeFileRenderer is supposed to be about 5x faster on |
import javax.swing.JSplitPane; |
39 |
* ShapeFiles. The ShapeFileRenderer falls back to the |
|
40 |
* StreamingRenderer. |
import org.apache.log4j.Logger; |
41 |
*/ |
|
42 |
// Old code: |
import schmitzm.geotools.gui.GeoMapPane; |
43 |
// protected final GeoMapPane geoMapPane = new GeoMapPane(null,null,null,null, new StreamingRenderer()); |
import schmitzm.geotools.gui.JMapPane; |
44 |
|
import schmitzm.geotools.gui.MapContextControlPane; |
45 |
// New Code uses Streaming renderer. |
import schmitzm.geotools.gui.MapPaneStatusBar; |
46 |
protected final GeoMapPane geoMapPane = new GeoMapPane(null,null,null,null, new StreamingRenderer()); |
import schmitzm.geotools.styling.ColorMapManager; |
47 |
|
|
48 |
private MapPaneToolBar jToolBar; |
/** |
49 |
|
* Achtung! Dieser code ist verwuestet TODO DOKU und initialize schöner machen. |
50 |
/** |
* SK |
51 |
* Creates a new {@link MapView}. A {@link MapView} is a combination of a |
*/ |
52 |
* {@link GeoMapPane}, a {@link MapContextManagerInterface} on the left, |
public class MapView extends JPanel { |
53 |
* and some buttons floating over the {@link JMapPane} |
private static final Logger LOGGER = Logger.getLogger(MapView.class); |
54 |
*/ |
|
55 |
public MapView(Window parentGui, MapPaneToolBar toolBar) { |
private final JSplitPane splitPane = new JSplitPane( |
56 |
super(new BorderLayout()); |
JSplitPane.HORIZONTAL_SPLIT); |
57 |
// Call initialize() by yourself afterwards. |
|
58 |
// Needed because variables for the overwritten methods |
protected MapPaneStatusBar statusBar = null; |
59 |
// are not yet set. |
|
60 |
getGeoMapPane().getMapPane().setWaitCursorComponent(parentGui); |
/** |
61 |
if ( toolBar == null ) |
* Komponente, in der die Karten, der Massstab und das Koordinaten-Raster |
62 |
toolBar = new MapPaneToolBar(getMapPane()); |
* dargestellt werden. |
63 |
jToolBar = toolBar; |
*/ |
64 |
} |
|
65 |
|
protected final GeoMapPane geoMapPane = new GeoMapPane(); |
66 |
/** |
|
67 |
* Creates a new {@link MapView}. A {@link MapView} is a combination of a |
private MapPaneToolBar jToolBar; |
68 |
* {@link GeoMapPane}, a {@link MapContextManagerInterface} on the left, |
|
69 |
* and some buttons floating over the {@link JMapPane} |
/** |
70 |
*/ |
* Creates a new {@link MapView}. A {@link MapView} is a combination of a |
71 |
public MapView(Window parentGui) { |
* {@link GeoMapPane}, a {@link MapContextManagerInterface} on the left, and |
72 |
this(parentGui, null); |
* some buttons floating over the {@link JMapPane} |
73 |
} |
*/ |
74 |
|
public MapView(Component parentGui, MapPaneToolBar toolBar) { |
75 |
/** |
super(new BorderLayout()); |
76 |
* This routine creates the main components of the GUI: The left Side and the map on the right side.<br/> |
// Call initialize() by yourself afterwards. |
77 |
* Calls #getSidePanel() which can be overwritten (call super!).<br/> |
// Needed because variables for the overwritten methods |
78 |
* |
// are not yet set. |
79 |
* This method initialized the variables {@link #statusBar} and {@link #splitPane} |
getGeoMapPane().getMapPane().setWaitCursorComponent(parentGui); |
80 |
* |
jToolBar = toolBar; |
81 |
* @see #adjustSizeOfGeoMapPane() |
} |
82 |
*/ |
|
83 |
public void initialize() { |
/** |
84 |
// horizontales SplitPane initialisieren |
* Creates a new {@link MapView}. A {@link MapView} is a combination of a |
85 |
|
* {@link GeoMapPane}, a {@link MapContextManagerInterface} on the left, and |
86 |
// Status-Line to show Coordinates and Rastervalues. |
* some buttons floating over the {@link JMapPane} |
87 |
statusBar = new MapPaneStatusBar(getGeoMapPane() |
*/ |
88 |
.getMapPane()); |
public MapView(Component parentGui) { |
89 |
statusBar.setBorder(BorderFactory.createCompoundBorder(BorderFactory |
this(parentGui, null); |
90 |
.createLoweredBevelBorder(), BorderFactory.createEmptyBorder(2, |
} |
91 |
5, 2, 5))); |
|
92 |
this.add(statusBar, BorderLayout.SOUTH); |
/** |
93 |
|
* This routine creates the main components of the GUI: The left Side and |
94 |
|
* the map on the right side.<br/> |
95 |
/** |
* Calls #getSidePanel() which can be overwritten (call super!).<br/> |
96 |
* The layout of the split pane can be configured in the atlas. |
* |
97 |
*/ |
* This method initialized the variables {@link #statusBar} and |
98 |
getSplitPane().setDividerSize(5); |
* {@link #splitPane} |
99 |
getSplitPane().setDividerLocation(-1); |
* |
100 |
|
* @see #adjustSizeOfGeoMapPane() |
101 |
getSplitPane().setResizeWeight(0.0); |
*/ |
102 |
getSplitPane().add(getSidePane()); |
public void initialize() { |
103 |
|
// horizontales SplitPane initialisieren |
104 |
/*********************************************************************** |
|
105 |
* To the right side we now add a JPanel that consists of a toolbar and |
// Status-Line to show Coordinates and Rastervalues. |
106 |
* a gmp |
statusBar = new MapPaneStatusBar(getGeoMapPane().getMapPane()); |
107 |
*/ |
statusBar.setBorder(BorderFactory.createCompoundBorder(BorderFactory |
108 |
JPanel newRight = new JPanel(new BorderLayout()); |
.createLoweredBevelBorder(), BorderFactory.createEmptyBorder(2, |
109 |
newRight.add(getToolBar(), BorderLayout.NORTH); |
5, 2, 5))); |
110 |
newRight.add(getGeoMapPane(), BorderLayout.CENTER); |
this.add(statusBar, BorderLayout.SOUTH); |
111 |
getSplitPane().add(newRight); |
|
112 |
|
/** |
113 |
this.add(getSplitPane(), BorderLayout.CENTER); |
* The layout of the split pane can be configured in the atlas. |
114 |
} |
* setDividerLocation(-1); has no effect here because the component is |
115 |
|
* not visible yet. |
116 |
/** |
*/ |
117 |
* Returns the tool bar which controls the active mouse actions on the map. |
getSplitPane().setDividerSize(5); |
118 |
* @return |
|
119 |
*/ |
getSplitPane().setResizeWeight(0.0); |
120 |
public MapPaneToolBar getToolBar() { |
getSplitPane().add(getSidePane()); |
121 |
return jToolBar; |
|
122 |
} |
/*********************************************************************** |
123 |
|
* To the right side we now add a JPanel that consists of a toolbar and |
124 |
/** |
* a gmp |
125 |
* Returns the split pane which divides the layer list from the map panel. |
*/ |
126 |
*/ |
JPanel newRight = new JPanel(new BorderLayout()); |
127 |
public JSplitPane getSplitPane() { |
newRight.add(getToolBar(), BorderLayout.NORTH); |
128 |
return splitPane; |
newRight.add(getGeoMapPane(), BorderLayout.CENTER); |
129 |
} |
getSplitPane().add(newRight); |
130 |
|
|
131 |
|
this.add(getSplitPane(), BorderLayout.CENTER); |
132 |
/** |
} |
133 |
* Sets the active tool. |
|
134 |
* Simply calls {@link MapPaneToolBar#setSelectedTool(Integer)}. |
/** |
135 |
* @param tool |
* Returns the tool bar which controls the active mouse actions on the map. |
136 |
* One of {@link #TOOL_INFO}, {@link #TOOL_PAN} .. constants |
* |
137 |
*/ |
* @return never <code>null</code>, will rather create a default |
138 |
public void setSelectedTool(Integer tool) { |
*/ |
139 |
jToolBar.setSelectedTool(tool); |
public MapPaneToolBar getToolBar() { |
140 |
} |
if (jToolBar == null) { |
141 |
|
jToolBar = new MapPaneToolBar(getMapPane()); |
142 |
/** |
} |
143 |
* Sets whether a tool is activated or not. |
return jToolBar; |
144 |
* Simply calls {@link MapPaneToolBar#setButtonEnabled(int, boolean, boolean)}. |
} |
145 |
* @param tool tool ID |
|
146 |
* @param enabled if {@code true} the tool becomes available |
/** |
147 |
* @param hideOnDisable if {@code true} the button is also hidden if |
* Returns the split pane which divides the layer list from the map panel. |
148 |
* {@code enabled} is {@code false} |
*/ |
149 |
*/ |
public JSplitPane getSplitPane() { |
150 |
public void setToolEnabled(Integer tool, boolean enabled, boolean hideOnDisable) { |
return splitPane; |
151 |
jToolBar.setButtonEnabled(tool,enabled,hideOnDisable); |
} |
152 |
} |
|
153 |
|
/** |
154 |
/** |
* Sets the active tool. Simply calls |
155 |
* Sets the activation for all tools. |
* {@link MapPaneToolBar#setSelectedTool(Integer)}. |
156 |
* Simply calls {@link MapPaneToolBar#setAllToolsEnabled(boolean, boolean)}. |
* |
157 |
* @param enabled if {@code true} all tool becomes available |
* @param tool |
158 |
* @param hideOnDisable if {@code true} the buttons are also hidden if |
* One of {@link #TOOL_INFO}, {@link #TOOL_PAN} .. constants |
159 |
* {@code enabled} is {@code false} |
*/ |
160 |
*/ |
public void setSelectedTool(Integer tool) { |
161 |
public void setAllToolsEnabled(boolean enabled, boolean hideOnDisable) { |
jToolBar.setSelectedTool(tool); |
162 |
jToolBar.setAllToolsEnabled(enabled, hideOnDisable); |
} |
163 |
} |
|
164 |
|
/** |
165 |
/** |
* Sets whether a tool is activated or not. Simply calls |
166 |
* Checks whether a tool is activated. |
* {@link MapPaneToolBar#setButtonEnabled(int, boolean, boolean)}. |
167 |
* Simply calls {@link MapPaneToolBar#isButtonEnabled(Integer)}. |
* |
168 |
* @param tool tool ID |
* @param tool |
169 |
* @return {@code false} if an unknown ID is specified |
* tool ID |
170 |
*/ |
* @param enabled |
171 |
public boolean isToolEnabled(Integer tool) { |
* if {@code true} the tool becomes available |
172 |
return jToolBar.isButtonEnabled(tool); |
* @param hideOnDisable |
173 |
} |
* if {@code true} the button is also hidden if {@code enabled} |
174 |
|
* is {@code false} |
175 |
/** |
*/ |
176 |
* called by initialize() to fill the left of the XULUMapView Supposed to be |
public void setToolEnabled(Integer tool, boolean enabled, |
177 |
* overwritten by AtlasMapView or DesignMapView |
boolean hideOnDisable) { |
178 |
*/ |
jToolBar.setButtonEnabled(tool, enabled, hideOnDisable); |
179 |
public JComponent getSidePane() { |
} |
180 |
return new MapContextControlPane(getGeoMapPane().getMapPane(), |
|
181 |
new ColorMapManager()); |
/** |
182 |
} |
* Sets the activation for all tools. Simply calls |
183 |
|
* {@link MapPaneToolBar#setAllToolsEnabled(boolean, boolean)}. |
184 |
/** |
* |
185 |
* Liefert die Status-Zeile, in der die Koordinaten und Raster-Werte |
* @param enabled |
186 |
* angezeigt werden. |
* if {@code true} all tool becomes available |
187 |
*/ |
* @param hideOnDisable |
188 |
public MapPaneStatusBar getStatusBar() { |
* if {@code true} the buttons are also hidden if {@code enabled} |
189 |
return this.statusBar; |
* is {@code false} |
190 |
} |
*/ |
191 |
|
public void setAllToolsEnabled(boolean enabled, boolean hideOnDisable) { |
192 |
/** |
jToolBar.setAllToolsEnabled(enabled, hideOnDisable); |
193 |
* Liefert den Karten-Bereich der Komponente. |
} |
194 |
*/ |
|
195 |
public final JMapPane getMapPane() { |
/** |
196 |
return getGeoMapPane().getMapPane(); |
* Checks whether a tool is activated. Simply calls |
197 |
} |
* {@link MapPaneToolBar#isButtonEnabled(Integer)}. |
198 |
|
* |
199 |
public GeoMapPane getGeoMapPane() { |
* @param tool |
200 |
return geoMapPane; |
* tool ID |
201 |
} |
* @return {@code false} if an unknown ID is specified |
202 |
|
*/ |
203 |
public int getSelectedTool() { |
public boolean isToolEnabled(Integer tool) { |
204 |
return jToolBar.getSelectedTool(); |
return jToolBar.isButtonEnabled(tool); |
205 |
} |
} |
206 |
|
|
207 |
} |
/** |
208 |
|
* called by initialize() to fill the left of the XULUMapView Supposed to be |
209 |
|
* overwritten by AtlasMapView or DesignMapView |
210 |
|
*/ |
211 |
|
public JComponent getSidePane() { |
212 |
|
return new MapContextControlPane(getGeoMapPane().getMapPane(), |
213 |
|
new ColorMapManager()); |
214 |
|
} |
215 |
|
|
216 |
|
/** |
217 |
|
* Liefert die Status-Zeile, in der die Koordinaten und Raster-Werte |
218 |
|
* angezeigt werden. |
219 |
|
*/ |
220 |
|
public MapPaneStatusBar getStatusBar() { |
221 |
|
return this.statusBar; |
222 |
|
} |
223 |
|
|
224 |
|
/** |
225 |
|
* Liefert den Karten-Bereich der Komponente. |
226 |
|
*/ |
227 |
|
public final JMapPane getMapPane() { |
228 |
|
return getGeoMapPane().getMapPane(); |
229 |
|
} |
230 |
|
|
231 |
|
public GeoMapPane getGeoMapPane() { |
232 |
|
return geoMapPane; |
233 |
|
} |
234 |
|
|
235 |
|
public int getSelectedTool() { |
236 |
|
return jToolBar.getSelectedTool(); |
237 |
|
} |
238 |
|
|
239 |
|
} |