ilog.views.maps.srs.coordtrans

Class IlvCoordinateTransformation

java.lang.Object

ilog.views.maps.srs.coordtrans.IlvCoordinateTransformation

All Implemented Interfaces:

IlvPersistentObject, Serializable

public class IlvCoordinateTransformation
extends Object
implements IlvPersistentObject

Describes a coordinate transformation.

Since:

JViews 5.0

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IlvCoordinateTransformation(IlvCoordinateSystem sourceCS, IlvCoordinateSystem targetCS) Constructor.
	IlvCoordinateTransformation(IlvCoordinateSystem sourceCS, IlvCoordinateSystem targetCS, IlvMathTransform transform) Constructor.
	IlvCoordinateTransformation(IlvInputStream stream) Reads an IlvCoordinateTransformation from the specified input stream.

Method Summary

Modifier and Type	Method and Description
static IlvCoordinateTransformation	CreateTransformation(IlvCoordinateSystem sourceCS, IlvCoordinateSystem targetCS) Returns a coordinate transformation to convert coordinates from one coordinate system to another.
IlvCoordinateTransformation	getInverse() Returns an inverse transformation for this coordinate transformation.
IlvCoordinateSystem	getSourceCS() Returns the source coordinate system for this transformation.
IlvCoordinateSystem	getTargetCS() Returns the destination coordinate system for this transformation.
IlvMathTransform	getTransform() Returns the transformation associated to this transformation.
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 IlvCoordinateTransformation 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

IlvCoordinateTransformation

public IlvCoordinateTransformation(IlvCoordinateSystem sourceCS,
                                   IlvCoordinateSystem targetCS,
                                   IlvMathTransform transform)

Constructor.

IlvCoordinateTransformation

protected IlvCoordinateTransformation(IlvCoordinateSystem sourceCS,
                                      IlvCoordinateSystem targetCS)

Constructor.

IlvCoordinateTransformation

public IlvCoordinateTransformation(IlvInputStream stream)
                            throws IlvReadFileException

Reads an IlvCoordinateTransformation 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 IlvCoordinateTransformation to the specified output file.

Specified by:

write in interface IlvPersistentObject

Parameters:

stream - The IlvOutputStream.

Throws:

IOException - If an error occurs.

getSourceCS

public IlvCoordinateSystem getSourceCS()

Returns the source coordinate system for this transformation.

getTargetCS

public IlvCoordinateSystem getTargetCS()

Returns the destination coordinate system for this transformation.

getTransform

public IlvMathTransform getTransform()

Returns the transformation associated to this transformation.

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.

Throws:

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.

Throws:

IlvCoordinateTransformationException

getInverse

public IlvCoordinateTransformation getInverse()

Returns an inverse transformation for this coordinate transformation.

CreateTransformation

public static IlvCoordinateTransformation CreateTransformation(IlvCoordinateSystem sourceCS,
                                                               IlvCoordinateSystem targetCS)

Returns a coordinate transformation to convert coordinates from one coordinate system to another.
The returned coordinate transformation owns an IlvMathTransform that is created using the following rules:

Source system ® Target system ¯	Geocentric	Geographic	Projected
Geocentric	Affine transform made from: Unit conversion to kernel units Axis translation to WGS84 Axis translation from WGS84 to target datum Unit conversion from kernel units	GeocentricEllipsoidal	Geocentric to geographic geographic to projected
Geographic	EllipsoidalGeocentric	AbridgedMolodenski	Geographic to geographic geographic to projected
Projected	Projected to geographic geographic to geocentric	Projected to geographic geographic to geographic	Projected to geographic Geographic to geographic Geographic to Projected