schmitzm.geotools
Class GTUtil

java.lang.Object
  extended by schmitzm.geotools.GTUtil

public class GTUtil
extends Object

Diese Klasse enthaelt allgemeine Funktionen fuer die Arbeit mit Geotools.

Version:
1.0
Author:
Martin Schmitz (University of Bonn/Germany)

Nested Class Summary
static class GTUtil.GTRendererType
          Specifies the types of renderer used by createGTRenderer() .
 
Field Summary
static CoordinateReferenceSystem WGS84
          Konstante fuer das CRS "WGS84" (erzeugt als "EPSG:4326")
 
Constructor Summary
GTUtil()
           
 
Method Summary
static CoordinateReferenceSystem createCRS_EPSG(String code)
          Erzeugt ein CoordinateReferenceSystem aus einem (EPSG-)Code.
static CoordinateReferenceSystem createCRS_UTM(int zone)
          Erzeugt ein UTM-CoordinateReferenceSystem.
static CoordinateReferenceSystem createCRS(String crsDef)
          Erzeugt ein CoordinateReferenceSystem aus einer String-Definition.
static Envelope2D createEnvelope2D(Rectangle2D env, CoordinateReferenceSystem crs)
          Erzeugt einen Envelope2D aus einem Rectangle2D .
static GTRenderer createGTRenderer()
          Creates a GTRenderer.
static GTRenderer createGTRenderer(MapContext mapContext)
          Creates a GTRenderer.
static GTRenderer createGTRenderer(MapContext mapContext, Map<Object,Object> additionalRenderingHints)
          Creates a GTRenderer.
static SortedMap<String,CoordinateReferenceSystem> getAvailableCRSByCode(String authority, boolean longitudeFirst, boolean suppressWarnings)
          Liefert alle zur Verfuegung stehenden CRS fuer eine Authority.
static SortedMap<String,CoordinateReferenceSystem> getAvailableCRSByName(String authority, boolean longitudeFirst, boolean suppressWarnings)
          Liefert alle zur Verfuegung stehenden CRS fuer eine Authority.
static HashMap<Object,Object> getDefaultGTRendererHints(GTRenderer renderer)
          Returns the default RendererHints for a given GTRenderer.
static GTUtil.GTRendererType getGTRendererType()
          Returns the renderer used by createGTRenderer().
static ReferencedEnvelope getVisibleLayoutBounds(MapContext context)
          Very similar to MapContext#getLayerBounds(), this may return null.
static Envelope intersectEnvelope(Envelope env1, Envelope env2, CoordinateReferenceSystem crs)
          Berechnet den Schnitt zweier Envelopes.
static void setGTRendererType(GTUtil.GTRendererType rType)
          Sets the renderer used by createGTRenderer().
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

WGS84

public static CoordinateReferenceSystem WGS84
Konstante fuer das CRS "WGS84" (erzeugt als "EPSG:4326")

Constructor Detail

GTUtil

public GTUtil()
Method Detail

createCRS

public static CoordinateReferenceSystem createCRS(String crsDef)
Erzeugt ein CoordinateReferenceSystem aus einer String-Definition. Akzeptiert wird ein EPSG-Code "EPSG:..." oder eine WKT-Definition des CRS

Parameters:
crsDef - Definition fuer das CRS.
Returns:
null, falls der String nicht zu einem CRS dekodiert werden kann

createCRS_EPSG

public static CoordinateReferenceSystem createCRS_EPSG(String code)
Erzeugt ein CoordinateReferenceSystem aus einem (EPSG-)Code. Entspricht CRS#decode(String,true). Exceptions werden jedoch abgefangen und stattdessen null zurueckgegeben.

Parameters:
code - Code fuer das CRS.

createCRS_UTM

public static CoordinateReferenceSystem createCRS_UTM(int zone)
Erzeugt ein UTM-CoordinateReferenceSystem.

Parameters:
zone - UTM-Zone

createEnvelope2D

public static Envelope2D createEnvelope2D(Rectangle2D env,
                                          CoordinateReferenceSystem crs)
Erzeugt einen Envelope2D aus einem Rectangle2D .

Parameters:
env - Georeferenz und Ausdehnung
crs - CoordinateReferenceSystem

getAvailableCRSByName

public static final SortedMap<String,CoordinateReferenceSystem> getAvailableCRSByName(String authority,
                                                                                      boolean longitudeFirst,
                                                                                      boolean suppressWarnings)
Liefert alle zur Verfuegung stehenden CRS fuer eine Authority.

Parameters:
authority - Authority fuer die die CRS geliefert werden (z.B. "EPSG")
longitudeFirst - true erzwingt die Achsenordnung (longitude, latitude). Siehe CRS#decode(String, boolean) (Bemerkung: false bedeutet System-Default, nicht (latitude, longitude)!)
suppressWarnings - wenn true werden Warnmeldungen unterdrueckt
Returns:
eine nach dem CRS-Namen geordnete Map

getAvailableCRSByCode

public static final SortedMap<String,CoordinateReferenceSystem> getAvailableCRSByCode(String authority,
                                                                                      boolean longitudeFirst,
                                                                                      boolean suppressWarnings)
Liefert alle zur Verfuegung stehenden CRS fuer eine Authority.

Parameters:
authority - Authority fuer die die CRS geliefert werden (z.B. "EPSG")
longitudeFirst - true erzwingt die Achsenordnung (longitude, latitude). Siehe CRS#decode(String, boolean) (Bemerkung: false bedeutet System-Default, nicht (latitude, longitude)!)
suppressWarnings - wenn true werden Warnmeldungen unterdrueckt
Returns:
eine nach dem CRS-Code geordnete Map

intersectEnvelope

public static Envelope intersectEnvelope(Envelope env1,
                                         Envelope env2,
                                         CoordinateReferenceSystem crs)
Berechnet den Schnitt zweier Envelopes.

Parameters:
env1 - erster Envelope
env2 - zweiter Envelope
crs - CoordinateReferenceSystem fuer den Schnitt-Envelope

createGTRenderer

public static GTRenderer createGTRenderer(MapContext mapContext)
Creates a GTRenderer. This method can be used all over a project, so the renderer can be switched easily.

Parameters:
mapContext - a MapContext (can be null)

createGTRenderer

public static GTRenderer createGTRenderer(MapContext mapContext,
                                          Map<Object,Object> additionalRenderingHints)
Creates a GTRenderer. This method can be used all over a project, so the renderer can be switched easily.

Parameters:
mapContext - a MapContext (can be null)
additionalRenderingHints - A list of hints that will overload the default hints. May be null

createGTRenderer

public static GTRenderer createGTRenderer()
Creates a GTRenderer. This method can be used all over a project, so the renderer can be switched easily. The GTRenderer is initialized with the default renering hints for the kind of renderer.

See Also:
getDefaultGTRendererHints(GTRenderer)

setGTRendererType

public static void setGTRendererType(GTUtil.GTRendererType rType)
Sets the renderer used by createGTRenderer().

Parameters:
rType - renderer type
See Also:
GTUtil.GTRendererType

getGTRendererType

public static GTUtil.GTRendererType getGTRendererType()
Returns the renderer used by createGTRenderer().

See Also:
GTUtil.GTRendererType

getDefaultGTRendererHints

public static HashMap<Object,Object> getDefaultGTRendererHints(GTRenderer renderer)
Returns the default RendererHints for a given GTRenderer. By 2009/11/01 the StreamingRenderer needs StreamingRenderer.MEMORY_PRE_LOADING_KEY false, whereas ShapefileRenderer need its set to true.

Parameters:
renderer - is null, the default GTUtil.GTRendererType is used.

getVisibleLayoutBounds

public static ReferencedEnvelope getVisibleLayoutBounds(MapContext context)
Very similar to MapContext#getLayerBounds(), this may return null. Different to MapContext#getLayerBounds(), this instance only looks at visible layers.

Parameters:
localContext -
Returns: