using System;
#if WPF
using System.Windows;
using System.Windows.Media;
#elif AVALONIA
using Avalonia;
#endif
namespace MapControl
{
///
/// Implements a map projection, a transformation between geographic coordinates,
/// i.e. latitude and longitude in degrees, and cartesian map coordinates in meters.
///
#if UWP || WINUI
[Windows.Foundation.Metadata.CreateFromString(MethodName = "Parse")]
#else
[System.ComponentModel.TypeConverter(typeof(MapProjectionConverter))]
#endif
public abstract class MapProjection
{
public const double Wgs84EquatorialRadius = 6378137d;
public const double Wgs84Flattening = 1d / 298.257223563;
public const double Wgs84MeterPerDegree = Wgs84EquatorialRadius * Math.PI / 180d;
public static MapProjectionFactory Factory
{
get => field ??= new MapProjectionFactory();
set;
}
///
/// Creates a MapProjection instance from a CRS identifier string.
///
public static MapProjection Parse(string crsId)
{
return Factory.GetProjection(crsId);
}
///
/// Gets the WMS 1.3.0 CRS identifier.
///
public string CrsId { get; protected set; } = "";
///
/// Indicates whether the projection is normal cylindrical, see
/// https://en.wikipedia.org/wiki/Map_projection#Normal_cylindrical.
///
public bool IsNormalCylindrical { get; protected set; }
///
/// The earth ellipsoid semi-major axis, or spherical earth radius respectively, in meters.
///
public double EquatorialRadius { get; set; } = Wgs84EquatorialRadius;
///
/// Gets the relative transform at the specified geographic coordinates.
/// The returned Matrix represents the local relative scale and rotation.
///
public abstract Matrix RelativeTransform(double latitude, double longitude);
///
/// Transforms geographic coordinates to a Point in projected map coordinates.
///
public abstract Point LocationToMap(double latitude, double longitude);
///
/// Transforms projected map coordinates to a Location in geographic coordinates.
///
public abstract Location MapToLocation(double x, double y);
///
/// Gets the grid convergence angle in degrees at the specified projected map coordinates.
/// Used for rotating the Rect resulting from BoundingBoxToMap in non-normal-cylindrical
/// projections, i.e. Transverse Mercator and Polar Stereographic.
///
public virtual double GridConvergence(double x, double y) => 0d;
///
/// Gets the relative transform at the specified geographic Location.
///
public Matrix RelativeTransform(Location location) => RelativeTransform(location.Latitude, location.Longitude);
///
/// Transforms a Location in geographic coordinates to a Point in projected map coordinates.
///
public Point LocationToMap(Location location) => LocationToMap(location.Latitude, location.Longitude);
///
/// Transforms a Point in projected map coordinates to a Location in geographic coordinates.
///
public Location MapToLocation(Point point) => MapToLocation(point.X, point.Y);
///
/// Transforms a BoundingBox in geographic coordinates to a Rect in projected map coordinates
/// with an optional rotation angle in degrees for non-normal-cylindrical projections.
///
public (Rect, double) BoundingBoxToMap(BoundingBox boundingBox)
{
Rect rect;
var rotation = 0d;
var southWest = LocationToMap(boundingBox.South, boundingBox.West);
var northEast = LocationToMap(boundingBox.North, boundingBox.East);
if (IsNormalCylindrical)
{
rect = new Rect(southWest.X, southWest.Y, northEast.X - southWest.X, northEast.Y - southWest.Y);
}
else
{
var southEast = LocationToMap(boundingBox.South, boundingBox.East);
var northWest = LocationToMap(boundingBox.North, boundingBox.West);
var south = new Point((southWest.X + southEast.X) / 2d, (southWest.Y + southEast.Y) / 2d);
var north = new Point((northWest.X + northEast.X) / 2d, (northWest.Y + northEast.Y) / 2d);
var centerX = (south.X + north.X) / 2d;
var centerY = (south.Y + north.Y) / 2d;
var dx = north.X - south.X;
var dy = north.Y - south.Y;
var dxS = southEast.X - southWest.X;
var dyS = southEast.Y - southWest.Y;
var dxN = northEast.X - northWest.X;
var dyN = northEast.Y - northWest.Y;
var width = (Math.Sqrt(dxS * dxS + dyS * dyS) + Math.Sqrt(dxN * dxN + dyN * dyN)) / 2d;
var height = Math.Sqrt(dx * dx + dy * dy);
rect = new Rect(centerX - width / 2d, centerY - height / 2d, width, height);
rotation = -GridConvergence(centerX, centerY); // invert direction for RotateTransform
}
return (rect, rotation);
}
public override string ToString()
{
return CrsId;
}
}
}