This page has been translated automatically.
视频教程
界面
要领
高级
实用建议
基础
专业(SIM)
UnigineEditor
界面概述
资源工作流程
Version Control
设置和首选项
项目开发
调整节点参数
Setting Up Materials
设置属性
照明
Sandworm
使用编辑器工具执行特定任务
如何擴展編輯器功能
嵌入式节点类型
Nodes
Effects
Decals
光源
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
编程
基本原理
搭建开发环境
使用范例
C++
C#
UnigineScript
统一的Unigine着色器语言 UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
材质和着色器
Rebuilding the Engine Tools
GUI
双精度坐标
应用程序接口(API)参考
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
创建内容
内容优化
材质
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials

Importing Terrain from Gaea 2

Once you've finished creating your terrain in Gaea 2, you can export it to UNIGINE.

Marking Nodes for Export#

Make sure you have nodes set up for both the heightmap (terrain elevation) and the albedo (terrain color).

Give the nodes clear and descriptive names (e.g., “Height” and “Albedo”) so the exported files are easily identifiable. Then mark these nodes for export.

Usually, the height map is the last node where terrain modifications were made, while the albedo is the very last node in the graph, after all coloring has been applied.

Export Settings#

To begin setting up your project, open the Build Settings window from the Project menu.

Resolution and Tiling#

Set the terrain resolution. The resolution determines the number of pixels in the exported height and albedo maps and directly affects the detail level of your terrain.

For resolutions above 8192 x 8192, exporting in tiles is recommended as this helps to avoid RAM limitations, especially when using 32-bit textures. To do that, in the Build Settings, select Tiled Images and define the Tile Size. Gaea will produce multiple tiles to cover the full terrain.

For example, exporting a terrain at 8192 x 8192 resolution with 1024px tiles will produce an 8 x 8 grid of tiles (64 tiles total).

Setting the Build Folder#

Specify your build destination folder. You can use predefined tokens in the folder path to dynamically generate names based on project data.

Tile Suffix Pattern#

If you're using tiling, configure the tile suffix pattern correctly.

Here's how the default patterns compare:

  • "_y%Y%_x%X%" (for Gaea 2)
  • "_%X_%Y" (for UNIGINE)

You can change the pattern in either Gaea 2 or UNIGINE, just make sure they match exactly to ensure correct tile loading and alignment.

Export Format#

Select the suitable export format. UNIGINE allows importing 8, 16, and 32-bit maps.

For heightmaps better use 32-bit to preserve elevation accuracy. Lower bit depths (8 or 16-bit) can bring visible artifacts, especially on large-scale terrains.

Notice
The RAW format is not supported for import.

Terrain Size#

Define your terrain's physical Height (vertical range) and Width (horizontal size) in meters.

Pay attention to:

  • Real Scale: Meters per pixel, defines detail density by showing how many meters are represented by each pixel. Сalculated as output resolution divided by width. (e.g. 4096 / 8192 = 0.5m/px)
  • Height-Scale Ratio: Defines the vertical exaggeration of the terrain. Calculated as height divided by width. (e.g. 2048 / 4096 = 0.5)

Start Build#

Once all settings are configured, click Execute Build to start the export process.

Importing#

To import the exported heightmap into UNIGINE, use the Landscape Layer Map as follows:

  • Landscape Asset
    • Size - Set the size of the Landscape terrain to match the size specified in the Gaea 2 export settings
  • Import Settings
    • Data Filling - Choose From Tileset
    • Data Sources - You can use either External Files or Assets. For better efficiency and faster loading times, it's recommended to import textures as assets
  • Heightmap
    • Heightmap - Select the first tile of your heightmap (or the only one, if you didn't use tiling in Gaea 2)
    • Height - Set the Height value to match the one specified in your Gaea 2 export settings.
  • Albedo
    • Albedo Color - Select the first tile of your albedo map (or the only one, if you didn't use tiling in Gaea 2)

Click Apply and then Reimport Data to load the terrain into your world.

The information on this page is valid for UNIGINE 2.20 SDK.

Last update: 2025-06-09
Build: ()