org.osmdroid.tileprovider.modules

Class MapTileApproximater

java.lang.Object

org.osmdroid.tileprovider.modules.MapTileModuleProviderBase

org.osmdroid.tileprovider.modules.MapTileApproximater

public class MapTileApproximater
extends MapTileModuleProviderBase

The MapTileApproximater computes approximation of tiles. The approximation is based on the tiles of the same region, but on lower zoom level tiles. An obvious use is in offline mode: it's better to display an approximation than an empty grey square.

Since:

5.6.5

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	MapTileApproximater.TileLoader

Field Summary

Fields inherited from class org.osmdroid.tileprovider.modules.MapTileModuleProviderBase

mPending, mQueueLockObject, mWorking

Constructor Summary

Constructors

Constructor and Description
MapTileApproximater()
MapTileApproximater(int pThreadPoolSize, int pPendingQueueSize)

Method Summary

Modifier and Type	Method and Description
void	addProvider(MapTileModuleProviderBase pProvider)
static Bitmap	approximateTileFromLowerZoom(BitmapDrawable pSrcDrawable, long pMapTileIndex, int pZoomDiff) Approximate a tile from a lower zoom level
Bitmap	approximateTileFromLowerZoom(long pMapTileIndex) Approximate a tile from a lower zoom level
Bitmap	approximateTileFromLowerZoom(long pMapTileIndex, int pZoomDiff) Approximate a tile from a lower zoom level
static Bitmap	approximateTileFromLowerZoom(MapTileModuleProviderBase pProvider, long pMapTileIndex, int pZoomDiff) Approximate a tile from a lower zoom level
void	detach() Detach, we're shutting down - Stops all workers.
int	getMaximumZoomLevel() Gets the maximum zoom level this tile provider can provide
int	getMinimumZoomLevel() Gets the minimum zoom level this tile provider can provide
protected String	getName() Gets the human-friendly name assigned to this tile provider.
protected String	getThreadGroupName() Gets the name assigned to the thread for this provider.
static Bitmap	getTileBitmap(int pTileSizePx) Try to get a tile bitmap from the pool, otherwise allocate a new one
MapTileApproximater.TileLoader	getTileLoader() It is expected that the implementation will construct an internal member which internally implements a MapTileModuleProviderBase.TileLoader.
boolean	getUsesDataConnection() Returns true if implementation uses a data connection, false otherwise.
void	setTileSource(ITileSource pTileSource) Deprecated.

Methods inherited from class org.osmdroid.tileprovider.modules.MapTileModuleProviderBase

loadMapTileAsync, removeTileFromQueues

Methods inherited from class java.lang.Object

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

Constructor Detail

MapTileApproximater

public MapTileApproximater()

Since:

6.0.0

MapTileApproximater

public MapTileApproximater(int pThreadPoolSize,
                           int pPendingQueueSize)

Since:

6.0.0

Method Detail

addProvider

public void addProvider(MapTileModuleProviderBase pProvider)

Since:

6.0.0

getUsesDataConnection

public boolean getUsesDataConnection()

Description copied from class: MapTileModuleProviderBase

Returns true if implementation uses a data connection, false otherwise. This value is used to determine if this provider should be skipped if there is no data connection.

Specified by:

getUsesDataConnection in class MapTileModuleProviderBase

Returns:

true if implementation uses a data connection, false otherwise

getName

protected String getName()

Description copied from class: MapTileModuleProviderBase

Gets the human-friendly name assigned to this tile provider.

Specified by:

getName in class MapTileModuleProviderBase

Returns:

the thread name

getThreadGroupName

protected String getThreadGroupName()

Description copied from class: MapTileModuleProviderBase

Gets the name assigned to the thread for this provider.

Specified by:

getThreadGroupName in class MapTileModuleProviderBase

Returns:

the thread name

getTileLoader

public MapTileApproximater.TileLoader getTileLoader()

Description copied from class: MapTileModuleProviderBase

It is expected that the implementation will construct an internal member which internally implements a MapTileModuleProviderBase.TileLoader. This method is expected to return a that internal member to methods of the parent methods.

Specified by:

getTileLoader in class MapTileModuleProviderBase

Returns:

the internal member of this tile provider.

getMinimumZoomLevel

public int getMinimumZoomLevel()

Description copied from class: MapTileModuleProviderBase

Gets the minimum zoom level this tile provider can provide

Specified by:

getMinimumZoomLevel in class MapTileModuleProviderBase

Returns:

the minimum zoom level

getMaximumZoomLevel

public int getMaximumZoomLevel()

Description copied from class: MapTileModuleProviderBase

Gets the maximum zoom level this tile provider can provide

Specified by:

getMaximumZoomLevel in class MapTileModuleProviderBase

Returns:

the maximum zoom level

setTileSource

@Deprecated
public void setTileSource(ITileSource pTileSource)

Deprecated.

Description copied from class: MapTileModuleProviderBase

Sets the tile source for this tile provider.

Specified by:

setTileSource in class MapTileModuleProviderBase

Parameters:

pTileSource - the tile source

approximateTileFromLowerZoom

public Bitmap approximateTileFromLowerZoom(long pMapTileIndex)

Approximate a tile from a lower zoom level

Parameters:

pMapTileIndex - Destination tile, for the same place on the planet as the source, but on a higher zoom

Returns:

Since:

6.0.0

approximateTileFromLowerZoom

public Bitmap approximateTileFromLowerZoom(long pMapTileIndex,
                                           int pZoomDiff)

Approximate a tile from a lower zoom level

Parameters:

pMapTileIndex - Destination tile, for the same place on the planet as the source, but on a higher zoom

pZoomDiff - Zoom level difference between the destination and the source; strictly positive

Returns:

Since:

6.0.0

approximateTileFromLowerZoom

public static Bitmap approximateTileFromLowerZoom(MapTileModuleProviderBase pProvider,
                                                  long pMapTileIndex,
                                                  int pZoomDiff)

Approximate a tile from a lower zoom level

Parameters:

pProvider - Source tile provider

pMapTileIndex - Destination tile, for the same place on the planet as the source, but on a higher zoom

pZoomDiff - Zoom level difference between the destination and the source; strictly positive

Returns:

Since:

6.0.0

approximateTileFromLowerZoom

public static Bitmap approximateTileFromLowerZoom(BitmapDrawable pSrcDrawable,
                                                  long pMapTileIndex,
                                                  int pZoomDiff)

Approximate a tile from a lower zoom level

Parameters:

pSrcDrawable - Source tile bitmap

pMapTileIndex - Destination tile, for the same place on the planet as the source, but on a higher zoom

pZoomDiff - Zoom level difference between the destination and the source; strictly positive

Returns:

Since:

5.6.5

getTileBitmap

public static Bitmap getTileBitmap(int pTileSizePx)

Try to get a tile bitmap from the pool, otherwise allocate a new one

Parameters:

pTileSizePx -

Returns:

detach

public void detach()

Description copied from class: MapTileModuleProviderBase

Detach, we're shutting down - Stops all workers.

Overrides:

detach in class MapTileModuleProviderBase

Since:

6.0.0