Struct HexwebGame 

pub struct HexwebGame { /* private fields */ }

The hexweb puzzle: pieces on a hexagonal lattice, moved until every arrow is met by the opposite arrow of the piece it points at.

Implementations

impl HexwebGame

pub fn random(params: Params, seed: u64) -> Self

Generates a new puzzle from params with a deterministic seed.

The generator lays a solved configuration down first, then verifies with an exact counting solver that exactly one placement of the pieces solves it (repairing by adding arrows if not), and finally scrambles the board with legal moves. See crate::generator.

Panics (see Params and [validate_params]) on impossible parameters: duplicate or isolated nodes, a piece count outside 1..nodes.len(), or an arrow range outside 1..=6 with min <= max.

pub fn nodes(&self) -> &[Node]

The board’s nodes, in the order of the coordinates passed to Params.

pub fn node_count(&self) -> usize

Total node count (occupied + empty).

pub fn piece_count(&self) -> usize

How many pieces the board holds.

pub fn empty_count(&self) -> usize

How many nodes are currently empty.

pub fn pieces(&self) -> &[Piece]

The pieces, in piece-id order.

pub fn piece_at(&self, node: usize) -> Option<usize>

The piece sitting on node, if any.

pub fn node_of(&self, piece: usize) -> Option<usize>

The node piece currently occupies.

pub fn node_at(&self, q: i32, r: i32) -> Option<usize>

The node with axial coordinates (q, r), if it exists on the board.

pub fn can_move(&self, piece: usize, to: usize) -> bool

Whether piece may be moved to to right now: the game must be unfinished, to must be an in-board node, and it must be empty and not piece’s own node. The other way a piece can land is onto an occupied node, swapping the two: see HexwebGame::can_swap.

pub fn move_piece(&mut self, piece: usize, to: usize) -> bool

Moves piece to the empty node to. Returns whether the move happened; illegal moves (see HexwebGame::can_move) leave the board unchanged. Counts the move and latches the win when the board becomes solved.

pub fn can_swap(&self, a: usize, b: usize) -> bool

Whether pieces a and b may be swapped right now: the game must be unfinished and both pieces must be placed and distinct. Two pieces with identical arrows may be swapped, but the swap is a free no-op (see HexwebGame::swap_pieces).

pub fn swap_pieces(&mut self, a: usize, b: usize) -> bool

Exchanges the nodes of the two placed pieces a and b. Returns whether the swap happened; illegal swaps (see HexwebGame::can_swap) leave the board unchanged. Counts the move and latches the win when the board becomes solved. Pieces with identical arrows are interchangeable, so swapping two of them leaves the move counter alone.

pub fn satisfied(&self, piece: usize) -> bool

Whether every arrow of piece currently forms a mutual pair.

pub fn unsatisfied_arrows(&self, piece: usize) -> Arrows

The arrows of piece that do not yet form a mutual pair: their target node is empty, off the board, or holds a piece that does not point back with the opposite arrow. This is the live feedback the widget paints in the accent color.

pub fn is_solved(&self) -> bool

Whether every arrow of every piece is met by the opposite arrow of the piece it points at: a completed web of mutual pairs.

pub fn moves(&self) -> usize

How many moves have been played since the last reset/new game.

pub fn status(&self) -> GameStatus

Whether the game is finished. Latched: once GameStatus::Won, it stays won until HexwebGame::reset or a new game.

pub fn reset(&mut self)

Restores the initial scramble, zeroing the move counter.

pub fn solution_count(&self, cap: usize) -> usize

How many distinct placements of the pieces solve the board, capped at cap. Counts the multiset: identical pieces are interchangeable, so swapping two of them is not a second solution. Runs in microseconds on the shipped board sizes; see crate::solver.

pub fn solution(&self) -> Option<Vec<usize>>

One solving placement, as the node each piece occupies (indexed by piece id), or None if the board has no solution.

Trait Implementations

impl Clone for HexwebGame

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HexwebGame

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.