org.osmdroid.views.overlay

Class NonAcceleratedOverlay

java.lang.Object

org.osmdroid.views.overlay.Overlay

org.osmdroid.views.overlay.NonAcceleratedOverlay

All Implemented Interfaces:

OverlayConstants

public abstract class NonAcceleratedOverlay
extends Overlay

This will allow an Overlay that is not HW acceleration compatible to work in a HW accelerated MapView. It will create a screen-sized backing Bitmap for the Overlay to draw to and then will draw the Bitmap to the HW accelerated canvas. Due to the extra work, it does not draw the shadow layer. If the Canvas passed into the Overlay is not HW accelerated or if isUsingBackingBitmap() returns false then it draws normally (including the shadow layer) without the backing Bitmap.

TODO:

1. Implement a flag to determine if the drawing has actually changed. If not, then reuse the last frame's backing bitmap. This will prevent having to re-upload the bitmap texture to GPU.

Nested Class Summary

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

Overlay.Snappable

Field Summary

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

SHADOW_X_SKEW, SHADOW_Y_SCALE

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

DEBUGMODE, DEFAULT_ZOOMLEVEL_MINIMAP_DIFFERENCE, NOT_SET

Constructor Summary

Constructors

Constructor and Description
NonAcceleratedOverlay()
NonAcceleratedOverlay(Context ctx) Deprecated.

Method Summary

Modifier and Type	Method and Description
void	draw(Canvas c, MapView osmv, boolean shadow) Draw the overlay over the map.
boolean	isUsingBackingBitmap() Allow forcing this overlay to skip drawing using backing Bitmap by returning false.
void	onDetach(MapView mapView) Override to perform clean up of resources before shutdown.
protected void	onDraw(Canvas c, Canvas acceleratedCanvas, MapView osmv, boolean shadow) Override if you really want access to the original (possibly) accelerated canvas.
protected abstract void	onDraw(Canvas c, MapView osmv, boolean shadow) A delegate for draw(Canvas, MapView, boolean).

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

drawAt, getSafeMenuId, getSafeMenuIdSequence, isEnabled, onDoubleTap, onDoubleTapEvent, onDown, onFling, onKeyDown, onKeyUp, onLongPress, onScroll, onShowPress, onSingleTapConfirmed, onSingleTapUp, onTouchEvent, onTrackballEvent, setEnabled

Methods inherited from class java.lang.Object

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

Constructor Detail

NonAcceleratedOverlay

@Deprecated
public NonAcceleratedOverlay(Context ctx)

Deprecated.

Use NonAcceleratedOverlay() instead

NonAcceleratedOverlay

public NonAcceleratedOverlay()

Method Detail

onDraw

protected abstract void onDraw(Canvas c,
                               MapView osmv,
                               boolean shadow)

A delegate for draw(Canvas, MapView, boolean).

onDraw

protected void onDraw(Canvas c,
                      Canvas acceleratedCanvas,
                      MapView osmv,
                      boolean shadow)

Override if you really want access to the original (possibly) accelerated canvas.

isUsingBackingBitmap

public boolean isUsingBackingBitmap()

Allow forcing this overlay to skip drawing using backing Bitmap by returning false.

onDetach

public void onDetach(MapView mapView)

Description copied from class: Overlay

Override to perform clean up of resources before shutdown. By default does nothing.

Overrides:

onDetach in class Overlay

draw

public final void draw(Canvas c,
                       MapView osmv,
                       boolean shadow)

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

Specified by:

draw in class Overlay