GeotiffLandscape - UE4 Plugin
Adds geotiff files as UE4 Landscape height/weight map file type and custom data asset type. This can be used to generate real scale UE4 maps from existing locations. Geotiff digital elevation models (DEM) contain information about geo coordinates of the map and information about maximum and minimum elevation. With this information 1:1 scale Landscapes can be created using this Plugin. Also geotiff land cover files from the S2GLC can be imported to named landscape layers.
Features
- Landscape Heightmap Fileformat Geotiff
- Landscape Weightmap Fileformat Geotiff
- Landscape Weightmap Fileformat S2GLC
- Layered Landscape Material Example for S2GLC Layers
- GeotiffHeightmap Asset with 16bit of height in red and green channels of a Texture
- S2GLC Weightmap Asset with 12 gracscale layer maps
WARNING: This is experimental research code that will be subject of change.
This example was generated using a DEM from Opentopography and the corresponding section from S2GLC around this coordinates: 50.959057,14.061609.
Landscape textures in the screenshots are from CC0textures and FreePBR. Foliage assets from NaturePackage (was free for April 2020 in UE4 Marketplace) and PN_FoliageCollection.
Cutbacks
DEMs are usually not available at high resolutions. The popular NASA SRTM GL1 data provides an average resolution of 30 meter per pixel while UE4 usually uses 1 pixel per meter for Landscapes. The low resolution geotiff texture is therefore scaled up using bi-linear interpolation to reflect their geo-spatial extends in UE4 scale (1 heightmappixel -> 1 meter of landscape). However artifacts of the low resolutions remain visible.
UE4 Landscapes usually support height differences of 655.33 meter. When the height difference of the geotiff is larger, the full range will be used to map the height values and a small yellow warning sign besides the filename suggest a Z-Scale to correct the scaling factor. This scale is best entered into the landscape z scale box before importing.
Building
This plugin uses GeoReference, UnrealGDAL, ue4cli and conan-ue4cli to build and manage the required GDAL libraries.
- Download a Release of UnrealGDAL and place it in the Plugins directory or clone and follow instructions to build UnrealGDAL from source.
Usage
Add GeotiffLandscape to .uproject or .uplugin
"Plugins": [
{
"Name": "GeotiffLandscape",
"Enabled": true
}
]Add build dependencies to your modules
PublicDependencyModuleNames.AddRange(
new string[]
{
"GeotiffLandscape",
"GeotiffLandscapeEditor"
}
);Landscape import
Landscape Heightmap import
In Landscape mode when importing a heightmap you will notice a new filetype "DEM Heightmap .tif files". Several checks are performed to ensure the file can be imported. In theory all projected geo coordinate systems with coordinates in meter containing a single Int16 or Float32 rasterband layer of gray-scale values in meters should work fine. Although it really does not make much sense to generate a landscape from a spherical projection it is also possible to import WGS48 references heightmaps. This can be usefull when geographic accuracy is not that important to avoid the effort of converting material.
Landscape Weightmap import
TIF files can be interpreted in two ways for weightmap generation.
Single layer weightmap
The obvious interpretion of the grayscale values is as one weightmap. The grayscale values are mapped to a range of 0 to 1 that represent the layer weight.
Multi layer weightmap
S2GLC provides huge landcover geotiffs for europe. Using the geo reference of the heightmap we can crop the area of interest into a smaller file. This is currently done in QGIS but may be integrated in the import process later. The gray scale values in this image represent 15 classes of landcover:
- Clouds
- Artificial
- Cultivated
- Vineyards
- Broadleaf
- Coniferous
- Herbaceous
- MoorsHeath
- Sclerophyllous
- Marsh
- Peatbog
- Natural
- Snow
- Water
- NoData
For every class a landscape layer can be created (The layers are automagically created when using the LMT_S2GLCExample material for the landscape (except NoData and Clouds atm.)). This material also shows how to implement landcover dependent foliage using the Landscape Grass Tool. When importing the weightmap into the layer, the name of the layer has to match one of the landcover classes to select the grayscale from the S2GLC geotiff.
A special implementation interpretes distinct grayscale values as distinct weightmaps. The resulting weightmaps have a weight of 1 where the TIF pixel has the matching grayscale value and 0 where it has not.
To enable UE4 to distinguish between regular TIF weightmaps and S2GLC weightmaps, this plugin introduces the file extension *.s2glc. This is basically a *.tif file that is supposed to only have the 15 S2GLC grayscale values.
DataAssets
If you want to use render targets to generate the landscape at runtime you'll need all the height- and weightdata as textures and the geo reference metadata. For this purpose Geotiff heightmaps and S2GLC files can also be imported as DataAssets.
Geotiff Heightmap DataAsset
Geotiff heightmap assets contain the geo information and a texture2D where the 16 bit height values are split into the red and green channel of the texture. Because .tif files can also be imported as Texture without the geo reference information it is important to select the file type "Geotiff File (.tif)" when importing an asset into the content browser otherwise the pure texture import will be auto-selected.
S2GLC Weightmap DataAsset
S2GLC DataAssets contain a texture for each of the 15 layers (except NoData and Clouds) and the geo reference information.
Funding
Development of this code was partially funded by the German Federal Ministry of Education and Research (BMBF) under funding reference number 13FH1I01IA.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent