Struct NormalizedGridConfiguration

Namespace

GridForge.Configuration

Assembly

GridForge.dll

Describes a validated grid configuration after topology-specific bounds normalization, without registering a live grid.

public readonly struct NormalizedGridConfiguration

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

ValueType.ToString()

object.GetType()

object.Equals(object, object)

object.ReferenceEquals(object, object)

Properties

AddressCount

The total number of topology-local addresses in the normalized grid. Sparse storage may materialize only a subset of these addresses.

public int AddressCount { get; }

Property Value

int

Configuration

The normalized configuration. Its bounds are topology-aligned, while scan-cell and storage settings retain the caller's requested values.

public GridConfiguration Configuration { get; }

Property Value

GridConfiguration

Height

The number of valid topology-local vertical layers.

public int Height { get; }

Property Value

int

IsValid

Indicates whether this descriptor contains a valid normalized address space.

public bool IsValid { get; }

Property Value

bool

Key

The exact normalized bounds-and-topology key used to bind equivalent grids. Storage kind and scan-cell size are deliberately excluded from this identity.

public GridConfigurationKey Key { get; }

Property Value

GridConfigurationKey

Length

The number of valid topology-local Z or axial-R addresses.

public int Length { get; }

Property Value

int

Width

The number of valid topology-local X or axial-Q addresses.

public int Width { get; }

Property Value

int

Methods

IsValidIndex(VoxelIndex)

Determines whether an index belongs to this topology-local address space. Validation is independent of sparse physical-voxel presence.

public bool IsValidIndex(VoxelIndex index)

Parameters

index VoxelIndex

The topology-local index to validate.

Returns

bool

True when each coordinate is inside the normalized dimensions.

Remarks

Validation uses coordinate values only; IsAllocated does not change whether the address is in range.

TryGetCellPrism(VoxelIndex, out GridCellPrism)

Attempts to derive the exact offline prism for a topology-local address.

public bool TryGetCellPrism(VoxelIndex index, out GridCellPrism prism)

Parameters

index VoxelIndex

The topology-local address.

prism GridCellPrism

The exact cell prism when the address and metrics are representable.

Returns

bool

True when the address is valid and its prism is exactly representable.

Remarks

The returned prism has no runtime world/grid identity. It is suitable for authoring validation before a matching physical grid exists.