Luciad.Maps.Map.ViewMapTransformation Class Reference

This class allows to transform between view (pixel coordinates on the screen) and map coordinates. More...

Inheritance diagram for Luciad.Maps.Map.ViewMapTransformation:

Public Member Functions
void	Dispose ()
Luciad.Cartesian.? Coordinate	MapToView (Luciad.Geometries.Point point)
	Transform a point from the world reference to a coordinate in the view space.
Luciad.Geometries.Point	ViewToMap (Luciad.Maps.Map.LocationMode locationMode, Luciad.Cartesian.Coordinate coordinate)
	Transform a coordinate from the view to a point in the world reference using the desired location mode.

Detailed Description

This class allows to transform between view (pixel coordinates on the screen) and map coordinates.

Unlike Camera, it takes into account what is visible on the screen. When transforming a point from view to map coordinates, this method will select the nearest visible surface. When transforming a point from map to view coordinates, it will take into account the visibility of that map point.

Member Function Documentation

Dispose()

void Luciad.Maps.Map.ViewMapTransformation.Dispose ( )

inline

MapToView()

Luciad.Cartesian.? Coordinate Luciad.Maps.Map.ViewMapTransformation.MapToView ( Luciad.Geometries.Point point )

inline

Transform a point from the world reference to a coordinate in the view space.

If the point cannot be represented on the view, a null is returned. This happens for example when the given world point lies behind the camera.

Note: this method does not take into account whether a point is hidden by something else on the screen. It can for example transform point on the back of the globe to view coordinates.

Parameters

point

the point in the map space.

Returns

the coordinate in the view space (device independent pixels), or null.

Exceptions

System.ArgumentException

when the point is not defined in the map reference.

ViewToMap()

Luciad.Geometries.Point Luciad.Maps.Map.ViewMapTransformation.ViewToMap ( Luciad.Maps.Map.LocationMode locationMode, Luciad.Cartesian.Coordinate coordinate )

inline

Transform a coordinate from the view to a point in the world reference using the desired location mode.

Parameters

locationMode	the desired location mode.
coordinate	the point in the view space (device independent pixels)

Returns

the point on the Map, or null when the given view point does not correspond to a point on the Map.

See also

LocationMode