viva_aion/position

Position - Discrete coordinates in the labyrinth

Space is quantized. Consciousness moves in discrete steps. Between positions lies the Void.

Types

Direction

Cardinal directions for movement

pub type Direction {
  Up
  Down
  Left
  Right
}

Constructors

```
Up
```
```
Down
```
```
Left
```
```
Right
```

Position

</>

A position in 2D space

pub type Position {
  Position(x: Int, y: Int)
}

Constructors

```
Position(x: Int, y: Int)
```

Values

all_directions

</>

pub fn all_directions() -> List(Direction)

All cardinal directions

direction_to_string

</>

pub fn direction_to_string(dir: Direction) -> String

Direction to string

distance_squared

</>

pub fn distance_squared(a: Position, b: Position) -> Int

Euclidean distance squared (avoids sqrt)

equals

</>

pub fn equals(a: Position, b: Position) -> Bool

Check if two positions are equal

from_key

</>

pub fn from_key(key: Int, width: Int) -> Position

Convert key back to position

in_bounds

</>

pub fn in_bounds(pos: Position, width: Int, height: Int) -> Bool

Check if position is within bounds

in_interior

</>

pub fn in_interior(
  pos: Position,
  width: Int,
  height: Int,
) -> Bool

Check if position is within interior (not on border)

manhattan_distance

</>

pub fn manhattan_distance(a: Position, b: Position) -> Int

Manhattan distance between two positions

midpoint

</>

pub fn midpoint(a: Position, b: Position) -> Position

Get midpoint between two adjacent positions

move

</>

pub fn move(pos: Position, direction: Direction) -> Position

Move position in a direction

move_double

</>

pub fn move_double(
  pos: Position,
  direction: Direction,
) -> Position

Move position by 2 steps (for maze generation)

neighbors

</>

pub fn neighbors(pos: Position) -> List(Position)

Get all neighbors (4-directional)

neighbors_in_bounds

</>

pub fn neighbors_in_bounds(
  pos: Position,
  width: Int,
  height: Int,
) -> List(Position)

Get neighbors within bounds

new

</>

pub fn new(x: Int, y: Int) -> Position

Create a new position

opposite

</>

pub fn opposite(dir: Direction) -> Direction

Opposite direction

origin

</>

pub fn origin() -> Position

Origin point

to_key

</>

pub fn to_key(pos: Position, width: Int) -> Int

Convert position to unique integer key (for dict)

to_string

</>

pub fn to_string(pos: Position) -> String

Convert position to string