Skip to content

Commit bba7ec4

Browse files
ElenaGalloElenaGallo
authored
Update User Guide - Terrain layer selector on Background tool (#11866)
* add_11346 * review-11346
1 parent aa1045d commit bba7ec4

17 files changed

Lines changed: 65 additions & 8 deletions

‎docs/user-guide/background.md‎

Lines changed: 65 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,19 @@ The background selector, located in the bottom left corner of the *Viewer*, allo
66

77
<img src="../img/background/background.jpg" class="ms-docimage"/>
88

9-
By clicking on the background selector several miniatures will be displayed. Those miniatures can be selected in order to switch from a background to another (the map backgrounds set by default in MapStore are *Open Street Map*, *NASAGIBS*, *OpenTopoMap*, *Sentinel 2* and the *Empty Background*).
9+
By clicking on the background selector, a list of available backgrounds will be displayed. The user can select one of them to switch to it. The default map backgrounds in MapStore are: *OSM Simple Light*, *OSM Simple Dark*, *OSM Bright*, *NE Political*, *Sentinel 2 Cloudless*, *Open Street Map* and *Empty Background*.
1010

1111
<img src="../img/background/bck-available.jpg" class="ms-docimage" style="max-width:500px;"/>
1212

13-
For example choosing *OpenTopoMap*, the map background will change like in the following image:
13+
For example choosing *NE Political*, the map background will change like in the following image:
1414

1515
<img src="../img/background/back-selector.jpg" class="ms-docimage"/>
1616

1717
If the user has editing permissions on the map (independently on the role, see [Resource Properties](resources-properties.md#resource-properties) section for more information about permissions), it is also possible to add, edit or remove backgrounds.
1818

1919
## Add background
2020

21-
A new background can be added through the <img src="../img/button/+++.jpg" class="ms-docbutton"/> button on the top of the background selector main card. Performing this operation the [Catalog](catalog.md#catalog-services) panel opens with the possibility to access the *Remote Services*:
21+
A new background can be added through the <img src="../img/button/++++.jpg" class="ms-docbutton"/> button on the top of the background selector. Performing this operation the [Catalog](catalog.md#catalog-services) panel opens with the possibility to access the *Remote Services*:
2222

2323
<img src="../img/background/bck-catalog.jpg" class="ms-docimage" style="max-width:500px;"/>
2424

@@ -71,22 +71,79 @@ The user can perform the following operations:
7171

7272
## Edit background
7373

74-
It is possible to edit backgrounds by clicking on settings icon on top of each background card:
74+
Backgrounds can be edited using the <img src="../img/button/edit-icon.jpg" class="ms-docbutton"/> button located to the right of each background in the list.
7575

7676
<img src="../img/background/edit-back-window.jpg" class="ms-docimage" style="max-width:600px;"/>
7777

78-
!!! warning
79-
*Default Backgrounds* layers can't be edited, with an exception for *Sentinel 2: only WMS Layers can be edited&/configured through the Background Selector*.
80-
8178
The **Edit Current Background** window opens, allowing the user to customize the same set of information when adding a new background (see [previous section](#add-background)).
8279

8380
## Remove background
8481

85-
It is possible to remove a background from the background selector by clicking on remove icon on top-right of each card
82+
Backgrounds can be removed using the <img src="../img/button/delete2.jpg" class="ms-docbutton"/> button located to the right of each background in the list.
8683

8784
<img src="../img/background/bck-delete.jpg" class="ms-docimage" style="max-width:500px;"/>
8885

8986
!!! note
9087
By default, for new maps, all backgrounds from *Default Backgrounds* Service are added to the background selector, and in [Catalog](catalog.md#catalog-services) they appear grayed (it's not allowed to add the same default background twice): as soon as you remove one from the background selector, it becomes selectable from the [Catalog](catalog.md#catalog-services).
9188

9289
<img src="../img/background/bck-unselectable.jpg" class="ms-docimage"/>
90+
91+
## Background Selector on the 3D navigation
92+
93+
On MapStore, when [3D Navigation](navigation-toolbar.md#3d-navigation) is enabled, the user can customize the background of the map viewer.
94+
95+
<img src="../img/background/3d-bck-selectors.jpg" class="ms-docimage" style="max-width:500px;"/>
96+
97+
If the user has editing permissions on the map, they can also add, edit, or remove terrain layers to be used as a background for that map.
98+
99+
!!! note
100+
By default, the only terrain available in the 3D map list is *Ellipsoid*, which cannot be edited or removed.
101+
102+
### Add Terrains
103+
104+
A new terrain can be added through the <img src="../img/button/++++.jpg" class="ms-docbutton"/> button. This opens the **Add New Terrain** panel, where the user can select the **Provider** by choosing between: *Cesium*, *Cesium Ion* and *WMS*.
105+
106+
<img src="../img/background/bck-provider.jpg" class="ms-docimage" style="max-width:500px;"/>
107+
108+
#### Cesium Provider
109+
110+
Using the **Cesium** provider, the user can add a terrain to the *Backgrounds Selector* list by:
111+
112+
<img src="../img/background/bck-cesium-provider.jpg" class="ms-docimage" style="max-width:500px;"/>
113+
114+
* Entering a service **Title** and **URL**
115+
116+
#### Cesium Ion Provider
117+
118+
Using the **Cesium Ion** provider, the user can add a terrain to the *Backgrounds Selector* list by:
119+
120+
<img src="../img/background/bck-cesium-ion-provider.jpg" class="ms-docimage" style="max-width:500px;"/>
121+
122+
* Entering a service **Title**
123+
* Providing the **Asset ID**
124+
* Providing the **Access Token**
125+
* Adding the **Server** name of the terrain
126+
127+
#### WMS Provider
128+
129+
Using the **WMS** provider, the user can add a terrain to the *Backgrounds Selector* list by:
130+
131+
<img src="../img/background/bck-wms-provider.jpg" class="ms-docimage" style="max-width:500px;"/>
132+
133+
* Entering a service **Title**
134+
* Entering the **URL** of the *WMS service*
135+
* Specifying the **Layer Name**
136+
* Setting the **Projection**
137+
* Setting the **WMS Version**
138+
139+
### Edit Terrain
140+
141+
Once a terrain has been added to the list, it can be edited using the <img src="../img/button/edit-icon.jpg" class="ms-docbutton"/> button located to the right of each terrain.
142+
143+
<img src="../img/background/edit-terrain-window.jpg" class="ms-docimage" style="max-width:600px;"/>
144+
145+
### Remove Terrain
146+
147+
Terrains can be removed using the <img src="../img/button/delete2.jpg" class="ms-docbutton"/> button located to the right of each terrain in the list.
148+
149+
<img src="../img/background/terrains-delete.jpg" class="ms-docimage" style="max-width:500px;"/>

‎docs/user-guide/img/background/3d-bck-selectors.jpg‎

31.8 KB
Loading

‎docs/user-guide/img/background/add-new-bck.jpg‎

11.6 KB
Loading

‎docs/user-guide/img/background/add_wmts_background.jpg‎

12.1 KB
Loading

‎docs/user-guide/img/background/back-selector.jpg‎

2.67 MB
Loading

‎docs/user-guide/img/background/background.jpg‎

1.29 MB
Loading

‎docs/user-guide/img/background/bck-available.jpg‎

-98.7 KB
Loading

‎docs/user-guide/img/background/bck-catalog.jpg‎

44.2 KB
Loading

‎docs/user-guide/img/background/bck-cesium-ion-provider.jpg‎

16.4 KB
Loading

‎docs/user-guide/img/background/bck-cesium-provider.jpg‎

8.87 KB
Loading

0 commit comments

Comments
 (0)