org.osmdroid.views.overlay

Class LinearRing

java.lang.Object

org.osmdroid.views.overlay.LinearRing

public class LinearRing
extends Object

Class holding one ring: the polygon outline, or a hole inside the polygon Used to be an inner class of Polygon and Polyline

Since:

6.0.0

Constructor Summary

Constructors

Constructor and Description
LinearRing(LineBuilder pLineBuilder) Dedicated to lines
LinearRing(LineBuilder pLineBuilder, boolean pClosePath) Dedicated to lines
LinearRing(Path pPath) Dedicated to `Path`
LinearRing(Path pPath, boolean pClosed)

Method Summary

Modifier and Type	Method and Description
protected void	addGreatCircle(GeoPoint startPoint, GeoPoint endPoint, int numberOfPoints)
void	addPoint(GeoPoint p)
(package private) void	buildLinePortion(Projection pProjection, boolean pStorePoints) Dedicated to Polyline, as they can run much faster with drawLine than through a Path
(package private) PointL	buildPathPortion(Projection pProjection, PointL pOffset, boolean pStorePoints) Feed the path with the segments corresponding to the GeoPoint pairs projected using pProjection and clipped into a "reasonable" clip area In most cases (Polygon without holes, Polyline) the offset parameter will be null.
void	clear()
(package private) void	clearPath()
(package private) float[]	computeDowngradePointList(int pSize) Computes the list of points of a polyline that would be the projection of the GeoPoints on a centered size*size square
void	getBestOffset(Projection pProjection, PointL pOffset, PointL pPixel)
BoundingBox	getBoundingBox()
GeoPoint	getCenter(GeoPoint pReuse)
static double	getCloserValue(double pPrevious, double pNext, double pWorldSize)
(package private) GeoPoint	getCloseTo(GeoPoint pPoint, double tolerance, Projection pProjection, boolean pClosePath)
double	getDistance()
(package private) double[]	getDistances()
ArrayList<GeoPoint>	getPoints()
ListPointL	getPointsForMilestones()
(package private) boolean	isCloseTo(GeoPoint pPoint, double tolerance, Projection pProjection, boolean pClosePath) Detection is done in screen coordinates.
boolean	isGeodesic()
void	setClipArea(long pXMin, long pYMin, long pXMax, long pYMax)
void	setClipArea(Projection pProjection)
void	setGeodesic(boolean geodesic)
void	setPoints(List<GeoPoint> points)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LinearRing

public LinearRing(Path pPath)

Dedicated to `Path`

LinearRing

public LinearRing(LineBuilder pLineBuilder,
                  boolean pClosePath)

Dedicated to lines

Since:

6.2.0

LinearRing

public LinearRing(LineBuilder pLineBuilder)

Dedicated to lines

Since:

6.0.0

LinearRing

public LinearRing(Path pPath,
                  boolean pClosed)

Since:

6.1.0

Method Detail

clearPath

void clearPath()

addGreatCircle

protected void addGreatCircle(GeoPoint startPoint,
                              GeoPoint endPoint,
                              int numberOfPoints)

addPoint

public void addPoint(GeoPoint p)

setPoints

public void setPoints(List<GeoPoint> points)

getPoints

public ArrayList<GeoPoint> getPoints()

getDistances

double[] getDistances()

getDistance

public double getDistance()

Since:

6.0.3

setGeodesic

public void setGeodesic(boolean geodesic)

isGeodesic

public boolean isGeodesic()

buildPathPortion

PointL buildPathPortion(Projection pProjection,
                        PointL pOffset,
                        boolean pStorePoints)

Feed the path with the segments corresponding to the GeoPoint pairs projected using pProjection and clipped into a "reasonable" clip area In most cases (Polygon without holes, Polyline) the offset parameter will be null. In the case of a Polygon with holes, the first path will use a null offset. Then this method will return the pixel offset computed for this path so that the path is in the best possible place on the map: the center of all pixels is as close to the screen center as possible Then, this computed offset must be injected into the buildPathPortion for each hole, in order to have the main polygon and its holes at the same place on the map.

Returns:

the initial offset if not null, or the computed offset

buildLinePortion

void buildLinePortion(Projection pProjection,
                      boolean pStorePoints)

Dedicated to Polyline, as they can run much faster with drawLine than through a Path

Since:

6.0.0

getPointsForMilestones

public ListPointL getPointsForMilestones()

Since:

6.0.0

getBestOffset

public void getBestOffset(Projection pProjection,
                          PointL pOffset,
                          PointL pPixel)

Since:

6.2.0

getCloserValue

public static double getCloserValue(double pPrevious,
                                    double pNext,
                                    double pWorldSize)

Since:

6.2.0

isCloseTo

boolean isCloseTo(GeoPoint pPoint,
                  double tolerance,
                  Projection pProjection,
                  boolean pClosePath)

Detection is done in screen coordinates.

Parameters:

tolerance - in pixels

Returns:

true if the Polyline is close enough to the point.

getCloseTo

GeoPoint getCloseTo(GeoPoint pPoint,
                    double tolerance,
                    Projection pProjection,
                    boolean pClosePath)

Parameters:

tolerance - in pixels

Returns:

the first GeoPoint of the Polyline close enough to the point

Since:

6.0.3 Detection is done in screen coordinates.

setClipArea

public void setClipArea(long pXMin,
                        long pYMin,
                        long pXMax,
                        long pYMax)

Since:

6.0.0 Mandatory use before clipping.

setClipArea

public void setClipArea(Projection pProjection)

Since:

6.0.0 Mandatory use before clipping.

getCenter

public GeoPoint getCenter(GeoPoint pReuse)

Since:

6.0.2

getBoundingBox

public BoundingBox getBoundingBox()

Since:

6.2.0

clear

public void clear()

Since:

6.2.0

computeDowngradePointList

float[] computeDowngradePointList(int pSize)

Computes the list of points of a polyline that would be the projection of the GeoPoints on a centered size*size square

Since:

6.2.0