org.osmdroid.views.overlay.simplefastpoint

Class SimpleFastPointOverlay

java.lang.Object

org.osmdroid.views.overlay.Overlay

org.osmdroid.views.overlay.simplefastpoint.SimpleFastPointOverlay

All Implemented Interfaces:

OverlayConstants

public class SimpleFastPointOverlay
extends Overlay

Overlay to draw a layer of clickable simple points, optimized for rendering speed. Nice performance up to 100k points. Supports styling each point and label individually, or shared style for all points in a theme. Does not support rotated maps. There are three rendering algorithms: NO_OPTIMIZATION: all points all drawn in every draw event MEDIUM_OPTIMIZATION: not recommended for >10k points. Recalculates the grid index on each draw event and only draws one point per grid cell. MAXIMUM_OPTIMIZATION: for >10k points, only recalculates the grid on touch up, hence much faster. Performs well for 100k points.

TODO: a quadtree index would improve rendering speed! TODO: an alternative to the CIRCLE shape, cause this is slow to render Created by Miguel Porto on 25-10-2016.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SimpleFastPointOverlay.OnClickListener
static interface	SimpleFastPointOverlay.PointAdapter
class	SimpleFastPointOverlay.StyledLabelledPoint Just a light internal class for storing point data

Nested classes/interfaces inherited from class org.osmdroid.views.overlay.Overlay

Overlay.Snappable

Field Summary

Fields inherited from class org.osmdroid.views.overlay.Overlay

mBounds, SHADOW_X_SKEW, SHADOW_Y_SCALE

Fields inherited from interface org.osmdroid.views.util.constants.OverlayConstants

DEFAULT_ZOOMLEVEL_MINIMAP_DIFFERENCE, NOT_SET

Constructor Summary

Constructors

Constructor and Description
SimpleFastPointOverlay(SimpleFastPointOverlay.PointAdapter pointList)
SimpleFastPointOverlay(SimpleFastPointOverlay.PointAdapter pointList, SimpleFastPointOverlayOptions style)

Method Summary

Modifier and Type	Method and Description
void	draw(Canvas canvas, MapView mapView, boolean b) Draw the overlay over the map.
protected void	drawPointAt(Canvas canvas, float x, float y, boolean showLabel, String label, Paint pointStyle, Paint textStyle, MapView pMapView)
BoundingBox	getBoundingBox()
Integer	getSelectedPoint()
SimpleFastPointOverlayOptions	getStyle()
boolean	onSingleTapConfirmed(MotionEvent event, MapView mapView) Default action on tap is to select the nearest point.
boolean	onTouchEvent(MotionEvent event, MapView mapView) You can prevent all(!) other Touch-related events from happening! By default does nothing (return false).
void	setOnClickListener(SimpleFastPointOverlay.OnClickListener listener)
void	setSelectedPoint(Integer toSelect) Sets the highlighted point.

Methods inherited from class org.osmdroid.views.overlay.Overlay

draw, drawAt, getBounds, getSafeMenuId, getSafeMenuIdSequence, isEnabled, onDetach, onDoubleTap, onDoubleTapEvent, onDown, onFling, onKeyDown, onKeyUp, onLongPress, onPause, onResume, onScroll, onShowPress, onSingleTapUp, onTrackballEvent, setEnabled

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleFastPointOverlay

public SimpleFastPointOverlay(SimpleFastPointOverlay.PointAdapter pointList,
                              SimpleFastPointOverlayOptions style)

SimpleFastPointOverlay

public SimpleFastPointOverlay(SimpleFastPointOverlay.PointAdapter pointList)

Method Detail

getStyle

public SimpleFastPointOverlayOptions getStyle()

Returns:

fast point overlay options (applied to all points)

onTouchEvent

public boolean onTouchEvent(MotionEvent event,
                            MapView mapView)

Description copied from class: Overlay

You can prevent all(!) other Touch-related events from happening!
By default does nothing (return false). If you handled the Event, return true , otherwise return false. If you returned true none of the following Overlays or the underlying MapView has the chance to handle this event.

Overrides:

onTouchEvent in class Overlay

onSingleTapConfirmed

public boolean onSingleTapConfirmed(MotionEvent event,
                                    MapView mapView)

Default action on tap is to select the nearest point.

Overrides:

onSingleTapConfirmed in class Overlay

setSelectedPoint

public void setSelectedPoint(Integer toSelect)

Sets the highlighted point. App must invalidate the MapView.

Parameters:

toSelect - The index of the point (zero-based) in the original list.

getSelectedPoint

public Integer getSelectedPoint()

getBoundingBox

public BoundingBox getBoundingBox()

setOnClickListener

public void setOnClickListener(SimpleFastPointOverlay.OnClickListener listener)

draw

public void draw(Canvas canvas,
                 MapView mapView,
                 boolean b)

Description copied from class: Overlay

Draw the overlay over the map. This will be called on all active overlays with shadow=true, to lay down the shadow layer, and then again on all overlays with shadow=false. Callers should check isEnabled() before calling draw(). By default, draws nothing.

changed for 5.6 to be public see https://github.com/osmdroid/osmdroid/issues/466 If possible, use Overlay.draw(Canvas, Projection) instead (cf. MapSnapshot

Overrides:

draw in class Overlay

drawPointAt

protected void drawPointAt(Canvas canvas,
                           float x,
                           float y,
                           boolean showLabel,
                           String label,
                           Paint pointStyle,
                           Paint textStyle,
                           MapView pMapView)