VASCO Framework Editor User Manual
Below you will find brief information for DMU Editor, Security Editor. This manual provides comprehensive guidance on using the DMU Editor for project and layer management, world exploration, and publishing, alongside the Security Editor's virtual entity and building management features.
Advertisement
Advertisement
VASCO F
RAMEWORK
U
SER
M
ANUAL
Public
Abstract
This document contains the user manual of the DMU Editor and the Security Editor.
Copyright by the VASCO consortium, 2014-2017
VASCO is a project that has received funding from the European Union’s Seventh Framework Programme for research, technological development and demonstration under grant agreement no. 607737. Please see http://vasco.diginext.fr
for more information.
DISCLAIMER: This document contains material, which is the copyright of the VASCO consortium members and the European Commission, and may not be reproduced or copied without permission, except as mandated by the European Commission Grant Agreement no.
607737 for reviewing and dissemination purposes.
The information contained in this document is provided by the copyright holders "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the members of the VASCO collaboration, including the copyright holders, or the European Commission be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of the information contained in this document, even if advised of the possibility of such damage.
VASCO
VASCO Framework Final Release
Contents
Grant Agreement 607737
PUBLIC
Page 1
VASCO
VASCO Framework Final Release
Grant Agreement 607737
PUBLIC
Page 2
VASCO
1 DMU Editor
1.1 Manage your project
1.1.1 Project wizard
VASCO Framework Final Release
This interface appears when the application is launched or a project closed. It allows to:
Create a new project
Open an existing project
Import an archived project
1.1.2 Project toolbar
The Tool bar's menu provides the same actions as the wizard and adds the following:
Save the current project
Close the current project
Export the current project
.
Grant Agreement 607737
Saving confirmation
PUBLIC
Page 3
VASCO
1.1.3 Creating a project
VASCO Framework Final Release
Create a project
It's possible to create a project by clicking on the Create button in the project wizard or by selecting Create
Project... in the tool bar menu. Pressing the Ctrl + N keys has the same effect.
Project creation assistant
Grant Agreement 607737
Project creation assistant
PUBLIC
Page 4
VASCO
VASCO Framework Final Release
Project creation assistant
Select the project name, folder, and projection.
The folder should exist but not the project to purchase.
This action creates an empty project. For Geographical projection, a default raster is displayed.
1.1.4 Opening a project
Opening a project
It's possible to open a project by clicking on the Open button on the project wizard or by selecting Open
Project... in the tool bar menu. Pressing the Ctrl + O keys has the same effect.
Grant Agreement 607737
Project opening assistant
PUBLIC
Page 5
VASCO
VASCO Framework Final Release
Click on the browse button to display a file explorer and select a DMU Project (*.vgeo) files or select a project in the recent list. The project’s URL is displayed and can be modified. The project’s file should exist to purchase.
A double-click on a recent project, already existing, opens it.
1.1.5 Saving a project
Saving a project
It's possible to save the current project by selecting Save Project in the tool bar's menu. Pressing the Ctrl +
S keys has the same effect.
1.1.6 Closing a project
Closing a project
It's possible to close the current project by selecting Close Project in the tool bar menu. As already mentioned, if the current project was modified since it has been opened, a message box will appear to ask for saving confirmation.
Grant Agreement 607737
PUBLIC
Page 6
VASCO
1.2 Manage your layers
1.2.1 Understanding layer type
VASCO Framework Final Release
Layer types
The Icons before each layer name illustrate the data type. The type list is:
Raster layer
Elevation layer
Value data
Point layer
Curve layer
Surface layer
Feature layer. A generic feature layer containing multiple element types.
VirtualGeo feature layer
KML files
GeoRSS layer
Sky layer
Cloud layer
Geo graticule layer or MGRS graticule layer
Relief map
Grant Agreement 607737
PUBLIC
Page 7
VASCO
1.2.2 Showing/hiding layers
VASCO Framework Final Release
Showing/hiding layers
Check the visibility box in the browser to show the layer in the 3D view. Uncheck the box to hide it.
1.2.3 Understanding layer status
Disabled layers
Layers that cannnot be displayed in the 3D view are disabled in the browser and cannnot be manipulated.
Grant Agreement 607737
PUBLIC
Page 8
VASCO
VASCO Framework Final Release
Data availability
The data availability is resumed in the second column of the browser.
No symbol means the layer reference data is inside of the project repository.
Means the layer reference data is outside of the project repository. Be careful when you move, share or export your project.
Means the layer reference is unavailable for data outside of the project repository.
Means the layer reference is network data. These data aren't available without internet connection.
Means the layer reference is unavailable for network data. Check your internet connection or the server’s availability.
Read-only data model
The last column of the browser indicates if the data model is editable or not. Only feature layers can have a model in read-only.
Grant Agreement 607737
PUBLIC
Page 9
VASCO
1.2.4 Understanding layer ranking
Layers in the browser respect the 3D view order.
VASCO Framework Final Release
Change layers ranking
It is possible to change this order by selecting Background layer on top on the preference dialog.
1.2.5 Zooming to layers
Zoom to layer
It is possible to zoom on the bound of a layer by selecting Zoom To Layer in the contextual layer menu.
A double-click on this layer has the same effect.
Grant Agreement 607737
PUBLIC
Page 10
VASCO
1.2.6 Adding layers
1.2.7 Data Tool Bar
VASCO Framework Final Release
Data tool bar
Layers can be added by using actions from the data tool bar. Some of them need an input file. In this case, a file explorer, that filters accepted formats, will assist you. A layer containing the selected file data will be created and added to the root of the layers’ browser. When a layer is created, the 3D view automatically navigates to the data bound.
1.2.8 Add Content to the Contextual Sub-Menu
The layer browser contextual menu provides the same actions as the data tool bar and the group creation.
The specificity of the layer browser actions is that created layers are added into the current group layer.
Grant Agreement 607737
PUBLIC
Page 11
VASCO
1.2.9 Drag and drop
VASCO Framework Final Release
Drag and drop
The final way to add layers is to drag and drop files into the layers browser or the 3D view. The mouse cursor has a special appearance to indicate if manipulation is possible and where the data will appear. The drag and drop has the following specificity:
A user interface appears, if needed, to solve ambiguity of layer type creation.
It's possible to drag and drop multiple files. By default, a unique layer containing all data will be created but it's also possible to create a layer for each file.
If the data isn't geo-referenced, it is added to the center of the screen in case of drop in the layer browser and at the release mouse position in case of drop in the 3D view.
In case of drag and drop into the layer browser, the mouse release position is used to determine the parent of the layer to create. If the layer under the drop position is a VirtualGeo Feature Layer and the dragged data can be read as features, they will be added into this layer.
Grant Agreement 607737
Drag and drop solve ambiguity
PUBLIC
Page 12
VASCO
1.2.10 From catalogue
VASCO Framework Final Release
Catalogue menu
A catalogue of pre-configured layers, sorted by publisher, can be displayed by clicking on Catalogue on the data tool bar. Click on a preview to add it.
Catalogue dialog
A dialog widget containing the same catalogue can be displayed by clicking Add Content and From
Catalogue ... on the contextual menu. Select a preview and click on the Add button to add the layer.
A double-click on a preview to have the same effect.
Grant Agreement 607737
PUBLIC
Page 13
VASCO
VASCO Framework Final Release
1.2.11 Group layers
Create groups from the layer contextual menu.
Group layers are useful to sort layers and show/hide multiple layers.
1.2.12 VirtualGeo layers
Create a VirtualGeo layer from the data tool bar, the layer contextual menu or by drag and drop.
VirtualGeo layers are raster, elevation, or data features optimized by VirtualGeo. Data are in a specific projection and tiled or spatialized as a pyramid. VirtualGeo layers can be loaded thanks to a local file access or over HTTP. Optimized layers have the .vrgis or the .voa extension.
1.2.13 Raster layers
Create raster layers from the data tool bar, the layer contextual menu or by .
VirtualGeo support GeoTiff (.tiff and .tiff), USRP/ASRP (.img), ERDAS ECW (.ecw) and JPEG 2000 (.jp2) format files.
1.2.14 Elevation layers
Create elevation layers from the data tool bar, the layer contextual menu or by drag and drop.
VirtualGeo support GeoTiff (.tiff and .tiff), DTED (.dt0, .dt1, .dt2, dt3, .dt4 and .dt5) format files.
1.2.15 Value layers
Create value layers from the data tool bar, the layer contextual menu or by drag and drop.
Value layers are useful to display scalar data. Supported format files are those of the elevation layer added to the GRIB (*.grb, *.grib2) format. A customizable colour map allows to assign a colour to display regarding the given scalar range.
1.2.16 Web service layers
A unique wizard helps the user establish a connection to Web Map Service (WMS), Web Map Tile Service
(WMTS), Web Feature Servie (WFS) or Georeferenced RSS stream (GeoRSS). This wizard isn't modal, meaning it can stay open throughout the entire session.
This wizard is available from the data tool bar or the layer contextual menu.
WMS
Server connection information
The first page of the wizard is used to set-up a server. Select an existing server or New Server... to define a new one. In this last case, an URL, the service type and version need to be entered. If the requested version isn't available, the default server version will be used. Click on the Next button to purchase.
Grant Agreement 607737
PUBLIC
Page 14
VASCO
VASCO Framework Final Release
Server capabilities
If the connection succeeds, a second page appears. This page resumes the server’s capabilities on the requested version. If the requested version isn't available, the default server version is used. On this page, it is possible to change the server’s name. In the future, this name will appear on the server’s configuration list on the first page of the wizard. Click on the Next button to purchase.
Grant Agreement 607737
PUBLIC
Page 15
VASCO
VASCO Framework Final Release
WMS layers properties
The third and final page lists the available WMS layers and their declined styles. This interface is divided into two parts:
The upper part allows selecting a layer or multiple styles on the same layer.
The bottom part allows defining the parameters.
Elevation data can be added as elevation or value layers.
Advanced parameters can also be selected such as the data projection and resolution, the image format and size and the invalid value for elevation data.
Click on the Add button to create a unique layer containing the selected data on the root of the browser.
WMTS
The WMTS connection interface is quite similar of the WMS for the two first pages.
Grant Agreement 607737
PUBLIC
Page 16
VASCO
VASCO Framework Final Release
WMTS layers properties
The third and final page lists the available WMTS layers. This interface is divided into two parts:
The upper part allows selecting a layer.
The bottom part allow defining the parameters:
Elevation data can be added as elevation or value layers.
Advanced parameters can also be selected such as the images size and the invalid value for elevation data.
Click on the Add button to create the layer containing the selected data on the root of the browser.
WFS
The WFS connection interface is quite similar to the WMS on the first two pages.
Grant Agreement 607737
PUBLIC
Page 17
VASCO
VASCO Framework Final Release
WFS layers properties
The third and final page lists the available WFS layers and their type. Select the desired data and click on the Add button to create a layer on the root of the browser.
1.2.17 Feature layers
Shapefiles
Load shapefiles from the data tool bar, the layer contextual menu or by drag and drop.
VirtualGeo support ESRI Shapefile (.shp), MapInfo TAB (.tab) and MapInfo Interchange Format (.mif) files format.
SQL databases
A wizard helps user to establish connection to PostgreSQL databases and SQLite (.sqlite) files. This wizard isn't modal, meaning it can stay open throughout the entire session.
This wizard is available from the data tool bar or the layer contextual menu.
Grant Agreement 607737
PUBLIC
Page 18
VASCO
VASCO Framework Final Release
SQLite file connection PostgreSQL database connection
The first page of the wizard is used to define the database. Click on the Next button to purchase.
Connect SQLite file
If the connection succeeds , a second page appears. It lists the available feature tables and types. Select
one or more tables and click on the Add button to create a feature layer on the root of the browser for each selected table.
Projection selection
If a selected table does not have projection information, this interface appears. Select the data projection and click on the OK button.
GPX, GML and KML
Load GPX, GML and KML files from the data tool bar, the layer contextual menu or by drag and drop.
Grant Agreement 607737
PUBLIC
Page 19
VASCO
VASCO Framework Final Release
VirtualGeo supports Keyhole Markup Language (.kml), Geography Markup Language (.gml) and GPS eXchange Format (.gpx) format files. KML data can be loaded thanks to a local file access or over HTTP.
1.2.18 Special layers
VirtualGeo Feature Layer
Create a VirtualGeo feature layer from the data tool bar, the layer contextual menu or by drag and drop.
A VirtualGeo feature layer is a feature layer whose model (position, geometry, ...) isn't in read-only. So, this layer allows feature creation, suppression, and edition.
Sky layer
Create a sky layer from the data tool bar, the layer contextual menu.
A sky layer is useful to have realistic lighting based on the sun position. Only one sky layer can be created.
Cloud layer
Create a cloud layer from the data tool bar, the layer contextual menu.
VirtualGeo allows to create a unique cloud layer that can have a worldwide or a viewpoint located coverage.
Hypsometric layer
Create a relief map layer from the data tool bar, the layer contextual menu.
A relief map layer is useful to highlight the elevation. A customizable colour map allows applying the given colours to each elevation range.
Graticule layer
Create a Geo or MGRS graticule layer from the data tool bar, the layer contextual menu.
A graticule layer is useful for the visualization of geographic coordinate system grids. A geographical grid is available with latitude and longitude coordinates. A military grid reference system (MGRS) used by NATO is available. A unique Geo and MGRS graticule layer can be created.
1.2.19 Ordering layers
Ordering layers
Layers in the 3D view are displayed in the layer browser order (or in reverse given the ranking). Drag and drop rows in the browser to organised layers and manage overlapping. The mouse cursor will have special appearance to indicate accepted moving and the final position of the layer.
Grant Agreement 607737
PUBLIC
Page 20
VASCO
1.2.20 Removing layers
VASCO Framework Final Release
Removing layers
It is possible to remove a layer by selecting Remove Layer in the layer contextual menu. Selecting it in the browser and pressing the Suppr key has the same effect.
1.2.21 Renaming layers
Removing layers
It is possible to rename a layer by selecting Rename Layer in the layer contextual menu. Selecting it in the browser and pressing the F2 key has the same effect.
1.2.22 Configuring layers
A dock-widget on the right-part of the application is dedicated to layer configuration.
Grant Agreement 607737
PUBLIC
Page 21
VASCO
VASCO Framework Final Release
Edit layer properties
The layer configuration editor can be displayed by selecting Edit Layer Properties in the layer contextual menu. Once the layer editor is displayed, the component is automatically updated given the selected layer in the browser.
The layer configuration editor is split in multiple sections. The first one, common to all layer types, is used to display information. Others are specific for each layer type and will be described below.
Layer information
Grant Agreement 607737
PUBLIC
Page 22
VASCO
VASCO Framework Final Release
Layer information
This editor allows displaying, setting, and editing the layer information such as:
Name: The name of the layer. This name also appears on the browser.
Projection: The data projection. This value is not editable.
Abstract: A brief description of the layer. Abstract also appears on the tooltip on the browser.
URL: The URL of the layer..
QuickLook: A representative snapshot of the data.
Click on the folder button to select a file on the disk.
Click on the camera to take and use a snapshot of the 3D view.
Click on the magnifying glass to see the QuickLook in the original size if it's downscale in the editor.
Click on the cross to remove existing QuickLook.
Grant Agreement 607737
PUBLIC
Page 23
VASCO
VASCO Framework Final Release
Overwrite Quicklook
The QuickLook picture is automatically copied on the project’s repository. If one already exists, the previous interface will ask overwrite confirmation to the user.
Provider: Properties are listed bellow:
Name
Website
Logo: Network link are supported. Click on the preview to load a local file.
Copyright: For common reason, use (c), (r) and (tm) in the editor to display ©, ® and ™ into the Intelectual Property Right widget.
Overwrite Logo
The logo picture is automatically copied on the project’s repository. If one already exists, the following interface will ask overwrite confirmation to the user.
Properties: This part of the editor display the layer properties
Bound in source projection
Grant Agreement 607737
PUBLIC
Bound in view projection
Page 24
VASCO
VASCO Framework Final Release
Bound: Data bound can be displayed in its original view or in projection view
Group layers
The group layer editor only presents the information section where unavailable components such as properties are hidden.
Raster layers
Elevation layer editor
The raster layer editor is divided into two sections. The Information section and the Appearance section allow editing the following parameters:
Fading: Enabling or not the fading on this layer. Available if global fading is enabled.
Opacity: Play with the layer transparency. Opacity varies from 0 to 1.
Visibility mode: Play with the visibility mode to parameter the layer visibility range given his resolution or the distance to the ground.
Visibility range and blending: Play here with the two double sliders to set the layer’s visibility and blending (transparency transition) range. Move markers or double click on them to enter a specific value. A background marker stands for the current point of view.
Contrast: This slider allows setting contrast to the raster. Contrast varies from 0 to 1.
Brightness: Play with this slider to set the raster’s brightness. Brightness varies from 0 to 1.
Image processing mode: These exclusive processing allows to colourize rasters or define a
"transparency" colour. Play with the editors to select a colour or pick it on the 3D view and define the treatment tolerance.
Elevation layers
Grant Agreement 607737
Elevation layer editor
PUBLIC
Page 25
VASCO
VASCO Framework Final Release
The elevation layer editor is divided into two sections. The Information section and the Appearance section allow editing the following parameters:
Scale factor: This latter enables to set an exaggeration (positive or negative) to the terrain. The factor varies from -10 to 10.
Invalid value: The invalid value or NoDataValue is a special value used to tag some elevations in the map as invalid like a "transparency" value.
Value layers
Value layer editor
The value layer editor is divided into three sections. The Information section, the Appearance section like for rasters layers and the Data Visualisation section which allows editing the following parameters:
Scale factor: This latter enables to set an exaggeration (positive or negative) to the scalar data. The factor varies from -10 to 10.
Invalid value: The invalid value or NoDataValue is a special value used to tag some scalar elevations to the map as invalid like a "transparency" value.
Colour map: A default colour map is used. Colour map interactions are listed below:
Interpolation: Colours can be applied in range or smoothly by activating the Linear
interpolation.
Load: Click on the open button to select a new one in the catalogue and click on the browse button to load one from a palette file (.vgpal or .xml).
Save: Click on the save button to save the palette in a file (.vrgis).
Edit Entry: To edit a colour map, just select an entry and change the value and/or colour.
Add Entry: Right-click on the map and select the Add Item action to create a new entry initialized by the interpolating clicking values
Remove Entry: Press the F2 key to remove the selected entry or right-click on an entry and select the Remove action.
Grant Agreement 607737
PUBLIC
Page 26
VASCO
VASCO Framework Final Release
Value map catalogue
Feature layers
The Feature layer editor is divided into five parts.
The Information section
An appearance section only available for point layers.
A style section, always available.
A label section always available.
An attribute data section available if the layer has attributed data.
Feature layers appearance
Feature layer appearance editor
This section allows editing the following parameters:
Visibility mode: Play with the visibility mode to parameter the given resolution layer’s visibility range or the distance to the ground.
Visibility range: Play here with the double slider to set the layer’s visibility range. Move markers or double click on them to enter a specific value. A background marker stands for the current point of view.
Feature layers style
The style section of the feature layer property editor allows setting a global style configuration to a feature layer.
This editor section is available for all feature layers, included network layers (i.e. WFS services and
PostgreSQL connections) and databases link (ie SQLite files and Shapefiles).
Feature layers label
Grant Agreement 607737
PUBLIC
Page 27
VASCO
VASCO Framework Final Release
The label section of the feature layer property editor allows setting a global label configuration to a feature layer.
The text label can be an attributed data field or the elements name. So, a layer configuration label allows displaying a specific text for each element.
This editor section is available for all feature layers, included network layer (i.e. WFS services and
PostgreSQL connections) and databases link (ie SQLite files and Shapefiles).
Feature layers attribute data
Feature layer attribute data editor
The feature layer attribute editor, only available if needed, allows displaying the field’s name and type of the attribute data layer. This section is in read-only mode.
GPX, GML and KML
GPS Data Files are imported as Group layer with two children. A curve feature layer for tracks and a point feature layer for waypoints.
GML files are imported as point, curve or surface feature layers given the data type.
KML files are imported as a specific layer. The editor is composed of the information section.
Feature layers created from markup language files have attribute data.
Shapefiles
Shapefiles are imported as point, curve or surface feature layers given the data type. The created feature layer has attributed data.
SQL databases
Each connection to SQL table generates point, curve, surface or multiple feature layers. Created feature layers have attributed data.
Web service layers
WMS
Grant Agreement 607737
PUBLIC
Page 28
VASCO
VASCO Framework Final Release
WMS Properties editor
The WMS raster layer editor is divided into three sections. The Information section, the Appearance section like for raster layers and the WMS Properties section that allows to edit the number of levels.
The WMS elevation editor is divided into two sections. The Information section and the Appearance section like for elevation layers.
WMTS
The WMTS raster layer editor is divided into two sections. The Information section and the Appearance section like for rasters layer.
The WMTS elevation editor is divided into two sections. The Information section and the Appearance section like for elevation layer.
WFS
Each connection to WFS table generates point, curve, surface or multiple feature layers. Created feature layers have attributed data.
GeoRSS
GeoRSS connection generates specific layers. The editor is composed of the Information section.
Special layers
Hypsometric layer
Grant Agreement 607737
Hypsometric layer editor
PUBLIC
Page 29
VASCO
VASCO Framework Final Release
The hypsometric layer editor is divided into three sections. The Information section, the Appearance section, for raster layers, and the Data Visualisation section, for value layers, that allow editing the colour map.
Sky layer
Sky layer editor
This editor allows to customize sky layer parameters that are listed below:
Date: The current date can be used by clicking on the Today button.
UTC Time: The current time can be used by clicking on the Now button
UTC Offset: This latter defines the time zone.
Cloud layer
This editor allows to customize the display of the cloudy layer.
Worldwide editor Local generation editor
Two modes are available:
Worldwide: In this case, the cloud layer corresponds to an image chosen by the user. Parameters are listed below:
Altitude: Enables to specify the altitude of the cloudy layer. The value is expressed in meters.
Image: This entry allows the user to select the image that will be used as a cloud layer.
Local generation: In this case, the cloudy layer is generated by the application according to the parameters set by the user and listed below:
Grant Agreement 607737
PUBLIC
Page 30
VASCO
VASCO Framework Final Release
Altitude: Enables to specify the altitude of the cloudy layer. The value is expressed in meters.
Resolution: Enables to specify the resolution of the image that will be generated. The user may then choose the following resolutions: 128*128px, 256*256px, 512*512px,
1024*1024px and 2048*2048px.
Radius: This parameter enables to determine the spread of the cloudy layer. The value is expressed in degrees and varies from 0° to 100°.
Frequency: Corresponds to the number of clouds generation points, i.e. the clouds frequency within the cloud layer. It varies from 0 to 100.
Sharpness: Enables to configure the cloud colour scale at the level of the cloud/sky transition zone. It varies from 0 to 1.
Cover: Enables to configure the filling ratio of cloud cover. Varies from 0 to 1.
Grey range: Enables to set the interval of grey ranges allocated to clouds. Two values must then be configured. It varies from 0 to 1.
1.2.23 Getting information on layers
Layer browser’s tooltips
Layer browser’s tooltips
The layer browser's tooltips display the abstract information.
Layer editor’s properties
Raster layers properties
Grant Agreement 607737
Elevation layers properties
PUBLIC
Features layers properties
Page 31
VASCO
VASCO Framework Final Release
The properties part if the Layer Information editor display data information depending of the layer type.
Properties are listed below:
Resolution: In deg/px and cm/px for rasters or in deg/node and m/node for elevations.
Size: Data bound size in px.
Precision: Available for elevations data, values can be INTEGER16 (integer addressed on 16 bits) or
FLOAT32 (half-precision float, addressed on 32 bits) and the best theoretical value.
Number of levels: The pyramid number of levels.
Number of tiles: The total number of tiles (all levels cumulated).
Feature type: Point, MultiPoint, Polyline, MultiPolyline, Polygon, MultiPolygon or Unknown(for unknown or multi-type features layer).
Number of feature: The number of elements in this layer.
1.3 Explore the world
The navigation widget is an overlay component of the 3D view.
The component is entirely highlighted when it gets the focus and each interactive part reacts specifically.
1.3.1 Navigation widgets
Positioning & orientating
Compass widget
Move around the inner ball to pan in the desired direction within the 3D view. Displacement speed is related to:
camera altitude,
distance from the ball to its fulcrum point.
Move around the outer ball (marked with N indicating North) to orientate the view.
Move the slider onto the external quadrant to tilt the view.
Zooming
Grant Agreement 607737
Zoom widget
PUBLIC
Page 32
VASCO
VASCO Framework Final Release
Drag and drop the altitude marker to change the altitude. If the slider has got the focus, you can also use the mouse wheel. The zoom range is displayed on the marker.
Click on the + button to increase the altitude. Click on the - button to decrease the altitude.
Current altitude is indicated in the user-configured unit. See application preferences for details.
Animations & transitions
Toggle buttons
A first button allows you to switch between top and tilted viewpoints.
A second button allows you to start gyration around current position. Click on this button again or in the map to stop gyration.
1.3.2 Navigation devices
Mouse
A mouse device can be used in all navigation modes.
Keyboard
A keyboard device can be used in observer and walker navigation modes.
Keyboard device also provides shortcuts for all navigation modes.
Joystick
A joystick device can be used in flight mode.
Multi-touch pad/screen
A multi-gesture touch-sensitive device can be used in observer mode.
1.3.3 Navigation modes
Navigation in the 3D view can be achieved with any supported device (Joystick, Wiimote...).
Several movement metaphors are available in VirtualGeo Studio:
Observer mode
Navigation is similar to an observer point-of-view.
Heading (azimuth) and tilt (elevation) are modified relatively to a reference point on the map, as with an altazimuth mount.
Reference point can be picked at screen centre or under mouse cursor.
This mode is actually the most user-friendly navigation mode.
It can be used with mouse, keyboard, and touch-sensitive devices.
Flight mode
Navigation is similar to an airplane flight.
It can be used with mouse and joystick devices.
Hover Flight mode
Navigation is similar to a helicopter hover flight.
It can only be used with a spacemouse device.
Walker mode
Navigation is carried out through a first-person perspective (walker-like).
Grant Agreement 607737
PUBLIC
Page 33
VASCO
VASCO Framework Final Release
This mode is mainly used to move inside a building.
It can be used with mouse and keyboard devices.
You can switch between all these different modes through the Navigator tool button in the tool bar.
Observer
This mode enables you to execute four different navigation actions:
Zooming in the view
Moving in the view
Orientating the view
Inclining the view
View orientation and inclination can be combined in order to visualize a position with different points of view.
Orthographic View Perspective View
Zooming
Using mouse:
Point the mouse cursor in the 3D view onto the zone you want to visualize more in detail.
You are then offered three possibilities to zoom:
Double-click left button: the application zooms smoothly in the pointed area.
Double-click right button: the application zooms smoothly out of the pointed area.
Scroll wheel up or down: the application zooms in or out relatively to ground position under mouse cursor.
Grant Agreement 607737
PUBLIC
Page 34
VASCO
VASCO Framework Final Release
Using keyboard: use the PageUp or PageDown keys to respectively zoom in or zoom out relatively to ground position at screen centre.
Using multi-touch: pinch in or pinch out two fingers or two whole hands to respectively zoom in or zoom out.
Alternatively, you can double-tap a location to focus and zoom smoothly.
Moving
Within the 3D view, you can pan in all directions, i.e. North, South, East, West.
Using mouse: click left button, hold pressed, and drag in the desired direction.
The map is panned according to mouse moves, following the cursor.
Thus:
moving the mouse downwards drags the cartography down and enables to move in the North direction, moving the mouse upwards drags the cartography up and enables to move in the South direction, moving the mouse left drags the cartography to the left and enables to move in the East direction,
moving the mouse right drags the cartography to the right and enables to move in the West direction.
Using keyboard: hold down the Up, Down, Left or Right keys to move in the desired direction.
Using multi-touch: swipe a finger or a whole hand.
Grant Agreement 607737
PUBLIC
Page 35
VASCO
VASCO Framework Final Release
Orientating
This functionality enables to orientate the horizontal view angle under which the 3D scene is seen and to visualize the zone from another direction.
To orientate the view, position the cursor into the 3D view and maintain the right button pressed while moving your mouse towards the right or the left:
moving the mouse left turns the view round to the LEFT around the pressed position (marked with crosshairs),
moving the mouse right turns the view round to the RIGHT around the pressed position (marked with crosshairs)
Using keyboard: use the CTRL + Left or Right keys to turn the view in the desired direction around ground position at screen centre (marked with crosshairs).
Using multi-touch: rotate a finger around a second one or the whole hand.
Inclining
Grant Agreement 607737
PUBLIC
Page 36
VASCO
VASCO Framework Final Release
This functionality enables to slop the vertical view angle under which the 3D scene is seen and visualize the zone under another perspective.
In the case where the relief would not be very important and according the chosen steepness, it is also possible to visualize the horizon.
Lets however point out that the tilt cannot exceed 85°.
To tilt the view, maintain the right mouse button pressed while moving the latter upwards or downwards:
moving downwards enables to reduce the tilt around the pressed position (marked with crosshairs) and enables to position vertically, i.e. in a ORTHOGRAPHIC view, moving upwards enables to increase the tilt around the pressed position (marked with crosshairs) and enables to position horizontally, i.e. in a PERSPECTIVE view.
Using keyboard: use the CTRL + Up or Down keys to reduce or increase the tilt around ground position at screen centre (marked with crosshairs).
Using multi-touch: hold two fixed fingers and use a third finger to move up or down.
Movement summary
Movement Manipulation
Pan
Zoom
Grant Agreement 607737
PUBLIC
Page 37
VASCO
VASCO Framework Final Release
Orientation
Flight
To navigate in Flight mode with the mouse, just keep one or several buttons pushed while moving the cursor in the 3D view to indicate the type of movement to be performed. The cursor position compared to the screen center impacts on the generated movements that are more or less fast.
To navigate in Flight mode with the joystick, just keep the trigger pushed, the first button or both while moving the control stick to indicate the type of movement to be performed.
The different movement modes are the following:
Left mouse button or trigger joystick pushed in: 'flat' trackball at a constant altitude.
Right mouse button or first button joystick pushed in: modification of the look direction.
Left and right mouse buttons or trigger and first button joystick pushed in: more realistic trackball where one can move while varying cap. Lets point out that they are 'flat' movements (no rolls).
Distinction must be done between:
movement direction, identical to the trajectory followed by a plane;
look direction, identical to the orientation of the pilot head.
These two directions can be cumulated and give the impression of a crab movement.
Movement metaphors with the mouse help are detailed in the following table:
Action Direction Navigation
Up/Down Camera moves in or out with a constant altitude.
Left button
Right button
Right/left
Camera turns right/left (cap modifications) preserving the same altitude.
Up/Down Camera turns up/down preserving the same position.
Right/left Camera turns right/left preserving the position.
Left button + right
Up/Down Camera moves with a constant speed, looking up/down button
Right/left Camera moves with a constant speed, changing the cap.
Wheel Up/Down The altitude of the camera increases/decreases.
Movement metaphors with the joystick help are detailed in the following table:
Action Direction Navigation
Control stick
Front/Back Camera moves in or out with a constant altitude.
Right/left
Camera turns right/left (cap modifications) preserving the same altitude.
Control stick + Trigger
Front/Back Camera turns up/down preserving the same position.
Right/left Camera turns right/left preserving the position.
Control stick + First Button Front/Back Camera moves with a constant speed, looking up/down
Grant Agreement 607737
PUBLIC
Page 38
VASCO
VASCO Framework Final Release
Right/left Camera moves with a constant speed, changing the cap.
Front/Back
Camera moves with a constant speed, changing the position.
Control stick + Trigger + First
Button
Right/left Camera turns right/left, changing the position.
Right/left tilt
Change the bank
Throttle control Up/Down Increase or decrease the movement speed
The movement speed can be configured thanks to the + and - keys of the numerical pad.
The camera altitude can be configured thanks to the PageUp and PageDown keys.
The joystick responsiveness can be configured thanks to the PageUp and PageDown keys.
1.4 Size the world
Click on the Measures action of the application tool bar to display the measure tools widget.
Measure tools' widget
The measure tool widget allows to select a measure tool and to display the results.
Measures are expressed in the application unit coordinate system. See application preferences for details.
1.4.1 Position
The first tool is the position measure.
Click on the 3D view. The picked position, materialized with a square on the view, is displayed on the measures tools widget.
Click on the 3D view to start another position measure or drag and drop the square on the map to update the current one.
1.4.2 Azimuth
The second tool is the azimuth measure.
Click two times on the 3D view to create the vertices of a line. The azimuth of the angle formed by the North axis and the drawing line is displayed on the tool widget.
Drag and drop the control points to edit the geometry and update the measure.
Click again on the view to start another azimuth measure.
Grant Agreement 607737
PUBLIC
Page 39
VASCO
VASCO Framework Final Release
1.4.3 Orthodromic distance
The third tool is the orthodromic distance measure. It computes the great circle distance i.e. the distance at ocean level considering the earth's curvature.
Click on the 3D view to create the vertices of a multi-line. The multi-line length is displayed on the tool widget.
Drag and drop the vertices to edit the geometry and update the measure.
Drag and drop the intermediate points to create new vertices.
A right click erases the last created point.
A double click adds a final point, validates the current distance measure and allows starting a new one.
1.4.4 Euclidean distance
The fourth tool is the Euclidean distance measure.
Click on the 3D view to create the vertices of a multi-line. The multi-line length is displayed on the tool widget.
Drag and drop the vertices to edit the geometry and update the measure.
Drag and drop the intermediate points to create new vertices.
A right click erases the last created point.
A double click adds a final point, validates the current distance measure, and allows starting a new one.
1.4.5 Surface area
The fifth tool is the area measure.
Measure area view
Click on the 3D view to create the vertices of a surface. The surface area and perimeter are displayed on the tool widget.
Drag and drop the vertices to edit the geometry and update the measure.
Drag and drop the intermediate points to create new vertices.
Grant Agreement 607737
PUBLIC
Page 40
VASCO
VASCO Framework Final Release
A right click erases the last created point. A double click adds a final point, validates the area measure and allows to start a new one.
1.4.6 Terrain profile
The sixth tool is the profile measure.
Measure profile view
Click on the 3D view to create the vertices of a multi-line. The multi-line profile is displayed in the plot widget.
Drag and drop the vertices to edit the geometry and update the profile.
Drag and drop the intermediate points to create new vertices.
A right click erases the last created point.
A double click adds a final point, validates the current profile measure, and allows starting a new one.
1.4.7 Plot's widget
Plot's widget
Measures in the plot widget are expressed in the application unit coordinate system. See application preferences for details.
Move the cursor on the profile to display an altitude in tool-tip.
Grant Agreement 607737
PUBLIC
Page 41
VASCO
VASCO Framework Final Release
Plot's widget
Click on the Edit button to display the curve editor.
Click on the 1:1 button to set an orthonormal basis.
Plot's widget
Click on the X:Y button to set the basis.
Click on the Save button to save the profile image.
Click on the Close button to close the profile.
1.5 Publish the world
VirtualGeo Studio brings 3 publications tools to generate a local package , populate a VirtualGeo
Server or export a 3D model of a scene part.
Publication tool interfaces are available from the application tool bar or the layer contextual menu .
Grant Agreement 607737
PUBLIC
Page 42
VASCO
VASCO Framework Final Release
Publication actions Publication context menu
1.5.1 Generating a local package
The Generate a local package tool can be used to export a project or a part of it into a local repository.
Some processes can be applied to enrich and optimize the resulting data.
The interface consists of a 3 page Wizard that allows you to configure the input data, the output repository, the extend and resolution of data to publish, and to define the process to apply.
Input / Output configuration
The first page of the publication wizard contains 2 sections.
Input / Output configuration
The first section allows to define the layers to publish.
Itis possible to select all the layers, the visible layers, or only the current layer. By default, Selected layers is checked when there is a contextual layer and All layers is checked in other cases.
The second section allows to set the output folder.
Grant Agreement 607737
PUBLIC
Page 43
VASCO
VASCO Framework Final Release
If the selected folder already contains a publication, the previous publication parameters will be loaded and the wizard automatically configured.
Check the Clear previously published data checkbox to clear previous publication processed data.
Extent / Resolution configuration
The second page of the wizard contains 2 sections.
Extent / Resolution configuration
The first section allows to define the extend of the area to publish. Global extent, the area visible on screen or a specific area are available.
If a specific extent is selected, itis possible to define it digitally by setting the exact extreme values or graphically by manipulating a rectangle on the 3D view.
Grant Agreement 607737
PUBLIC
Page 44
VASCO
VASCO Framework Final Release
Graphical extent configuration
All graphical manipulations are interactive. Itis possible to :
Drag and drop a corner or a middle edge point to update the extent geometry
The same manipulation with the Shift key pressed allows to preserve the extent centre.
The same manipulation with the Ctrl key pressed allows to preserve the extent ratio.
Drag and drop the centre of the rectangle to move the extent. An alternative is to press the middle mouse button anywhere in the extent and to release the button at the expected position.
The second section of the interface is used to define the resolution of the area to publish. Resolutions are expressed in degree by tile and in kilometres by pixel. By default, all the pyramid range is selected.
Click on the Current buttons to used the 3D view resolution as minimum or maximum value.
Process configuration
The third and last page of the wizard allows to define the process to apply.
Grant Agreement 607737
PUBLIC
Page 45
VASCO
VASCO Framework Final Release
Process configuration
There are 3 processes available:
Copy data : Copy all files referenced in the project from various places into the local package folder.
Eventually extract and copy only data in the published area.
Download online data : Download and store remote data within published area in the local package. If needed, use network links to forbid the enrichment of resulting data during the operational phase.
Optimize data: Transform and tile raster/elevation data to optimize run-time performances into the current view projection. All network links are removed.
Below, the available processes given the layer data type:
Copy data Downnload online data Optimize data
Web service raster/elevation data X X
Raw raster/elevation data X X
Optimized raster/elevation data X
Web features data X X X
Features data X X X
Grant Agreement 607737
PUBLIC
Page 46
VASCO
VASCO Framework Final Release
3D models data X X X
By default, the Downnload online data and the Optimize data processes are checked.
Click on the Finish button to launch the publication. Processes are applied (if possible) for each layer depending on the chosen extent and resolution. .
If the publication about to be ran will extend a previous one, a compatibility test occurs. To be compatible, two publications must have the same processes to prevent any data corruption.
Parameters changed
To run a publication incompatible with the previous one at the same location, the user must confirm the action.
Publication progression
Once a publication is running, an interface appears to follow the progression.
Publication progression
This interface contains a global and a current task progression bar with an estimation of the remaining time.
This interface allows to see the publication logs. Logs inform of the current processes and those finished with the resulting state.
A final message box informs the user when a publication is finished. This message box gives also access to the final logs.
Grant Agreement 607737
PUBLIC
Page 47
VASCO
VASCO Framework Final Release
Publication finished Publication log
1.5.2 Populating a VirtualGeo Server
The Populate VirtualGeo Server tool can be used to fill with data a VirtualGeo Server; our solution to stream and serve your geospatial data on your intranet or on the Web.
Managing your data on the Server is really easy thanks to the server publication interface: add your data coming for any source in the studio, visualize them and edit their parameters, then push them on the server in a few clicks.
Server configuration
The first page of the wizard allows setting the layer to publish and the server target.
Grant Agreement 607737
PUBLIC
Page 48
VASCO
VASCO Framework Final Release
Server configuration
Select an existing server or enter a new one and fill the user authentication information.
By clicking on the Next > button, a server validity test occurs:
If the test fails , a message box informs the user of the occurred errors,
If the test succeeds, the server is added to the preferred list and the 2nd page of the wizard is displayed.
Extent configuration
The second page, similar to the previous publication tool wizard, allows to set the extent configuration.
Process configuration
The final page of the wizard allows configuring the processes to apply.
Grant Agreement 607737
PUBLIC
Page 49
VASCO
VASCO Framework Final Release
Server process configuration
Rasterize group layers: Convert a group layer into a raster layer combining all its children on the server.
Rasterize feature layers: Convert a feature layer into a raster layer on the server if its style is compatible for rasterisation (no 3D model, no extrusion, etc.).
Click on the Finish button to run the publication. For each conflicted layer (i.e. a layer with the same name already existing on the server), the following message box appears.
Server publication conflict
Click on the Yes button to remove the existing server layer before publishing the new one.
Click on the No button to create a new server layer. A unique server layer Id allows differentiating each layer.
Click on the Cancel button to ignore the publication of the conflicted layer.
A dialog interface allows following the publication progression and success.
Grant Agreement 607737
PUBLIC
Page 50
VASCO
VASCO Framework Final Release
Advanced VirtualGeo Server publication
For further information on VirtualGeo Server publication features please click here .
1.5.3 Exporting a 3D model
The last publication tool can be used to export 3D models. Let youself be guided through the 3 page wizard to generate 3D models using the layers of a scene.
Input / Output configuration
The first page of the wizard, similar to the Generate local package tool, allows to set the layer to publish and the output folder.
Extent / Resolution configuration
The second page of the wizard allows setting the extent and resolution of data to publish.
Extent / Resolution configuration
Process configuration
The last page of the wizard allows to select:
The output 3D model file format,
The output texture file format and compression.
Grant Agreement 607737
PUBLIC
Page 51
VASCO
VASCO Framework Final Release
Process configuration
Click on Finish to run the publication. A dialog interface allows following the progression and success.
1.6 Building Editor
To open the Building Editor, locate the corresponding menu in the DMU Editor Toolbar, and select the
geographic view and uses it as a background for the building editor, enabling the user to easily geolocate his creation.
This opens the Building Editor window shown in Figure 2 which is divided in three parts:
On top: the toolbar offers quick access to the tools
On the left: the property grid allows to modify the selected element’s properties
The rest of the display is dedicated to the view and manipulation area.
Grant Agreement 607737
PUBLIC
Page 52
VASCO
VASCO Framework Final Release
Figure 1. Building Editor menu inside the DMU Editor
Figure 2. The Building Editor Window.
1.6.1 Toolbar
As seen in Figure 3, the toolbar offers the following tools, from left to right:
Background adjustment: moves the background screenshot
Pan: moves the view
Selector: allows object selection
Delete: deletes the currently selected object
Exterior walls: allows drawing the exterior walls (depicted in Figure 4). Once selected:
Left click to add point
Right click to end the drawing
Interior walls: draw interior walls by intersecting other walls. See Figure 5
Doors: click a wall to add a door on it
Windows: click a wall to add a window on it
Aperture: Click on the floor to create a hole on it
Stairs: allows creating stairs (depicted in Figure 4). Once selected:
Left click to add point
Right click to end the drawing
Floor selection
Grant Agreement 607737
PUBLIC
Page 53
VASCO
Add and delete floors
Zoom in, zoom out and reset zoom
Toggle grid and background
Settings
Generate and export building
Figure 3. Building Editor toolbar.
VASCO Framework Final Release
Figure 4. Exterior walls tool.
Figure 5. Interior walls tool.
Grant Agreement 607737
Figure 6. Doors tool.
PUBLIC
Page 54
VASCO
VASCO Framework Final Release
Figure 7. Stairs tool.
Figure 8. Create level dialog.
1.6.2 Property Grid
The properties control allows modifying the selected object’s properties. The properties depend on the type of the selected object (e.g. a stair will have a “step width” property whereas a door will have a
“closed” property).
Grant Agreement 607737
Figure 9. Property Grid
PUBLIC
Page 55
VASCO
VASCO Framework Final Release
Figure 10. After generation, the building is added to the scene.
Grant Agreement 607737
PUBLIC
Page 56
VASCO
VASCO Framework Final Release
2 Security Editor
The VASCO Security Editor graphical user interface is illustrated in Figure 11. After launching the
application, 4 zones are displayed:
The main menu button: allows opening DMUs, display the Situation Manager, etc...
The toolbar: offers quick access to the most used tools
The Virtual Entity Browser: to search the entities database and place entities
Switches: offers quick access to the most used toggles
These zones are detailed in the following subsections.
Figure 11. The VASCO Security Editor graphical user interface.
2.1 Main menu
The main menu can be opened and closed by toggling its button. Once opened, it displays the options to
manage the editor, DMUs, and situations as illustrated in Figure. 12.
Grant Agreement 607737
PUBLIC
Page 57
VASCO
VASCO Framework Final Release
Figure. 12 Main menu.
2.2 Toolbar
The toolbar displays the following tools:
Lines and paths tool
Click to open the submenu and choose the colour of the line
Use the left click to add points on the line
Use the right click to cancel the last point
Click again on the button to disable the line tool
Annotations tool
Click to open the submenu and choose the colour of the annotation
Drag and drop from the button onto the map to add the annotation
Erase tool
Click to enable the erase tool
Click on an annotation or a line to delete it
Click to disable the erase tool
Visibility tool
Drag and drop from the button onto the map to add a visibility object
Click on the created object to change its properties
Oculus tool
Drag and drop from the button onto the map to add an oculus object
Click on the created object then the view button to start the oculus view
Crowds tool
Click to open the submenu and choose between
A brush to draw a crowd
A brush to erase a crowd
The editor enters the “crowd mode” if not already in it
Click on the map to add or remove individuals to the crowd
Grant Agreement 607737
PUBLIC
Page 58
VASCO
Click the Quit Edit button to exit “crowd mode”
VASCO Framework Final Release
Figure 13. The toolbar widget.
2.3 Virtual Entity Browser
Virtual Entities are firstly divided into categories such as indoor equipment, outdoor equipment, units, threats, individuals, and crowds. The selection of one of these categories opens up a list of all the entities of the selected category with automatically generated previews. This enables to visualize the content of the entity before populating the DMU. Then, using the drag and drop metaphor, entities are placed at the desired location. A search bar placed on top enables one to select the desired entity from a subset of the
Knowledge Database thanks to textual queries. The Virtual Entity Browser is visible in Figure 14.
Figure 14. Populating a DMU is made simple thanks to an intuitive Virtual Entities Browser which enables an easy and visual selection and insertion of virtual equipments and threats.
2.4 Switches
Two switches are currently available:
Coverage toggle: enable or disable the visibility check of all the cameras of the environment.
Model / Symbol toggle: switches the entities representation between their 3D model and their 2D
Grant Agreement 607737
PUBLIC
Page 59
VASCO
VASCO Framework Final Release
Figure 15. Model (above) and symbolic (below) entities representations.
2.5 Placing Virtual Entities
To select an entity, the user must firstly click or tap on the entity. A menu appears which proposes to rotate, move and remove the entity. Thanks to intuitive and tactile friendly controls, the user can easily manipulate the Virtual Entities in space. For translations or rotations, blue and green arrows can be selected by a mouse click or by a tap and dragged to the desired position. This scheme is illustrated in
Figure 16. A fire extinguisher, from the Virtual Equipment Database, is firstly selected. A menu offers the user the possibility to move the object, in blue, to rotate the object in green, and to remove it from the situation.
2.6 Building management
To enable the building management tool, locate and click the green pin on the 3D environment as shown in
and the filter interface. The “Quit Visit” button at the bottom of the screen allows exiting the visit mode.
information displayed next to the slider. If a user selects “Show Only” doors, everything but the doors and floor information will be hidden.
above occluding ones. A gradient mini-building-map is shown on the bottom left hand side of the screen.
Grant Agreement 607737
PUBLIC
Page 60
VASCO
VASCO Framework Final Release
Clicking or tapping a floor will remove (with animation) the top floor. A home menu enables to return to the full building visualisation.
Figure 17. The visit button allows entering the visit mode.
Figure 18. The filters user interface is displayed in visit mode.
Figure 19. The floor selection user interface allows switching the currently displayed level.
2.7 Situation Manager
The main menu offers 5 options regarding situations:
Save & Load Situations: saves or loads the current situations to or from the file system
Grant Agreement 607737
PUBLIC
Page 61
VASCO
VASCO Framework Final Release
Export Situations: exports the situations to the operational tool
Close All Situations: closes the current situations
Display Situations: opens or closes the Situation Manager interface illustrated in Figure 20
The Situation Manager displays four action buttons in a toolbar and the list of the currently loaded situations. The four actions allow reordering situations and deleting or adding a situation. When adding a situation, the user can choose between three options in a submenu:
Create a blank situation
Duplicate the selected situation
Create a “picture situation”: this kind of situation is to be used like a slide in a presentation. It will only display the selected picture when selected.
The user, then, can click left to switch the currently displayed situations. This will move the camera to the situation’s point of view, display the entities of the selected situation and hide everything else.
By clicking right on a situation, the user can rename and update the point of view of a situation.
Figure 20. The Situation Manager user interface, with 2 situations and one “picture situation”
Grant Agreement 607737
PUBLIC
Page 62
Download
Advertisement
Key features
DMU Editor: Project & Layer Management
DMU Editor: 3D World Exploration
DMU Editor: Package Generation
Security Editor: Virtual Entity Placement
Security Editor: Building Management
Frequently asked questions
Create a project by clicking on the Create button in the project wizard or by selecting Create Project... in the tool bar menu.
Open a project by clicking on the Open button on the project wizard or by selecting Open Project... in the tool bar menu.
Layers can be added by using actions from the data tool bar, layer browser contextual menu, or by dragging and dropping files into the layers browser or the 3D view.