Landscape
The section contains settings that control rendering of Landscape Terrain.
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) |
| Advanced | Exposes the Advanced Settings for Landscape Terrain. |
Geometry#
| Preset | The index of the Landscape Terrain geometry preset used at the moment. Notice One of the following values: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).
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) |
| Detail Max Height |
The maximum height for detail displacement clamping. Adjust this value to the highest height value used in details in case of artifacts of stepped geometry caused by insufficient bit depth.
Range of values: [0.0f, 10.0f]. The default value is : 0.5f. Console access: render_landscape_terrain_geometry_detail_max_height (API control)
|
Customizable Settings#
The following settings are available when the Custom preset is selected.
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 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#
| Preset | The index of the Landscape Terrain streaming preset used at the moment. Notice One of the following values: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).
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:
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:
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:
Console access: render_landscape_terrain_detail_resolution_additional_mask (API control) |
| Detail Compression | The mode of detail textures compression. Compressed detail textures take less video memory.
One of the following values:
Console access: render_landscape_terrain_detail_compression (API control) |
| Texture Filtering | The filtering mode for the Landscape Terrain textures. The following values are available:
Console access: render_landscape_terrain_vt_filtering (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) |
Customizable Settings#
The following settings are available when the Custom preset is selected.
Streaming Settings
| Texture Memory Size | The value defining memory consumption for the Landscape Terrain textures. The value is interpreted as follows:
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 By Depth | The
value indicating if culling by depth is enabled. Keep this option enabled to get the performance higher due to culling of tiles occluded by geometry and Landscape Terrain itself.
enabled by default.
Console access: render_landscape_terrain_culling_by_depth (API control) |
|---|---|
| Culling Frustum 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_frustum_aggressive (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) |
|---|---|
| CPU Cache Prefetch Radius | The radius within which heights data is pre-loaded into memory for correct calculation of collisions and intersections. Range of values: [0.0f, inf]. The default value is : 0.0f. Console access: render_landscape_cache_cpu_prefetch_radius (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) |
Advanced Settings#
The following settings are available when the Advanced option is enabled. The advanced settings do not affect the visual quality of Landscape Terrain and intended for fine tuning of data streaming and rendering performance-wise.
Warning
It is not recommended to make changes to the default values without understanding these settings. Improper configuration may lead to major performance issues.
Advanced Streaming Settings#
| Sampler Feedback Screen Resolution | The resolution of the screen buffer used to detect visible tiles and what MIP-levels to be loaded.
One of the following values:
Console access: render_landscape_terrain_vt_sampler_feedback_screen_resolution (API control) |
|---|---|
| Sampler Feedback Buffer Resolution | The resolution of the buffer used to transfer data about tiles and what MIP-levels to be loaded.
From 1x1 to 1024x1024 Default: 80x60 Console access: render_landscape_terrain_vt_sampler_feedback_buffer_resolution (API control) |
| Streaming Threads | The
number of threads used for streaming.
Range of values: [0, 32]. The default value is : 1. Console access: render_landscape_terrain_streaming_threads (API control) |
| Streaming Per Lods | The value indicating if streaming per LODs (MIP maps) is enabled. Disable this option to make streaming faster by skipping loading of intermediate MIP-levels for textures.
enabled by default.
Console access: render_landscape_terrain_streaming_per_lods (API control) |
Advanced Culling Setings#
| Culling Depth Resolution | The
resolution of the buffer used for culling by depth.
Range of values: [4, 2048]. The default value is : 64. Console access: render_landscape_terrain_culling_depth_resolution (API control) |
|---|---|
| Culling Patch Resolution GPU | The
number of subdivisions for patches of Landscape Terrain culled on the GPU side that are to be tessellated. By lowering this value you reduce the load on CPU, by increasing it you reduce the load on GPU. The point is to find a trade-off between loads in the given conditions on the target hardware.
Range of values: [4, 64]. The default value is : 32. Console access: render_landscape_terrain_culling_patch_resolution_gpu (API control) |
| Culling Patch Resolution CPU | The
number of subdivisions for patches of Landscape Terrain culled on the CPU side that are to be passed to GPU. The lowest value of 2 corresponds to no subdivisions at all, i.e. all patched will be culled on the CPU side. By increasing this value you can reduce the load on CPU as more patches will be checked for visibility on the GPU side.
Range of values: [2, 64]. The default value is : 2. Console access: render_landscape_terrain_culling_patch_resolution_cpu (API control) |
| Culling Patch Batching | The
number of culling patches of Landscape Terrain processed in a batch. The higher this value, the more patches will be checked for visibility on CPU at once.
Range of values: [1, 64]. The default value is : 16. Console access: render_landscape_terrain_culling_patch_batching (API control) |
| Culling Padding Triangles | The
padding between LODs of tessellated polygons.
Range of values: [0.0f, inf]. The default value is : 1.0f. Console access: render_landscape_terrain_culling_padding_triangles (API control) |
| Culling Padding Patch GPU | The
padding between LODs of patches culled on GPU.
Range of values: [0.0f, inf]. The default value is : 1.0f. Console access: render_landscape_terrain_culling_padding_patch_gpu (API control) |
| Culling Padding Patch CPU | The
padding between LODs of patches culled on CPU.
Range of values: [0.0f, inf]. The default value is : 1.0f. Console access: render_landscape_terrain_culling_padding_patch_cpu (API control) |
| Culling Map | The
extent of culling of Landscape Layer Maps with the distance. In case small Landscape Layer Maps disappear too soon with the distance, try increasing this value.
Range of values: [0.0f, 1.0f]. The default value is : 0.3f. Console access: render_landscape_terrain_culling_map (API control) |
Last update:
2024-04-19
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)