diff --git a/src/gis/setup_themes/index.md b/src/gis/setup_themes/index.md index f3ef4c41..af0fcd6c 100644 --- a/src/gis/setup_themes/index.md +++ b/src/gis/setup_themes/index.md @@ -1,32 +1,94 @@ --- description: Set up map themes for your Mergin Maps project to easily switch between different combinations of layer styles and visibility. +outline: deep --- # Map Themes [[toc]] -In , you can use different **map themes**. This is ideal for switching between different background maps (e.g. cartography map and aerial photography), combinations of visible layers or their styles. The map themes should be first set up in QGIS. +In QGIS, you can define different **map themes** for your project to easily switch between different background maps, combinations of visible layers or their styles, and use them in your project in the . -## Setting up QGIS map themes +:::tip Example project available +Download or clone our public project to see how this setup works. +::: -Read how to in QGIS. +![Mergin Maps mobile app map themes](./mobile-map-themes.gif "Mergin Maps mobile app map themes") -- Open QGIS Desktop with your QGIS Project -- Define the visibility and/or styles of the layers in your project -- In the Layers Panel, click on "Manage Map Themes" (eye-icon) and add a new theme (or replace an existing one) +## Setting up styles and map themes in QGIS +Here, we will define different symbology for survey layers depending on the displayed background map using styles. Then we will set up [map themes](#map-themes-1) so that we can switch between the basic and the satellite background maps along with the corresponding layers' styles. + +Note that you can use the [map themes](#map-themes-1) without defining custom styles for layers, simply to switch between different combinations of visible layers. + +You can read more about and in the QGIS documentation. + +### Custom layers style + +:::warning Styles store also attributes forms +Note that a style includes more than symbology: the style also stores labels, attributes form, display and other properties of a layer. The complete list can be found in . + +This means that you can have different attributes form setup for various styles of the same survey layer. However, this can also mean that there may be discrepancies in input data, say if these forms use different [widgets](../../layer/form-widgets/) or [default values](../../layer/default-values/) for the same fields. + +Therefore we recommend setting up styles after configuring the [attributes form](../../layer/overview/). +::: + +First, define the symbology (or other properties) for your survey layers. This will be stored as the *default* style that each layer has by default. + +Here we have a point layer `Survey` and a polygon layer `Survey_polygons` that use simple symbols with a non-transparent fill so that they are clearly visible on the basic background map. + +Now we will define a new style named *satellite* for survey layers: +1. Right-click on a survey layer and select **Styles** > **Add...** + ![QGIS Add new layer style](./qgis-layer-add-style.webp "QGIS Add new layer style") +2. Enter the name of the style, here: `satellite` +3. Define the symbology of a feature (or other properties) for the new style. + + Here we use a transparent fill so that the outline of a feature is visible on to the satellite background map. + +Repeat these steps for each survey layer that should have different styles. One layer can have multiple styles. + +Now you can easily switch between the *default* and *satellite* style by right-clicking the survey layer: +![QGIS Add new layer style](./qgis-layer-styles.webp "QGIS Add new layer style") + + +### Map themes +A map theme records the visibility of layers and their styles. + +To define the *default* theme: +1. In the **Layers** panel, make sure that: + - the survey layers are set to the *default* styles (optional) + - the survey layers and the basic background map are displayed (hide the satellite background map or other layers) +2. Use the **Manage map themes** button to **Add Theme...**. + + This theme will be named *default*. + +![QGIS Map Themes setup](./qgis_map_themes_setup.webp "QGIS Map Themes setup") + +For the *satellite* theme: +1. In the **Layers** panel, make sure that: + - the survey layers are set to the *satellite* styles (optional) + - the survey layers and the satellite background map are displayed (hide the basic background map or other layers) +2. Use the **Manage map themes** button to **Add Theme...** and name this theme *satellite* + +Themes can be easily switched using the **Manage map themes** button. +![QGIS Map Themes](./qgis_map_themes.webp "QGIS Map Themes") + +Don't forget to save and synchronise the project. + +:::tip Using themes in QGIS +In QGIS, themes can be renamed, removed or replaced using the **Manage map themes** button. + +To modify an existing theme, make the desired changes in the **Layers** panel and use the **Replace theme** option. +::: -Here, we created two themes: `OSM` and `Aerial photos` to easily switch between two types of background maps. -![QGIS Map Themes setup](./qgis_map_themes_setup.jpg "QGIS Map Themes setup") ## Map themes in Mergin Maps mobile app In the , tap **More** and select the **Map themes** option. -![Map themes option in Mergin Maps mobile app](./mobile-app-map-themes-option.jpg "Map themes option in Mergin Maps mobile app") +![Map themes option in Mergin Maps mobile app](./mobile-app-map-themes-option.webp "Map themes option in Mergin Maps mobile app") -Now you will see the list of map themes that are available in your project. To switch the map theme, tap on it. +Now you will see the map themes that are available in your project. To switch the map theme, tap on it. -Here, we switched from `OSM` to `Aerial photos`. +Here, we switched from *default* to *satellite*. -![Mergin Maps mobile app switching map themes](./mobile-app-map-themes-switch.jpg "Mergin Maps mobile app switching map themes") +![Mergin Maps mobile app switching map themes](./mobile-app-map-themes-switch.webp "Mergin Maps mobile app switching map themes") It may be useful to define a *default* map theme for your project. Then, If you change the visibility of layers through the [**Layers**](../../field/layers/) option in the during the survey, you can use this map theme to get back to the default setup. diff --git a/src/gis/setup_themes/mobile-app-map-themes-option.jpg b/src/gis/setup_themes/mobile-app-map-themes-option.jpg deleted file mode 100644 index 6b7a4aeb..00000000 Binary files a/src/gis/setup_themes/mobile-app-map-themes-option.jpg and /dev/null differ diff --git a/src/gis/setup_themes/mobile-app-map-themes-option.webp b/src/gis/setup_themes/mobile-app-map-themes-option.webp new file mode 100644 index 00000000..f3864cbf Binary files /dev/null and b/src/gis/setup_themes/mobile-app-map-themes-option.webp differ diff --git a/src/gis/setup_themes/mobile-app-map-themes-option.xcf b/src/gis/setup_themes/mobile-app-map-themes-option.xcf index 577336a8..95764d02 100644 Binary files a/src/gis/setup_themes/mobile-app-map-themes-option.xcf and b/src/gis/setup_themes/mobile-app-map-themes-option.xcf differ diff --git a/src/gis/setup_themes/mobile-app-map-themes-switch.jpg b/src/gis/setup_themes/mobile-app-map-themes-switch.jpg deleted file mode 100644 index 7c26c71a..00000000 Binary files a/src/gis/setup_themes/mobile-app-map-themes-switch.jpg and /dev/null differ diff --git a/src/gis/setup_themes/mobile-app-map-themes-switch.webp b/src/gis/setup_themes/mobile-app-map-themes-switch.webp new file mode 100644 index 00000000..2507719f Binary files /dev/null and b/src/gis/setup_themes/mobile-app-map-themes-switch.webp differ diff --git a/src/gis/setup_themes/mobile-app-map-themes-switch.xcf b/src/gis/setup_themes/mobile-app-map-themes-switch.xcf index b9b3f359..c07a4f7f 100644 Binary files a/src/gis/setup_themes/mobile-app-map-themes-switch.xcf and b/src/gis/setup_themes/mobile-app-map-themes-switch.xcf differ diff --git a/src/gis/setup_themes/mobile-map-themes.gif b/src/gis/setup_themes/mobile-map-themes.gif new file mode 100644 index 00000000..cea35d5f Binary files /dev/null and b/src/gis/setup_themes/mobile-map-themes.gif differ diff --git a/src/gis/setup_themes/qgis-layer-add-style.webp b/src/gis/setup_themes/qgis-layer-add-style.webp new file mode 100644 index 00000000..beed1a86 Binary files /dev/null and b/src/gis/setup_themes/qgis-layer-add-style.webp differ diff --git a/src/gis/setup_themes/qgis-layer-add-style.xcf b/src/gis/setup_themes/qgis-layer-add-style.xcf new file mode 100644 index 00000000..8a2bfec6 Binary files /dev/null and b/src/gis/setup_themes/qgis-layer-add-style.xcf differ diff --git a/src/gis/setup_themes/qgis-layer-styles.webp b/src/gis/setup_themes/qgis-layer-styles.webp new file mode 100644 index 00000000..93ce0479 Binary files /dev/null and b/src/gis/setup_themes/qgis-layer-styles.webp differ diff --git a/src/gis/setup_themes/qgis-layer-styles.xcf b/src/gis/setup_themes/qgis-layer-styles.xcf new file mode 100644 index 00000000..4a7d5ddc Binary files /dev/null and b/src/gis/setup_themes/qgis-layer-styles.xcf differ diff --git a/src/gis/setup_themes/qgis_map_themes.webp b/src/gis/setup_themes/qgis_map_themes.webp new file mode 100644 index 00000000..f99a79be Binary files /dev/null and b/src/gis/setup_themes/qgis_map_themes.webp differ diff --git a/src/gis/setup_themes/qgis_map_themes.xcf b/src/gis/setup_themes/qgis_map_themes.xcf new file mode 100644 index 00000000..c05677ae Binary files /dev/null and b/src/gis/setup_themes/qgis_map_themes.xcf differ diff --git a/src/gis/setup_themes/qgis_map_themes_setup.jpg b/src/gis/setup_themes/qgis_map_themes_setup.jpg deleted file mode 100644 index e50c11e1..00000000 Binary files a/src/gis/setup_themes/qgis_map_themes_setup.jpg and /dev/null differ diff --git a/src/gis/setup_themes/qgis_map_themes_setup.webp b/src/gis/setup_themes/qgis_map_themes_setup.webp new file mode 100644 index 00000000..44696a86 Binary files /dev/null and b/src/gis/setup_themes/qgis_map_themes_setup.webp differ diff --git a/src/gis/setup_themes/qgis_map_themes_setup.xcf b/src/gis/setup_themes/qgis_map_themes_setup.xcf index fbc25b6d..08972f38 100644 Binary files a/src/gis/setup_themes/qgis_map_themes_setup.xcf and b/src/gis/setup_themes/qgis_map_themes_setup.xcf differ diff --git a/src/gis/supported_formats/index.md b/src/gis/supported_formats/index.md index 4b4a25ab..aec1956e 100644 --- a/src/gis/supported_formats/index.md +++ b/src/gis/supported_formats/index.md @@ -34,7 +34,7 @@ PostgreSQL connection (username, password, host, port, etc.) can be set up: - use a *Connection Service File* `pg_service.conf`, if you want to have different PostgreSQL user for each surveyor To use a *Connection Service File*, you have to: -- create a `pg_service.conf` file as described in and test it in QGIS Desktop +- create a `pg_service.conf` file as described in and test it in QGIS Desktop - [manually transfer](../../manage/missing-data/index.md) the `pg_service.conf` file to data folder. The data folder is shown in the [Diagnostic Log](../../misc/troubleshoot/#diagnostic-log-on-mergin-maps-mobile-app) - restart the . Check the [Diagnostic Log](../../misc/troubleshoot/#diagnostic-log-on-mergin-maps-mobile-app) to see if the file is found and used after restart.