Class NavigationMapBuilder

Namespace

Trailblazer.Pathing

Assembly

Trailblazer.dll

Collects one-grid authoring input and builds a validated, canonically ordered map.

public sealed class NavigationMapBuilder

Inheritance

object

NavigationMapBuilder

Inherited Members

object.GetType()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Constructors

NavigationMapBuilder(string, GridConfiguration)

Creates a builder by normalizing an offline GridForge configuration.

public NavigationMapBuilder(string mapId, GridConfiguration gridConfiguration)

Parameters

mapId string

gridConfiguration GridConfiguration

NavigationMapBuilder(string, NormalizedGridConfiguration)

Creates a builder for an already normalized grid descriptor.

public NavigationMapBuilder(string mapId, NormalizedGridConfiguration gridBinding)

Parameters

mapId string

gridBinding NormalizedGridConfiguration

Properties

GridBinding

The normalized storage-neutral GridForge configuration binding.

public NormalizedGridConfiguration GridBinding { get; }

Property Value

NormalizedGridConfiguration

MapId

The stable host-owned identifier assigned to the resulting map.

public string MapId { get; }

Property Value

string

Methods

AddCell(VoxelIndex, NavigationCell)

Adds one authored cell. Duplicate indices reject when Build() normalizes the bake.

public NavigationMapBuilder AddCell(VoxelIndex index, NavigationCell cell)

Parameters

index VoxelIndex

cell NavigationCell

Returns

NavigationMapBuilder

AddCell(NavigationCellEntry)

Adds one authored cell entry.

public NavigationMapBuilder AddCell(NavigationCellEntry entry)

Parameters

entry NavigationCellEntry

Returns

NavigationMapBuilder

AddConnection(NavigationConnection)

Adds one directed source-owned physical connection.

public NavigationMapBuilder AddConnection(NavigationConnection connection)

Parameters

connection NavigationConnection

Returns

NavigationMapBuilder

AddTransition(TraversalTransitionDefinition)

Adds one directed source-owned semantic transition.

public NavigationMapBuilder AddTransition(TraversalTransitionDefinition transition)

Parameters

transition TraversalTransitionDefinition

Returns

NavigationMapBuilder

AddTransitionRule(TraversalTransitionRule)

Adds one bounded procedural semantic transition rule.

public NavigationMapBuilder AddTransitionRule(TraversalTransitionRule rule)

Parameters

rule TraversalTransitionRule

Returns

NavigationMapBuilder

Build()

Validates and copies all input into an immutable canonical map.

public NavigationMap Build()

Returns

NavigationMap

ImportAxialHex(string, GridConfiguration, IEnumerable<NavigationCellEntry>)

Imports explicit axial Q/layer/R hex cells into the canonical sparse map representation.

public static NavigationMap ImportAxialHex(string mapId, GridConfiguration gridConfiguration, IEnumerable<NavigationCellEntry> cells)

Parameters

mapId string

gridConfiguration GridConfiguration

cells IEnumerable<NavigationCellEntry>

Returns

NavigationMap

ImportDenseRectangular(string, GridConfiguration, NavigationCell?[,,])

Imports an X/Y/Z rectangular dense source into the canonical sparse map representation. Null entries are omitted from the bake.

public static NavigationMap ImportDenseRectangular(string mapId, GridConfiguration gridConfiguration, NavigationCell?[,,] cells)

Parameters

mapId string

gridConfiguration GridConfiguration

cells NavigationCell?[,,]

Returns

NavigationMap

SetDefaultCell(NavigationCell?)

Sets the optional complete fallback payload used when no explicit cell wins.

public NavigationMapBuilder SetDefaultCell(NavigationCell? defaultCell)

Parameters

defaultCell NavigationCell?

Returns

NavigationMapBuilder