ilog.views.maps.srs.coordtrans
Class IlvProjectionTransform

java.lang.Object
  ilog.views.maps.srs.coordtrans.IlvProjectionTransform

All Implemented Interfaces:

IlvPersistentObject, IlvMathTransform

public class IlvProjectionTransform
extends Object
implements IlvMathTransform, IlvPersistentObject

The transformation to transform ellipsoidal coordinates to and from projected cartographic coordinate systems.
This class encapsulates an IlvProjection into an IlvMathTransform.
This transformation transforms from 2 dimension coordinates (longitude, latitude) to 2 dimension coordinates (easting, northing). The input coordinates are expressed in radians, whereas the resulting coordinates are expressed in the unit of the transformation.

Since:

JViews 5.0

See Also:

IlvProjection

Constructor Summary

IlvProjectionTransform(IlvInputStream stream)
Reads a GeocentricEllipsoidal from the specified input stream.

IlvProjectionTransform(IlvProjectedCoordinateSystem pcs)
Constructs a new transformation to transform from ellipsoidal coordinate system to the specified projected coordinate system.

Method Summary

IlvMathTransform	getInverse() Returns the inverse transformation.
int	getSourceDimension() Returns the dimension of source coordinates.
int	getTargetDimension() Returns the dimension of target coordinates.
boolean	isIdentity() Returns true if this transformation is an identity,
IlvCoordinate[]	transform(IlvCoordinate[] sourceCP, IlvCoordinate[] result) Transforms the specified array of coordinate points, and puts the resulting coordinates in result.
IlvCoordinate	transform(IlvCoordinate sourceCP, IlvCoordinate result) Transforms the specified source coordinate point, and puts the result coordinate in result.
void	write(IlvOutputStream stream) Writes this transformation to the specified output file.

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvProjectionTransform

public IlvProjectionTransform(IlvProjectedCoordinateSystem pcs)

Constructs a new transformation to transform from ellipsoidal coordinate system to the specified projected coordinate system.

Parameters:

pcs - The IlvProjectedCoordinateSystem describing the projected coordinate system.

IlvProjectionTransform

public IlvProjectionTransform(IlvInputStream stream)
                       throws IlvReadFileException

Reads a GeocentricEllipsoidal from the specified input stream.

Parameters:

stream - The IlvInputStream.

Throws:

IlvReadFileException - If a transformation cannot be read from the input stream.

Method Detail

write

public void write(IlvOutputStream stream)
           throws IOException

Writes this transformation to the specified output file.

Specified by:

write in interface IlvPersistentObject

Parameters:

stream - The IlvOutputStream.

Throws:

IOException - If an error occurs.

getInverse

public IlvMathTransform getInverse()

Returns the inverse transformation.

Specified by:

getInverse in interface IlvMathTransform

Returns:

The inverse transformation or null if no inverse transformation is defined.

transform

public IlvCoordinate transform(IlvCoordinate sourceCP,
                               IlvCoordinate result)
                        throws IlvCoordinateTransformationException

Transforms the specified source coordinate point, and puts the result coordinate in result. If result is null, a new coordinate is allocated and then returned.

Specified by:

transform in interface IlvMathTransform

Throws:

IlvToleranceConditionException - If the coordinate to transform is not within the limits of the projection.

IlvUnsupportedProjectionFeature - If the transformation leads to an operation that is not supported by the projection.

IlvCoordinateTransformationException

transform

public IlvCoordinate[] transform(IlvCoordinate[] sourceCP,
                                 IlvCoordinate[] result)
                          throws IlvCoordinateTransformationException

Transforms the specified array of coordinate points, and puts the resulting coordinates in result. If result is null, a new array of coordinate is allocated.

Specified by:

transform in interface IlvMathTransform

Throws:

IlvToleranceConditionException - If the coordinates to transform is not within the limits of the projection.

IlvUnsupportedProjectionFeature - If the transformation leads to an operation that is not supported by the projection.

IlvCoordinateTransformationException

getSourceDimension

public int getSourceDimension()

Returns the dimension of source coordinates.

Specified by:

getSourceDimension in interface IlvMathTransform

Returns:

2 (this transformation only processes 2D coordinates).

getTargetDimension

public int getTargetDimension()

Returns the dimension of target coordinates.

Specified by:

getTargetDimension in interface IlvMathTransform

Returns:

2 (this transformation only processes 2D coordinates).

isIdentity

public boolean isIdentity()

Returns true if this transformation is an identity,

Specified by:

isIdentity in interface IlvMathTransform

Returns:

true if this transformation is an identity.