interface IMapProjectionFactory in Tinman.Terrain.Mapping

Base interface for classes that create IMapProjection objects.

interface	IMapProjectionFactory	extends	IConfigurable
		base of	MapProjectionFactory

Methods

CreateMapProjection

Creates a new instance of IMapProjection.

method	CreateMapProjection (MapInfo source, MapInfo target, bool reverse = false, bool clip = false)
type	IMapProjection
params	source		The source raster space.
	target		The target raster space.
	reverse		true to create a reverse map projection (i.e. one that transforms from target to source, false to create a normal map projection. Defaults to false.
	clip		Clip bad geographic coordinates (see GeographicClip)? Defaults to false.
returns		[not-null]	The map projection.

Remarks:

When a map projection factory transforms between map types (i.e. Rect to Cube or vice-versa), the source and target raster spaces can be swapped in order to create a reverse map projection (see Reverse). If the source and target map types are equal, an implementation cannot determine whether a reverse map projection is requested or not. In this case, the reverse parameter must be used.

Exceptions:

• TinmanException:
  If the given source and target rasters do not correlate to this map projection factory.

ToConfig

Returns the configuration value that describes this object.

method	ToConfig ()
type	ConfigValue
returns		[not-null]	The configuration value.
inherited	IConfigurable.ToConfig

Remarks:

All configurable objects need to implement this interface. For simple types, it is preferable to delegate to ToValue.

The returned value may be of type Invalid, which means that this object in its current state cannot be described with the configuration API.

Before returning the resulting configuration value, Cache must be called on it, passing this IConfigurable object as parameter.