Struct HexTerrainSettings

Struct for storing hex terrain settings like TerrainSize, ChunkSize, HexRotation, HexLayout, etc. Has methods for converting between pixel and cell coordinates, getting cell index by coordinates, etc.

Implements

IEquatable<HexTerrainSettings>

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Namespace: Fwt.HexTerrains.Data

Assembly: fwt.hexterrains.dll

Syntax

[BurstCompile]
[Serializable]
public struct HexTerrainSettings : IEquatable<HexTerrainSettings>

Fields

ChunkSize

Size of the chunk in cells (usually it's 16x16, because the chunk has one mesh and the amount of vertexes must be under 64000)

Declaration

public int2 ChunkSize

Field Value

Type	Description
int2

HexHeight

Height of the hexagon in world space. Cell Height is a byte value that is multiplied by this value to get the height of the cell in world space.

Declaration

public float HexHeight

Field Value

Type	Description
float

HexLayout

HexLayout of the hexagon the terrain is composed of.

Declaration

public HexLayouts HexLayout

Field Value

Type	Description
HexLayouts

HexRadius

Radius of the hexagon in world space. The half of the distance between two opposite corners of the hexagon.

Declaration

public float HexRadius

Field Value

Type	Description
float

HexRotation

HexRotation of the hexagon the terrain is composed of.

Declaration

public HexRotations HexRotation

Field Value

Type	Description
HexRotations

IsConnectedHorizontally

If true, the top and bottom edges of the terrain are seamlessly connected

Declaration

public bool IsConnectedHorizontally

Field Value

Type	Description
bool

IsConnectedVertically

If true, the right and left edges of the terrain are seamlessly connected

Declaration

public bool IsConnectedVertically

Field Value

Type	Description
bool

SlopeSize

Value from 0 to 1 (part of the Hex are that slopes take)

Declaration

[Tooltip("Value from 0 to 1 (part of the Hex are that slopes take)")]
[Range(0, 1)]
public float SlopeSize

Field Value

Type	Description
float

TerrainSize

Size of the terrain in cells (width and height).

Declaration

public int2 TerrainSize

Field Value

Type	Description
int2

Properties

CellsCount

Total mount of cells on terrain.

Declaration

public int CellsCount { get; }

Property Value

Type	Description
int

CellsPerChunk

Max amount of cells in one chunk. Some chunks (at the edges of the terrain) may have less cells than this value.

Declaration

public int CellsPerChunk { get; }

Property Value

Type	Description
int

ChunksCount

Total number of chunks in the terrain

Declaration

public int ChunksCount { get; }

Property Value

Type	Description
int

ChunksGridSize

Size of the chunks grid (one item = one chunk)

Declaration

public int2 ChunksGridSize { get; }

Property Value

Type	Description
int2

Default

returns a default HexTerrainSettings

Declaration

public static HexTerrainSettings Default { get; }

Property Value

Type	Description
HexTerrainSettings

TerrainAreaSize

Size of the rectangle area that the whole terrain occupies in world space.

Declaration

public float2 TerrainAreaSize { get; }

Property Value

Type	Description
float2

Methods

CellIndexToPixel(int)

Calculates a cell coordinate by cell index, then converts a cell coord to the world point (assuming the terrain origin is 0:0:0). Clamps the coordinate to the terrain size, meaning takes into account if terrain's edges are connected or not

Declaration

[BurstCompile]
public float3 CellIndexToPixel(int cellIndex)

Parameters

Type	Name	Description
int	cellIndex

Returns

Type	Description
float3

ClampCellIndex(int)

Clamps the cell index to the terrain size. Takes into account if Terrain's edges are connected or not.

Declaration

[BurstCompile]
public int ClampCellIndex(int cellIndex)

Parameters

Type	Name	Description
int	cellIndex	Raw cell index (can be outside of terrain)

Returns

Type	Description
int	clamped cell index

ClampChunkCoordinate(int2)

Declaration

[BurstCompile]
public int2 ClampChunkCoordinate(int2 chunkCoord)

Parameters

Type	Name	Description
int2	chunkCoord

Returns

Type	Description
int2

ClampCoordinate(int2)

Takes a cell coordinate and wraps it around the terrain size taking into account if terrain's edges are connected or not. So if IsConnectedHorizontally is true, the x coordinate will be wrapped around the terrain's width, If IsConnectedVertically is true, the y coordinate will be wrapped around the terrain's height. Negative cell coordinates are also wrapped around.

Declaration

[BurstCompile]
public int2 ClampCoordinate(int2 cellCoord)

Parameters

Type	Name	Description
int2	cellCoord	raw cell coordinate

Returns

Type	Description
int2	clamped cell coordinate

CoordToPixel(int2)

Converts a cell coordinate to the world point (assuming the terrain origin is 0:0:0). Clamps the coordinate to the terrain size, meaning takes into account if terrain's edges are connected or not ClampCoordinate(int2)

Declaration

[BurstCompile]
public float3 CoordToPixel(int2 coord)

Parameters

Type	Name	Description
int2	coord	cell coordinate

Returns

Type	Description
float3	world point

CoordToPixelRaw(int2)

Converts a cell coordinate to the world point (assuming the terrain origin is 0:0:0).

Declaration

[BurstCompile]
public float3 CoordToPixelRaw(int2 coord)

Parameters

Type	Name	Description
int2	coord	cell coordinate

Returns

Type	Description
float3	world point

Equals(HexTerrainSettings)

Declaration

public bool Equals(HexTerrainSettings other)

Parameters

Type	Name	Description
HexTerrainSettings	other

Returns

Type	Description
bool

GetCellCoord(int)

Converts a cell index into a cell coordinate

Declaration

[BurstCompile]
public int2 GetCellCoord(int cellIndex)

Parameters

Type	Name	Description
int	cellIndex

Returns

Type	Description
int2

GetCellHeightInMeters(float)

Calculates a cell height in meters from the heightmap value

Declaration

[BurstCompile]
public float GetCellHeightInMeters(float cellHeight)

Parameters

Type	Name	Description
float	cellHeight	heightmap value of the cell

Returns

Type	Description
float	cell height in meters

GetCellIndex(int2)

Converts a cell coordinate to the cell index. Takes into account if terrain's edges are connected or not

Declaration

[BurstCompile]
public int GetCellIndex(int2 cellCoord)

Parameters

Type	Name	Description
int2	cellCoord	cell coordinate

Returns

Type	Description
int	cell index

GetCellIndexRaw(int2)

Converts a cell coordinate to the cell index. Does NOT take into account if terrain's edges are connected or not

Declaration

[BurstCompile]
public int GetCellIndexRaw(int2 cellCoord)

Parameters

Type	Name	Description
int2	cellCoord	cell coordinate

Returns

Type	Description
int	cell index

GetChunkCoord(int)

Converts a chunk index into a chunk coordinate (in chunks grid, not cells grid)

Declaration

[BurstCompile]
public int2 GetChunkCoord(int chunkIndex)

Parameters

Type	Name	Description
int	chunkIndex	chunk index

Returns

Type	Description
int2	chunk coordinate in a chunks grid

GetChunkCoordByCellCoord(int2)

Returns chunk coordinate (in chunks grid) by cell coordinate (in cells grid)

Declaration

[BurstCompile]
public int2 GetChunkCoordByCellCoord(int2 cellCoord)

Parameters

Type	Name	Description
int2	cellCoord

Returns

Type	Description
int2

GetChunkCoordByCellCoordRaw(int2)

Returns chunk coordinate for cell with a giving coord

Declaration

[BurstCompile]
public int2 GetChunkCoordByCellCoordRaw(int2 cellCoord)

Parameters

Type	Name	Description
int2	cellCoord

Returns

Type	Description
int2

GetChunkIndex(int2)

Returns a chunk index of giving chunk coordinate (in chunks grid, not cells grid)

Declaration

[BurstCompile]
public int GetChunkIndex(int2 chunkCoord)

Parameters

Type	Name	Description
int2	chunkCoord	chunk coordinate in a chunks grid

Returns

Type	Description
int	chunk index

GetChunkIndexByCellCoord(int2)

Returns a chunk index for cell at provided cell coordinate (not chunk coordinate)

Declaration

[BurstCompile]
public int GetChunkIndexByCellCoord(int2 cellCoord)

Parameters

Type	Name	Description
int2	cellCoord

Returns

Type	Description
int

GetChunkIndexByCellCoordRaw(int2)

Returns a chunk index for cell with a giving coordinate

Declaration

[BurstCompile]
public int GetChunkIndexByCellCoordRaw(int2 cellCoord)

Parameters

Type	Name	Description
int2	cellCoord

Returns

Type	Description
int

GetChunkIndexByCellIndex(int)

Returns a chunk index for giving cell index

Declaration

[BurstCompile]
public int GetChunkIndexByCellIndex(int cellIndex)

Parameters

Type	Name	Description
int	cellIndex

Returns

Type	Description
int

GetChunksAdjacentToCell(int, out FixedArray8<int>, out int)

Declaration

[BurstCompile]
public bool GetChunksAdjacentToCell(int cellIndex, out FixedArray8<int> chunkIndexes, out int chunksCount)

Parameters

Type	Name	Description
int	cellIndex
FixedArray8<int>	chunkIndexes
int	chunksCount

Returns

Type	Description
bool

HasNeighbour(in int, in int)

Declaration

[BurstCompile]
public bool HasNeighbour(in int cellIndex, in int direction)

Parameters

Type	Name	Description
int	cellIndex
int	direction

Returns

Type	Description
bool

HasNeighbour(in int2, in int)

Declaration

[BurstCompile]
public bool HasNeighbour(in int2 cellCoord, in int direction)

Parameters

Type	Name	Description
int2	cellCoord
int	direction

Returns

Type	Description
bool

IsCellInsideTheTerrain(int)

Checks if the cell index is inside the terrain. Takes into account if terrain's edges are connected or not

Declaration

[BurstCompile]
public bool IsCellInsideTheTerrain(int cellIndex)

Parameters

Type	Name	Description
int	cellIndex

Returns

Type	Description
bool

IsCellInsideTheTerrain(int2)

Checks if the cell coordinate is inside the terrain. Takes into account if terrain's edges are connected or not

Declaration

[BurstCompile]
public bool IsCellInsideTheTerrain(int2 cellCoord)

Parameters

Type	Name	Description
int2	cellCoord

Returns

Type	Description
bool

PixelToCoord(float2)

Converts a world point to a cell coordinate (assuming the terrain origin is 0:0:0).

Declaration

[BurstCompile]
public int2 PixelToCoord(float2 pixel)

Parameters

Type	Name	Description
float2	pixel	world point

Returns

Type	Description
int2	cell coordinate

PixelToCoordRaw(float2)

Converts a world 2D point (without height) to a cell coordinate (assuming the terrain origin is 0:0:0).

Declaration

[BurstCompile]
public int2 PixelToCoordRaw(float2 pixel)

Parameters

Type	Name	Description
float2	pixel	world point

Returns

Type	Description
int2	cell coordinate

PixelToCoordRaw(float3)

Converts a world point to a cell coordinate (assuming the terrain origin is 0:0:0).

Declaration

[BurstCompile]
public int2 PixelToCoordRaw(float3 pixel)

Parameters

Type	Name	Description
float3	pixel	world point

Returns

Type	Description
int2	cell coordinate

ToString()

Declaration

public override string ToString()

Returns

Type	Description
string

Overrides

ValueType.ToString()

TryGetNeighbourCellCoord(int, int, out int2)

Declaration

[BurstCompile]
public bool TryGetNeighbourCellCoord(int cellIndex, int direction, out int2 neighbourCoordinate)

Parameters

Type	Name	Description
int	cellIndex
int	direction
int2	neighbourCoordinate

Returns

Type	Description
bool

TryGetNeighbourCellCoord(in int2, in int, out int2)

Declaration

[BurstCompile]
public bool TryGetNeighbourCellCoord(in int2 cellCoord, in int direction, out int2 neighbourCoordinate)

Parameters

Type	Name	Description
int2	cellCoord
int	direction
int2	neighbourCoordinate

Returns

Type	Description
bool

TryGetNeighbourCellIndex(int, int, out int)

Declaration

[BurstCompile]
public bool TryGetNeighbourCellIndex(int cellIndex, int direction, out int neighbourCellIndex)

Parameters

Type	Name	Description
int	cellIndex
int	direction
int	neighbourCellIndex

Returns

Type	Description
bool

TryGetNeighbourCellIndex(int2, int, out int)

Declaration

[BurstCompile]
public bool TryGetNeighbourCellIndex(int2 cellCoord, int direction, out int neighbourCellIndex)

Parameters

Type	Name	Description
int2	cellCoord
int	direction
int	neighbourCellIndex

Returns

Type	Description
bool

TryGetNeighbourChunkCoord(int2, int, out int2)

Declaration

[BurstCompile]
public bool TryGetNeighbourChunkCoord(int2 cellCoord, int direction, out int2 neighbourChunkCoord)

Parameters

Type	Name	Description
int2	cellCoord
int	direction
int2	neighbourChunkCoord

Returns

Type	Description
bool

TryGetNeighbourChunkIndex(int2, int, out int)

Declaration

[BurstCompile]
public bool TryGetNeighbourChunkIndex(int2 cellCoord, int direction, out int neighbourChunkIndex)

Parameters

Type	Name	Description
int2	cellCoord
int	direction
int	neighbourChunkIndex

Returns

Type	Description
bool

WorldPosToPixelRaw(float3)

Converts a world position to its corresponding pixel coordinates in the hex grid layout. Returns a raw coordinate, meaning it can be outside of the terrain size or negative.

Declaration

[BurstCompile]
public float3 WorldPosToPixelRaw(float3 worldPos)

Parameters

Type	Name	Description
float3	worldPos	The world position to convert, where the X and Z components represent the horizontal plane.

Returns

Type	Description
float3	A Unity.Mathematics.float3 representing the pixel coordinates corresponding to the specified world position. The Y component is set to 0.

Implements

IEquatable<T>

Extension Methods

HashExtensions.GetHashCode_ValueType<TValue>(TValue, int)

Extensions_UnityObject.SmartDestroy(object)

Extensions_UnityObject.SmartGetComponent<TComponent>(object)

Extensions_UnityObject.SmartGetGameGameObject(object)