This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Landscape Tool
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
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
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Landscape

The section contains settings that control rendering of Landscape Terrain.

Landscape rendering settings

Landscape Terrain rendering settings

All the settings are also available via Console.

Operations Per Frame The maximum number of Landscape texture draw operations (asyncTextureDraw) that can be performed per frame.
Range of values: [1, 1000]. The default value is 10.
Console access: render_landscape_operations_per_frame (API control)
Mask Dithering The global dither amount multiplier to be used for rendering details of the Landscape Terrain. Dithering enables reduction of graphical artefacts in case of increased Mask Contrast values set for a detail. This is a global multiplier for dithering values set for each detail mask.
Range of values: [0.0f, 1.0f]. The default value is 1.0f.
Console access: render_landscape_terrain_mask_dithering (API control)

Geometry#

Terrain geometry rendering settings

Preset The index of the Landscape Terrain geometry preset used at the moment.
Notice
Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via API has no effect. The parameter value set via the last API call shall be used only when the Custom preset is active. When checking the current parameter value via API you'll get the corresponding setting stored in the active preset (default or custom one).
One of the following values:
  • Low (by default)
  • Medium
  • High
  • Ultra
  • Extreme
  • Custom

Console access: render_landscape_terrain_geometry_preset (API control)
Holes The value indicating if decal-based holes for the Landscape Terrain are enabled. Enabled by default.
Console access: render_landscape_terrain_geometry_holes (API control)
Visibility Distance The maximum visibility distance for the Landscape Terrain, in meters. The terrain is visible, as long as the distance between the camera and the terrain does not exceed this value.
Range of values: [0.0f, inf]. The default value is 30000.0f.
Console access: render_landscape_terrain_visible_distance (API control)

Customizable Settings#

The following settings are available when the Custom preset is selected.

Geometry custom settings

Geometry Settings
Geometry Progression The progression of Landscape Terrain geometry tessellation.
Range of values: [0.0f, 50.0f]. The default value is 1.5f.
Console access: render_landscape_terrain_geometry_progression (API control)

Geometry Fade Lods The intensity of fading between levels of Global Water geometry tessellation. This value can be increased to remove sharp edges between areas with different geometry density.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_water_geometry_fade_lods (API control)

Geometry Subpixel Reduction The minimum ratio between the polygon size (in screen space) to the size of an area in the viewport for skipping polygons rendering (the ones having a lower ratio will be removed).
Notice
Setting too high values may cause small but noticeable visual artifacts when the camera moves.

Range of values: [0.0f, 50.0f]. The default value is 6.0f.
Console access: render_landscape_terrain_geometry_subpixel_reduction (API control)

Geometry Polygon Size The size of Landscape Terrain polygons defining the maximum allowed density of Landscape Terrain geometry.
Range of values: [0.0f, 1000.0f]. The default value is 0.01f.
Console access: render_landscape_terrain_geometry_polygon_size (API control)

Streaming#

Terrain streaming rendering settings

Preset The index of the Landscape Terrain streaming preset used at the moment.
Notice
Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via API has no effect. The parameter value set via the last API call shall be used only when the Custom preset is active. When checking the current parameter value via API you'll get the corresponding setting stored in the active preset (default or custom one).
One of the following values:
  • Low (by default)
  • Medium
  • High
  • Ultra
  • Extreme
  • Custom

Console access: render_landscape_terrain_streaming_preset (API control)
Detail Albedo Texture Resolution The resolution of the albedo texture for details of the Landscape Terrain. One of the following values:
  • 64×64
  • 128×128
  • 256×256
  • 512×512
  • 1024×1024 (by default)
  • 2048×2048
  • 4096×4096
  • 8192×8192
  • 16384×16384

Console access: render_landscape_terrain_detail_resolution_albedo (API control)
Detail Height Texture Resolution The resolution of the height texture for details of the Landscape Terrain. One of the following values:
  • 64×64
  • 128×128
  • 256×256
  • 512×512
  • 1024×1024 (by default)
  • 2048×2048
  • 4096×4096
  • 8192×8192
  • 16384×16384

Console access: render_landscape_terrain_detail_resolution_height (API control)
Detail Additional Mask Texture Resolution The resolution of the additional mask texture for details of the Landscape Terrain. One of the following values:
  • 64×64
  • 128×128
  • 256×256
  • 512×512
  • 1024×1024 (by default)
  • 2048×2048
  • 4096×4096
  • 8192×8192
  • 16384×16384

Console access: render_landscape_terrain_detail_resolution_additional_mask (API control)
Target Resolution The target resolution (width x height) for the Landscape Terrain, in pixels.
1344 х 756 - (default)
Console access: render_landscape_terrain_vt_target_resolution (API control)
Texture Filtering The filtering mode for the Landscape Terrain textures. The following values are available:
  • Low — use the lower mip-level
  • Medium — use the higher mip-level
  • High — linearly interpolate between adjacent mip-levels
Option #2 is selected by default (see above).
Console access: render_landscape_terrain_vt_filtering (API control)

Customizable Settings#

The following settings are available when the Custom preset is selected.

Streaming custom settings

Streaming Settings
Texture Memory Size The value defining memory consumption for the Landscape Terrain textures. The value is interpreted as follows:
  • 0.0f - 3072×3072 (~200 MB of VRAM)
  • 1.0f - 16384×16384 (~3.1 GB of VRAM)
  • 0.4f - 8192×8192 (~860 MB of VRAM)

Range of values: [0.0f, 1.0f]. The default value is 0.4f.
Console access: render_landscape_terrain_vt_memory_size (API control)
Detail Level By Angle The value indicating detail level reduction depending on the inclination of the the Landscape Terrain polygons relative to viewing direction. Can be used to reduce streaming load and memory consumption. The value of 1 corresponds to the pixel-to-pixel quality, and lower values decrease it.
Range of values: [0.0f, 1.0f]. The default value is 0.95f.
Console access: render_landscape_terrain_vt_detail_level_by_angle (API control)

Tiles Update Per Frame The number of tiles passed to the virtual texture of the Landscape Terrain each frame.
Range of values: [1, 256]. The default value is 60.
Console access: render_landscape_terrain_vt_tiles_update_per_frame (API control)
Tiles Load Per Frame The number of Landscape Terrain tiles loaded per frame. You can decrease the value of this parameter to reduce spikes, but in this case streaming becomes slower and more noticeable.
Range of values: [1, 64]. The default value is 4.
Console access: render_landscape_terrain_vt_tiles_load_per_frame (API control)
Tiles Reload Per Frame The number of tiles to be reloaded per frame after applying changes to the Landscape Terrain surface.
Range of values: [1, 64]. The default value is 4.
Console access: render_landscape_terrain_vt_tiles_reload_per_frame (API control)
Texel Size The texel size of the Landscape Terrain render textures representing the maximum level of detail for the albedo, normal, and height components of the Landscape Terrain.
Range of values: [0.0001f, 1.0f]. The default value is 0.001f.
Console access: render_landscape_terrain_texel_size (API control)

Culling#

Culling Aggressive The value indicating if frustum culling optimization is enabled for the Landscape Terrain. When enabled, the number of culled polygons increases thereby increasing performance. In case of any issues with polygons rendering, try disabling this option (however, note that performance may drop). Enabled by default.
Console access: render_landscape_terrain_culling_aggressive (API control)
Culling Frustum Padding The multiplier for the size of viewing frustum to be used for culling polygons of the Landscape Terrain (value, by which the borders of the current frustum are increased). Frustum culling is performed for the frustum of the increased size. By the maximum value of 1, the frustum borders will be increased by the size of the current frustum.
Range of values: [0.0f, 1.0f]. The default value is 0.1f.
Console access: render_landscape_terrain_culling_frustum_padding (API control)
Culling Back Face The threshold used for culling tessellation patches of the Landscape Terrain oriented to the camera with their back faces (it is a multiplier for the angle between the tessellation patch normal and the camera's view direction). Higher values result in a smaller angle between the patch normal and the camera's view direction required for culling this patch.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_landscape_terrain_culling_back_face (API control)
Culling Oblique Frustum The multiplier for culling of tessellation patches of the Landscape Terrain beyond the oblique frustum plane. Higher values result in more patches culled.
Range of values: [0.0f, 1.0f]. The default value is 0.9f.
Console access: render_landscape_terrain_culling_oblique_frustum (API control)

Cache#

CPU Cache Size The CPU cache size to be used for landscape terrain rendering, in percentage of the total memory. CPU cache size affects intersections, physics, streaming, etc. The size of CPU cache depends on the scene.
Range of values: [1, 100]. The default value is 10.
Console access: render_landscape_cache_cpu_size (API control)
GPU Cache Size The GPU cache size to be used for landscape terrain rendering, in percentage of the total GPU memory. GPU cache is used to accumulate tiles, that are visible to the camera, before streaming them to the megatexture.
Notice
High-resolution maps require larger cache capacity.

Range of values: [1, 100]. The default value is 4.
Console access: render_landscape_cache_gpu_size (API control)
GPU Cache Life Time The lifetime of GPU cache used for Landscape Terrain rendering, in frames.
Range of values: [1, 60]. The default value is 4.
Console access: render_landscape_cache_gpu_life_time (API control)
Last update: 2022-03-10
Build: ()