Image Overlay: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:


==What is the Image overlay==
==What is the Image overlay==
The Image overlay is a map layer that allows users to upload and display custom images over the project area in the Tygron Engine. Because not everything can be displayed using the available overlays, users can easily upload their own custom image as an overlay in the Tygron Engine.
The Image overlay is a layer that allows users to upload and display images over the project area in the Tygron Engine. <br>
A much used possibility of the Image Overlay is to import [[WMS]] data: geographically referenced data, accessible through an url. <br>
It is also possible to add a custom Image. Keep in mind that the allowed image size for custom images is 1024x1024 pixels. The image must also be in the .PNG format, the Portable Network Graphics format, which is a raster graphics file format that supports lossless data compression.


Examples of custom overlays can be: a transparent watermark layer, a large drawn image, a photo realistic image, custom markings, etc.
<gallery>
File:Watermark-overlay.jpg|Example of watermark overlay
File:DrawnImage-overlay.jpg|Example of a hand drawn image overlay
File:PhotoRealistic-overlay.jpg|Example of a photo realistic image overlay
File:CustomMarkings-overlay.jpg|Example of a custom image overlay with markings
</gallery>
==How to configure the Image overlay==
==How to configure the Image overlay==
{{Editor ribbon|header=3D World|bar=Overlays}}
{{Editor ribbon|header=3D World|bar=Overlays}}
To display a custom image as overlay in the Tygron Engine, an image must first be available and uploaded when creating the overlay. In order to do so, users have to keep in mind that the allowed image size for custom image overlays is 1024x1024 pixels. Any other format is now allowed. The image must be in the .PNG format, the Portable Network Graphics format, which is a raster graphics file format that supports lossless data compression.
===Uploading an image===
[[File:PropertiesImageOverlay.jpg|thumb|left|300px|Properties of the Image overlay on the right panel]]
[[File:ImageSelectorforOverlay.jpg|thumb|right|300px|Image selection pop up window]]
When the default Image overlay has been added to a project, nothing will be displayed, as there is no image assigned to the overlay yet. To assign an image to the overlay, the default overlay needs to be highlighted on the left panel first. On the right panel the overlay properties now become available, consisting of the name and image of this overlay. By clicking on the blue field, the image selection window opens. Here it is possible to use an already present custom image, or to upload a new custom image.


{{Editor steps|title=upload a custom image for an image overlay|Select in the editor '3D World' from the ribbon|Select 'Overlays' > 'Edit overlays' from the ribbon bar|Select the just added default image overlay from the list of active overlays on the left panel|Select the blue field on the right panel|Use the newly opened image selection window to upload and assign a custom image to the overlay}}
After adding the Image Overlay, the Configuration Wizard can be found on the right side of the screen. This wizard helps with importing the image.
There are three methods to import an Image: <br>
# '''Import an Image from a file.''' With this method a custom Image can be imported. Keep in mind that the size of the image should be 1024x1024 pixels and in .png format.
# '''Import from a Web Image Service.''' With this method it is possible to import a [[WMS]]. Read the corresponding page on how to import [[WMS]] data. <br>
# '''Select an Existing image.''' This method differs from the first option in that it is now possible to already select an existing (imported) Image from the Engine to display as an Overlay.


===Naming the overlay===
Also on the right panel the field 'Image Overlay Name' can be found. Here the user can enter a more relevant name for the overlay being created.
<br clear=all>
==Adding and removing the Image overlay==
==Adding and removing the Image overlay==
{{Editor ribbon|header=3D World|bar=Overlays}}
{{Editor ribbon|header=3D World|bar=Overlays}}


{{Editor steps|title=add an Image overlay|Select in the editor '3D World' from the ribbon|Select 'Overlays' > 'Edit overlays' from the ribbon bar|Select the Image overlay from the drop down menu on the bottom of the left panel|Select 'Add' from the bottom of the left panel|Rename the overlay, if required, on the right panel|Select the blue area on the right panel to upload and/ or select the desired image in the newly opened Image Selection window|The overlay icon will now appear under the mini map}}
{{Editor steps|title=add an Image overlay|Select in the editor '3D World' from the ribbon|Select 'Overlays' > 'Edit overlays' from the ribbon bar|Select the Image overlay from the drop down menu on the bottom of the left panel|Select 'Add' from the bottom of the left panel|Rename the overlay, if required, on the right panel|Use the Configuration Wizard to import an Image|The overlay icon will now appear on the right side of the interface}}


<gallery>
<gallery>
Line 36: Line 26:
File:SelectAddOverlay.jpg|4. Select 'Add' from the bottom of the left panel
File:SelectAddOverlay.jpg|4. Select 'Add' from the bottom of the left panel
File:OverlayParameters.jpg|5&6. Select and configure available properties on the right panel
File:OverlayParameters.jpg|5&6. Select and configure available properties on the right panel
File:OverlayIconPresent.jpg|7. The overlay icon will now appear under the mini map
File:OverlayIconPresent.jpg|7. The overlay icon will now appear on the right side of the interface
</gallery>
</gallery>



Revision as of 12:22, 6 August 2018

Template:Learned

What is the Image overlay

The Image overlay is a layer that allows users to upload and display images over the project area in the Tygron Engine.
A much used possibility of the Image Overlay is to import WMS data: geographically referenced data, accessible through an url.
It is also possible to add a custom Image. Keep in mind that the allowed image size for custom images is 1024x1024 pixels. The image must also be in the .PNG format, the Portable Network Graphics format, which is a raster graphics file format that supports lossless data compression.

How to configure the Image overlay

Template:Editor ribbon

After adding the Image Overlay, the Configuration Wizard can be found on the right side of the screen. This wizard helps with importing the image. There are three methods to import an Image:

  1. Import an Image from a file. With this method a custom Image can be imported. Keep in mind that the size of the image should be 1024x1024 pixels and in .png format.
  2. Import from a Web Image Service. With this method it is possible to import a WMS. Read the corresponding page on how to import WMS data.
  3. Select an Existing image. This method differs from the first option in that it is now possible to already select an existing (imported) Image from the Engine to display as an Overlay.

Adding and removing the Image overlay

Template:Editor ribbon

How to add an Image overlay:
  1. Select in the editor '3D World' from the ribbon
  2. Select 'Overlays' > 'Edit overlays' from the ribbon bar
  3. Select the Image overlay from the drop down menu on the bottom of the left panel
  4. Select 'Add' from the bottom of the left panel
  5. Rename the overlay, if required, on the right panel
  6. Use the Configuration Wizard to import an Image
  7. The overlay icon will now appear on the right side of the interface
How to remove an overlay:
  1. Select in the editor '3D World' from the ribbon
  2. Select 'Overlays' > 'Edit overlays' from the ribbon bar
  3. Select the desired overlay from the list of active overlays on the left panel
  4. Select 'remove' from the bottom of the left panel
  5. Confirm the removal in the pop up confirmation message

Sometimes it can be convenient to duplicate an already existing overlay. To do so, follow the steps for removal, but select 'Duplicate' in stead of 'Remove'.