map_slippy(n) [suse man page]

map::slippy(n)							 Mapping utilities						    map::slippy(n)

__________________________________________________________________________________________________________________________________________________

NAME

       map::slippy - Common code for slippy based map packages

SYNOPSIS

       package require Tcl  8.4

       package require Tk  8.4

       package require map::slippy  ?0.2?

       ::map::slippy length level

       ::map::slippy tiles level

       ::map::slippy tile size

       ::map::slippy tile valid tile levels ?msgvar?

       ::map::slippy geo 2tile geo

       ::map::slippy geo 2point geo

       ::map::slippy tile 2geo tile

       ::map::slippy tile 2point tile

       ::map::slippy point 2geo point

       ::map::slippy point 2tile point

_________________________________________________________________

DESCRIPTION

       This package provides a number of methods doing things needed by all types of slippy-based map packages.

API

       ::map::slippy length level
	      This  method  returns the width/height of a slippy-based map at the specified zoom level, in pixels. This is, in essence, the result
	      of

		   expr { [tiles $level] * [tile size] }

       ::map::slippy tiles level
	      This method returns the width/height of a slippy-based map at the specified zoom level, in tiles.

       ::map::slippy tile size
	      This method returns the width/height of a tile in a slippy-based map, in pixels.

       ::map::slippy tile valid tile levels ?msgvar?
	      This method checks whether tile described a valid tile in a slippy-based map containing that many zoom levels. The result is a bool-
	      ean  value, true if the tile is valid, and false otherwise. For the latter a message is left in the variable named by msgvar, should
	      it be specified.

	      A tile identifier as stored in tile is a list containing zoom level, tile row, and tile column, in this order.  The  command  essen-
	      tially checks this, i.e. the syntax, that the zoom level is between 0 and "levels-1", and that the row/col information is within the
	      boundaries for the zoom level, i.e. 0 ...  "[tiles $zoom]-1".

       ::map::slippy geo 2tile geo
	      Converts a geographical location at a zoom level (geo, a list containing zoom level, latitude, and longitude, in this  order)  to  a
	      tile identifier (list containing zoom level, row, and column) at that level.

       ::map::slippy geo 2point geo
	      Converts	a  geographical  location at a zoom level (geo, a list containing zoom level, latitude, and longitude, in this order) to a
	      pixel position (list containing zoom level, y, and x) at that level.

       ::map::slippy tile 2geo tile
	      Converts a tile identifier at a zoom level (tile, list containing zoom level, row, and column) to a geographical location (list con-
	      taining zoom level, latitude, and longitude, in this order) at that level.

       ::map::slippy tile 2point tile
	      Converts	a tile identifier at a zoom level (tile, a list containing zoom level, row, and column, in this order) to a pixel position
	      (list containing zoom level, y, and x) at that level.

       ::map::slippy point 2geo point
	      Converts a pixel position at a zoom level (point, list containing zoom level, y, and x) to a geographical location (list	containing
	      zoom level, latitude, and longitude, in this order) at that level.

       ::map::slippy point 2tile point
	      Converts	a pixel position at a zoom level (point, a list containing zoom level, y, and x, in this order) to a tile identifier (list
	      containing zoom level, row, and column) at that level.

REFERENCES

       [1]    http://wiki.openstreetmap.org/wiki/Main_Page

KEYWORDS

       geodesy, geography, latitute, location, longitude, map, slippy, zoom

map									0.2							    map::slippy(n)

Check Out this Related Man Page

map::slippy::cache(n)						 Mapping utilities					     map::slippy::cache(n)

__________________________________________________________________________________________________________________________________________________

NAME

       map::slippy::cache - Management of a tile cache in the local filesystem

SYNOPSIS

       package require Tcl  8.4

       package require Tk  8.4

       package require img::png

       package require map::slippy

       package require map::slippy::cache  ?0.2?

       ::map::slippy::cache cacheName cachedir provider

       cacheName valid tile ?msgvar?

       cacheName exists tile

       cacheName get tile donecmd

_________________________________________________________________

DESCRIPTION

       This package provides a class for managing a cache of tiles for slippy-based maps in the local filesystem.

API

       ::map::slippy::cache cacheName cachedir provider
	      Creates the cache cacheName and configures it with both the path to the directory contaiing the locally cached tiles (cachedir), and
	      the command prefix from which it will pull tiles asked for and not yet known to the cache itself (provider).

	      The result of the command is cacheName.

   METHODS
       cacheName valid tile ?msgvar?
	      This method checks the validity of a the given tile identifier.  This is a convenience wrapper to ::map::slippy tile valid  and  has
	      the same interface.

       cacheName exists tile
	      This  methods  tests whether the cache contains the specified tile or not. The result is a boolean value, true if the tile is known,
	      and false otherwise. The tile is identified by a list containing three elements, zoom level, row, and column number, in this order.

       cacheName get tile donecmd
	      This is the main method of the cache, retrieving the image for the specified tile from the cache. The tile identifier is a list con-
	      taining three elements, the zoom level, row, and column number of the tile, in this order.

	      The  command refix donecmd will be invoked when the cache either knows the image for the tile or that no image will forthcoming.	It
	      will be invoked with either 2 or 3 arguments, i.e.

	      [1]    The string set, the tile, and the image.

	      [2]    The string unset, and the tile.
       These two possibilities are used to either signal the image for the tile, or that the tile has no image defined for it.

       When the cache has no information about the tile it will invoke the provider command prefix specified during its construction, adding three
       arguments: The string get, the tile, and a callback into the cache. The latter will be invoked by the provider to either transfer the image
       to the cache, or signal that the tile has no image.

       When multiple requests for the same tile are made only one request will be issued to the provider.

REFERENCES

       [1]    http://wiki.openstreetmap.org/wiki/Main_Page

KEYWORDS

       cache, filesystem, location, map, slippy, tile, zoom

map									0.2						     map::slippy::cache(n)

Linux and UNIX Man Pages

map_slippy(n) [suse man page]

Check Out this Related Man Page