com.wialon.render

Class Renderer

java.lang.Object

com.wialon.core.EventProvider

com.wialon.render.Renderer

public class Renderer
extends EventProvider

Wialon renderer object. Manages various server-based layers rendering.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Renderer.events
static class	Renderer.poiFlag POI layers creation flags, used upon layer creation
static class	Renderer.zonesFlag Geofence layers creation flags, used upon layer creation

Constructor Summary

Constructors

Constructor and Description
Renderer()

Method Summary

Methods

Modifier and Type	Method and Description
void	createMessagesLayer(LayerSpec params, LayerResponseHandler callback) Create new messages layer into renderer, require ACL Item.accessFlag.execReports
void	createPoiLayer(java.lang.String layerName, POISpec[] pois, int flags, LayerResponseHandler callback) Create POI layer into renderer, require ACL Resource.accessFlag.viewPoi to resource items
void	createZonesLayer(java.lang.String layerName, ZonesSpec[] zones, int flags, LayerResponseHandler callback) Create Geofence layer into renderer, require ACL Resource.accessFlag.viewZone to resource items
void	enableLayer(Layer layer, boolean enable, ResponseHandler callback) Enable or disable layer.
java.util.List<Layer>	getLayers() Get layers
Layer	getReportLayer() Get report layer
java.lang.String	getTileUrl(int x, int y, int z) Get URL for 256x256 GMaps style tile
int	getVersion() Active, incremental version of renderer, version property is incremented when picture is changed and redraw required
void	hitTest(double lat, double lon, int scale, double radius, java.lang.String layerName, ResponseHandler callback) Perform hit test over coordinates over all layers in renderer
void	removeAllLayers(ResponseHandler callback) Remove all layers from renderer
void	removeLayer(Layer layer, ResponseHandler callback) Remove layer from renderer
void	setLocale(int tzOffset, java.lang.String language, int density, ResponseHandler callback)
void	setLocale(int tzOffset, java.lang.String language, ResponseHandler callback) Initialize/update localization settings,

Methods inherited from class com.wialon.core.EventProvider

addListener, clearListeners, fireEvent, removeListener, removeListeners

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Renderer

public Renderer()

Method Detail

getVersion

public int getVersion()

Active, incremental version of renderer, version property is incremented when picture is changed and redraw required

getLayers

public java.util.List<Layer> getLayers()

Get layers

Returns:

layers collection

getReportLayer

public Layer getReportLayer()

Get report layer

Returns:

may return null

getTileUrl

public java.lang.String getTileUrl(int x,
                          int y,
                          int z)

Get URL for 256x256 GMaps style tile

Parameters:

x - X coordinate (lon?)

y - Y coordinate (lat?)

z - Z coordinate (zoom)

Returns:

tile URL

setLocale

public void setLocale(int tzOffset,
             java.lang.String language,
             ResponseHandler callback)

Initialize/update localization settings,

Parameters:

tzOffset - timezone offset, see wialon.util.DateTime

language - 2byte language code, e.g.: ru, en, de, ...

callback - function that is called after renderer initialization

setLocale

public void setLocale(int tzOffset,
             java.lang.String language,
             int density,
             ResponseHandler callback)

createMessagesLayer

public void createMessagesLayer(LayerSpec params,
                       LayerResponseHandler callback)

Create new messages layer into renderer, require ACL Item.accessFlag.execReports

Parameters:

params - layer parameters, format: {layerName: text, itemId: long, timeFrom: uint, timeTo: uint, tripDetector: bool, trackColor: text, trackWidth: int, arrows: bool, points: bool, pointColor: text, annotations: bool}

callback - callback that will receive information about new layer addition

createPoiLayer

public void createPoiLayer(java.lang.String layerName,
                  POISpec[] pois,
                  int flags,
                  LayerResponseHandler callback)

Create POI layer into renderer, require ACL Resource.accessFlag.viewPoi to resource items

Parameters:

layerName - layer name

pois - POI to render specification in form: [{resourceId: ID, poiId: [id1, id2, id3]}]

flags - layer rendering flags, see wialon.render.Renderer.PoiFlag for more details

callback - callback that will receive information about new layer addition

createZonesLayer

public void createZonesLayer(java.lang.String layerName,
                    ZonesSpec[] zones,
                    int flags,
                    LayerResponseHandler callback)

Create Geofence layer into renderer, require ACL Resource.accessFlag.viewZone to resource items

Parameters:

layerName - layer name

zones - Zones to render specification in form: [{resourceId: ID, zoneId: [id1, id2, id3]}]

flags - layer rendering flags, see wialon.render.Renderer.ZonesFlag for more details

callback - callback that will receive information about new layer addition

removeLayer

public void removeLayer(Layer layer,
               ResponseHandler callback)

Remove layer from renderer

Parameters:

layer - layer which to remove

callback - callback that will receive information about new layer removal

enableLayer

public void enableLayer(Layer layer,
               boolean enable,
               ResponseHandler callback)

Enable or disable layer.

Parameters:

layer - layer to enable or disable

enable - true to enable layer, false - to disable

callback - callback that will receive information about layer update

removeAllLayers

public void removeAllLayers(ResponseHandler callback)

Remove all layers from renderer

Parameters:

callback - callback that will be called after all layers are removed

hitTest

public void hitTest(double lat,
           double lon,
           int scale,
           double radius,
           java.lang.String layerName,
           ResponseHandler callback)

Perform hit test over coordinates over all layers in renderer

Parameters:

lat - point latitude

lon - point longtitude

scale - scale in some adsa-known metrics

radius - maximum possible range till object, probably in degrees

layerName - maybe zero string (value: "")

callback - callback, that get result in form callback(code, result), where zero code mean success, result is complex object, which fields depending on type of hitted layer