AbstractProjection (JOSM)

java.lang.Object
- org.openstreetmap.josm.data.projection.AbstractProjection

All Implemented Interfaces:

Projection

Direct Known Subclasses:

CustomProjection
```
public abstract class AbstractProjection
extends java.lang.Object
implements Projection
```
Implementation of the Projection interface that represents a coordinate reference system and delegates the real projection and datum conversion to other classes. It handles false easting and northing, central meridian and general scale factor before calling the delegate projection. Forwards lat/lon values to the real projection in units of radians. The fields are named after Proj.4 parameters. Subclasses of AbstractProjection must set ellps and proj to a non-null value. In addition, either datum or nadgrid has to be initialized to some value.

Field Summary

Fields
Modifier and Type	Field and Description
`protected Datum`	`datum`
`protected Ellipsoid`	`ellps`
`protected double`	`k0`
`protected double`	`lon0`
`protected double`	`pm`
`protected Proj`	`proj`
`private ProjectionBounds`	`projectionBoundsBox`
`protected double`	`toMeter`
`protected double`	`x0`
`protected double`	`y0`

Constructor Summary

Constructors
Constructor and Description

AbstractProjection()

Constructors
Constructor and Description
`AbstractProjection()`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`protected static double`	`convertDegreeMinuteSecond(double degree, double minute, double second)`
`protected static double`	`convertMinuteSecond(double minute, double second)`
`LatLon`	`eastNorth2latlon(EastNorth en)` Convert from easting/norting to lat/lon.
`double`	`getCentralMeridian()`
`Datum`	`getDatum()`
`double`	`getDefaultZoomInPPD()` The default scale factor in east/north units per pixel (`NavigatableComponent.getState()`)).
`Ellipsoid`	`getEllipsoid()`
`abstract java.lang.Integer`	`getEpsgCode()`
`double`	`getFalseEasting()`
`double`	`getFalseNorthing()`
`Proj`	`getProj()` Replies the projection (in the narrow sense)
`double`	`getScaleFactor()`
`double`	`getToMeter()` Get the factor that converts meters to intended units of east/north coordinates.
`ProjectionBounds`	`getWorldBoundsBoxEastNorth()` Get an approximate EastNorth box around the lat/lon world bounds.
`EastNorth`	`latlon2eastNorth(LatLon ll)` Convert from lat/lon to easting/northing.
`java.lang.String`	`toCode()` Default implementation of toCode().

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.openstreetmap.josm.data.projection.Projection
getCacheDirectoryName, getLatLonBoundsBox, getMetersPerUnit, getWorldBoundsLatLon, switchXY, toString

- Field Detail
  - ellps
```
protected Ellipsoid ellps
```
  - datum
```
protected Datum datum
```
  - proj
```
protected Proj proj
```
  - x0
```
protected double x0
```
  - y0
```
protected double y0
```
  - lon0
```
protected double lon0
```
  - pm
```
protected double pm
```
  - k0
```
protected double k0
```
  - toMeter
```
protected double toMeter
```
  - projectionBoundsBox
```
private volatile ProjectionBounds projectionBoundsBox
```
- Constructor Detail
  - AbstractProjection
```
public AbstractProjection()
```
- Method Detail
  - getEllipsoid
```
public final Ellipsoid getEllipsoid()
```
  - getDatum
```
public final Datum getDatum()
```
  - getProj
```
public final Proj getProj()
```
    Replies the projection (in the narrow sense)
    
    Returns:
    
    The projection object
  - getFalseEasting
```
public final double getFalseEasting()
```
  - getFalseNorthing
```
public final double getFalseNorthing()
```
  - getCentralMeridian
```
public final double getCentralMeridian()
```
  - getScaleFactor
```
public final double getScaleFactor()
```
  - getToMeter
```
public final double getToMeter()
```
    Get the factor that converts meters to intended units of east/north coordinates. For projected coordinate systems, the semi-major axis of the ellipsoid is always given in meters, which means the preliminary projection result will be in meters as well. This factor is used to convert to the intended units of east/north coordinates (e.g. feet in the US). For geographic coordinate systems, the preliminary "projection" result will be in degrees, so there is no reason to convert anything and this factor will by 1 by default.
    
    Returns:
    
    factor that converts meters to intended units of east/north coordinates
  - latlon2eastNorth
```
public EastNorth latlon2eastNorth(LatLon ll)
```
    Description copied from interface: Projection
    
    Convert from lat/lon to easting/northing.
    
    Specified by:
    
    latlon2eastNorth in interface Projection
    
    Parameters:
    
    ll - the geographical point to convert (in WGS84 lat/lon)
    
    Returns:
    
    the corresponding east/north coordinates
  - eastNorth2latlon
```
public LatLon eastNorth2latlon(EastNorth en)
```
    Description copied from interface: Projection
    
    Convert from easting/norting to lat/lon.
    
    Specified by:
    
    eastNorth2latlon in interface Projection
    
    Parameters:
    
    en - the geographical point to convert (in projected coordinates)
    
    Returns:
    
    the corresponding lat/lon (WGS84)
  - getDefaultZoomInPPD
```
public double getDefaultZoomInPPD()
```
    Description copied from interface: Projection
    
    The default scale factor in east/north units per pixel (NavigatableComponent.getState())). FIXME: misnomer
    
    Specified by:
    
    getDefaultZoomInPPD in interface Projection
    
    Returns:
    
    the scale factor
  - getEpsgCode
```
public abstract java.lang.Integer getEpsgCode()
```
    Returns:
    
    The EPSG Code of this CRS, null if it doesn't have one.
  - toCode
```
public java.lang.String toCode()
```
    Default implementation of toCode(). Should be overridden, if there is no EPSG code for this CRS.
    
    Specified by:
    
    toCode in interface Projection
    
    Returns:
    
    the projection identifier
  - convertMinuteSecond
```
protected static final double convertMinuteSecond(double minute,
                                                  double second)
```
  - convertDegreeMinuteSecond
```
protected static final double convertDegreeMinuteSecond(double degree,
                                                        double minute,
                                                        double second)
```
  - getWorldBoundsBoxEastNorth
```
public final ProjectionBounds getWorldBoundsBoxEastNorth()
```
    Description copied from interface: Projection
    
    Get an approximate EastNorth box around the lat/lon world bounds. Note: The projection is only valid within the bounds returned by Projection.getWorldBoundsLatLon(). The lat/lon bounds need not be a rectangular shape in east/north space. This method returns a box that contains this shape.
    
    Specified by:
    
    getWorldBoundsBoxEastNorth in interface Projection
    
    Returns:
    
    EastNorth box around the lat/lon world bounds

Class AbstractProjection

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.openstreetmap.josm.data.projection.Projection

Field Detail

ellps

datum

proj

x0

y0

lon0

pm

k0

toMeter

projectionBoundsBox

Constructor Detail

AbstractProjection

Method Detail

getEllipsoid

getDatum

getProj

getFalseEasting

getFalseNorthing

getCentralMeridian

getScaleFactor

getToMeter

latlon2eastNorth

eastNorth2latlon

getDefaultZoomInPPD

getEpsgCode

toCode

convertMinuteSecond

convertDegreeMinuteSecond

getWorldBoundsBoxEastNorth