From 4271ee6ed28d2147039871141754e93c0f15cd0e Mon Sep 17 00:00:00 2001
From: evolvedexperiment <55178666+evolvedexperiment@users.noreply.github.com>
Date: Wed, 18 Dec 2019 12:46:09 +0200
Subject: [PATCH] Added a page to explain how to add a heightmap image overlay.

---
 Heightmap-image-overlay.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 Heightmap-image-overlay.md

diff --git a/Heightmap-image-overlay.md b/Heightmap-image-overlay.md
new file mode 100644
index 0000000..7fb259c
--- /dev/null
+++ b/Heightmap-image-overlay.md
@@ -0,0 +1,38 @@
+## Overview
+The "Texture" layer can be used as an image overlay - an image that appears over the existing map.
+
+This can be enabled during heightmap editing to allow you to see both the heightmap and the image.  Possible uses are for tracing landmasses or adding features more accurately.
+
+## Caveats
+For the texture to work, the image must be available on the web.
+Due to browser security restrictions, only websites that have a relatively open Cross-Origin Resource Sharing (CORS) policy will work.  You can possibly use a CORS proxy for other sites.  [Imgur](https://www.imgur.com) is one site that works for this feature.
+
+
+## Loading an image as an overlay
+Go to Style, then click the "+" button next to Image.
+
+![Style texture dialog](https://evolvedexperiment.github.io/FMGImages/images/style_texture1.png)
+
+
+Enter the URL of the image you want to use - when it is correct, the image will appear here - this does not mean that it will work - just that the URL is correct.  Click Apply.
+
+
+![Image URL](https://evolvedexperiment.github.io/FMGImages/images/style_texture2.png)
+
+Still on the Texture style, change Clipping to "No Clipping".
+
+
+Go to Layers, choose the Heightmap preset.
+Enable the Texture layer, then drag the Texture layer before the Heightmap layer.
+![Texture and Heightmap layers both enabled](https://evolvedexperiment.github.io/FMGImages/images/style_texture3.png)
+
+Lower the opacity of the texture under Style.  
+![Map showing both heightmap and image overlay](https://evolvedexperiment.github.io/FMGImages/images/style_texture4.png)
+Alternatively you can lower the opacity of the heightmap - it depends on what looks best to you.  
+At this point you should be able to see both your map and the image.
+You can play with it till everything looks clear.
+
+
+Go to Tools, Heightmap, Erase.
+Initially it will hide the Texture layer - go to Layers, then enable the Texture layer again, and it should show 
+both the heightmap and your image.