GML Editor Help

Quick Reference

Editor Operation User Action
Zoom In CTRL and click on area
Zoom Out CTRL + SHIFT and click in area
Pan ALT + click and drag map
Selecting points Click left button and drag area to highlight
Selecting single point Click left button close to point
Adding points to selected group Hold SHIFT while selecting points
Deleting points Select points and press 'd'
Adding points Select two adjacent points and press 'a'
Retrieving feature information Doubleclick on a point in the feature
Edit feature information Doubleclick on the value to edit

Zooming and navigating the map

All these functions use the internal zoom and panning features present in the Adobe SVG Plugin v3.0.

Zoom in

To zoom in the map, press the CTRL-key and drag the cursor to highlight the area you want to magnify. You may also press the right mouse button and select 'Zoom In' from the menu.

Zoom out

To unzoom the map, press the CTRL-key together with the SHIFT-key. The cursor will change into a magnifying glass and you may now just click somewhere in the map to zoom out. You may also press the right mouse button and select 'Zoom Out' from the menu.

Moving the current viewpoint

To move the current viewport (pan), press the left ALT-key to change the cursor into a hand. While keeping the ALT-key pressed down, press the left mouse button and drag the map in the plugin.

You may also navigate in the map by moving (by clicking it and then moving the mouse) the highlighted area in the Navigator window.

Original view

There is currently no support for restoring the view to the one presented at startup.

Selecting points

Before manipulating the map, you'll need to select at least one point. This can be done in several ways.

Selection by highlighting area

The easiest way to select a group of point, is simply by left-clicking somewhere in the map and highlighting the area you want to select the points from. This can be seen in Figure 1.
help-draggingforpoints.jpg

Figure 1: Selection of Points by Highlighting an Area

After you've highlighted the area you want to select the points from, the SVG application will search the given area for points that are present. These points will then be highlighted with a larger, filled circle. If your selection seems like a large cluster of points, it is recommended that you zoom in closer to the points themselves. The result from the previous operation is shown in Figure 2.
help-foundpoints.jpg

Figure 2: The Points Selected From the Previous Highlighting

Selection by selecting single point

To select a single point in the map, just double click close to it's location. The application currently searches the space that is covered by extending an rectangle 0.7% of the total width (of the application) from your current cursor position. If there are several points inside the generated square, all of them will be selected. Please zoom closer in on the point if this poses a problem.

Adding points to the current selection

To add points to an already selected cluster, you may use any of the previously mentioned techniques while holding down the SHIFT-key. This will cause the newly selected points to be added to the cluster for previously selected points instead of selecting a whole new range.

Removing points from the current selection

To remove a point from the selected cluser of points, simply click the already selected point while holding down the SHIFT-key. The point should now be de-selected.

Manipulating points

The editor currently supports three ways to manipulate the structure of the geometric features in the map. In addition it also supports editing the properties of a given point or feature. This will be covered in the next section.

Moving a point (or a group of points)

The main operation (and default) is to be able to move the selected group of points. After selecting a cluster like described in the previous section, simply left-click on one of the selected points and while keeping the button pressed, simply move your mouse to drag the group of points around. If the total number of points currently selected is less than five, the map will be updated in real-time while you move the points around. In the case of more than five selected points, the lines that connected the points will not be visible while moving the points around.

Deleting a point (or a group of points)

To delete a set of points, press 'd' on your keyboard after selecting the points you wish to delete.

Adding a point

To add a point, you'll have to select two points which are connected by a line. Pressing 'a' on the keyboard will cause the line connecting the two points be split into two lines with a new point connecting the previous points.

Feature info

In addition to editing the geographic data of the features, the editor is also capable of display and editing feature properties.

Retrieving the feature information

To show the information assigned to a given feature, simply select a point in the feature (by clicking it with the left mouse button) and double click it to show the feature information window. The currently selected feature will also be highlighted in the background map. The window may be moved by simply dragging it to a new location by clicking (and holding) the title bar of the window. To close the window, simply click the 'x' in the upper right corner.

Editing the feature properties

To edit a given feature property, double click on the value you want to change. You may change the name of the property, the type of the property and the value of the property. In the current version, the editor will pop up a javascript input box where the user may make his or hers changes. After changing the information (and pressing 'ok'), the internal structure will be immediately updated to reflect the changes.

Scaling the property window

If for any reason there is a problem with reading the contents of the feature properties window, you may resize all the columns in the window. It is currently not possible to resize the window itself. In the case of long values or a large number of name / value-pairs, the scrollbars will be enabled as needed.

The layer window

The layer window (see Figure 3) contains information about the different layers in the current map. Conceptually these layers may be old data, new data or different types of data (roads, coastline etc). In the current example these are labeled "old" and "new".

Displaying the Bounding Box

While the cursor is hovering over one of the layers in the window, the main editor window will display the bounding box of the currently selected layer. This illustrates which area is covered by a given layer quite nicely.

Hiding and showing the layer

To hide or show a layer, simply click the 'Eye'-icon for the layer you want to hide or show in the layer window. When a layer is hidden, the 'Eye'-icon will have a red cross covering it.

Locking a layer

You may also 'lock' a layer (the source that provides the data to the editor may also define a layer as "not editable"), so that it becomes not editable. In the default mode, the old layer is locked since there is no point in editing the old data. You may use this function to simplify the process of editing several layers that are placed on top of each other.

The history window

Undoing changes

To undo an earlier operation, all actions between the operation to be cancelled and the current state must be rolled back. This is illustrated by greying out the actions that has to be rolled back to reach the current state. When moving back in the history window, the map will be updated real time to the state at that current time. You may then choose to just continue your work on the map or to select a new spot in the history.

Redoing changes

If you somehow moved to far back in history (and that you didn't change anything after doing that), the actions that took place after the current state should still be greyed out in the history window. By selecting one of the later actions, the state will be rolled ahead to the selected position.

The navigator window