Packagenet.systemeD.halcyon
Classpublic class Map
InheritanceMap Inheritance flash.display.Sprite

The representation of part of the map on the screen, including information about coordinates, background imagery, paint properties etc.



Public Properties
 PropertyDefined by
  backdrop : Object
reference to backdrop sprite
Map
  baselon : Number
urllon-xradius/masterscale;
Map
  basey : Number
lat2lat2p(urllat)+yradius/masterscale;
Map
  centre_lat : Number
Map
  centre_lon : Number
Map
  draggable : Boolean
[write-only] Should map be allowed to pan?
Map
  dragstate : uint = 0
Is the map being panned
Map
  edge_b : Number
Map
  edge_l : Number
Map
  edge_r : Number
Map
  edge_t : Number
Map
  editableLayer : MapPaint
[read-only]
Map
  initparams : Object
object containing HTML page parameters: lat, lon, zoom, background_dim, background_sharpen, tileblocks
Map
  mapheight : uint
height (Flash pixels)
Map
  mapwidth : uint
width (Flash pixels)
Map
  scale : uint = 14
map scale
Map
  scalefactor : Number = 5825.4222222222
current scaling factor for lon/latp
Map
  showall : Boolean = true
show all objects, even if unstyled?
Map
  tileset : TileSet
background tile object
Map
Public Methods
 MethodDefined by
  
Map()
Map constructor function
Map
  
addDebug(text:String):void
Map
  
addLayer(connection:Connection, styleurl:String, backgroundlayer:Boolean = true, interactive:Boolean = false):MapPaint
Map
  
clearDebug():void
Map
  
coord2lat(a:Number):Number
Map
  
coord2latp(a:Number):Number
Map
  
coord2lon(a:Number):Number
Map
  
download():void
Download map data.
Map
  
entityMouseEvent(event:MouseEvent, entity:Entity):void
Map
  
findLayer(name:String):MapPaint
Map
  
getDimming():Boolean
Return background dimming.
Map
  
Find which paint object an entity will be displayed on.
Map
  
getLayers():Array
Get all the layers available for this Map object
Map
  
getSharpen():Boolean
Return background sharpening.
Map
  
init(startlat:Number, startlon:Number, startscale:uint = 0):void
Initialise map at a given lat/lon
Map
  
keyUpHandler(event:KeyboardEvent):void
Respond to cursor movements and zoom in/out.
Map
  
lat2coord(a:Number):Number
Map
  
lat2latp(a:Number):Number
Map
  
latp2coord(a:Number):Number
Map
  
latp2lat(a:Number):Number
Map
  
lon2coord(a:Number):Number
Map
  
mouseDownHandler(event:MouseEvent):void
Prepare for being dragged by recording start time and location of mouse.
Map
  
mouseMoveHandler(event:MouseEvent):void
Respond to mouse movement, dragging the map if tolerance threshold met.
Map
  
mouseUpHandler(event:MouseEvent = null):void
Respond to mouse up by possibly moving map.
Map
  
moveMapFromLatLon(lat:Number, lon:Number):void
Recentre map at given lat/lon, updating the UI and downloading entities.
Map
  
nudgeBackground(x:Number, y:Number):void
Sets the offset between the background imagery and the map.
Map
  
redraw():void
Map
  
redrawPOIs():void
Map
  
removeLayerByName(name:String):void
Map
  
scrollIfNeeded(lat:Number, lon:Number):void
Recentre map at given lat/lon, if that point is currently outside the visible area.
Map
  
setController(controller:MapController):void
Assign map controller.
Map
  
setDimming(dim:Boolean):void
Set background dimming on/off.
Map
  
setSharpen(sharpen:Boolean):void
Set background sharpening on/off.
Map
  
updateCoords(tx:Number, ty:Number):void
Recalculate co-ordinates from new Flash origin
Map
  
updateCoordsFromLatLon(lat:Number, lon:Number):void
Move the map to centre on a given latitude/longitude.
Map
  
updateSize(w:uint, h:uint):void
Resize map size based on current stage and height
Map
  
zoomIn():void
Map
  
zoomOut():void
Map
Public Constants
 ConstantDefined by
  DRAGGING : uint = 2
Map
  MASTERSCALE : Number = 5825.4222222222
master map scale - how many Flash pixels in 1 degree longitude (for Landsat, 5120)
Map
  MAXSCALE : uint = 23
don't zoom in past this
Map
  MINSCALE : uint = 13
don't zoom out past this
Map
  NOT_DRAGGING : uint = 0
Map
  NOT_MOVED : uint = 1
Map
  TOLERANCE : uint = 7
How far the map can be dragged without actually triggering a pan.
Map
Property detail
backdropproperty
public var backdrop:Object

reference to backdrop sprite

baselonproperty 
public var baselon:Number

urllon-xradius/masterscale;

baseyproperty 
public var basey:Number

lat2lat2p(urllat)+yradius/masterscale;

centre_latproperty 
public var centre_lat:Number
centre_lonproperty 
public var centre_lon:Number
draggableproperty 
draggable:Boolean  [write-only]

Should map be allowed to pan?

Implementation
    public function set draggable(value:Boolean):void
dragstateproperty 
public var dragstate:uint = 0

Is the map being panned

edge_bproperty 
public var edge_b:Number
edge_lproperty 
public var edge_l:Number
edge_rproperty 
public var edge_r:Number
edge_tproperty 
public var edge_t:Number
editableLayerproperty 
editableLayer:MapPaint  [read-only]Implementation
    public function get editableLayer():MapPaint
initparamsproperty 
public var initparams:Object

object containing HTML page parameters: lat, lon, zoom, background_dim, background_sharpen, tileblocks

mapheightproperty 
public var mapheight:uint

height (Flash pixels)

mapwidthproperty 
public var mapwidth:uint

width (Flash pixels)

scaleproperty 
public var scale:uint = 14

map scale

scalefactorproperty 
public var scalefactor:Number = 5825.4222222222

current scaling factor for lon/latp

showallproperty 
public var showall:Boolean = true

show all objects, even if unstyled?

tilesetproperty 
public var tileset:TileSet

background tile object

Constructor detail
Map()constructor
public function Map()

Map constructor function

Method detail
addDebug()method
public function addDebug(text:String):voidParameters
text:String
addLayer()method 
public function addLayer(connection:Connection, styleurl:String, backgroundlayer:Boolean = true, interactive:Boolean = false):MapPaintParameters
connection:Connection
 
styleurl:String
 
backgroundlayer:Boolean (default = true)
 
interactive:Boolean (default = false)

Returns
MapPaint
clearDebug()method 
public function clearDebug():void
coord2lat()method 
public function coord2lat(a:Number):NumberParameters
a:Number

Returns
Number
coord2latp()method 
public function coord2latp(a:Number):NumberParameters
a:Number

Returns
Number
coord2lon()method 
public function coord2lon(a:Number):NumberParameters
a:Number

Returns
Number
download()method 
public function download():void

Download map data. Data is downloaded for the connection and the vector layers, where supported. The bounding box for the download is taken from the current map edges.

entityMouseEvent()method 
public function entityMouseEvent(event:MouseEvent, entity:Entity):voidParameters
event:MouseEvent
 
entity:Entity
findLayer()method 
public function findLayer(name:String):MapPaintParameters
name:String

Returns
MapPaint
getDimming()method 
public function getDimming():Boolean

Return background dimming.

Returns
Boolean
getLayerForEntity()method 
public function getLayerForEntity(entity:Entity):MapPaint

Find which paint object an entity will be displayed on.

Parameters
entity:Entity

Returns
MapPaint
getLayers()method 
public function getLayers():Array

Get all the layers available for this Map object

Returns
Array — An array of MapPaint objects
getSharpen()method 
public function getSharpen():Boolean

Return background sharpening.

Returns
Boolean
init()method 
public function init(startlat:Number, startlon:Number, startscale:uint = 0):void

Initialise map at a given lat/lon

Parameters
startlat:Number
 
startlon:Number
 
startscale:uint (default = 0)
keyUpHandler()method 
public function keyUpHandler(event:KeyboardEvent):void

Respond to cursor movements and zoom in/out.

Parameters
event:KeyboardEvent
lat2coord()method 
public function lat2coord(a:Number):NumberParameters
a:Number

Returns
Number
lat2latp()method 
public function lat2latp(a:Number):NumberParameters
a:Number

Returns
Number
latp2coord()method 
public function latp2coord(a:Number):NumberParameters
a:Number

Returns
Number
latp2lat()method 
public function latp2lat(a:Number):NumberParameters
a:Number

Returns
Number
lon2coord()method 
public function lon2coord(a:Number):NumberParameters
a:Number

Returns
Number
mouseDownHandler()method 
public function mouseDownHandler(event:MouseEvent):void

Prepare for being dragged by recording start time and location of mouse.

Parameters
event:MouseEvent
mouseMoveHandler()method 
public function mouseMoveHandler(event:MouseEvent):void

Respond to mouse movement, dragging the map if tolerance threshold met.

Parameters
event:MouseEvent
mouseUpHandler()method 
public function mouseUpHandler(event:MouseEvent = null):void

Respond to mouse up by possibly moving map.

Parameters
event:MouseEvent (default = null)
moveMapFromLatLon()method 
public function moveMapFromLatLon(lat:Number, lon:Number):void

Recentre map at given lat/lon, updating the UI and downloading entities.

Parameters
lat:Number
 
lon:Number
nudgeBackground()method 
public function nudgeBackground(x:Number, y:Number):void

Sets the offset between the background imagery and the map.

Parameters
x:Number
 
y:Number
redraw()method 
public function redraw():void
redrawPOIs()method 
public function redrawPOIs():void
removeLayerByName()method 
public function removeLayerByName(name:String):voidParameters
name:String
scrollIfNeeded()method 
public function scrollIfNeeded(lat:Number, lon:Number):void

Recentre map at given lat/lon, if that point is currently outside the visible area.

Parameters
lat:Number
 
lon:Number
setController()method 
public function setController(controller:MapController):void

Assign map controller.

Parameters
controller:MapController
setDimming()method 
public function setDimming(dim:Boolean):void

Set background dimming on/off.

Parameters
dim:Boolean
setSharpen()method 
public function setSharpen(sharpen:Boolean):void

Set background sharpening on/off.

Parameters
sharpen:Boolean
updateCoords()method 
public function updateCoords(tx:Number, ty:Number):void

Recalculate co-ordinates from new Flash origin

Parameters
tx:Number
 
ty:Number
updateCoordsFromLatLon()method 
public function updateCoordsFromLatLon(lat:Number, lon:Number):void

Move the map to centre on a given latitude/longitude.

Parameters
lat:Number
 
lon:Number
updateSize()method 
public function updateSize(w:uint, h:uint):void

Resize map size based on current stage and height

Parameters
w:uint
 
h:uint
zoomIn()method 
public function zoomIn():void
zoomOut()method 
public function zoomOut():void
Constant detail
DRAGGINGconstant
public const DRAGGING:uint = 2
MASTERSCALEconstant 
public const MASTERSCALE:Number = 5825.4222222222

master map scale - how many Flash pixels in 1 degree longitude (for Landsat, 5120)

MAXSCALEconstant 
public const MAXSCALE:uint = 23

don't zoom in past this

MINSCALEconstant 
public const MINSCALE:uint = 13

don't zoom out past this

NOT_DRAGGINGconstant 
public const NOT_DRAGGING:uint = 0
NOT_MOVEDconstant 
public const NOT_MOVED:uint = 1
TOLERANCEconstant 
public const TOLERANCE:uint = 7

How far the map can be dragged without actually triggering a pan.