Topology View – Custom Sprites
The GUI Topology View has the ability to have custom sprites displayed as a layer between the (geographical) background map and the topology elements (nodes/links).
In the current release (1.3.0 "Cardinal") sprite layers are defined in an external JSON format and uploaded to the controller via a REST command. They are loaded into the Topology view by manually adjusting the browser URL to include a "sprites" query parameter. We hope to provide a more user-friendly mechanism (directly through the GUI) in some future release.
JSON Sprite Definition File
The sprites to load into the sprite layer of the topology view are defined in an external file.
File Format
The general format of the JSON is as follows:
{ "defn_name": "sprite_layer_id", "defn_desc": "Brief One-Line description of sprite layer", "paths": [ { ... path defn 1 ... }, { ... path defn 2 ... }, ... ], "defn": [ { ... sprite defn 1 ... }, { ... sprite defn 2 ... }, ... ], "load": { "sprites": [ { ... sprite instance 1 ... }, { ... sprite instance 2 ... }, { ... sprite instance 3 ... }, ... ], "labels": [ { ... label instance 1 ... }, { ... label instance 2 ... }, ... ] } }
File Identification
The definition file identity
Path Definitions
The paths
Sprite Definitions
The sprites
Load Definition
The sprite instances and label instances..
Sample Files
Sample sprite definition files can be found in the source code repository under the onos-web bundle:
onos-web:~/gui/src/main/webapp/data/sprites