Show:

ia.CanvasBase Class

Module: ia

ia.CanvasBase defines the basic layout behavior of chart or map.

Constructor

ia.CanvasBase

(
  • id
)

Parameters:

  • id String

    The id.

Methods

_addListeners

() private

Adds the listeners.

_createCanvas

() HTML Canvas private

Creates a new canvas.

Returns:

HTML Canvas: The canvas.

_mouseEventHandler

(
  • event
)
private

Responsible for handling mouse events and then dispatching the relevant map event.

Parameters:

  • event MouseEvent

    Dispatched by the mouse.

_touchEventHandler

(
  • event
)
private

Responsible for handling touch events and then dispatching the relevant map event.

Parameters:

  • event TouchEvent

    Dispatched by the mouse.

addEventListener

(
  • eventType
  • fnc
  • obj
)

Add an event listener.

Parameters:

  • eventType String

    The type of event to listen for.

  • fnc Function

    The function to call when the event occurs.

  • obj Object

    An optional parent object.

addLayer

(
  • layer
)

Adds a layer to the map.

Parameters:

adjustBBox

(
  • bb
)

Adjusts the bounding box to fit the pixel space whilst maintaining its aspect ratio.

Parameters:

adjustY

(
  • bb
)

Adjusts the y coords to fit the pixel space whilst maintaining x coords.

Parameters:

clear

()

Clears the canvas.

clear

()

Clears the foreground canvas.

commitChanges

()

A call to commitChanges commits any changes made to canvasWidth, canvasHeight or bBox.

This function exists to allow properties to be changed without continuous updates to the object.

dispatchEvent

(
  • event
)

Dispatch an event to the listeners.

Parameters:

  • event Object

    The event object.

endDrag

()

Ends a map drag.

exportData

(
  • txt
)

Exports as an image in a new page.

Parameters:

  • txt String

    Any text to go with image.

getBBox

() ia.BoundingBox

Gets the bounding box.

Returns:

ia.BoundingBox: The bounding box.

getDataBBox

(
  • rect
)
ia.BoundingBox

Converts a rectangle (pixel units) to a bBox (data units).

Parameters:

Returns:

ia.BoundingBox: A bBox (data units).

getDataHeight

(
  • dimension
)
Number

Converts a height from pixel units to data units.

Parameters:

  • dimension Number

    A height (pixel units).

Returns:

Number: A height (data units).

getDataPoint

(
  • p
)
ia.Point

Converts a point from pixel units to data units.

Parameters:

Returns:

ia.Point: A point (data units).

getDataWidth

(
  • dimension
)
Number

Converts a width from pixel units to data units.

Parameters:

  • dimension Number

    A width (pixel units).

Returns:

Number: A width (data units).

getDataX

(
  • x
)
Number

Converts an x-coord from pixel units to data units.

Parameters:

  • x Number

    An x-coord (pixel units).

Returns:

Number: An x-coord (data units).

getDataY

(
  • y
)
Number

Converts a y-coord from pixel units to data units.

Parameters:

  • y Number

    A y-coord (pixel units).

Returns:

Number: A y-coord (data units).

getLayer

(
  • id
)
ia.LayerBase

Gets the map layer with the given id.

Parameters:

  • id String

    The layer id.

Returns:

ia.LayerBase: The layer, or undefined.

getLayers

() ia.LayerBase[]

Gets the map layers.

Returns:

ia.LayerBase[]: The layers in the map.

getPixelHeight

(
  • y
)
Number

Converts a height from data units to pixel units.

Parameters:

  • y Number

    A height (data units).

Returns:

Number: A height (pixel units).

getPixelPoint

(
  • p
)
ia.Point

Converts a point from data units to pixel units.

Parameters:

Returns:

ia.Point: A point (pixel units).

getPixelRect

(
  • bb
)
ia.Rectangle

Converts a bounding box (data units) to a rectangle (pixel units).

Parameters:

Returns:

ia.Rectangle: A rectangle (pixel units).

getPixelWidth

(
  • x
)
Number

Converts a width from data units to pixel units.

Parameters:

  • x Number

    A width (data units).

Returns:

Number: A width (pixel units).

getPixelX

(
  • x
)
Number

Converts an x-coord from data units to pixel units.

Parameters:

  • x Number

    An x-coord (data units).

Returns:

Number: An x-coord (pixel units).

getPixelY

(
  • y
)
Number

Converts a y-coord from data units to pixel units.

Parameters:

  • y Number

    A y-coord (data units).

Returns:

Number: A y-coord (pixel units).

hide

()

Hides the chart.

mouseCoords

() ia.Point

Returns the cursor position in data units.

Returns:

ia.Point: The cursor position (data units).

removeLayers

()

Removes all layers from the map.

removeListener

(
  • obj
)

Removes all event listeners for the given object.

Parameters:

  • obj Object

    The object.

render

()

Clears and renders the map.

setBBox

(
  • bBox
)

Sets the bounding box.

Parameters:

show

()

Shows the chart.

startDrag

()

Starts a map drag.

toggle

()

Toggles the chart visibility.

Properties

animationMode

Boolean

Animation mode.

Default: false

backgroundContainer

JQUERY Element

Containers the map canvas.

canvas

HTML Canvas

The canvas.

canvas

HTML Canvas

The foreground canvas for drawing elements on top of the map/chart.

canvasHeight

Number

The pixel height.

Default: 0

canvasWidth

Number

The pixel width.

Default: 0

canvasX

Number

The pixel x-position.

Default: 0

canvasY

Number

The pixel y-position.

Default: 0

container

JQUERY Element

The container that holds the object.

context

HTML Canvas Context

The canvas context.

context

HTML Canvas Context

The foreground context for drawing elements on top of the map/chart.

datatip

ia.ChartTip

The data tip.

embeddedInGoogleMaps

Boolean

Indicates if embedded in google maps.

Default: false

foregroundContainer

JQUERY Element

Containers selection / highlight canvas.

id

String

The id.

isDraggable

Boolean

Indicates if its draggable ie Its a map - used by touch events.

Default: false

isVisible

Boolean

The chart visibility.

Default: true

layerContainer

JQUERY Element

The container that holds the layers.

maintainAspectRatio

Boolean

The data space will often be a different shape to the pixel space it has to fill.

If set to true the data space is adjusted to maintain the aspect ratio.

If set to false the data space stretches to fit the pixel space. This will generally result in the aspect ratio changing (a stretching effect).

Default: false

mapContainer

JQUERY Element

The container that holds all the divs.

maxZoom

Number

The maximum extent.

Default: -1

minZoom

Number

The minimum extent.

Default: -1

mouseX

Number

The x coordinate of the mouse (pixel units) relative to the map origin.

Default: 0

mouseY

Number

The y coordinate of the mouse (pixel units) relative to the map origin.

Default: 0