Gen Terrain Module

Procedural terrain and road lattice generation module for the gen editor.

Overview

The terrain module provides tools for procedural terrain analysis and road network generation. It reads terrain heightmap data, manages road decals, generates lattice-based road layouts within regions, and provides debug visualization with colored markers. Works with TerrainBlock for height queries and the decal road system for road placement.

Module Table: T

Default Parameters

Key Functions

Debug Marker Colors

Terrain Access

-- The module reads terrain data on initialization:
local tb = extensions.editor_terrainEditor.getTerrainBlock()
local grid = tb:getSquareSize()           -- Grid resolution
local tersize = tb:getObjectBox():getExtents() / grid  -- Terrain size in grid units
local tfr = tb:getWorldBox().minExtents   -- World-space origin

-- Height query at any point:
local height = core_terrain.getTerrainHeight(point)

Dependencies

Usage Example

local T = require('/lua/ge/extensions/editor/gen/terrain')

-- Inject the decal module dependency
T.inject(D)

-- Mark points on the terrain for debugging
toMark({vec3(100,100,0), vec3(200,200,0)}, 'red')

-- Clear all generated content
clear()

-- Access generation parameters
local spacing = T.out.default.LAT_SPACE  -- 15

Exported Functions

T.decalDel(ind)

Deletes a generated road decal by index.

• ind (number) - Index into internal adec array

T.onUpdate()

Per-frame update callback. Renders debug markers and region overlays.

T.inject(oD)

Injects the decal module dependency.

• oD (table) - Decal module reference

T.clear()

Deletes all generated decals, resets terrain materials, and clears state.

Note: onVal and test are internal (local) functions and are NOT exported on the module table.

See Also

• Gen Decal - Road/decal generation
• Gen Region - Urban region generation
• Gen Network - Road network topology
• Gen Render - Debug visualization