com.nutiteq.datasources.raster

Class MGMFileRasterDataSource

java.lang.Object

com.nutiteq.rasterdatasources.AbstractRasterDataSource

com.nutiteq.datasources.raster.MGMFileRasterDataSource

All Implemented Interfaces:

com.nutiteq.rasterdatasources.RasterDataSource

public class MGMFileRasterDataSource
extends com.nutiteq.rasterdatasources.AbstractRasterDataSource

A raster tile data source class that uses the SDCard a source for the map tile data. The map data has to be in MGMaps format. The request are generated in this manner:

path + name + "_" + zoom + "/" + tpfx + "_" + tpxy + ".mgm"

For example if: path = "/london/", name = "OpenStreetMap"

"/london/" + "OpenStreetMap" + "_" + "0" + "/" + "0" + "_" + "0" + ".mgm"

Result: /london/OpenStreetMap_0/0_0.mgm

Nested Class Summary

Nested classes/interfaces inherited from interface com.nutiteq.rasterdatasources.RasterDataSource

com.nutiteq.rasterdatasources.RasterDataSource.OnChangeListener

Field Summary

Fields inherited from class com.nutiteq.rasterdatasources.AbstractRasterDataSource

maxZoom, minZoom, projection

Constructor Summary

Constructors

Constructor and Description
MGMFileRasterDataSource(com.nutiteq.projections.Projection projection, int minZoom, int maxZoom, int tileSize, String name, String path) Class constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected String	buildTileFileName(com.nutiteq.components.MapTile tile) Generate file name based on the tile info.
com.nutiteq.components.TileBitmap	loadTile(com.nutiteq.components.MapTile tile)

Methods inherited from class com.nutiteq.rasterdatasources.AbstractRasterDataSource

addOnChangeListener, getMaxZoom, getMinZoom, getProjection, notifyTilesChanged, removeOnChangeListener

Methods inherited from class java.lang.Object

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

Constructor Detail

MGMFileRasterDataSource

public MGMFileRasterDataSource(com.nutiteq.projections.Projection projection,
                       int minZoom,
                       int maxZoom,
                       int tileSize,
                       String name,
                       String path)

Class constructor. Creates a new tile data source that uses a specified folder on the SDCard as a source for the tile data. The tile size is used to determine the naming convention for the tile files. Tiles that are out of the specified minimum / maximum zoom range are not downloaded. The id used should be unique to each rasterlayer, if two or more raster layers use the same id, they will also share the tiles in the cache. The map data must be in MGMaps format.

Parameters:

projection - the desired projection

tileSize - the tile size in pixels

minZoom - the minimum zoom

maxZoom - the maximum zoom

id - unique layer id. Id for the layer must be depend ONLY on the layer source, otherwise tile caching will not work properly.

minZoom - minimum zoom level supported by this data source

maxZoom - maximum zoom level supported by this data source

name - the name of the sub folders

path - the path to the main map folder

Method Detail

buildTileFileName

protected String buildTileFileName(com.nutiteq.components.MapTile tile)

Generate file name based on the tile info. This method can be customized in subclasses.

Parameters:

tile - tile to generate file name for.

Returns:

full path to the tile file.

loadTile

public com.nutiteq.components.TileBitmap loadTile(com.nutiteq.components.MapTile tile)