Overview

Description

Real World Terrain is designed to generate Terrains, Meshes and Gaia stamps, based on real Earth elevation data, and buildings, roads, grass, trees, based on data from Open Street Map.

With Real World Terrain comes utility that allows you to select the necessary part on Google Maps, a set of tools for post-processing terrains, textures, place objects on the map.

 

Specification

Real World Terrain uses:

  • For elevation maps uses:
    • SRTM v4.1 elevation maps, accuracy of 3 arcseconds (90 meters). The relative error in height for the data of less than 6 meters.
    • SRTM 30. Accuracy of 1 arcseconds (30 meters). 
    • Bing Maps Elevation API. Accuracy: 10m – USA, 90m - 56° S - 60° N, 900m – other.
    • Mapbox. Accuracy is unknown.
  • To create additional objects used data «Open Street Map».
  • To create textures used: Google Maps, ArcGIS, Map Quest, Nokia Maps (here.com), Virtual Earth (Bing Maps), Open Street Map.

Note: SRTM data do not contain water depth maps, so zero height is used for seas and oceans.

Note: When using SRTM 30, to bypass the problem with SSL in Mono, authorization to earthdata.nasa.gov and downloading of data goes using our proxy server. We do not cache and store private data that used for downloading.

 

Updating from Real World Terrain v2.x

Real World Terrain v3.x is not compatible with Real World Terrain v2.x.

Before you import Real World Terrain v3 remove the old version of Real World Terrain.

 

Using

Select the menu item «Window / Infinity Code / Real World Terrain / Open Real World Terrain», to open Real World Terrain window. 

Enter the coordinates of the area in decimal, configure the fields and click «Start».

Real World Terrain will automatically download the necessary elevation data, textures, «Open Street Map» data, create new Terrains containing the specified area, and add them to the scene. For each Terrain creates an information block containing the coordinates, texture, and giving the opportunity to re-create it with the new settings.

Created terrains are stored in «RWT_Result».

 

IMPORTANT

Real World Terrain works with a lot of data, and can, depending on the settings to use a lot of memory. 

We do not limit Real World Terrain settings, so you can get exactly what you want. But when a large amount of generated Terrains, you may get an error of memory, with crashes to Unity Editor.

To create the most detailed Terrains and avoid mistakes, we recommend the following steps:

  • Create the desired area without textures, or with a minimum resolution (128 or less).
  • Create a texture with the required resolution.
  • Create additional objects.

After the successful completion of each step to save your scene.

 

Generation of Gaia stamps

Select the menu item «Window / Infinity Code / Real World Terrain / Open Real World Terrain», to open Real World Terrain window.

Enter the coordinates of the area in decimal, select «Result - Gaia Stamp», specify the required resolution and click «Start».

Note: Real World Terrain uses Gaia's built-in features to generate terrains, so only Gaia stamp is created.

Real World Terrain will create a new RAW object that contains elevation data.

RAW object will be scanned using Gaia Scanner and saved as Gaia stamp in «Assets / Gaia / Stamps / Bases» folder.

The new Gaia stamp will be opened in Gaia Stamper.

You will need to specify the required size, position and Base Level, and click «Stamp».

Read more about working with Gaia stamps in the Gaia documentation.

Note: If you do not have a Gaia Session Manager in the scene, the new Session Manager will be created.

 

Commercial use

You can use terrains, buildings, roads, rivers, trees, grass, created with Real World Terrain, for commercial purposes.

The rights to the commercial use of textures depending on the selected provider. You are responsible to read the license agreement on the provider's site. 

 

 

Real World Terrain Window

Description of fields

Along with most of the fields added icons, when you hover on which you can read a summary of the field. Clicking on the icon will open a detailed description of the field.

File - allows you to export and import settings.

History - contains the history of generations.

Settings - opens the settings window.

Decimal coordinates - the coordinates of the top-left and bottom-right corners of the area in decimal format. 

Title - a description of the current generation. Used only in history.

Insert the coordinates from the clipboard - inserts the coordinates copied in the helper.

Run the helper - open the helper.

Get the best settings for the specified coordinates - opens the wizard that will help you get the best result.

Show Open Street Map - opens Open Street Map in the browser on your current location. It is useful to know which objects are marked on the selected area.

Elevation Provider – provider of elevation data.

  • SRTM
  • Bing Maps. Required Bing Maps API Key.
  • SRTM 30. Required a login / password for earthdata.nasa.gov.
  • Mapbox. Required a Mapbox API key (public token).

 

Result type - the type of object being created. 

  • Terrain - standard Unity Terrain. After creating the object, you will be available built-in tools to work with the Terrain. 
  • Mesh
  • Gaia Stamp

Count terrains - the number of new terrains by longitude and latitude.

Size type - the method of determining the size of created Terrains.

  • Real world sizes. Width equal to the average of the lengths of the upper and lower parallels. Height equal to the length of the meridian.
  • Mercator sizes. The size of one degree of latitude and longitude is fixed.

Scale - a scaling factor to the new area.

Max elevation - the maximum height of the new area.

  • Auto detect - the maximum height is determined automatically. Recommended.
  • Real World Value - the maximum height is 15,000 meters.

Max underwater depth - the value used when no value of the height map. Usually it is the sea, oceans, lakes. Uses the absolute depth, such as «-30».

Detail Resolution - resolution map Detail Map.

Resolution Per Patch - indicates the size in pixels of each Detail Path.

Base Map Resolution - resolution Base Map.

Height Map Resolution - resolution height map.

Create prefab - specifies whether to create prefab, in the folder results. Create prefab takes some time.

Generate textures - indicates whether the created texture. Important: Textures are for informational purposes only.

Provider - the source that will be downloaded texture. Textures derived from different providers vary in quality, maximum detail and conditions of use.

Type - the type of texture map.

Count textures - number of created texture. Only Mesh.

Texture width / height - size of the texture created for each terrains.

Max level - the highest level of approximation for the textures.

Generate buildings - specifies whether to create buildings and walls.

Generate roads - specifies whether to generate roads. This field will be available if the integration with EasyRoads3D v3 or Road Architect is enabled.

Generate trees - specifies whether to create trees.

Generate grass - specifies whether to create grass.

 

 

History

It contains the history of all runs Real World Terrain.

Each record contains fields:

  • Number.
  • Title. If the title is empty, then the coordinates of the area are displayed.
  • Time of starting the generation.
  • > - restores the generation settings.
  • X - remove a record from the history.

 

Best Settings

If you do not know what settings to use for the selected area, click «Get the best settings for the specified coordinates». Move the sliders to the desired quality setting and press «Apply».

 

Settings of Real World Terrain

To open the Settings window, click «Settings» in the upper part of the window.

In the settings you can:

  • Change the folder of the application cache. This is useful if you want to use a shared cache for multiple applications.
  • Specify the name of the created GameObject.
  • Enable or disable working with third-party assets. To enable will be available only assets that are present in the project.

 

Clear the cache

Real World Terrain uses a large amount of data that it caches in the folder «RWT_Cache». If this data is not more than you need, you can clear cache by pressing the «Clear cache» in the Real World Terrain.

 

Helper

Usage of the helper

Click «Run the helper», to show a helper. Helper will run in the default browser with the coordinates specified in Real World Terrain.

Helper contains:

  • A search box.
  • Google map with a frame added to it that indicates the area that will be used in Real World Terrain. The frame can be resized and moved. To move the entire frame, hold down «CTRL».
  • Block information on the current position, the code to copy and control buttons.
    • The button «Add POI» adds a new POI (point of interest) in the center of map.
    • The button «Place selector» fits the frame to the visible area of ​​the map and set the frame size - 70% of the visible area.
    • The button «Show Open Street Map» - opens in a new tab «openstreetmap.org» in the same position in which the map in the helper.
    • The button «Show download links» shows the download links height maps.
  • Block POI lists all the POI on the map. What would change the title of the POI, double-click on the title. POI on the map supports Drag and Drop.
  • Download links height maps of the selected area.

 

Place the frame on the desired area on the map, select and copy the text in the block «Copy this to Clipboard». In Real World Terrain, click «Insert the coordinates from the clipboard» and selected in the helper coordinates frame will be inserted into Real World Terrain.

 

 

Alternative helper

If you have any problems when using the built-in helper, you can use an alternative helper:

http://service.infinity-code.com/RWT_Helper/RWT_Helper.html

 

POI

Contains a list of points of interest. After creating the terrains all the POI will be placed in right places. You can quickly navigate to the desired POI double-clicking on the line in the window «Hierarchy».

 

 

Additional features

Generation of additional elements (terrain only)

Real World Terrain can automatically create buildings, roads, trees and grass, based on real data from «Open Street Map».

Before the creation of additional objects please visit «www.openstreetmap.org» and make sure that you are required objects are marked on the map. In Europe, perfectly marked, almost all of the city. In America, most buildings are not marked.

Important: the created objects may be slightly different from the picture on the texture. This is because the layout objects in «Open Street Map». If the building is present on the texture, but not created, then it means that it is not marked in «Open Street Map».

For buildings and walls added a description of all available tags «Open Street Map». For many of the buildings there including address, name, height, etc.

For buildings and walls are automatically generated UV-maps.

If the tag contains the height or number of floors, the object will be created with the correct height. You can always correct height, specifying the desired value and pressing the «Update». For buildings can change the type and height of the roof.

If the building was created with the wrong normals walls or roof, you can quickly fix it by pressing «Invert wall normals» or «Invert roof normals» respectively.

 

 

Regeneration (terrain only)

You can recreate the already created objects with the new settings.
To do this, select «RealWorld Terrain» in the «Hierarchy» and click:

Regenerate terrains - to change the parameters Terrains.

Regenerate textures - to create textures with the new settings.

Regenerate additional - to rebuild the buildings, roads, trees and grass.

Scale - for quick scaling existing Terrains.

 

Utils

Overview

Real World Terrain contains a set of tools that will be useful for the search and placement of objects on the map, working with the POI, etc.

These tools are grouped in «Real World Terrain Container / Utils».

 

Building Manager

Tool to search the buildings.

It allows you to filter the buildings on the values of tags.

Enter the street name, house number or any other information contained in the tags, and will show buildings that contain tags with the specified value.

 

Object Placer

A tool for placing objects on the terrains by geographical coordinates.

This tool works in two modes:

  • Creating a new GameObject at the specified coordinates.
  • Updating existing provisions GameObject.

To create a new select GameObject «Place New Object», specify prefab and coordinates, and click «Place».

To update position of existing GameObject select «Update Position», specify GameObject and coordinates, and click «Update».

 

Place your cursor on the terrains, to see the location under the cursor.

Press «CTRL + SHIFT», to insert the coordinates under the cursor in coordinates fields.

 

POI Manager

POI management tool created using the helper or specified before generating.

For each POI is displayed: name, coordinates and buttons:

S - Select POI GameObject.

P - Open the POI in Object Places.

 

Scaler

Tool to change the size of terrain in the scene.

It works in two modes:

  • Relative. Specify the relative scale of terrains and click Apply.
  • Absolute. Specify a new absolute size for terrains and click Apply.

 

Scale first SplatPrototype allows you to adjust the size of the texture so that it looks correct after scaling.

Show Location

The tool, showing the geographical coordinates of under cursor and the scene view camera.

 

 

Post-processing of textures

Overview

Real World Terrain contains set of tools for post-processing textures.

These tools are grouped in «Real World Terrain Container / Postprocess».

 

Brightness, Contrast and HUE

Tool to adjust brightness, contrast, hue and saturation of the image.

Left - the original image, to the right - a preview of the result.

Specify the required values using the sliders and press «Apply».

 

Color Balance

Tool to change the color balance of the image.

Left - the original image, to the right - a preview of the result.

Specify the required values using the sliders and press «Apply».

 

 

Color Levels

Tool to change the color range of the image.

Left - the original image, to the right - a preview of the result.

Specify the required values using the sliders and press «Apply».

 

 

Generate Grass from Texture

Tool to generate grass based on texture.

Add grass texture, and specify grass parameters. 

Add colors, which will be created grass.

To work was faster for each color indicates range of values.

Click «Generate preview», to see the area to be created grass.

Click «Generate grass», to create grass and close the window.

You can save and load settings using the buttons at the top of the window.

To remove the grass, remove the relevant Detail in a script «Terrain».

 

Generate SplatPrototypes from Texture

Tool to generate SplatPtototypes based on texture.

Add base texture, specify parameters. Base texture will be used for all terrain. Add SplatPrototype, you want to use. For each SplatPrototype add color, so it will be created.

To work was faster for each color indicates range of values.

Click «Generate preview», to see the area to be used corresponding SplatPrototype.

Click «Generate SplatPrototypes», to create SplatPrototypes and close the window.

You can save and load settings using the buttons at the top of the window.

 

Export / import RAW data

Real World Terrain can export and import RAW data: heightmaps, detailmaps, alphamaps and texture.

Select generated terrains, and in «Real World Terrain Container / Export / Import Raw» select a menu item.

In the export / import window specify the required color depth (8 or 16 bits) and the order of the bytes (Windows or Mac).

 

Third Party Assets

Overview

Third-party assets is not contains on Real World Terrain and integration is disabled by default.

Import the asset into your project and enable integration in Real World Terrain settings.

If you want to remove the asset from the project, first disable it in Real World Terrain settings.

If you forget to to disable asset and removed it, you will see an error in the console. To manually remove the integration with the asset, open PlayerSettings (Edit / Project Settings / Player), and remove the corresponding entry from «Scripting Define Symbols».

 

Building BuildR Procedural Generator and BuildR2

https://www.assetstore.unity3d.com/en/#!/content/82220

It allows you to generate procedural editable buildings.

Supported BuildR v1.x and BuildR2.

How to generate buildings using BuildR:

  • Enable integration with BuildR in Real World Terrain settings;
  • Real World Terrain / Generate Buildings - ON;
  • Real World Terrain / Building Generator - BuildR.

All buildings generated using Real World Terrain is editable, and you can completely change the style and setting of the buildings.

 

EasyRoads 3D v3

https://www.assetstore.unity3d.com/en/#!/content/469

It allows you to generate editable roads.

How to generate the roads using EasyRoads 3D:

  • Enable integration with EasyRoads 3D in Real World Terrain settings;
  • Real World Terrain / Generate Roads - ON.

All roads created by the Real World Terrain is editable.

Note: only supported EasyRoads 3D v3. EasyRoads 3D v2.x is not supported.

 

Gaia

https://www.assetstore.unity3d.com/en/#!/content/42618

A great all-in-one tool for generating terrains.

The integration of this asset does not need to enable or configure.

You just need to have Gaia in the project.

 

Online Maps

https://www.assetstore.unity3d.com/en/#!/content/13261

It allows you to show the location from Real World Terrain on a dynamic map.

Integration with Online Maps enabled using OnlineMapsRWTConnector component.

Add this component to the map GameObject, and click «Enable Real World Terrain».

 

Relief Terrain Pack (RTP)

https://www.assetstore.unity3d.com/en/#!/content/5664

Great shader for terrains. Using this shader, the result will look a lot better.

Relief Terrain Pack does not require configuration. Just enable integration with Relief Terrain Pack in Real World Terrain settings.

 

Road Architect

https://github.com/MicroGSD/RoadArchitect

Allows generating roads.

How to generate roads using Road Architect:

  • Enable Road Architect support in the settings;
  • Real World Terrain / Generate Roads - ON.

All roads created using Real World Terrain is editables.

 

 

Volume Grass

https://www.assetstore.unity3d.com/en/#!/content/436

It allows you to generate a volumetric dynamic grass.

How to generate the grass using Volume Grass:

  • Enable the integration with Volume Grass in Real World Terrain settings;
  • Real World Terrain / Generate Grass - ON;
  • Real World Terrain / Grass Generator - Volume Grass.

Note: If you try to generate the grass outside the terrains, Volume Grass can cause freezing of Unity Editor.

 

 

WorldStreamer

https://www.assetstore.unity3d.com/en/#!/content/36486

Keeps objects in the separate scenes, and dynamically load them during use. 

This allows you to greatly increase the performance of your application.

How to use WorldStreamer:

  • Enable the integration with WorldStreamer in Real World Terrain settings;
  • Generate all terrains;
  • Real World Terrain Container / Finish / Open WorldStreamer.

 

Real World Terrain API

Detailed information about all the available classes, methods and fields can be found in API Reference.

http://infinity-code.com/docs/api/real-world-terrain/

 

The order of the values in the coordinates:

Vector2, Vector3: X - longitude, Y - latitude;

Parameters of methods: first - the longitude, second - the latitude.

 

 

Updating versions

In Unity Asset Store, we will send only the stable version. Renewal period is several months.

Real World Terrain has built-in update system, using which you can update Real World Terrain to the latest version and get early access to all versions and updates.

Click «Window / Infinity Code / Real World Terrain / Check Updates», to open the window checking for updates. Enter your Invoice Number (digits only), select a channel of updates and click «Check New Versions».

You can find out your Invoice Number in order confirmation, or visit the account transaction page in Unity Asset Store:

https://www.assetstore.unity3d.com/en/#!/account/transactions

 

If from the current version was released more than 10 updates in the selected channel then will only show the last 10 updates.

If updates are available, you can read the list of changes and download the update.

 

If you have any problems with installing the update, then:

  1. Open an empty scene.
  2. Delete the folder «Infinity Code / Real World Terrain».
  3. Import the new version of Real World Terrain to the project.

If you want to return to the previous version of Real World Terrain, select the channel «Stable Previous». Using this channel, you can get 10 previous updates.

 

Real World Terrain automatically checks for updates every 24 hours. If a new version is available, you will see a red button in Real World Terrain. When clicked, will open check for updates window.

Automatic check for updates does not require Invoice Number, and works on the selected channel updates. If you do not select a channel update, it will be checked only stable versions.

 

 

Troubleshooting

Known issues

If you have trouble downloading elevation maps in Real World Terrain, or you want to download them manually (eg on another computer), follow these steps:

  • Select the desired area in the helper.
  • Press the «Show download links».
  • Download the files.
  • Put the files «*.asc» from the archives to folder «{Project} / RWT_Cache / Heightmaps».
  • Start Real World Terrain.

 

If you have trouble downloading textures, change provider of textures

 

If the building has inverted normals, click «Invert normals». 

 

To create an intersection with Road Architect, select the nodes, which must be crossed, turn on «Allow intersect», and move the one node to the other node.

 

Your problem is not listed

Please write us about your problem (support@infinity-code.com). We will try to fix all errors and release an update as soon as possible.

 

Support

If you have something does not work, you find a bug, or you have a suggestion, please contact us.

We strive to answer all messages in the customer support within 24 hours.

 

Frequently asked questions

Q: What is the maximum area can be created.

A: We are at a time creating an area of ​​10x10 angular degrees. It's a little larger than the size of Germany. But the maximum created territory, strongly depends on the settings of Real World Terrain.

English