CoordinateTransformation

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.partnersoft.geometry.projection
Class CoordinateTransformation

java.lang.Object
  com.partnersoft.geometry.projection.CoordinateTransformation

All Implemented Interfaces:: Coggable

public class CoordinateTransformation
extends java.lang.Object
implements Coggable
extends java.lang.Object
implements Coggable

Handles transformation of coordinates from one system to another. Both reverse and forward projection are provided, along with input and output scaling and offsets. This allows a variety of transformations, including but not limited to:

feet to meters
meters to feet
state plane feet to latlong
latlong to state plane feet
utm to state plane via latlong

For truly weird transformations, write a special implementation of Projection. The order of application is:

addition of inputOffset
multiplication by inputScale
reverse projection using reverseProjection
forward projection using projection
multiplication by outputScale
addition of outputOffset

Notice that this means the offsets are always in the correct units of either the input coordinate system or output coordinate system. Also note that, in general, projections are done in meters, which must be converted from feet (or inches, or furlongs, or whatever). If either projection is empty or blank, nothing is done for those stages. Zero inputScale or outputScale is interpreted as 1 (no change) rather than actual zero (which would simply zero out any input). The algorithm is optimized to do nothing for the default case of no scaling, projection, or offset, and you can check the isIdentity() property to see if it is such a case and avoid passing points to it at all.

Version:: $Id: CoordinateTransformation.java 2046 2009-08-25 05:28:53Z paul $
Author:: Paul Reavis

Constructor Summary
`CoordinateTransformation()`

Method Summary
`void`	`CoordinateTransform(Cog state)`
`double`	`getInputOffsetX()`
`double`	`getInputOffsetY()`
`double`	`getInputScaleX()`
`double`	`getInputScaleY()`
`double`	`getOutputOffsetX()`
`double`	`getOutputOffsetY()`
`double`	`getOutputScaleX()`
`double`	`getOutputScaleY()`
`java.lang.String`	`getProjectionName()`
`java.lang.String`	`getReverseProjectionName()`
`boolean`	`isIdentity()`
`void`	`setInputOffsetX(double d)`
`void`	`setInputOffsetY(double d)`
`void`	`setInputScaleX(double d)`
`void`	`setInputScaleY(double d)`
`void`	`setOutputOffsetX(double d)`
`void`	`setOutputOffsetY(double d)`
`void`	`setOutputScaleX(double d)`
`void`	`setOutputScaleY(double d)`
`Cog`	`toCog()` Returns the complete internal state of this object in the form of a `Cog`.
`void`	`transform(DoubleBuffer coords)` Modifies the given DoubleBuffer, treating it as a list of x, y pairs.
`Point`	`transform(double x, double y)`
`void`	`transform(Point point)` Modifies the coordinates of the input Point.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail