ilog.views.maps.srs.wkt

Class IlvWKTProjectionFactory

java.lang.Object

ilog.views.maps.srs.wkt.IlvWKTProjectionFactory

public class IlvWKTProjectionFactory
extends Object

The factory used to create projections from WKT names.
This factory is used by the IlvWKTCoordinateSystemFactory to instantiate a projection from a WKT string.

Since:

JViews 5.0

See Also:

IlvWKTCoordinateSystemFactory

Constructor Summary

Constructors

Constructor and Description
IlvWKTProjectionFactory() Creates a new projection factory.

Method Summary

Modifier and Type	Method and Description
IlvProjection	fromName(String name, IlvGeographicCoordinateSystem geocs, IlvLinearUnit lunit, Properties oparams) Returns the projection corresponding to the specified name.
String	toWKT(IlvProjection projection, boolean withParameters) Returns the WKT representation of the specified projection.
String	toWKT(IlvProjection projection, boolean withParameters, IlvLinearUnit lunit, IlvAngularUnit aunit) Returns the WKT representation of the specified projection.
String	wktName(IlvProjection projection, Properties params) Returns the WKT name of the specified projection, with its parameters set as properties, using meters and degrees.
String	wktName(IlvProjection projection, Properties params, IlvLinearUnit lunit, IlvAngularUnit aunit) Returns the WKT name of the specified projection, with its parameters set as properties, using the specified units.

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvWKTProjectionFactory

public IlvWKTProjectionFactory()

Creates a new projection factory.

Method Detail

fromName

public IlvProjection fromName(String name,
                              IlvGeographicCoordinateSystem geocs,
                              IlvLinearUnit lunit,
                              Properties oparams)
                       throws IlvProjectionException

Returns the projection corresponding to the specified name.
To create a projection, we also need the corresponding geographic coordinate system as defined in the WKT, to interpret the parameters of the projection (mainly for the units used when specifying parallels and meridians).
The linear unit is used to interpret false easting and false northing. This linear unit is not set to the projection (using IlvProjection.setUnit()), since unit conversion is performed by the transformation.

Parameters:

name - The name of the projection.

geocs - The geographic coordinate system for the projection.

lunit - The linear unit used in the projection.

oparams - The projection parameters.

Returns:

The projection or null if the projection is unknown.

Throws:

IlvProjectionException - If the projection could not be initialized.

wktName

public String wktName(IlvProjection projection,
                      Properties params)

Returns the WKT name of the specified projection, with its parameters set as properties, using meters and degrees.
The parameter params must be an empty Properties; each projection parameter is set as a property in this holder.

Parameters:

projection - The projection.

params - The projection parameters.

Returns:

the name of the projection in WKT format.

wktName

public String wktName(IlvProjection projection,
                      Properties params,
                      IlvLinearUnit lunit,
                      IlvAngularUnit aunit)

Returns the WKT name of the specified projection, with its parameters set as properties, using the specified units.
The parameter params must be an empty Properties; each projection parameter is set as a property in this holder.

Parameters:

projection - The projection.

params - The projection parameters.

lunit - Linear unit to use for projection parameters in the output string.

aunit - Angular unit of projection parameters in the output string.

Returns:

the name of the projection in WKT format.

Since:

JViews 7.5

toWKT

public String toWKT(IlvProjection projection,
                    boolean withParameters)

Returns the WKT representation of the specified projection.

Parameters:

projection - The projection.

withParameters - If true, the projection parameters are appended to the WKT representation of the projection. By default, projection parameters are saved in meters and degrees.

See Also:

toWKT(IlvProjection, boolean, IlvLinearUnit, IlvAngularUnit)

toWKT

public String toWKT(IlvProjection projection,
                    boolean withParameters,
                    IlvLinearUnit lunit,
                    IlvAngularUnit aunit)

Returns the WKT representation of the specified projection.

Parameters:

projection - The projection.

withParameters - If true, the projection parameters are appended to the WKT representation of the projection.

lunit - Linear unit to use for projection parameters in the output string.

aunit - Angular unit of projection parameters in the output string.

Returns:

the WKT representation of the specified projection.

Since:

JViews 7.5