org.deegree.graphics
Class MapView

java.lang.Object
  org.deegree.graphics.MapView

public class MapView
extends Object

This interface describes the data model of the map itself. It is built from themes containing DisplayElements to be rendered. Themes can be added and removed. Existing themes can be re-arragned by changing their order.

Version:

$Revision: 9340 $, $Date: 2007-12-27 13:32:12 +0100 (Do, 27 Dez 2007) $

Author:

Andreas Poth, Markus Schneider, last edited by: $Author: apoth $

Constructor Summary

MapView(String name, Envelope boundingbox, CoordinateSystem crs, double pixelsize)

MapView(String name, Envelope boundingbox, double pixelsize)

Method Summary

void	activateTheme(Theme theme) activates a theme.
void	addEventController(MapEventController obj) adds an eventcontroller to the MapView that's reponsible for handling events that targets the map.
void	addHighlighter(Highlighter highlighter) A Highlighter is a class that is responsible for managing the highlight capabilities for one or more Themes.
void	addOptimizer(Optimizer optimizer) Adds an Optimizer.
void	addSelector(Selector obj) A selector is a class that offers methods for selecting and deselecting single DisplayElements or groups of DisplayElements.
void	addTheme(Theme theme) adds a theme to the MapView
void	clear() removes all themes from the MapView.
void	enableTheme(Theme theme, boolean enable) enables or disables a theme that is part of the MapView.
Theme[]	getAllThemes() returns the Themes in correct order.
Envelope	getBoundingBox() returns the BoundingBox (Envelope) of the MapView.
CoordinateSystem	getCoordinatesSystem() returns the coordinate reference system of the MapView
String	getName() returns the name of the map
Optimizer[]	getOptimizers() Returns the Optimizers.
GeoTransform	getProjection() Returns the GeoTransform that is associated to this MapView.
double	getScale() Returns the current scale of the MapView.
double	getScale(Graphics g) Returns the current scale of the MapView.
int	getSize() returns the amount of themes within the MapView.
Theme	getTheme(int index) returns the Theme that matches the submitted index
Theme	getTheme(String name) returns the Theme that matches the submitted name
boolean	isThemeActivated(Theme theme) returns true if the passed theme is the one that is set to be activated
boolean	isThemeEnabled(Theme theme) returns true if the passed theme is set to be enabled
void	moveDown(Theme theme) move a theme down for one index position (index = oldindex - 1)
void	moveUp(Theme theme) move a theme up for one index position (index = oldindex + 1)
void	paint(Graphics g) renders the map to the passed graphic context
void	paintHighlighted(Graphics g) renders the features marked as highlighted of all themes contained within the MapView
void	paintSelected(Graphics g) renders the features marked as selected of all themes contained within the MapView
void	removeEventController(MapEventController obj)
void	removeHighlighter(Highlighter highlighter)
void	removeSelector(Selector obj)
void	removeTheme(int index) removes the theme that matches the submitted index from the MapView
void	removeTheme(String name) removes the theme that matches the submitted name from the MapView
void	removeTheme(Theme theme) removes a theme from the MapView
void	setBoundingBox(Envelope boundingbox)
void	setCoordinateSystem(CoordinateSystem crs) sets the coordinate reference system of the map;
void	setOptimizers(Optimizer[] optimizers) Sets the Optimizers.
void	swapThemes(Theme first, Theme second) swaps the positions of the submitted themes

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MapView

MapView(String name,
        Envelope boundingbox,
        double pixelsize)
  throws UnknownCRSException

Parameters:

name -

boundingbox -

pixelsize -

Throws:

UnknownCRSException

MapView

MapView(String name,
        Envelope boundingbox,
        CoordinateSystem crs,
        double pixelsize)

Parameters:

name -

boundingbox -

crs -

pixelsize -

Method Detail

getName

public String getName()

returns the name of the map

getTheme

public Theme getTheme(String name)

returns the Theme that matches the submitted name

getTheme

public Theme getTheme(int index)

returns the Theme that matches the submitted index

getAllThemes

public Theme[] getAllThemes()

returns the Themes in correct order. The first Theme (index == 0) shall be rendered at first (bottom most).

getScale

public double getScale()

Returns the current scale of the MapView.

getScale

public double getScale(Graphics g)
                throws Exception

Returns the current scale of the MapView.

Throws:

Exception

addTheme

public void addTheme(Theme theme)
              throws Exception

adds a theme to the MapView

Throws:

Exception

removeTheme

public void removeTheme(Theme theme)

removes a theme from the MapView

removeTheme

public void removeTheme(String name)

removes the theme that matches the submitted name from the MapView

removeTheme

public void removeTheme(int index)

removes the theme that matches the submitted index from the MapView

clear

public void clear()

removes all themes from the MapView.

swapThemes

public void swapThemes(Theme first,
                       Theme second)

swaps the positions of the submitted themes

moveUp

public void moveUp(Theme theme)

move a theme up for one index position (index = oldindex + 1)

moveDown

public void moveDown(Theme theme)

move a theme down for one index position (index = oldindex - 1)

enableTheme

public void enableTheme(Theme theme,
                        boolean enable)

enables or disables a theme that is part of the MapView. A theme that has been disabled won't be rendered and usually doesn't react to events targeted to the MapView, but still is part of the MapView.

isThemeEnabled

public boolean isThemeEnabled(Theme theme)

returns true if the passed theme is set to be enabled

activateTheme

public void activateTheme(Theme theme)

activates a theme. Usually the activated theme is perferred to react to events (this doesn't mean that other themes are not allowed to react to events).

isThemeActivated

public boolean isThemeActivated(Theme theme)

returns true if the passed theme is the one that is set to be activated

getSize

public int getSize()

returns the amount of themes within the MapView.

addEventController

public void addEventController(MapEventController obj)

adds an eventcontroller to the MapView that's reponsible for handling events that targets the map. E.g.: zooming, panning, selecting a feature etc.

removeEventController

public void removeEventController(MapEventController obj)

See Also:

addEventController(MapEventController)

addSelector

public void addSelector(Selector obj)

A selector is a class that offers methods for selecting and deselecting single DisplayElements or groups of DisplayElements. A selector may offers methods like 'select all DisplayElements within a specified bounding box' or 'select all DisplayElements thats area is larger than 120 km�' etc.

removeSelector

public void removeSelector(Selector obj)

See Also:

addSelector(Selector)

getBoundingBox

public Envelope getBoundingBox()

returns the BoundingBox (Envelope) of the MapView. This isn't nessecary the BoundingBox of the data that will be rendered. It's the boundingBox of the the visible area of the map measured in its coordinate reference system.

setBoundingBox

public void setBoundingBox(Envelope boundingbox)

See Also:

this method may be used for zooming and panning the map

getCoordinatesSystem

public CoordinateSystem getCoordinatesSystem()

returns the coordinate reference system of the MapView

setCoordinateSystem

public void setCoordinateSystem(CoordinateSystem crs)
                         throws Exception

sets the coordinate reference system of the map;

Throws:

Exception

paint

public void paint(Graphics g)
           throws RenderException

renders the map to the passed graphic context

Parameters:

g -

Throws:

RenderException - thrown if the passed Graphic haven't clipbounds. use g.setClip( .. );

paintSelected

public void paintSelected(Graphics g)
                   throws RenderException

renders the features marked as selected of all themes contained within the MapView

Parameters:

g - graphic context to render the map too

Throws:

RenderException - thrown if the passed Graphic haven't clipbounds. use g.setClip( .. );

paintHighlighted

public void paintHighlighted(Graphics g)
                      throws RenderException

renders the features marked as highlighted of all themes contained within the MapView

Parameters:

g - graphic context to render the map too

Throws:

RenderException - thrown if the passed Graphic haven't clipbounds. use g.setClip( .. );

addHighlighter

public void addHighlighter(Highlighter highlighter)

A Highlighter is a class that is responsible for managing the highlight capabilities for one or more Themes.

removeHighlighter

public void removeHighlighter(Highlighter highlighter)

See Also:

addHighlighter(Highlighter)

getProjection

public GeoTransform getProjection()

Returns the GeoTransform that is associated to this MapView.

Returns:

the associated GeoTransform-instance

addOptimizer

public void addOptimizer(Optimizer optimizer)

Adds an Optimizer.

Parameters:

optimizer -

getOptimizers

public Optimizer[] getOptimizers()

Returns the Optimizers.

Returns:

the Optimizers.

setOptimizers

public void setOptimizers(Optimizer[] optimizers)

Sets the Optimizers.

Parameters:

optimizers -