All Implemented Interfaces:

org.osmdroid.api.IProjection
```
public class Projection
 implements IProjection
                    
```
A Projection serves to translate between the coordinate system of x/y on-screen pixel coordinates and that of latitude/longitude points on the surface of the earth. You obtain a Projection from MapView.getProjection(). You should not hold on to this object for more than one draw, since the projection of the map could change. Uses the web mercator projection Note: This class will "wrap" all pixel and lat/long values that overflow their bounds (rather than clamping to their bounds).

Field Summary

Fields
Modifier and Type	Field	Description
`public final static double`	`mProjectedMapSize`

Constructor Summary

Constructors
Constructor	Description
`Projection(double pZoomLevel, Rect pScreenRect, GeoPoint pCenter, long pScrollX, long pScrollY, float pOrientation, boolean pHorizontalWrapEnabled, boolean pVerticalWrapEnabled, TileSystem pTileSystem, int pMapCenterOffsetX, int pMapCenterOffsetY)`
`Projection(double pZoomLevel, int pWidth, int pHeight, GeoPoint pCenter, float pOrientation, boolean pHorizontalWrapEnabled, boolean pVerticalWrapEnabled, int pMapCenterOffsetX, int pMapCenterOffsetY)`

Method Summary

Modifier and Type	Method	Description
`Projection`	`getOffspring(double pZoomLevel, Rect pScreenRect)`
`double`	`getZoomLevel()`
`BoundingBox`	`getBoundingBox()`
`Rect`	`getScreenRect()`
`Rect`	`getIntrinsicScreenRect()`
`IGeoPoint`	`fromPixels(int x, int y)`	Create a new GeoPoint from pixel coordinates relative to the top-left of the MapView thatprovided this PixelConverter.
`IGeoPoint`	`fromPixels(int pPixelX, int pPixelY, GeoPoint pReuse)`	note: if setHorizontalMapRepetitionEnabled or setVerticalMapRepetitionEnabled is false, then thiscan return values that beyond the max extents of the world.
`IGeoPoint`	`fromPixels(int pPixelX, int pPixelY, GeoPoint pReuse, boolean forceWrap)`	* note: if setHorizontalMapRepetitionEnabled or setVerticalMapRepetitionEnabled is false, then thiscan return values that beyond the max extents of the world.
`Point`	`toPixels(IGeoPoint in, Point reuse)`	Converts the given IGeoPoint to onscreen pixel coordinates, relative to the top-leftof the org.osmdroid.views.MapView that provided this Projection.
`Point`	`toPixels(IGeoPoint in, Point reuse, boolean forceWrap)`
`long`	`getLongPixelXFromLongitude(double pLongitude, boolean forceWrap)`
`long`	`getLongPixelXFromLongitude(double pLongitude)`
`long`	`getLongPixelYFromLatitude(double pLatitude, boolean forceWrap)`
`long`	`getLongPixelYFromLatitude(double pLatitude)`
`PointL`	`toProjectedPixels(GeoPoint geoPoint, PointL reuse)`	A wrapper for toProjectedPixels
`PointL`	`toProjectedPixels(long latituteE6, long longitudeE6, PointL reuse)`	Performs only the first computationally heavy part of the projection.
`PointL`	`toProjectedPixels(double latitude, double longitude, PointL reuse)`	Performs only the first computationally heavy part of the projection.
`PointL`	`toProjectedPixels(double latitude, double longitude, boolean pWrapEnabled, PointL reuse)`
`Point`	`toPixelsFromProjected(PointL in, Point reuse)`	Performs the second computationally light part of the projection.
`Point`	`toPixelsFromMercator(long pMercatorX, long pMercatorY, Point reuse)`
`PointL`	`toMercatorPixels(int pPixelX, int pPixelY, PointL reuse)`
`float`	`metersToEquatorPixels(float meters)`	Converts a distance in meters (along the equator) to one in (horizontal) pixels at thecurrent zoomlevel.
`float`	`metersToPixels(float meters)`	Converts a distance in meters to one in (horizontal) pixels at the current zoomlevel and atthe current latitude at the center of the screen.
`float`	`metersToPixels(float meters, double latitude, double zoomLevel)`
`IGeoPoint`	`getNorthEast()`	Get the coordinates of the most north-easterly visible point of the map.
`IGeoPoint`	`getSouthWest()`	Get the coordinates of the most south-westerly visible point of the map.
`Matrix`	`getInvertedScaleRotateCanvasMatrix()`	This will provide a Matrix that will revert the current map's scaling and rotation.
`Point`	`unrotateAndScalePoint(int x, int y, Point reuse)`	This will revert the current map's scaling and rotation for a point.
`Point`	`rotateAndScalePoint(int x, int y, Point reuse)`	This will apply the current map's scaling and rotation for a point.
`void`	`detach()`
`Rect`	`getPixelFromTile(int pTileX, int pTileY, Rect pReuse)`
`long`	`getMercatorFromTile(int pTile)`
`Matrix`	`getScaleRotateCanvasMatrix()`	This will provide a Matrix that will revert the current map's scaling and rotation.
`double`	`getProjectedPowerDifference()`
`Point`	`getPixelsFromProjected(PointL in, double powerDifference, Point reuse)`
`PointL`	`getLongPixelsFromProjected(PointL in, double powerDifference, boolean pCloser, PointL reuse)`
`int`	`getTileFromMercator(long pMercator)`
`RectL`	`getMercatorViewPort(RectL pReuse)`
`int`	`getScreenCenterX()`
`int`	`getScreenCenterY()`
`long`	`getMercatorXFromPixel(int pPixelX)`
`long`	`getMercatorYFromPixel(int pPixelY)`
`long`	`getCleanMercator(long pMercator, boolean wrapEnabled)`
`GeoPoint`	`getCurrentCenter()`
`long`	`getOffsetX()`
`long`	`getOffsetY()`
`void`	`save(Canvas pCanvas, boolean pMapRotation, boolean pForce)`
`void`	`restore(Canvas pCanvas, boolean pForce)`
`void`	`adjustOffsets(IGeoPoint pGeoPoint, PointF pPixel)`	Adjust the offsets so that this geo point projects into that pixel
`void`	`adjustOffsets(BoundingBox pBoundingBox)`	Adjust the offsets so thateither this bounding box is bigger than the screen and contains itor it is smaller and it is centered
`static long`	`getScrollableOffset(long pPixelMin, long pPixelMax, double pWorldSize, int pScreenSize, int pExtraSize)`
`boolean`	`isHorizontalWrapEnabled()`
`boolean`	`isVerticalWrapEnabled()`
`float`	`getOrientation()`
`int`	`getWidth()`
`int`	`getHeight()`
`double`	`getWorldMapSize()`

Methods inherited from class org.osmdroid.api.IProjection
metersToEquatorPixels, toPixels
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Projection
```
Projection(double pZoomLevel, Rect pScreenRect, GeoPoint pCenter, long pScrollX, long pScrollY, float pOrientation, boolean pHorizontalWrapEnabled, boolean pVerticalWrapEnabled, TileSystem pTileSystem, int pMapCenterOffsetX, int pMapCenterOffsetY)
```
  - Projection
```
Projection(double pZoomLevel, int pWidth, int pHeight, GeoPoint pCenter, float pOrientation, boolean pHorizontalWrapEnabled, boolean pVerticalWrapEnabled, int pMapCenterOffsetX, int pMapCenterOffsetY)
```
- Method Detail
  - getOffspring
```
 Projection getOffspring(double pZoomLevel, Rect pScreenRect)
```
  - getZoomLevel
```
 double getZoomLevel()
```
  - getBoundingBox
```
 BoundingBox getBoundingBox()
```
  - getScreenRect
```
 Rect getScreenRect()
```
  - getIntrinsicScreenRect
```
 Rect getIntrinsicScreenRect()
```
  - fromPixels
```
 IGeoPoint fromPixels(int x, int y)
```
    Create a new GeoPoint from pixel coordinates relative to the top-left of the MapView thatprovided this PixelConverter.
  - fromPixels
```
 IGeoPoint fromPixels(int pPixelX, int pPixelY, GeoPoint pReuse)
```
    note: if setHorizontalMapRepetitionEnabled or setVerticalMapRepetitionEnabled is false, then thiscan return values that beyond the max extents of the world. This may or may not bedesired. https://github.com/osmdroid/osmdroid/pull/722for more information and the discussion associated with this.
  - fromPixels
```
 IGeoPoint fromPixels(int pPixelX, int pPixelY, GeoPoint pReuse, boolean forceWrap)
```
    * note: if setHorizontalMapRepetitionEnabled or setVerticalMapRepetitionEnabled is false, then thiscan return values that beyond the max extents of the world. This may or may not bedesired. https://github.com/osmdroid/osmdroid/pull/722for more information and the discussion associated with this.
  - toPixels
```
 Point toPixels(IGeoPoint in, Point reuse)
```
    Converts the given IGeoPoint to onscreen pixel coordinates, relative to the top-leftof the org.osmdroid.views.MapView that provided this Projection.
    
    Parameters:
    
    in - The latitude/longitude pair to convert.
  - toPixels
```
 Point toPixels(IGeoPoint in, Point reuse, boolean forceWrap)
```
  - getLongPixelXFromLongitude
```
 long getLongPixelXFromLongitude(double pLongitude, boolean forceWrap)
```
  - getLongPixelXFromLongitude
```
 long getLongPixelXFromLongitude(double pLongitude)
```
  - getLongPixelYFromLatitude
```
 long getLongPixelYFromLatitude(double pLatitude, boolean forceWrap)
```
  - getLongPixelYFromLatitude
```
 long getLongPixelYFromLatitude(double pLatitude)
```
  - toProjectedPixels
```
 PointL toProjectedPixels(GeoPoint geoPoint, PointL reuse)
```
    A wrapper for toProjectedPixels
  - toProjectedPixels
```
@Deprecated() PointL toProjectedPixels(long latituteE6, long longitudeE6, PointL reuse)
```
    Performs only the first computationally heavy part of the projection. Call getLongPixelsFromProjected to get the final position.
    
    Parameters:
    
    latituteE6 - the latitute of the point
    
    longitudeE6 - the longitude of the point
    
    reuse - just pass null if you do not have a PointL to be 'recycled'.
  - toProjectedPixels
```
 PointL toProjectedPixels(double latitude, double longitude, PointL reuse)
```
    Performs only the first computationally heavy part of the projection. Call getLongPixelsFromProjected to get the final position.
    
    Parameters:
    
    latitude - the latitute of the point
    
    longitude - the longitude of the point
    
    reuse - just pass null if you do not have a PointL to be 'recycled'.
  - toProjectedPixels
```
 PointL toProjectedPixels(double latitude, double longitude, boolean pWrapEnabled, PointL reuse)
```
  - toPixelsFromProjected
```
@Deprecated() Point toPixelsFromProjected(PointL in, Point reuse)
```
    Performs the second computationally light part of the projection.
    
    Parameters:
    
    in - the PointL calculated by the toProjectedPixels
    
    reuse - just pass null if you do not have a Point to be 'recycled'.
  - toPixelsFromMercator
```
@Deprecated() Point toPixelsFromMercator(long pMercatorX, long pMercatorY, Point reuse)
```
  - toMercatorPixels
```
 PointL toMercatorPixels(int pPixelX, int pPixelY, PointL reuse)
```
  - metersToEquatorPixels
```
 float metersToEquatorPixels(float meters)
```
    Converts a distance in meters (along the equator) to one in (horizontal) pixels at thecurrent zoomlevel. In the default Mercator projection, the actual number of pixels for agiven distance will get higher as you move away from the equator.
    
    Parameters:
    
    meters - the distance in meters
  - metersToPixels
```
 float metersToPixels(float meters)
```
    Converts a distance in meters to one in (horizontal) pixels at the current zoomlevel and atthe current latitude at the center of the screen.
    
    Parameters:
    
    meters - the distance in meters
  - metersToPixels
```
 float metersToPixels(float meters, double latitude, double zoomLevel)
```
  - getNorthEast
```
 IGeoPoint getNorthEast()
```
    Get the coordinates of the most north-easterly visible point of the map.
  - getSouthWest
```
 IGeoPoint getSouthWest()
```
    Get the coordinates of the most south-westerly visible point of the map.
  - getInvertedScaleRotateCanvasMatrix
```
 Matrix getInvertedScaleRotateCanvasMatrix()
```
    This will provide a Matrix that will revert the current map's scaling and rotation. This canbe useful when drawing to a fixed location on the screen.
  - unrotateAndScalePoint
```
 Point unrotateAndScalePoint(int x, int y, Point reuse)
```
    This will revert the current map's scaling and rotation for a point. This can be useful whendrawing to a fixed location on the screen.
  - rotateAndScalePoint
```
 Point rotateAndScalePoint(int x, int y, Point reuse)
```
    This will apply the current map's scaling and rotation for a point. This can be useful whenconverting MotionEvents to a screen point.
  - detach
```
 void detach()
```
  - getPixelFromTile
```
 Rect getPixelFromTile(int pTileX, int pTileY, Rect pReuse)
```
  - getMercatorFromTile
```
 long getMercatorFromTile(int pTile)
```
  - getScaleRotateCanvasMatrix
```
 Matrix getScaleRotateCanvasMatrix()
```
    This will provide a Matrix that will revert the current map's scaling and rotation. This canbe useful when drawing to a fixed location on the screen.
  - getProjectedPowerDifference
```
 double getProjectedPowerDifference()
```
  - getPixelsFromProjected
```
@Deprecated() Point getPixelsFromProjected(PointL in, double powerDifference, Point reuse)
```
  - getLongPixelsFromProjected
```
 PointL getLongPixelsFromProjected(PointL in, double powerDifference, boolean pCloser, PointL reuse)
```
    Parameters:
    
    in - Input point: a geo point projected to the map with the largest zoom level (aka "projected" map)
    
    powerDifference - Factor between the large "projected" map and the wanted projection zoom level
    
    pCloser - "Should we move the resulting point - modulo the map size - so that it'sas close to the screen limits as possible?
  - getTileFromMercator
```
 int getTileFromMercator(long pMercator)
```
  - getMercatorViewPort
```
 RectL getMercatorViewPort(RectL pReuse)
```
  - getScreenCenterX
```
 int getScreenCenterX()
```
  - getScreenCenterY
```
 int getScreenCenterY()
```
  - getMercatorXFromPixel
```
 long getMercatorXFromPixel(int pPixelX)
```
  - getMercatorYFromPixel
```
 long getMercatorYFromPixel(int pPixelY)
```
  - getCleanMercator
```
 long getCleanMercator(long pMercator, boolean wrapEnabled)
```
  - getCurrentCenter
```
 GeoPoint getCurrentCenter()
```
  - getOffsetX
```
 long getOffsetX()
```
  - getOffsetY
```
 long getOffsetY()
```
  - save
```
 void save(Canvas pCanvas, boolean pMapRotation, boolean pForce)
```
  - restore
```
 void restore(Canvas pCanvas, boolean pForce)
```
  - adjustOffsets
```
 void adjustOffsets(IGeoPoint pGeoPoint, PointF pPixel)
```
    Adjust the offsets so that this geo point projects into that pixel
  - adjustOffsets
```
@Deprecated() void adjustOffsets(BoundingBox pBoundingBox)
```
    Adjust the offsets so thateither this bounding box is bigger than the screen and contains itor it is smaller and it is centered
  - getScrollableOffset
```
 static long getScrollableOffset(long pPixelMin, long pPixelMax, double pWorldSize, int pScreenSize, int pExtraSize)
```
    Parameters:
    
    pPixelMin - Pixel position of the limit (left)
    
    pPixelMax - Pixel position of the limit (right)
    
    pWorldSize - World map size - for modulo adjustments
    
    pScreenSize - Screen size
    
    pExtraSize - Extra size to consider at each side of the screen
  - isHorizontalWrapEnabled
```
 boolean isHorizontalWrapEnabled()
```
  - isVerticalWrapEnabled
```
 boolean isVerticalWrapEnabled()
```
  - getOrientation
```
 float getOrientation()
```
  - getWidth
```
 int getWidth()
```
  - getHeight
```
 int getHeight()
```
  - getWorldMapSize
```
 double getWorldMapSize()
```

Class Projection

Field Summary

Constructor Summary

Method Summary

Methods inherited from class org.osmdroid.api.IProjection

Methods inherited from class java.lang.Object

Constructor Detail

Projection

Projection

Method Detail

getOffspring

getZoomLevel

getBoundingBox

getScreenRect

getIntrinsicScreenRect

fromPixels

fromPixels

fromPixels

toPixels

toPixels

getLongPixelXFromLongitude

getLongPixelXFromLongitude

getLongPixelYFromLatitude

getLongPixelYFromLatitude

toProjectedPixels

toProjectedPixels

toProjectedPixels

toProjectedPixels

toPixelsFromProjected

toPixelsFromMercator

toMercatorPixels

metersToEquatorPixels

metersToPixels

metersToPixels

getNorthEast

getSouthWest

getInvertedScaleRotateCanvasMatrix

unrotateAndScalePoint

rotateAndScalePoint

detach

getPixelFromTile

getMercatorFromTile

getScaleRotateCanvasMatrix

getProjectedPowerDifference

getPixelsFromProjected

getLongPixelsFromProjected

getTileFromMercator

getMercatorViewPort

getScreenCenterX

getScreenCenterY

getMercatorXFromPixel

getMercatorYFromPixel

getCleanMercator

getCurrentCenter

getOffsetX

getOffsetY

save

restore

adjustOffsets

adjustOffsets

getScrollableOffset

isHorizontalWrapEnabled

isVerticalWrapEnabled

getOrientation

getWidth

getHeight

getWorldMapSize