Class Garmin.DeviceDisplay

Object
   |
   +--Garmin.DeviceDisplay

class Garmin.DeviceDisplay

Garmin.DeviceDisplay
Defined in GarminDeviceDisplay.js

Requires:

- Garmin.DeviceControl

Field Detail

LINKS

<static> Object LINKS

Constant defining links referenced in the DeviceDisplay

Garmin.DeviceDisplay

Garmin.DeviceDisplay(mainElement, options)

Provides the easiest avenue for getting a working instance of the plug-in onto your page. Generates the UI elements and places them on the page.

Parameters:
mainElement - - (String) id of the element in which to generate the contents (can also be a reference to the dom element itself).
options - - (Object) Object with options (see Garmin.DeviceDisplayDefaultOptions for descriptions of possible options). requires Prototype

Requires:
- Garmin.DeviceControl

_applyDataFilters

void _applyDataFilters()

_createElement

Object _createElement(id, text, type, parent)

_finishReadProcessing

void _finishReadProcessing(json)

_listActivities

void _listActivities(activities)

_seriesFromSelect

Garmin.Series _seriesFromSelect(select)

Retreive the two index string value from the selected index. Activities are stored in Select objects as strings with 2 Garmin.DeviceDisplay.prototype.numbers = "(index of array), (index of series)"; for Garmin.DeviceDisplay.prototype.example = "1,1";.

Parameters:
Select - select - the Select DOM instance

Returns:
a Series instance

cancelFindDevices

void cancelFindDevices()

Entry point for cancelling search for connected devices.

clearMapDisplay

void clearMapDisplay()

Clears overlays from map.

displayTrack

void displayTrack(series)

Draws a simple line on the map using the Garmin.MapController.

Parameters:
Garmin - .Series series - that contains a track.

displayWaypoint

void displayWaypoint(series)

Draws a point (usualy as a thumb tack) on the map using the Garmin.MapController.

Parameters:
Garmin - .Series series - that contains the lat/lon position of the point.

handleException

void handleException(<Error> error)

Central exception dispatch method, default is to If customExceptionHandler is defined, all error handling is delegated to that method - good luck.

Parameters:
error - to process.

hideProgressBar

void hideProgressBar()

Hides progress bar.

isUnlocked

Boolean isUnlocked()

Plugin unlock status

onCancelFindDevices

void onCancelFindDevices(json)

Call-back for find device cancelled.

onCancelReadFromDevice

void onCancelReadFromDevice(json)

Call-back for device read cancelled. see Garmin.DeviceControl

onCancelWriteToDevice

void onCancelWriteToDevice(json)

Call-back triggered when write has been cancelled.

See:
- Garmin.DeviceControl

onException

void onException(json)

Call-back for asynchronous method exceptions. see Garmin.DeviceControl

onFinishFindDevices

void onFinishFindDevices(json)

Call-back triggered after plugin has completed its search for devices.

See:
- Garmin.DeviceControl
- startFindDevices()

onFinishReadFromDevice

void onFinishReadFromDevice(json)

Call-back for device read. see Garmin.DeviceControl

onFinishWriteToDevice

void onFinishWriteToDevice(json)

onProgressReadFromDevice

void onProgressReadFromDevice(json)

Call-back for device read progress.

onProgressWriteToDevice

void onProgressWriteToDevice(json)

onStartFindDevices

void onStartFindDevices(json)

Call-back triggered before plugin searches for connected devices.

See:
- Garmin.DeviceControl
- startFindDevices()

onStartWriteToDevice

void onStartWriteToDevice(json)

Call-back triggered before writing to a device.

See:
- Garmin.DeviceControl

onWaitingWriteToDevice

void onWaitingWriteToDevice(json)

Call-back when the device already has a file with this name on it. Do we want to override? 1 is yes, 2 is no

See:
- Garmin.DeviceControl

readFromDevice

void readFromDevice()

Initiation call for reading from a device. If a fitness device is detected reads TCX otherwise reads GPX. Upon completion if the afterFinishReadFromDevice method is defined it will be called. At this time you may also obtain location data using the getTracks and getWaypoints methods.

readSpecificTypeFromDevice

void readSpecificTypeFromDevice(<String> extension)

Initiation call for reading from a device. Upon completion if the afterFinishReadFromDevice method is defined it will be called. At this time you may also obtain location data using the getTracks and getWaypoints methods.

Parameters:
extension - - the file extension of the type to Garmin.DeviceDisplay.prototype.read = gpx;or tcx

resetUI

void resetUI()

Resets UI widgets based on state of application.

Parameters:
String - > optional status message.

setOptions

void setOptions(<Object> options)

Sets options for this display object. Any options that are set will override the default values.

Parameters:
options - - Object with options.

Throws:
- InvalidOptionException
See:
- for possible options and default values.

setStatus

void setStatus(statusText)

Set status text if showStatusElement is visible.

Parameters:
text - to display.

showProgressBar

void showProgressBar()

Makes progress bar visible.

startFindDevices

void startFindDevices()

Entry point for searching for connected devices. Will attempt to unlock the plugin if necessary.

updateProgressBar

void updateProgressBar(value)

Update percentage representation of progress bar.

Parameters:
percentage - Garmin.DeviceDisplay.prototype.completion = 0;-100

writeToDevice

void writeToDevice()

Writes any supported data to the device. Requires that the option writeDataType field be set correctly to any of the following values located in Garmin.DeviceControl.FILE_TYPES: gpx, crs, or gpi

Throws:
- InvalidTypeException