interface IMapShapes in Tinman.Terrain.Mapping

Base interface for maps that perform on-the-fly rasterization of vector shapes.

interface	IMapShapes	with	<TShape>	as	class, IMapShape
		extends	IGeorefInfo
		base of	IHeightmapShape
			IPixelPyramidShape

Remarks

A map shape consists of a vector shape (i.e. an IShape object) and additional information concerning rasterization. When adding a map shape, it will be transformed to the georeferenced raster of this object (see Georef). This is done as follows:

• Raster is a cubemap (see IsCubemap):
  The vector shape is transformation with TransformCubemap.
• Raster is rectangular:
  First, the vector shape is transformed to the coordinate system of the raster (see TransformCoordinateSystem). Then, the vector shape is transformed to the raster space (see TransformCoordinates). If the raster transform (see Transform) is not affine (see Matrix), it will be skipped silently.

Attributes

Georef

Returns georeferencing information.

property	Georef { get }
type	Raster
value		The georeferencing object or null if no georeferencing is available.
inherited	IGeorefInfo.Georef

Map

Returns a MapInfo value that describes the used map raster.

property	Map { get }
type	MapInfo
value		The map info value.
inherited	IMapInfo.Map

ShapeAccuracy

The accuracy to use for edge subdivision when transforming shapes in ShapeAdd resp. ShapePrepare.

property	ShapeAccuracy { get set }
type	float64
value	[>=0]	The maximum allowed error, specified in the coordinate system of this map (see Coordinates).

Remarks:

Set to 0 to disable edge subdivision. Defaults to 0.

Shapes

The map shapes.

property	Shapes { get }
type	IVectorConst<TShape>
value	[not-null]	The list of map shapes (as returned by ShapeAdd).

Methods

ShapeAdd

Adds a map shape.

method	ShapeAdd (TShape shape)
type	TShape
params	shape	[not-null]	The map shape to add.
returns			The added map shape or null if empty (after preparation).

Remarks:

It may be necessary to perform some preparation on the given shape before it can be used by this map object. The ShapePrepare method can be used to prepare shapes in the background to avoid lengthy computations here.

ShapePrepare

Prepares the given map shape for being used by this object.

[ThreadSafe]
method	ShapePrepare (TShape shape)
type	TShape
params	shape	[not-null]	The map shape to prepare.
returns			The prepared map shape or null if empty.

ShapeRemove

Removes a map shape.

method	ShapeRemove (TShape shape)
params	shape	[not-null]	The map shape to remove (as returned by ShapeAdd resp. ShapePrepare.