1 |
# Copyright (c) 2001, 2002 by Intevation GmbH |
# Copyright (c) 2001-2003, 2005 by Intevation GmbH |
2 |
# Authors: |
# Authors: |
3 |
# Bernhard Herzog <[email protected]> |
# Bernhard Herzog <[email protected]> |
4 |
|
# Jonathan Coles <[email protected]> |
5 |
# |
# |
6 |
# This program is free software under the GPL (>=v2) |
# This program is free software under the GPL (>=v2) |
7 |
# Read the file COPYING coming with Thuban for details. |
# Read the file COPYING coming with Thuban for details. |
22 |
|
|
23 |
class Map(TitledObject, Modifiable): |
class Map(TitledObject, Modifiable): |
24 |
|
|
25 |
"""Represent a map. A map is simply a list of layers. |
"""Represent a map. A map is a list of layers. Additionally |
26 |
|
there is a special label layer containing all labels that |
27 |
|
are defined for the map. |
28 |
|
|
29 |
Map objects send the following message types: |
Map objects send the following message types: |
30 |
|
|
53 |
self.projection = projection |
self.projection = projection |
54 |
|
|
55 |
def Destroy(self): |
def Destroy(self): |
56 |
# call Modifiable.Destroy first since it will call |
"""Destroys the map object with all layers including |
57 |
# Publisher.Destroy which removes all subscriptions. Otherwise |
the label layer. |
58 |
# clearing the layers results in messages to be sent which can |
|
59 |
# cause problems. |
Calls Modifiable.Destroy first since it will call |
60 |
|
Publisher.Destroy which removes all subscriptions. Otherwise |
61 |
|
clearing the layers results in messages to be sent which can |
62 |
|
cause problems. |
63 |
|
""" |
64 |
Modifiable.Destroy(self) |
Modifiable.Destroy(self) |
65 |
self.ClearLayers() |
self.ClearLayers() |
66 |
self.label_layer.Unsubscribe(CHANGED, self.forward, MAP_LAYERS_CHANGED) |
self.label_layer.Unsubscribe(CHANGED, self.forward, MAP_LAYERS_CHANGED) |
74 |
self.changed(MAP_LAYERS_ADDED, self) |
self.changed(MAP_LAYERS_ADDED, self) |
75 |
|
|
76 |
def RemoveLayer(self, layer): |
def RemoveLayer(self, layer): |
77 |
"""Remove layer from the map.""" |
"""Remove layer from the map. |
78 |
|
This can not be applied for the label layer of the map. |
79 |
|
""" |
80 |
self.unsubscribe_layer_channels(layer) |
self.unsubscribe_layer_channels(layer) |
81 |
self.layers.remove(layer) |
self.layers.remove(layer) |
82 |
self.changed(MAP_LAYERS_CHANGED, self) |
self.changed(MAP_LAYERS_CHANGED, self) |
93 |
return 1 |
return 1 |
94 |
|
|
95 |
def ClearLayers(self): |
def ClearLayers(self): |
96 |
"""Delete all layers.""" |
"""Delete all layers and also remove all labels from the |
97 |
|
label layer. |
98 |
|
""" |
99 |
for layer in self.layers: |
for layer in self.layers: |
100 |
self.unsubscribe_layer_channels(layer) |
self.unsubscribe_layer_channels(layer) |
101 |
layer.Destroy() |
layer.Destroy() |
121 |
def Layers(self): |
def Layers(self): |
122 |
"""Return the list of layers contained in the map. |
"""Return the list of layers contained in the map. |
123 |
|
|
124 |
The list does not include the label layer""" |
The list does not include the label layer which |
125 |
|
can be retrieved by a separate method.""" |
126 |
return self.layers |
return self.layers |
127 |
|
|
128 |
def HasLayers(self): |
def HasLayers(self): |
129 |
"""Return true if the map has at least one shape layer""" |
"""Return true if the map has at least one layer other |
130 |
|
than the label layer.""" |
131 |
return len(self.layers) > 0 |
return len(self.layers) > 0 |
132 |
|
|
133 |
def MoveLayerToTop(self, layer): |
def MoveLayerToTop(self, layer): |
134 |
"""Put the layer on top of the layer stack. |
"""Put the layer on top of the layer stack. This can not |
135 |
|
be applied to the label layer. |
136 |
|
|
137 |
If the layer is already at the top do nothing. If the stacking |
If the layer is already at the top do nothing. If the stacking |
138 |
order has been changed, issue a MAP_LAYERS_CHANGED message. |
order has been changed, issue a MAP_LAYERS_CHANGED message. |
144 |
self.changed(MAP_LAYERS_CHANGED, self) |
self.changed(MAP_LAYERS_CHANGED, self) |
145 |
self.changed(MAP_STACKING_CHANGED, self) |
self.changed(MAP_STACKING_CHANGED, self) |
146 |
|
|
|
|
|
147 |
def RaiseLayer(self, layer): |
def RaiseLayer(self, layer): |
148 |
"""Swap the layer with the one above it. |
"""Swap the layer with the one above it. This does |
149 |
|
not apply to the label layer. |
150 |
|
|
151 |
If the layer is already at the top do nothing. If the stacking |
If the layer is already at the top do nothing. If the stacking |
152 |
order has been changed, issue a MAP_LAYERS_CHANGED message. |
order has been changed, issue a MAP_LAYERS_CHANGED message. |
159 |
self.changed(MAP_STACKING_CHANGED, self) |
self.changed(MAP_STACKING_CHANGED, self) |
160 |
|
|
161 |
def LowerLayer(self, layer): |
def LowerLayer(self, layer): |
162 |
"""Swap the layer with the one below it. |
"""Swap the layer with the one below it. This does |
163 |
|
not apply to the label layer. |
164 |
|
|
165 |
If the layer is already at the bottom do nothing. If the |
If the layer is already at the bottom do nothing. If the |
166 |
stacking order has been changed, issue a MAP_LAYERS_CHANGED message. |
stacking order has been changed, issue a MAP_LAYERS_CHANGED message. |
173 |
self.changed(MAP_STACKING_CHANGED, self) |
self.changed(MAP_STACKING_CHANGED, self) |
174 |
|
|
175 |
def MoveLayerToBottom(self, layer): |
def MoveLayerToBottom(self, layer): |
176 |
"""Put the layer at the bottom of the stack. |
"""Put the layer at the bottom of the stack. This does |
177 |
|
not apply to the label layer. |
178 |
|
|
179 |
If the layer is already at the bottom do nothing. If the |
If the layer is already at the bottom do nothing. If the |
180 |
stacking order has been changed, issue a MAP_LAYERS_CHANGED message. |
stacking order has been changed, issue a MAP_LAYERS_CHANGED message. |
188 |
|
|
189 |
def BoundingBox(self): |
def BoundingBox(self): |
190 |
"""Return the bounding box of the map in Lat/Lon coordinates. |
"""Return the bounding box of the map in Lat/Lon coordinates. |
191 |
|
The label layer is not considered for the computation of the |
192 |
|
bounding box. |
193 |
|
|
194 |
Return None if there are no layers or no layer contains any shapes. |
Return None if there are no layers (except the label layer) or |
195 |
|
no layer contains any shapes. |
196 |
""" |
""" |
197 |
if not self.layers: |
if not self.layers: |
198 |
return None |
return None |
201 |
urx = [] |
urx = [] |
202 |
ury = [] |
ury = [] |
203 |
for layer in self.layers: |
for layer in self.layers: |
|
if layer is self.label_layer: |
|
|
continue |
|
204 |
# the layer's bbox may be None if it doesn't have any shapes |
# the layer's bbox may be None if it doesn't have any shapes |
205 |
bbox = layer.LatLongBoundingBox() |
bbox = layer.LatLongBoundingBox() |
206 |
if bbox is not None: |
if bbox is not None: |
218 |
|
|
219 |
def ProjectedBoundingBox(self): |
def ProjectedBoundingBox(self): |
220 |
"""Return the bounding box of the map in projected coordinates. |
"""Return the bounding box of the map in projected coordinates. |
221 |
|
The label layer is not considered for the computation of the |
222 |
|
bounding box. |
223 |
|
|
224 |
Return None if there are no layers or no layer contains any shapes. |
Return None if there are no layers (except the label layer) or |
225 |
|
no layer contains any shapes. |
226 |
""" |
""" |
227 |
# This simply returns the rectangle given by the projected |
# This simply returns the rectangle given by the projected |
228 |
# corners of the non-projected bbox. |
# corners of the non-projected bbox. |
232 |
return bbox |
return bbox |
233 |
|
|
234 |
def GetProjection(self): |
def GetProjection(self): |
235 |
|
"""Return the projection of the map.""" |
236 |
return self.projection |
return self.projection |
237 |
|
|
238 |
def SetProjection(self, projection): |
def SetProjection(self, projection): |
267 |
self.label_layer.UnsetModified() |
self.label_layer.UnsetModified() |
268 |
|
|
269 |
def TreeInfo(self): |
def TreeInfo(self): |
270 |
|
"""Return a tuple of (title, tupel) describing the contents |
271 |
|
of the object in a tree-structure. |
272 |
|
""" |
273 |
items = [] |
items = [] |
274 |
if self.BoundingBox() != None: |
if self.BoundingBox() != None: |
275 |
items.append(_("Extent (lat-lon): (%g, %g, %g, %g)") |
items.append(_("Extent (lat-lon): (%g, %g, %g, %g)") |
284 |
layers = self.layers[:] |
layers = self.layers[:] |
285 |
layers.reverse() |
layers.reverse() |
286 |
items.extend(layers) |
items.extend(layers) |
287 |
|
items.append(self.label_layer) |
288 |
|
|
289 |
return (_("Map: %s") % self.title, items) |
return (_("Map: %s") % self.title, items) |
|
|
|