org.mapfish.print.attribute.map

Class MapfishMapContext

java.lang.Object

org.mapfish.print.attribute.map.MapfishMapContext

public final class MapfishMapContext
extends java.lang.Object

Utility class that adjusts the bounds and the map size in case a rotation is set. Also it provides an AffineTransform to render the layer graphics.

Constructor Summary

Constructors

Constructor and Description
MapfishMapContext(MapBounds bounds, java.awt.Dimension mapSize, double rotationInDegree, double dpi, double requestorDpi, java.lang.Boolean forceLongitudeFirst, boolean dpiSensitiveStyle) Constructor.
MapfishMapContext(MapfishMapContext parent, MapBounds bounds, java.awt.Dimension mapSize, double rotation, boolean rotationInDegree, double dpi, double requestorDpi, java.lang.Boolean forceLongitudeFirst, boolean dpiSensitiveStyle) Constructor.
MapfishMapContext(MapfishMapContext parent, MapBounds bounds, java.awt.Dimension mapSize, double rotationInDegree, double dpi, double requestorDpi, java.lang.Boolean forceLongitudeFirst, boolean dpiSensitiveStyle) Constructor.

Method Summary

Modifier and Type	Method and Description
MapBounds	getBounds()
double	getDPI()
Scale	getGeodeticScale()
java.awt.Dimension	getMapSize()
java.awt.Rectangle	getPaintArea()
MapfishMapContext	getParentContext() Get the parent context if there is one.
double	getRequestorDPI()
MapfishMapContext	getRootContext() Return the root context which is this context or the context found by recursively calling parent.getRootContext().
MapBounds	getRotatedBounds() Return the map bounds rotated with the set rotation.
MapBounds	getRotatedBounds(java.awt.geom.Rectangle2D.Double paintAreaPrecise, java.awt.Rectangle paintArea) Return the map bounds rotated with the set rotation.
java.awt.Dimension	getRotatedMapSize()
java.awt.geom.Rectangle2D.Double	getRotatedMapSizePrecise()
double	getRotation()
double	getRoundedScale() Get a nicely rounded scale for to use for displaying the map scale.
double	getRoundedScale(boolean geodetic) Get a nicely rounded scale for to use for displaying the map scale.
Scale	getScale()
java.awt.geom.AffineTransform	getTransform() Returns an AffineTransform taking the rotation into account.
java.lang.Boolean	isDpiSensitiveStyle()
java.lang.Boolean	isForceLongitudeFirst()
static java.awt.Dimension	rectangleDoubleToDimension(java.awt.geom.Rectangle2D.Double rectangle) Round the size of a rectangle with double values.
org.geotools.geometry.jts.ReferencedEnvelope	toReferencedEnvelope() Get the bounds as a referenced envelope.

Methods inherited from class java.lang.Object

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

Constructor Detail

MapfishMapContext

public MapfishMapContext(MapBounds bounds,
                         java.awt.Dimension mapSize,
                         double rotationInDegree,
                         double dpi,
                         double requestorDpi,
                         java.lang.Boolean forceLongitudeFirst,
                         boolean dpiSensitiveStyle)

Constructor.

Parameters:

bounds - the map bounds

mapSize - the map size

rotationInDegree - the rotation in degree

dpi - the dpi of the printed map

requestorDpi - the dpi of the client map

forceLongitudeFirst - If true then force longitude coordinates as the first coordinate.

dpiSensitiveStyle - Scale the vector styles?

MapfishMapContext

public MapfishMapContext(MapfishMapContext parent,
                         MapBounds bounds,
                         java.awt.Dimension mapSize,
                         double rotationInDegree,
                         double dpi,
                         double requestorDpi,
                         java.lang.Boolean forceLongitudeFirst,
                         boolean dpiSensitiveStyle)

Constructor.

Parameters:

parent - the context that this context is derived from

bounds - the map bounds

mapSize - the map size

rotationInDegree - the rotation in degree

dpi - the dpi of the printed map

requestorDpi - the dpi of the client map

forceLongitudeFirst - If true then force longitude coordinates as the first coordinate.

dpiSensitiveStyle - Scale the vector styles?

MapfishMapContext

public MapfishMapContext(MapfishMapContext parent,
                         MapBounds bounds,
                         java.awt.Dimension mapSize,
                         double rotation,
                         boolean rotationInDegree,
                         double dpi,
                         double requestorDpi,
                         java.lang.Boolean forceLongitudeFirst,
                         boolean dpiSensitiveStyle)

Constructor.

Parameters:

parent - the context that this context is derived from

bounds - the map bounds

mapSize - the map size

rotation - the rotation

rotationInDegree - the rotation in degree?

dpi - the dpi of the printed map

requestorDpi - the dpi of the client map

forceLongitudeFirst - If true then force longitude coordinates as the first coordinate.

dpiSensitiveStyle - Scale the vector styles?

Method Detail

getRotation

public double getRotation()

Returns:

The rotation in radians.

getBounds

public MapBounds getBounds()

getRotatedBounds

public MapBounds getRotatedBounds()

Return the map bounds rotated with the set rotation.

Returns:

Rotated bounds.

getRotatedBounds

public MapBounds getRotatedBounds(java.awt.geom.Rectangle2D.Double paintAreaPrecise,
                                  java.awt.Rectangle paintArea)

Return the map bounds rotated with the set rotation. The bounds are adapted to rounding changes of the size of the paint area.

Parameters:

paintAreaPrecise - The exact size of the paint area.

paintArea - The rounded size of the paint area.

Returns:

Rotated bounds.

getMapSize

public java.awt.Dimension getMapSize()

getScale

public Scale getScale()

getGeodeticScale

public Scale getGeodeticScale()

getRoundedScale

public double getRoundedScale()

Get a nicely rounded scale for to use for displaying the map scale.

One of the output parameters of the CreateMapProcessor is 'mapContext' which can be accessed in a template. If the scale is required in the template then it can be accessed via: $P{mapContext}.getRoundedScale()

getRoundedScale

public double getRoundedScale(boolean geodetic)

Get a nicely rounded scale for to use for displaying the map scale.

One of the output parameters of the CreateMapProcessor is 'mapContext' which can be accessed in a template. If the scale is required in the template then it can be accessed via: $P{mapContext}.getRoundedScale()

Parameters:

geodetic - Get geodetic scale

getRotatedMapSize

public java.awt.Dimension getRotatedMapSize()

Returns:

The new map size taking the rotation into account.

getRotatedMapSizePrecise

public java.awt.geom.Rectangle2D.Double getRotatedMapSizePrecise()

Returns:

The new map size taking the rotation into account.

rectangleDoubleToDimension

public static java.awt.Dimension rectangleDoubleToDimension(java.awt.geom.Rectangle2D.Double rectangle)

Round the size of a rectangle with double values.

Parameters:

rectangle - The rectangle.

Returns:

getTransform

public java.awt.geom.AffineTransform getTransform()

Returns an AffineTransform taking the rotation into account.

Returns:

an affine transformation

getDPI

public double getDPI()

getRequestorDPI

public double getRequestorDPI()

getPaintArea

public java.awt.Rectangle getPaintArea()

isForceLongitudeFirst

@Nullable
public java.lang.Boolean isForceLongitudeFirst()

isDpiSensitiveStyle

public java.lang.Boolean isDpiSensitiveStyle()

toReferencedEnvelope

public org.geotools.geometry.jts.ReferencedEnvelope toReferencedEnvelope()

Get the bounds as a referenced envelope.

Returns:

bounds as a referenced envelope.

getParentContext

@Nullable
public MapfishMapContext getParentContext()

Get the parent context if there is one. A parent context is the context that this context is derived from. Normally there are some parameters that have been changed for this context from the parent. An example of when there might be a parent is when the child has been rotated and has a bounds to envelope the original bounds. It can be useful in some cases to be able to access the parent (and original bounds).

Returns:

the parent context or null if there is no parent.

getRootContext

@Nonnull
public MapfishMapContext getRootContext()

Return the root context which is this context or the context found by recursively calling parent.getRootContext().

Returns: