FEarthworksResult

What a feature does to the ground, from FTerrainWorld::Evaluate (preview) or Commit.

Declaration

struct FEarthworksResult

Header: #include "Native/EarthworksResult.h"
Module: PublicDependencyModuleNames.Add("OrreryTerrainCore"); in your module’s Build.cs.
Stability: Stable: changes within a major version only add.

Description

From the world, Cut_m3, Fill_m3, Footprint_m2, Touched and Hash are the whole-ground delta of the feature: the ground composed with it minus the ground composed without it, the rest of the feature set unchanged. A second track on an existing embankment is not charged for that embankment again, and a track that cuts back its neighbour's batter is charged for that. Clearance and structure advice read the Natural surface (what the player left), because tunnel depth and viaduct height are about the ground before construction.

The per-station areas are the posts this feature determined (ComposeWindow): its formation where its band is the deepest, its batter where it set the bound that holds, and a connector post when it is the nearer member of the tied pair. Straight from ApplyCorridor, ApplyPlate or ComposeWindow, the volumes are those posts too.

Properties

Name	Type	Default	Meaning
`Cut_m3`	`double`	`0.0`	—
`Fill_m3`	`double`	`0.0`	—
`Footprint_m2`	`double`	`0.0`	—
`Touched`	`FTileRange`	—	Edit-layer tiles whose heights change.
`Sections`	`std::vector<FStationSection>`	—	One per station for corridors and channels; empty for plates.
`Walls`	`std::vector<FWallRun>`	—	Retaining walls at this feature's formation edges, by first station then side. Rebuilt from Sections (corridors) at the end of every evaluation call, so it reflects every window evaluated into this result so far. From the world, these are followed by the Shoulder runs the feature puts on its neighbours (`FWallRun::Feature` names the neighbour, Other this feature: 0 for an add Evaluate has not numbered), by the neighbours' content key.
`BasedOn`	`FRevision`	`0`	Revision the evaluation read.
`Hash`	`uint64_t`	`0`	Hash of the resulting heights over Touched.
`bApproximate`	`bool`	`false`	Some base tiles were not resident: the numbers came from the mip pyramid.