EarthWorX Basics, Tips & Tricks

22nd February 2016

Article Introduction

 In this blog we are going to take a look at the EarthWorX module, which we are beginning to see many of our customers use within new projects and existing systems, in order to provide geospatial displays. For those with more experience, it may seem easy to drop an EarthWorX control into GraphWorX64 and then overlay objects on top and get going, although this does not always have the desired effect, for example, when zooming objects also zoom and cover the entire screen, EarthWorX display shows a whole world view when launched, instead of the desired view. This article will briefly run through some general tips and initial steps to take when using EarthWorX.

 

EarthWorX_Population2_4.png

 

Article Content

Tip 1 Display settings

If you plan to use EarthWorX in GraphWorX64, the first thing you will need to make sure of is that the display layout is set to Canvas. The easiest way to do this is to select File > New Settings… in GraphWorX64 and ensure that the Advanced settings are set as follows in the New Display dialog:

Scale = Fixed (if set as Scalable, then zoom is negated within the display)
Stretch = Uniform (Uniform preserves aspect ratio of display content)
Layout = Canvas

EarthWorx Article image 1.png

Selecting OK on the New Display dialog at this point will setup an empty GraphWorX64 display with the selected settings. At this point you can add an EarthWorX control to the display. When the control is added, it is recommended to select ‘Yes’ at the message regarding changing the display dimensions to 512x512.

Tip 2 Set a Default Region

One step that most forget is to set a Default Region on the EarthWorX map, which in most cases causes some pain later on if not set initially. The reason for doing this is twofold:
1.    It creates the default Home view which is used when the EarthWorX display is loaded
2.    It provides a 100% zoom level on which objects can be added too. Without this, objects would appear at whichever zoom level you were at e.g. imagine an ellipse added to a display but at a zoom level of 3000%, this would cover the entire screen
This is set using the Default Region option on the EarthWorX Configuration ribbon within GraphWorX64. There are two options to choose from, ‘Set Default Starting Region’ and ‘Set Default Starting Region and Clip display’. My personal preference is to use the former as clipping the display removes all content from outside of the Default Region area.
Version v10.90 GENESIS64 now provides the ability to preview the Default Region before setting which comes in very handy.

EarthWorx Article image 2.png

Tip 3 EarthWorX Pin or Native GraphWorX64 Object

EarthWorX provides native Pushpins which can be used on EarthWorX maps which are very quick and handy to use when representing very simple objects on a map e.g. representing the location of a site or asset which is selectable to trigger a desired pick action.
If choosing to use a Pushpin it is recommended to do the following:
1.    Add the Pushpins to the map prior to setting a Default Region at 100% zoom level
2.    It is recommended to add each individual Pushpin to its own group (select Pushpin and press CTRL+ g). This is not essential when Pushpins are positioned using constant longitude and latitude values but is required if you use dynamic tags to set longitude and latitude values in the future
3.    Always set the correct Horizontal and Vertical alignment for the pushpin. If you have followed steps 1 and 2 above, then this should be set on the Group Properties of the Pushpin. The alignment you choose should be based on style of Pushpin selected e.g. if you select the standard Pushpin as shown in Figure 3, then you would set HorizontalAlignment = Left and VerticalAlignment = Bottom as in this case you would want the bottom, left of the pushpin to be aligned where the pin point is on the map

EarthWorx Article image 3.png

If a dynamic object is required e.g. an object which changes colour depending on an input or an object which displays multiple pieces of information, then native objects or symbols would be best used here.
If selecting to use a native object or Symbol, follow the same recommended settings as above for a Pushpin with the following additional step:

1.    Add a Layer to GraphWorX64 and move the native object or Symbol into that layer. You will also want to set the Layers NoZoom property to True.

This will ensure that the native object or Symbol will remain the same size as the map is zoomed in.

Conclusion

EarthWorX is a great way to create geospatial displays or provide an alternative navigational or summarised view to your solution. Following the steps outlined within this article should provide you with a good foundation to build on when using EarthWorX for the first time and can be used as a refresher for existing users of EarthWorX.
Further information on EarthWorX can be found through the Customer Connection Portal https://getconnected.iconics.com.