RasterTransform

Description

abstract class Tinman.Terrain.Georef.RasterTransform

Derived from: SerializableBase ^abstract
IRasterTransform
Extended by: RasterTransformMatrix ^sealed

Abstract base class for IRasterTransform implementations.

Public / Constants

Identity

public static readonly attribute Identity → (IRasterTransform)

The identity raster transform.

Public / Constructors

Barycentric

public static method Barycentric → (6)

rasterA ⁱⁿ : Vec2D: First tie-point, in raster space.
mapA ⁱⁿ : Vec2D: First tie-point, in map space.
rasterB ⁱⁿ : Vec2D: Second tie-point, in raster space.
mapB ⁱⁿ : Vec2D: Second tie-point, in map space.
rasterC ⁱⁿ : Vec2D: Third tie-point, in raster space.
mapC ⁱⁿ : Vec2D: Third tie-point, in map space.
returns → IRasterTransform: The created IRasterTransform object.

Creates a new instance of IRasterTransform that ties a triangle in map space to a triangle in rectangular raster space using barycentric coordinates.

Cube

public static method Cube → (2)

size ^opt : int32 = MappingUtil.MaxSize: [pow2]
The cubemap size (edge length, not sample count), see IRasterTransform.Size.
unit ^opt : UnitOfMeasure = null: The geographic unit. If null, UnitOfMeasure.Degree will be used.
returns → IRasterTransform: The created IRasterTransform object.

Creates a new instance of RasterTransform that interprets input raster coordinates as cubemap coordinates and converts them to output map coordinates as geographic coordinates in the given unit.

Rectangle

public static method Rectangle → (8)

mapX1 ⁱⁿ : float64: The map coordinate that corresponds to rasterX ^opt.
mapY1 ⁱⁿ : float64: The map coordinate that corresponds to rasterY ^opt.
mapX2 ⁱⁿ : float64: The map coordinate that corresponds to rasterX ^opt + rasterWidth ^opt.
mapY2 ⁱⁿ : float64: The map coordinate that corresponds to rasterY ^opt + rasterHeight ^opt.
rasterWidth ^opt : int32 = MappingUtil.MaxSize: [>0]
The raster width.
rasterHeight ^opt : int32 = 0: [>=0]
The raster height. If 0, rasterWidth ^opt will be used.
rasterX ^opt : int32 = 0: The raster X-coordinate that corresponds to mapX1 ⁱⁿ.
rasterY ^opt : int32 = 0: The raster Y-coordinate that corresponds to mapY1 ⁱⁿ.
returns → IRasterTransform: The created IRasterTransform object.

Creates a new instance of RasterTransform that maps the given raster rectangle to map bounds.

See also: RasterTransform.TiepointScale

TiepointScale

public static method TiepointScale → (3)

raster ⁱⁿ : Vec2D: The raster point coordinates.
map ⁱⁿ : Vec2D: The map point coordinates.
scale ⁱⁿ : Vec2D: Scale factors per axis, from raster coordinates to map coordinates.
returns → IRasterTransform: The created IRasterTransform object.

Creates a new instance of IRasterTransform that ties the given map point to the specified rectangular raster point.

The following formulas describe the transformation between map coordinates and raster coordinates:

a.X = (b.X - raster.X) * scale.X + map.X
a.Y = (b.Y - raster.Y) * scale.Y + map.Y
b.X = (a.X - map.X) / scale.X + raster.X
b.Y = (a.Y - map.Y) / scale.Y + raster.Y

where a represents the map coordinates of a point and b represents its raster coordinates.

Transform

public static method Transform → (6)

a ⁱⁿ : float64: Transformation matrix component.
b ⁱⁿ : float64: Transformation matrix component.
d ⁱⁿ : float64: Transformation matrix component.
e ⁱⁿ : float64: Transformation matrix component.
f ⁱⁿ : float64: Transformation matrix component.
h ⁱⁿ : float64: Transformation matrix component.
returns → IRasterTransform: The created IRasterTransform object.

Creates a new instance of IRasterTransform that uses an affine transformation from rectangular raster space to map space.

The following matrix will be used to transform raster space to map space:

/   \     /            \  /   \
| E |     | a  b  0  d |  | X |
| N |  =  | e  f  0  h |  | Y |
| 0 |     | 0  0  1  0 |  | 0 |
| 1 |     | 0  0  0  1 |  | 1 |
\   /     \            /  \   /

X := Raster X-coordinate
Y := Raster Y-coordinate
E := Map easting coordinate
N := Map northing coordinate

The given matrix must be invertible, so a*f - e*b must not be zero.

Protected / Constructors