Struct PathfindingConfig 

pub struct PathfindingConfig<C>
where
    C: Clone + Hash + Eq,
{
    pub max_distance: Option<u32>,
    pub obstacles: HashSet<C>,
    pub terrain_costs: HashMap<C, u32>,
    pub blocking_entities: HashMap<C, u32>,
    pub base_cost: u32,
    pub allow_diagonal: bool,
}

Pathfinding configuration for complex scenarios.

This struct provides a builder pattern for configuring advanced pathfinding with multiple constraint types and optimization options.

Fields

max_distance: Option<u32>

Maximum search distance (prevents infinite searches)

obstacles: HashSet<C>

Set of impassable coordinates

terrain_costs: HashMap<C, u32>

Terrain cost modifiers for specific coordinates

blocking_entities: HashMap<C, u32>

Entities that block movement

base_cost: u32

Base movement cost

allow_diagonal: bool

Whether diagonal movement is allowed (for applicable grids)

Implementations

impl<C> PathfindingConfig<C>

where C: Clone + Hash + Eq,

pub fn new() -> Self

Creates a new pathfinding configuration.

Examples found in repository

examples/advanced_pathfinding_demo.rs (line 69)

fn demonstrate_advanced_pathfinding() {
    println!("\n=== Advanced A* with Configuration ===");
    let start = SquareCoord::<FourConnected>::new(0, 0);
    let goal = SquareCoord::<FourConnected>::new(5, 5);
    
    let config = PathfindingConfig::new()
        .with_max_distance(20)
        .with_terrain_cost(SquareCoord::<FourConnected>::new(1, 1), 3)
        .with_terrain_cost(SquareCoord::<FourConnected>::new(1, 2), 3)
        .with_base_cost(1);
    
    if let Some((path, cost)) = astar_advanced(&start, &goal, &config) {
        println!("Advanced path found: {} steps, cost: {}", path.len(), cost);
        println!("Path: {path:?}");
    } else {
        println!("No advanced path found");
    }
}

pub fn with_max_distance(self, max_distance: u32) -> Self

Sets the maximum search distance.

Examples found in repository

examples/advanced_pathfinding_demo.rs (line 70)

fn demonstrate_advanced_pathfinding() {
    println!("\n=== Advanced A* with Configuration ===");
    let start = SquareCoord::<FourConnected>::new(0, 0);
    let goal = SquareCoord::<FourConnected>::new(5, 5);
    
    let config = PathfindingConfig::new()
        .with_max_distance(20)
        .with_terrain_cost(SquareCoord::<FourConnected>::new(1, 1), 3)
        .with_terrain_cost(SquareCoord::<FourConnected>::new(1, 2), 3)
        .with_base_cost(1);
    
    if let Some((path, cost)) = astar_advanced(&start, &goal, &config) {
        println!("Advanced path found: {} steps, cost: {}", path.len(), cost);
        println!("Path: {path:?}");
    } else {
        println!("No advanced path found");
    }
}

pub fn with_obstacle(self, coord: C) -> Self

Adds an obstacle at the specified coordinate.

pub fn with_obstacles<I>(self, obstacles: I) -> Self

where I: IntoIterator<Item = C>,

Adds multiple obstacles.

pub fn with_terrain_cost(self, coord: C, cost: u32) -> Self

Sets terrain cost for a specific coordinate.

Examples found in repository

examples/advanced_pathfinding_demo.rs (line 71)

fn demonstrate_advanced_pathfinding() {
    println!("\n=== Advanced A* with Configuration ===");
    let start = SquareCoord::<FourConnected>::new(0, 0);
    let goal = SquareCoord::<FourConnected>::new(5, 5);
    
    let config = PathfindingConfig::new()
        .with_max_distance(20)
        .with_terrain_cost(SquareCoord::<FourConnected>::new(1, 1), 3)
        .with_terrain_cost(SquareCoord::<FourConnected>::new(1, 2), 3)
        .with_base_cost(1);
    
    if let Some((path, cost)) = astar_advanced(&start, &goal, &config) {
        println!("Advanced path found: {} steps, cost: {}", path.len(), cost);
        println!("Path: {path:?}");
    } else {
        println!("No advanced path found");
    }
}

pub fn with_blocking_entity(self, coord: C, entity_id: u32) -> Self

Adds a blocking entity at the specified position.

pub fn with_base_cost(self, cost: u32) -> Self

Sets the base movement cost.

Examples found in repository

examples/advanced_pathfinding_demo.rs (line 73)

fn demonstrate_advanced_pathfinding() {
    println!("\n=== Advanced A* with Configuration ===");
    let start = SquareCoord::<FourConnected>::new(0, 0);
    let goal = SquareCoord::<FourConnected>::new(5, 5);
    
    let config = PathfindingConfig::new()
        .with_max_distance(20)
        .with_terrain_cost(SquareCoord::<FourConnected>::new(1, 1), 3)
        .with_terrain_cost(SquareCoord::<FourConnected>::new(1, 2), 3)
        .with_base_cost(1);
    
    if let Some((path, cost)) = astar_advanced(&start, &goal, &config) {
        println!("Advanced path found: {} steps, cost: {}", path.len(), cost);
        println!("Path: {path:?}");
    } else {
        println!("No advanced path found");
    }
}

pub fn without_diagonal(self) -> Self

Disables diagonal movement.

Trait Implementations

impl<C> Clone for PathfindingConfig<C>

where C: Clone + Hash + Eq + Clone,

fn clone(&self) -> PathfindingConfig<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C> Debug for PathfindingConfig<C>

where C: Clone + Hash + Eq + Debug,

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

Formats the value using the given formatter.

impl<C> Default for PathfindingConfig<C>

where C: Clone + Hash + Eq,

fn default() -> Self

Returns the “default value” for a type.