Involves placing one image on top of another, usually a base image or map, with the overlay often containing additional information or highlighting specific areas. Useful in GIS applications, or data visualization over geographic maps.
Inputs
The Image Overlay node has mandatory inputs. These are:
Input |
Requirement |
Comments |
Areas - Location |
Mandatory |
This is the location of the field that is being displayed on the uploaded image |
Areas - Data Field Name |
Mandatory |
This is the field name within the incoming JSON payload that contains the data to be displayed on the widget. |
Functionality
The Image Overlay node is used to show data with a user-uploaded image as the background.
Outputs
The data value shown on the image at a location specified by the user.
How to Use
Implementation
In the Rayven Workflow Builder:
- Select Visualizations.
- Drag the Image Overlay node to the canvas.
- Connect the TImage Overlay node to your input node.
- Double click on the Image Overlay node to open the configuration window.
Configuration
Section: General |
||
This section contains basic configuration elements required for any Image Overlay implementation |
||
Field |
Requirement |
Comments |
Widget Name |
Mandatory |
Enter a name for this node. This provides a handle to which you and others can refer, so it should be simple but meaningful and explain the node’s purpose. |
Widget Header |
Mandatory |
Ability to show or hide the widget’s header. |
Device Name |
Optional |
Select this option if the device name should be shown to the dashboard viewer. |
Background Color |
Optional |
Ability to select desired colors as the image overlay’s background color. |
Edit Overlay |
Mandatory |
Ability to upload an image, add objects and textbox. Every object and textbox has their own unique SVG_ID. The SVG_ID will be shown on the right hand side of the edit overlay pop up when an object is created. |
Widget Subtitle |
Optional |
Enter a subtitle for this node. This provides additional information to the end user regarding the information displayed on this node. |
Decimal Precision |
Optional |
Enter a numerical value to set the decimal precision of the information displayed. |
Section: Areas |
||
This section is where the user can configure the list of fields to be displayed on the dashboard and the location of the field on the uploaded image. |
||
Field |
Requirement |
Comments |
Area Name |
Optional |
Enter a name to be shown on the tooltip message when hovered over the object or text box that is overlaid on the image. Note: There should not be any spacing in this field. |
Text |
Optional |
Select an option from the dropdown menu:
|
Input Data Field |
Optional |
This is the field name within the incoming JSON payload that contains the data to be displayed on the objects overlaid on the image. |
SVG ID |
Mandatory |
A unique ID that allows users to tie a value to an object that is overlaid on the image. |
Decimals |
Optional |
Enter the number of decimal places to display on the dashboard. |
Pre Symbol |
Optional |
Enter a symbol that will be displayed at the beginning of the value. |
Post Symbol |
Optional |
Enter a symbol that will be displayed at the end of the value. |
Thousands Comma |
Optional |
Select an option from the dropdown menu:
|
Dashboard to Link to |
Optional |
Drop down list to select a configured dashboard to link to. |
Section: Tooltip Info |
||
Field |
Requirement |
Comments |
Show Tooltip |
Optional |
When checked, it allows users to display their tooltip text on the widget. |
Tooltip Text |
Optional |
This section only exists when “Show Tooltip” is checked. Users are able to write any tooltip message they desire which will be display on the widget. |
Section: Group by Device Label |
||
Field |
Requirement |
Comments |
Device label name |
Mandatory |
There are no labels available in this box until you have saved at least one in the Device Labels section of the Workspace. Select a Label to use to filter devices. |
Grouped |
Mandatory |
Select a method for grouping the widget on the dashboard from the dropdown: No Grouping (widget per device): one widget will appear for each device Group by device label value (Widget per label value): One widget will appear for each value of a label. For example, if the Label is ‘Color’ and there are the values ‘Green’ and ‘Gold’, then two widgets will be displayed, one with devices with Color Label equal to “Green” and one with devices with Color Label equal to “Gold” Group by device label name (One widget): Only one widget will be displayed and this will contain data from all devices. |
Steps by Steps Section
- Open the configuration window by double clicking the image overlay node in the workflow.
- Click on “Edit Overlay” on the pop-up window. You will see another pop up window as shown below.
- In this pop-up window, you are able to upload a photo or display your own creativity by drawing.
- This canvas will allow you to receive data from your data source and display on the Rayven’s dashboard.
- To upload a background image for your image overlay node, click on “File” and select “Image”.
- After uploading your desired photo as the background, you are able to create different shapes simply by choosing one of the icons on the left-hand side bar.
- After creating your box, you can add a Text box to the image overlay by clicking on “T” on the left-hand side of the bar.
- If you wish to display your data from your data source, you can create a text box and give it any name. Grab the Element Details ID (svg_5 in the photo above).
- Click on File, select “Save & Close” or you can use your keyboard shortcuts (ctrl + s).
- Click on the “Areas” section.
- Give your area a name, please note that there should be no spaces.
- Provide your input data field from the data source or the workflow.
- Provide the SVG ID from the Element Details ID.
- Once that’s done, you can save the configuration and make sure your node is connected. You will be able to see data display on the image overlay widget on the dashboard when it receives data.