org.osmdroid.views.drawing

Class MapSnapshot

java.lang.Object

org.osmdroid.views.drawing.MapSnapshot

All Implemented Interfaces:

Runnable

public class MapSnapshot
extends Object
implements Runnable

Create a bitmap in the background from MapView-like data but without a MapView

Since:

6.1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MapSnapshot.MapSnapshotable
static class	MapSnapshot.Status

Field Summary

Fields

Modifier and Type	Field and Description
static int	INCLUDE_FLAG_EXPIRED
static int	INCLUDE_FLAG_NOTFOUND
static int	INCLUDE_FLAG_SCALED
static int	INCLUDE_FLAG_UPTODATE The INCLUDE_FLAGs let you precise the tiles you accept in your snapshot, depending on their states.
static int	INCLUDE_FLAGS_ALL

Constructor Summary

Constructors

Constructor and Description
MapSnapshot(MapSnapshot.MapSnapshotable pMapSnapshotable, int pIncludeFlags, MapTileProviderBase pTileProvider, List<Overlay> pOverlays, Projection pProjection)
MapSnapshot(MapSnapshot.MapSnapshotable pMapSnapshotable, int pIncludeFlags, MapView pMapView)

Method Summary

Modifier and Type	Method and Description
Bitmap	getBitmap()
MapSnapshot.Status	getStatus()
static boolean	isUIThread() To be used in View-related Overlay's draw methods.
void	onDetach()
void	refreshASAP()
void	run()
boolean	save(File pFile)

Methods inherited from class java.lang.Object

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

Field Detail

INCLUDE_FLAG_UPTODATE

public static final int INCLUDE_FLAG_UPTODATE

The INCLUDE_FLAGs let you precise the tiles you accept in your snapshot, depending on their states. For instance, if your flag includes INCLUDE_FLAG_SCALED, that means that you accept scaled tiles in your output. If your flag equals INCLUDE_FLAG_UPTODATE, that means that you accept only up-to-date tiles, and implicitly that you may have to wait, and need background downloads. Cf. ExpirableBitmapDrawable

See Also:

Constant Field Values

INCLUDE_FLAG_EXPIRED

public static final int INCLUDE_FLAG_EXPIRED

See Also:

Constant Field Values

INCLUDE_FLAG_SCALED

public static final int INCLUDE_FLAG_SCALED

See Also:

Constant Field Values

INCLUDE_FLAG_NOTFOUND

public static final int INCLUDE_FLAG_NOTFOUND

See Also:

Constant Field Values

INCLUDE_FLAGS_ALL

public static final int INCLUDE_FLAGS_ALL

See Also:

Constant Field Values

Constructor Detail

MapSnapshot

public MapSnapshot(MapSnapshot.MapSnapshotable pMapSnapshotable,
                   int pIncludeFlags,
                   MapView pMapView)

MapSnapshot

public MapSnapshot(MapSnapshot.MapSnapshotable pMapSnapshotable,
                   int pIncludeFlags,
                   MapTileProviderBase pTileProvider,
                   List<Overlay> pOverlays,
                   Projection pProjection)

Method Detail

isUIThread

public static boolean isUIThread()

To be used in View-related Overlay's draw methods. Not only are we not able to include View's in the snapshots, but drawing those View's can make the app crash. A solution is to catch an Exception when drawing, and to be lenient when we're not on the UI thread

run

public void run()

Specified by:

run in interface Runnable

getStatus

public MapSnapshot.Status getStatus()

getBitmap

public Bitmap getBitmap()

save

public boolean save(File pFile)

onDetach

public void onDetach()

refreshASAP

public void refreshASAP()