Orrery Terrain · OrreryTerrain module · class
UOrreryTerrainTileStoreAsset
ExperimentalThe cooked tile store: natural ground for large worlds, streamed per tile.
Declaration
UCLASS(BlueprintType)
class UOrreryTerrainTileStoreAsset : public UOrreryTerrainSourceAsset- Header
#include "OrreryTerrainTileStoreAsset.h"- Module
PublicDependencyModuleNames.Add("OrreryTerrain");in your module’s Build.cs.- Stability
- Experimental: supported, may change in a minor version, with a changelog line.
- Thread
- Game thread.
- Derives from
UOrreryTerrainSourceAsset- Blueprint
- “Orrery Terrain Tile Store Asset”, a Blueprint type
Description
Every base and mip tile is stored as a version-1 store tile (TileStoreCodec.h), compressed alone, in one bulk-data payload saved out of line (BULKDATA_Force_NOT_InlinePayload): the payload never loads with the package, and a tile is read by one byte-range request. The packed index (FOrreryTerrainTileStoreIndex) loads with the package.
Written only by the editor builder (FOrreryTerrainTileStoreBuilder) and the importers that use it, never at runtime. A terrain actor reaches the asset through its hard Source reference, which is what puts the asset and its payload in a cook.
Game thread. The tile source it bakes reads on loader tasks and keeps no pointer to it.
Functions
- MakeTileSource
Bake the store into a tile source that streams from the payload.
- Serialize
- GetResourceSizeEx
- GetStoredTileCountBlueprint
Tiles stored, every level and field counted (a classed level-0 tile counts twice).
- GetPayloadSizeBlueprint
Bytes of the payload (all stored tiles).
- GetIndexBlobSizeBlueprint
Bytes of the packed index as saved.
- IsPayloadInMemory
Whether the payload's bytes are in memory (just built, or forced loaded); false for a store loaded from disk.
- GetIndex
The index, or null for an empty store.
Properties
| Name | Type | Default | Meaning |
|---|---|---|---|
k | int64 | 256 | A store with more level-0 tiles than this refuses ResidentMipLevel 0, which would load the whole base. |
MinBlueprintReadOnly | FInt | FInt | First base tile with data, inclusive (a copy of the index's, for the details panel). |
MaxBlueprintReadOnly | FInt | FInt | Last base tile with data, inclusive. |
MaxBlueprintReadOnly | uint8 | 0 | Deepest mip level stored. |
Content | uint64 | 0 | Hash of the stored ground: every slot's tile hash (decoded posts and channels, and the ground classes of field 1) in index order, plus the fields' rectangles and levels. The tile source mixes the grid into it, so a save is refused over another store or over the same store moved. |
GeoBlueprintReadOnly | FOrrery | — | Where the ground sits on the earth (metadata). |
ProvenanceBlueprintReadOnly | FOrrery | — | What the store was imported from (metadata for staleness checks). |
Blueprint
- Get Index Blob SizeOrrery › Terrain › Tile Store
- Get Payload SizeOrrery › Terrain › Tile Store
- Get Stored Tile CountOrrery › Terrain › Tile Store