OpenSpace. MapBounds

Instances of this class represent bounding boxes.  Data stored as left, bottom, right, top floats.  All values are initialized to null, however, you should make sure you set them before using the bounds for anything.

Possible use case

bounds = new OpenSpace.MapBounds();
bounds.extend(new OpenSpace.MapPoint(40,50));
bounds.extend(new OpenSpace.MapPoint(50,60));
bounds.toBBOX(); // returns 40,50,50,60

Inherits

Summary
Instances of this class represent bounding boxes.
{Number} The spatial reference system
Construct a new map bounds object.
{String} String representation of bounds object.
{Array} array of left, bottom, right, top
{Float} The width of the bounds
{Float} The height of the bounds (top minus bottom).
{OpenSpace.MapSize} The size of the box.
{OpenSpace.MapPoint} The center of the bounds in map space.
Extend the bounds to include the point, map point, or bounds specified.
Alternative constructor that builds a new OpenLayers.Bounds from a parameter string
Alternative constructor that builds a new OpenLayers.Bounds from an array
Alternative constructor that builds a new OpenLayers.Bounds from a size

Properties

srs

{Number} The spatial reference system

Constructor

OpenSpace. MapBounds

Construct a new map bounds object.

Parameters

left{Float} The left bounds of the box.  Note that for width calculations, this is assumed to be less than the right value.
bottom{Float} The bottom bounds of the box.  Note that for height calculations, this is assumed to be more than the top value.
right{Float} The right bounds.
top{Float} The top bounds.

Functions

toString

toString:function()

Returns

{String} String representation of bounds object.  (ex.<i>”left-bottom=(5,42) right-top=(10,45)”</i>)

toArray

toArray: function()

Returns

{Array} array of left, bottom, right, top

toBBOX

toBBOX:function(decimal)

Parameters

decimal{Integer} How many significant digits in the bbox coords?  Default is 6

Returns

{String} Simple String representation of bounds object.  (ex.  <i>”5,42,10,45”</i>)

getWidth

getWidth:function()

Returns

{Float} The width of the bounds

getHeight

getHeight:function()

Returns

{Float} The height of the bounds (top minus bottom).

getSize

getSize:function()

Returns

{OpenSpace.MapSize} The size of the box.

getCenterLonLat

Returns

{OpenSpace.MapPoint} The center of the bounds in map space.

add

add:function(x,
y)

Parameters

x{Float}
y{Float}

Returns

{OpenSpace.MapBounds} A new bounds whose coordinates are the same as this, but shifted by the passed-in x and y values.

extend

extend:function(object)

Extend the bounds to include the point, map point, or bounds specified.  Note, this function assumes that left < right and bottom < top.

Parameters

object{Object} Can be MapPoint, Point, or Bounds

containsLonLat

containsLonLat:function(ll,
inclusive)

Parameters

ll{OpenSpace.MapPoint}
inclusive{Boolean} Whether or not to include the border.  Default is true.

Returns

{Boolean} The passed-in lonlat is within this bounds.

contains

contains:function(x,
y,
inclusive)

Parameters

x{Float}
y{Float}
inclusive{Boolean} Whether or not to include the border.  Default is true.

Returns

{Boolean} Whether or not the passed-in coordinates are within this bounds.

intersectsBounds

intersectsBounds:function(bounds,
inclusive)

Parameters

bounds{OpenLayers.Bounds}
inclusive{<Boolean>} Whether or not to include the border.  Default is true.

Returns

{Boolean} The passed-in OpenLayers.Bounds object intersects this bounds.  Simple math just check if either contains the other, allowing for partial.

containsBounds

containsBounds:function(bounds,
partial,
inclusive)
bounds{OpenLayers.Bounds}
partial{<Boolean>} If true, only part of passed-in bounds needs be within this bounds.  If false, the entire passed-in bounds must be within.  Default is false
inclusive{<Boolean>} Whether or not to include the border.  Default is true.

Returns

{Boolean} The passed-in bounds object is contained within this bounds.

determineQuadrant

determineQuadrant: function(lonlat)

Parameters

lonlat{OpenLayers.LonLat}

Returns

{String} The quadrant (“br” “tr” “tl” “bl”) of the bounds in which the coordinate lies.

fromString

OpenSpace.MapBounds.fromString = function(str)

Alternative constructor that builds a new OpenLayers.Bounds from a parameter string

Parameters

str{String}Comma-separated bounds string.  (ex.  <i>”5,42,10,45”</i>)

Returns

{OpenSpace.MapBounds} New bounds object built from the passed-in String.

fromArray

OpenSpace.MapBounds.fromArray = function(bbox)

Alternative constructor that builds a new OpenLayers.Bounds from an array

Parameters

bbox{Array(Float)} Array of bounds values (ex.  <i>[5,42,10,45]</i>)

Returns

{OpenSpace.MapBounds} New bounds object built from the passed-in Array.

fromSize

OpenSpace.MapBounds.fromSize = function(size)

Alternative constructor that builds a new OpenLayers.Bounds from a size

Parameters

size{OpenSpace.MapSize}

Returns

{OpenSpace.MapBounds} New bounds object built from the passed-in size.

toString:function()
{String} String representation of bounds object.
toArray: function()
{Array} array of left, bottom, right, top
toBBOX:function(decimal)
getWidth:function()
{Float} The width of the bounds
getHeight:function()
{Float} The height of the bounds (top minus bottom).
getSize:function()
{OpenSpace.MapSize} The size of the box.
Instances of this class represent a width/height pair in map units
This class represents an eastings and northings pair of coordinates in British National Grid (BNG) format
add:function(x,
y)
extend:function(object)
Extend the bounds to include the point, map point, or bounds specified.
containsLonLat:function(ll,
inclusive)
contains:function(x,
y,
inclusive)
intersectsBounds:function(bounds,
inclusive)
containsBounds:function(bounds,
partial,
inclusive)
determineQuadrant: function(lonlat)
OpenSpace.MapBounds.fromString = function(str)
Alternative constructor that builds a new OpenLayers.Bounds from a parameter string
OpenSpace.MapBounds.fromArray = function(bbox)
Alternative constructor that builds a new OpenLayers.Bounds from an array
OpenSpace.MapBounds.fromSize = function(size)
Alternative constructor that builds a new OpenLayers.Bounds from a size
Instances of this class represent bounding boxes.
Construct a new map bounds object.
This class represents a longitude and latitude pair