Viz World User Guide

Version 17.0 | Published March 11, 2019 ©

Tools

This section contains information on the following topics:

Map Editor Toolbar

The Map Editor has the following toolbars:

Horizontal Toolbar

images/download/attachments/29301242/editor_toolbar-top-client.png
The horizontal toolbar contains the following options:

  • images/download/attachments/29301242/editor_toolbar-top-client-save-favorites-icon.png Save Favorites: Save current project as a favorite project. Unlike projects which only contain the base map styling, a Favorite is a project which also has data saved as part of it, such as selected countries, loaded streets, and labels.

    Note: User favorites will not be synchronized across servers when working with server allocator. When working with multiple servers, synchronizing user favorites can be done as an automated process of replicating the relevant folders. User favorites are stored by default under C:\Program Files\Vizrt\Viz World\Users\Default\Favorites.

  • images/download/attachments/29301242/editor_toolbar-top-client-open-favorites-icon.png Open Favorite: Open a favorite project.

  • images/download/attachments/29301242/editor_toolbar-top-client-open-project-icon.png Open Project: Open existing map template files.

  • images/download/attachments/29301242/editor_toolbar-top-client-undo-icon.png Undo: Undo last change

  • images/download/attachments/29301242/editor_toolbar-top-client-redo-icon.png Redo: Redo last change

  • images/download/attachments/29301242/editor_toolbar-top-client-clipboard-icon.png Copy Map to Clipboard:

    • Click the icon to copy the current map view, and its details, to a clipboard that can be used later on when reopening World Map Editor.

    • Select a previously copied map from the dropdown. The clipboard is a local list, for the currently active directory.

    • Delete an item from the clipboard list by right clicking an item and selecting Delete from the context menu.

  • Search: Search the map.

  • Select stylesheet: Select one of the template’s available stylesheets.
    If the stylesheet uses either Digital Globe or Microsoft Bing, an additional dropdown will allow you to select the profile of imagery to use from the provider. The different Profiles provide a different imagery set for the same location.
    images/download/attachments/29301242/editor_toolbar-top-stylesheet.png

    Note:+Vivid provides a set of seamless tiles of imagery for every level, however some images may not be the most recent imagery. The +Vivid option on Digital Globe is a paid subscription, contact your local Vizrt Sales representative if you require a license.

  • images/download/attachments/29301242/editor_toolbar-top-client-notification-icon.png Notifications: Displays notifications of errors.

  • images/download/attachments/29301242/editor_toolbar-top-client-settings-icon.png Settings: Change the Settings (Viz World Server, Language, Map Legend, Safe Guide)

  • images/download/attachments/29301242/editor_toolbar-top-client-info-icon.png Information: Displays version information about the Viz World Client and Server.

Vertical Toolbar

images/download/attachments/29301242/editor_toolbar-left-client.png
The vertical toolbar contains the following options:

  • images/download/attachments/29301242/editor_toolbar-left-client-layers-icon.png Layers: Enables you to search for and filter features based on the current map Layers in view.

  • images/download/attachments/29301242/editor_toolbar-left-client-details-icon.png Details: Shows the Details for all selected features. Right-clicking the button will open a context menu that allows you to fit to, center to or clear all details.

  • images/download/attachments/29301242/editor_toolbar-left-client-pan-icon.png Pan: Enables the user to click and drag on the map to move the map in the direction of the drag.

  • images/download/attachments/29301242/editor_toolbar-left-client-zoom-icon.png Zoom: Zooms the map according to the area selected. To select an area, click and drag to draw a rectangle.

  • images/download/attachments/29301242/editor_toolbar-left-client-shapes-icon.png Shapes tool: Opens the Shapes Tool. Right-clicking the button will open a context menu that allows you to select the shape.

  • images/download/attachments/29301242/editor_toolbar-left-client-streets-icon.png Streets tool: Opens the Streets Tool.

  • images/download/attachments/29301242/editor_toolbar-left-client-inverse-icon.png Inverse Colors: Toggle the color of the map legend and map features (countries, cities, etc.) See Settings for how to enable/disable the map legend.

  • images/download/attachments/29301242/editor_toolbar-left-client-features-icon.png Show/Hide Features on Map: Click the button to show or hide the selected map features. Click the arrow to select which map features to show. See Show or Hide Map Features.

Quick Map Toolbar

images/download/attachments/29301242/editor_quick-map-toolbar.png
Use this to access the Quick Map features.

Locator and Preview Tabs

images/download/attachments/29301242/editor_locator-preview-l-tab.png
Use this to access the Locator and Preview features.

Settings

images/download/attachments/29301242/editor_settings-options.png

  • Server: Set the Viz World Server hostname. If not specified, the Map Editor will connect to localhost.

  • Language: Select from the available map languages. See Map Name Editor for information on how to configure the languages.

  • Map Legend: Enable or disable the map legend.

  • Safe Guide: Enable or disable a safety area around the map (e.g. for text safety)

Layers

Places

images/download/attachments/29301242/editor_layers-map.png
Enables you to search for and filter features based on the current map layer in view. You can also sort based on Country, Name, and Type.

Streets

images/download/attachments/29301242/editor_layers-streets.png
This tab allows users to load street data by clicking Select Streets to Load, and using the Extra Data Manager, as well as add items to the map using the Extra Data Browser.

The roads in the visible map can be loaded into the list by clicking Load Visible Streets.

Shapefile

images/download/attachments/29301242/editor_layers-shapefile.png
This tab is to allow users to load Extra data such as Shape files.

KML

images/download/attachments/29301242/editor_layers-kml.png
The KML Manager lets you load Keyhole Markup Language (KML) files which can then be added to the map. The KML file can be uploaded from the Viz World Server or opened from a local file.

  • Load:Load a file from the Viz World Server. Clicking the Load button, opens the KML Browser and lists all the available KML files. It works the same way as the Extra Data Browser.

  • Open:Open a file from the file system, but do not copy it to the Viz World Server

  • Upload File: Open a file from the file system and copy to the Viz World Server

    Note: If the KML file includes a camera position, then the map will zoom to that position, otherwise the map will focus on all of the data found in the file.

    KML files can also be manually imported into the server, and must be placed in the following folders:

  • 32 bit:

    • C:\ProgramData\Curious Software\Curious World Maps\KML

    • C:\ProgramData\Curious Software\Curious World Maps\Users\Default\KML

  • 64 bit:

    • C:\ProgramData\vizrt\Viz World\KML

    • C:\ProgramData\vizrt\Viz World\Users\Default\KML
      Any files uploaded from the client will be stored in this same location.

First Look

images/download/attachments/29301242/editor_layers-events.png
The events tab is a feed of events from Digital Globe’s FirstLook service.

FirstLook provides rapid imagery of major global events, such as:

  • Natural disasters: Earthquakes, fires, tornados, hurricanes

  • Man-made crisis: Terrorism, large accidents

  • Political instability: Riots, civil war

  • Human interest: World Cup, Olympics, F1, NFL

It requires a yearly license to use the imagery.

Extra Data Manager

The Extra Data Manager is available from the Layers Tool and allows users to manage extra data that is stored on the Viz World Server.

Note: In order to work with Extra Data, the Viz World Server must have data loaded.

Note: Streets data requires additional license features and the installation of street data on the server.

Using Extra Data

  1. In the Layers tool, click on the Streets tab, to open the Extra Data Browser. (this will be empty if no data has been selected).

    images/download/attachments/29301242/editor_extra-data-load-streets.png
  2. Click on Load Streets to open the Extra Data Manger.

  3. Navigate to the required data and use the Add, Fit and Centre buttons to select the data and/or move the map.
    Close the Extra Data Manager when finished.

  4. Open the Extra Data Browser again to see all the loaded data and add features which are related to the loaded data.

  5. Data can be deselected either from within the Extra Data Manager or the Extra Data Browser, using the ‘X’ button.

Extra Data Manager

In the Extra Data Manager, the view can be switched between Flat List view and Tree view, using the buttons at the bottom of the window.

The Flat List view presents the data in a flat structure with a navigation bar at the top. To navigate in the data, double-click an item in the list to open it, or use the drop-down menus. In this case, the Filter only filters the content of the current directory.

The Tree view presents the data in a hierarchical structure. To navigate in the data, double-click an item in the list. The Filter filters the whole tree and lets you navigate within the results using Enter and Shift+Enter keys or the ‘^’ and ‘v’ buttons.

images/download/attachments/29301242/editor_extra-data-flat-list.png
images/download/attachments/29301242/editor_extra-data-tree.png

Extra Data Browser

The Extra Data Browser displays all the loaded data and can be used to add features which are related to the loaded data.

images/download/attachments/29301242/editor_extra-data-browser.png

Details

images/download/attachments/29301242/editor_details-view.png
The Details view allows you to edit the name and appearance of details. Changes can be made to multiple details by selecting them together. The details in the list can be reordered by dragging them, or easily hidden from the map.

Custom styles and style families can be created in the Map Designer using the Style Editor. These styles will then be available in the Editor.

The icon used for each detail can be changed by selecting the detail in the list and browsing for a new icon in the list of icons.

Details can be sorted alphabetically using the images/download/attachments/29301242/editor_details-sort-buttons.png buttons.

images/download/attachments/29301242/editor_details-sort.png
Show/hide each detail, without removing it from the list, by clicking the images/download/attachments/29301242/editor_details-eye-icon.png icon. When a detail is hidden, it is not rendered in the scene.

images/download/attachments/29301242/editor_edit-single-detail.png
Clicking the Edit button next to each item in the Details list allows editing the following features:

  • All Caps: Caps on or off

  • Add to Database: New name alternatives (e.g. language specific) can be saved to the database

  • Label Location: Adjust the location of the detail’s label.

    images/download/attachments/29301242/editor_edit-multiple-details.png

    The context menu provides the following options:

  • Fit to details: Fits the map according to the selected details

  • Center to details: Centers the current view according to the selected details

  • Remove details: Removes all selected details

  • Clear all details: Removes all details regardless of selection

    Note: If the default style defined in the server is not available in the scene designs, then the first design which is available in that scene will be used.

Shapes Tool

images/download/attachments/29301242/editor_shapes-tool-button.png
The Shape Tool lets users draw shapes on the map.

Context Menu

A right-click or a long left-click on the Shapes Tool icon will present a context menu with the following options:

  • Spline Shape: Draw segments of a smoothed, curved line. It can be closed or open. Double click to finish drawing.

  • Linear Shape: Draw straight-line segments. It can be closed or open. Double click to finish drawing.

  • Closed Shape: The shape drawn is closed, i.e. the first and last points drawn will be joined.

  • Fill Shape: The shape will be filled. Forces the shape to be closed.

  • Circle / Ellipse / Rectangle: Select a geometric shape. If none are selected, the tool will default to drawing a spline or linear shape.

Edit Mode

images/download/attachments/29301242/editor_shapes-tool-toolbar.png
When the Shapes Tool icon is selected, clicking on an existing shape will present the Shapes toolbar:

  • Lock/unlock the handles (only relevant to spline shapes): Allows the shape to be modified more flexibly.

  • Remove the shape from the map.

  • Fit the map to shape.

  • Center the map on shape.

  • Convert shape to spline/linear (not relevant to geometric shapes).

  • Make shape closed/open (only relevant to lines).

  • Fill the shape with color.

  • Change the shape style (for example an ellipse can be a Region or a Country). Note that this may affect the appearance in Viz Artist scenes.

Shortcut keys

When a shape is in edit mode, the following shortcuts keys are available:

  • DELETE key deletes the shape.

  • * (asterisk) key centers the map on the shape.

At any time, pressing the D key will activate the Shape Tool. When the D key is released, the previously active tool will become active and the shape will be submitted to the Server.

To add a shape to the map

  1. Click on the Shapes Tool icon to activate it.

  2. Right-click on the Shapes Tool icon. A context menu will appear.

  3. Select the kind of shape to draw, for example an ellipse.

  4. Drag on the map to create a shape. When the mouse button is released, the shape is submitted to the Viz World Server.

To edit an existing shape

  1. Click on the Shapes Tool icon to activate it.

  2. Click on the shape you want to edit. A toolbar will appear next to the shape.

  3. Use the Shape Tool to modify the shape.

Streets Tool

images/download/attachments/29301242/editor_streets-tool-icon.png
The Streets Tool can be used to add streets or segments of streets. It uses the data that has been added by the Extra Data Manager.

When the Streets Tool is activated, a red dot will appear when the mouse is hovered over a street. Clicking on the red dot brings up the Streets Tool menu bar.

images/download/attachments/29301242/editor_streets-toolbar.png
The Streets Tool menu bar contains:

  • Add Segment: Allows the user to add segments of the street. Each click on the map adds a segment. Double-click to finish the operation and submit the shape to the Server.

  • Add Street: Add the selected street to the map.

  • Label Street: Add just the label without the line.

  • Fit the map to the street.

  • Center the map on the street.

Once a street is added to the map, the user can edit it using the Shapes Tool.

images/download/attachments/29301242/editor_streets-tool-edit-shape.png

Show or Hide Map Features

images/download/attachments/29301242/editor_show-hide-features.png
The Show/Hide Map Features button toggles the features on and off. If they are on, a summary of features is also displayed.

images/download/attachments/29301242/editor_map-features-select.png
To configure which features will be displayed, click the arrow and select which map features to show.

To modify a feature, you can also hover over the feature on the map to display the tool bar.

images/download/attachments/29301242/editor_map-features-name-hover.png

Note: You can also show or hide individual details, using the Details tool.

Quick Map

images/download/attachments/29301242/editor_quick-map-nsw.png
The Quick Map toolbar allows quick navigation to regions, countries and cities. It works together with the Locator tab to identify the location of the map segment which is currently displayed in the Map Editor window.

  • Q: Click on the Q icon to filter the drop-down lists and configure which features will be listed in them.

  • Globe: Provides quick access to regions of the world, for example, Asia, Middle East, Europe.

  • World drop-down: Select a country

  • Country drop-down: Select a State or City

  • Click on the drop-down headings (e.g. World or Australia) to zoom to the corresponding level (i.e. world or country).

  • Type in the text field to search for countries, regions or sub-regions.

Locator and Preview

images/download/attachments/29301242/editor_locator-preview-l-map.png
The Locator-Preview tabs display the following information:

Locator

  • Select an area and the map will zoom to that location

Preview

  • If the Map Editor was opened from Viz Artist, Viz Trio or Viz Pilot, the Preview tab will generate a snapshot of the Viz Scene. For Viz Pilot it will only work if a preview server is configured.

    Note: The Preview Server URI must include the http prefix (e.g http://localhost:54000). In Viz Pilot 5.7.x and earlier, check the setting in VizPilot under Options > Preferences > Advanced > preview_server_uri. In Viz Pilot 6.0 or later, check the setting in the Data Server under Settings > VCP Parameters > preview_server_uri. For more information see the section ‘To give applications access to the Preview Server’ in the Viz Pilot User Guide.

Preset Editor

  • Right click on the Locator to display a list of predefined regions.

    images/download/attachments/29301242/editor_preset-editor-menu.png
  • Add your own presets to this list by right-clicking and selecting Add Current View as Preset. Then enter a name for the preset.

    images/download/attachments/29301242/editor_preset-editor-new.png
  • Edit your presets by right-clicking and selecting Edit Presets. In the window that appears, you can rename, reorder, delete, or duplicate the custom list.

    images/download/attachments/29301242/editor_preset-editor-edit.png

Multihop Editor

The Multihop Editor allows users to control the number of hops on a template. For example, if a scene was designed with 2 hops, the user in Viz Trio would be able to add up to 30 hops.

Enable the Multihop Editor

The Multihop Editor is hidden by default, but can be enabled in the following ways:

  • If a scene contains a Control Multihop plugin, then when the World Map Editor is opened from Viz Trio or Viz Pilot, it will include the Multihop Editor.

  • When a scene in Viz Artist contains the Hops Manager plugin, then pressing the Multihop button will open the World Map Editor, including the Multihop Editor.

Using the Multihop Editor

Once enabled, the Multihop Editor appears on the right-hand side of the World Map Editor, and shows all the hops that are defined. The hops can be reordered by dragging them to the desired place in the list.

images/download/attachments/29301242/editor_multihop-editor1.png

Multihop Editing Options

images/download/attachments/29301242/editor_multihop-editor2.png
A context menu on the Multihop Editor displays the following options:

  • Cut, Copy, Paste, Duplicate or Remove items in the list.

  • Change Style: Select one or more hops and change their style. The change will ONLY apply to the selected hops.
    images/download/attachments/29301242/editor_multihop-styles.png

    Note: To change the style of ALL hops, use the Select stylesheet button in the Horizontal Toolbar.

  • Change Project: Select one or more hops and select a new map template file for these hops. The change will ONLY apply to the selected hops.

    Note: To change the project of ALL hops, use the Open Project button in the Horizontal Toolbar.