Struct HexwebGame 

pub struct HexwebGame { /* private fields */ }

The hexweb puzzle: pieces on a hexagonal lattice, moved until every arrow points at another piece.

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.

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 satisfied(&self, piece: usize) -> bool

Whether every arrow of piece currently points at an occupied node.

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

The arrows of piece whose target node is empty or off the board. This is the live feedback the widget paints in the accent color.

pub fn is_solved(&self) -> bool

Whether every arrow of every piece points at an occupied node.

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) -> HexwebGame

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.