com.moximedia.ows.projection
Class ProjectionUtm

java.lang.Object
  com.moximedia.ows.projection.ProjectionUtm

All Implemented Interfaces:

java.lang.Cloneable, MeasureUnitsType, Projection, ProjectionType, java.io.Serializable

public class ProjectionUtm

extends java.lang.Object

implements Projection, ProjectionType, MeasureUnitsType, java.lang.Cloneable, java.io.Serializable

Convenience class for backwards compatibility.

Author:

Doug Cates - www.moximedia.com

See Also:

Serialized Form

Field Summary

static int	HEMISPHERE_NORTH Northern hemisphere
static int	HEMISPHERE_SOUTH Southern hemisphere

Fields inherited from interface com.moximedia.ows.types.ProjectionType

PROJECTION_TYPE_ALBERS_CONIC_EQUAL_AREA, PROJECTION_TYPE_GEOGRAPHIC, PROJECTION_TYPE_LAMBERT_CONFORMAL_CONIC_2SP, PROJECTION_TYPE_TRANSVERSE_MERCATOR, PROJECTION_TYPE_UTM, PROJECTION_TYPE_UTM_AUTO, PROJECTION_TYPE_WKT

Fields inherited from interface com.moximedia.ows.types.MeasureUnitsType

MEASURE_UNITS_DECIMAL_DEGREES, MEASURE_UNITS_FEET, MEASURE_UNITS_IMPERIAL, MEASURE_UNITS_METERS, MEASURE_UNITS_METRES, MEASURE_UNITS_METRIC, MEASURE_UNITS_UNKNOWN, MEASURE_UNITS_US, MEASURE_UNITS_YARDS

Constructor Summary

ProjectionUtm()
Creates a new instance

Method Summary

java.lang.Object	clone() Returns a separate copy of this object.
boolean	equals(Projection anotherProjection) Returns an indicator of whether this projection is the same as another.
java.lang.String	getAlias() Return the alias of the projection
java.lang.String	getAlias(java.util.Locale locale) Return the alias of the projection
CoordinateSystem	getCoordinateSystem() Method to compare projections.
ProjectionUtm	getCopy() Returns a separate copy of this object.
java.lang.String	getMapCenterString(Point geoPoint, double scaleFactor, java.util.Locale locale) Returns the map center coordinate text in the specified locale.
java.lang.String	getName() Return the name of the projection
java.lang.String	getName(java.util.Locale locale) Return the name of the projection
int	getProjectionType() Gets the projection type enumeration.
java.lang.String	getReportString(Point geoPoint, double scaleFactor, java.util.Locale locale) Returns the report for the standard identify reports.
java.lang.String	getSrs() Return the spatial reference system code.
int	getUnits() Return the map units of the projection.
java.lang.String	getUnitsString() Return the map units of the projection as a string.
double	getZone() Return the zone of the projection
boolean	isGeographicCoordinateSystem() Returns an indicator of whether this coordinate system is geographic.
boolean	isProjectedCoordinateSystem() Returns an indicator of whether this coordinate system is projected (non-geographic).
boolean	isValid() Gets an indicator of whether the projection is valid.
Point	project(Point point) Projects a geographic position into this projection.
void	setAlias(java.lang.String alias) Sets the alias for the projection for use in reports.
void	setEllipsoid(Ellipsoid ellipsoid) Sets the ellipsoid.
void	setEllipsoidFromName(java.lang.String name) Sets the ellipsoid using its name.
void	setFalseNorthing(double value) Sets a projection parameter
void	setHemisphere(int hemisphere) Sets the hemisphere using the enumeration.
void	setHemisphere(java.lang.String hemisphere) Sets the hemisphere using a string north or south.
void	setUnits(int units) Sets the units with an enumeration.
void	setUnits(java.lang.String units) Sets the units with a String.
void	setXmlAttribute(java.lang.String tag, java.lang.String name, java.lang.String value) Sets one of the attributes of this object using a string value.
void	setZone(double zone) Sets the central meridian using a UTM zone number.
void	setZone(int zone) Sets the central meridian using a UTM zone number.
java.lang.String	toString() Displays the projection as a string.
java.lang.String	toWktString() Displays the projection parameters as a well known text string.
Point	unproject(Point point) Unprojects a projection position into geographic.

Methods inherited from class java.lang.Object

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

Field Detail

HEMISPHERE_NORTH

public static final int HEMISPHERE_NORTH

Northern hemisphere

See Also:

Constant Field Values

HEMISPHERE_SOUTH

public static final int HEMISPHERE_SOUTH

Southern hemisphere

See Also:

Constant Field Values

Constructor Detail

ProjectionUtm

public ProjectionUtm()

Creates a new instance

Method Detail

setXmlAttribute

public void setXmlAttribute(java.lang.String tag,
                            java.lang.String name,
                            java.lang.String value)

Sets one of the attributes of this object using a string value. This method should only be called from the SAX event handler.

Specified by:

setXmlAttribute in interface Projection

Parameters:

tag - The AXL element tag containing this attribute (not used).

name - The AXL attribute name.

value - The AXL attribute value.

setAlias

public void setAlias(java.lang.String alias)

Sets the alias for the projection for use in reports.

Parameters:

alias - The alternate name for this projection.

clone

public java.lang.Object clone()

Returns a separate copy of this object.

Specified by:

clone in interface Projection

Returns:

A copy of this object as an Object.

getCopy

public ProjectionUtm getCopy()

Returns a separate copy of this object.

Returns:

A copy of this object.

getAlias

public java.lang.String getAlias()

Return the alias of the projection

Specified by:

getAlias in interface Projection

Returns:

The alias of the projection.

getAlias

public java.lang.String getAlias(java.util.Locale locale)

Return the alias of the projection

Specified by:

getAlias in interface Projection

Parameters:

locale - The locale to format text and numbers.

Returns:

The alias of the projection.

getMapCenterString

public java.lang.String getMapCenterString(Point geoPoint,
                                           double scaleFactor,
                                           java.util.Locale locale)

Returns the map center coordinate text in the specified locale.

Specified by:

getMapCenterString in interface Projection

Parameters:

geoPoint - A geographic point.

scaleFactor - The current map scale factor for use in rounding results.

locale - The Locale to use for number display.

Returns:

The report string.

getName

public java.lang.String getName()

Return the name of the projection

Specified by:

getName in interface Projection

Returns:

The name of the projection.

getName

public java.lang.String getName(java.util.Locale locale)

Return the name of the projection

Specified by:

getName in interface Projection

Parameters:

locale - The locale to format text and numbers.

Returns:

The name of the projection.

project

public Point project(Point point)

Projects a geographic position into this projection. Note that this is a simple transformation without dataum shifts.

Specified by:

project in interface Projection

Parameters:

point - The geographic position.

Returns:

The projected position, or null if there is an error.

getReportString

public java.lang.String getReportString(Point geoPoint,
                                        double scaleFactor,
                                        java.util.Locale locale)

Returns the report for the standard identify reports.

Specified by:

getReportString in interface Projection

Parameters:

geoPoint - A geographic point.

scaleFactor - The current map scale factor for use in rounding results.

Returns:

The report string.

getSrs

public java.lang.String getSrs()

Return the spatial reference system code.

Specified by:

getSrs in interface Projection

Returns:

The spatial reference system code.

toString

public java.lang.String toString()

Displays the projection as a string.

Specified by:

toString in interface Projection

Returns:

The projection string.

toWktString

public java.lang.String toWktString()

Displays the projection parameters as a well known text string.

Specified by:

toWktString in interface Projection

Returns:

The projection's well known text.

getUnits

public int getUnits()

Return the map units of the projection.

Specified by:

getUnits in interface Projection

Returns:

The map units of the projection.

getUnitsString

public java.lang.String getUnitsString()

Return the map units of the projection as a string.

Specified by:

getUnitsString in interface Projection

Returns:

The map units of the projection as a string.

unproject

public Point unproject(Point point)

Unprojects a projection position into geographic. Note that this is a simple transformation without dataum shifts.

Specified by:

unproject in interface Projection

Parameters:

point - The projected position.

Returns:

The geographic position, or null if there is an error.

isGeographicCoordinateSystem

public boolean isGeographicCoordinateSystem()

Returns an indicator of whether this coordinate system is geographic.

Specified by:

isGeographicCoordinateSystem in interface Projection

Returns:

True if it is geographic and valid, otherwise false.

isProjectedCoordinateSystem

public boolean isProjectedCoordinateSystem()

Returns an indicator of whether this coordinate system is projected (non-geographic).

Specified by:

isProjectedCoordinateSystem in interface Projection

Returns:

True if it is projected and valid, otherwise false.

isValid

public boolean isValid()

Gets an indicator of whether the projection is valid.

Specified by:

isValid in interface Projection

Returns:

True if valid, otherwise false.

getCoordinateSystem

public CoordinateSystem getCoordinateSystem()

Method to compare projections.

Specified by:

getCoordinateSystem in interface Projection

Returns:

The geotools coordinate system backing this projection.

equals

public boolean equals(Projection anotherProjection)

Returns an indicator of whether this projection is the same as another.

Specified by:

equals in interface Projection

Parameters:

anotherProjection - The other projection.

Returns:

True if equal, otherwise false.

setFalseNorthing

public void setFalseNorthing(double value)

Sets a projection parameter

Parameters:

value - The projection parameter.

setEllipsoid

public void setEllipsoid(Ellipsoid ellipsoid)

Sets the ellipsoid.

Parameters:

ellipsoid - The ellipsoid for this projection.

setEllipsoidFromName

public void setEllipsoidFromName(java.lang.String name)

Sets the ellipsoid using its name.

Parameters:

name - The ellipsoid name.

setUnits

public void setUnits(int units)

Sets the units with an enumeration.

Parameters:

units - The units enumerations of type MeasureUnitsType.

setUnits

public void setUnits(java.lang.String units)

Sets the units with a String.

Parameters:

units - The units name, FEET, METERS, or METRES.

getProjectionType

public int getProjectionType()

Gets the projection type enumeration.

Returns:

The projection type enumeration.

setHemisphere

public void setHemisphere(int hemisphere)

Sets the hemisphere using the enumeration.

Parameters:

hemisphere - The hemisphere eumeration.

setHemisphere

public void setHemisphere(java.lang.String hemisphere)

Sets the hemisphere using a string north or south.

Parameters:

hemisphere - The hemisphere, north or south.

setZone

public void setZone(int zone)

Sets the central meridian using a UTM zone number.

Parameters:

zone - The UTM zone number.

setZone

public void setZone(double zone)

Sets the central meridian using a UTM zone number.

Parameters:

zone - The UTM zone number.

getZone

public double getZone()

Return the zone of the projection

Returns:

The zone of the projection.