Method RequestData

Namespace

Pinwheel.Vista

Assembly

Pinwheel.Vista.Runtime.dll

RequestData(Bounds, int, int, BiomeDataMask, CancellationSignal)

Requests biome data for a target tile by remapping this biome's cached outputs into the requested bounds.

public BiomeDataRequest RequestData(Bounds worldBounds, int heightMapResolution, int textureResolution, BiomeDataMask consumableDataMask = (BiomeDataMask)-1, CancellationSignal cancellationSignal = null)

Parameters

worldBounds Bounds

Tile bounds that should receive the biome contribution. Cached data is copied from the biome's own world bounds into this destination area.

heightMapResolution int

Target resolution for height-related outputs such as height, holes, and mesh density in the returned data.

textureResolution int

Target resolution for texture-like outputs such as splat weights, albedo maps, density maps, and biome mask.

consumableDataMask BiomeDataMask

Channels the caller can consume. The biome intersects this value with dataMask before graph execution and rebuilds an existing cache when it lacks a newly required channel.

cancellationSignal CancellationSignal

Optional read-only cancellation state propagated into terrain graph execution. Cancellation is observed after graph cleanup completes; partial cache data, cloned graphs, and input-provider resources are then released before the returned request completes.

Returns

BiomeDataRequest

A progressive request whose data payload is filled asynchronously. If terrainGraph is not assigned, the returned request completes immediately with an empty data object.

Remarks

The first request after cache invalidation triggers full graph execution in the biome's own bounds at baseResolution. Later requests reuse Pinwheel.Vista.LocalProceduralBiome.cachedData and only perform the bounds-aware copy/remap step. The cache bounds are rounded to whole-world-unit XZ extents before generation so repeated requests use a stable cache domain. A cancelled cache build is never assigned to Pinwheel.Vista.LocalProceduralBiome.cachedData and does not modify the caller-facing payload.