Crate bsp_pathfinding
source · [−]Expand description
Provides a path finding search space generation and A* search algorithm using Binary Spatial Partitioning.
The navigable space is defined by polygons delimiting the space. A graph of navigable nodes and edges will be generated.
The algorithm does not impose any constraints on size or angle of the scene as is the case for grid or quadtree based approaches.
Usage
use bsp_pathfinding::*;
use glam::*;
// Define a simple scene
let square = Shape::rect(Vec2::new(50.0, 50.0), Vec2::new(0.0, 0.0));
let left = Shape::rect(Vec2::new(10.0, 200.0), Vec2::new(-200.0, 10.0));
let right = Shape::rect(Vec2::new(10.0, 200.0), Vec2::new(200.0, 10.0));
let bottom = Shape::rect(Vec2::new(200.0, 10.0), Vec2::new(10.0, -200.0));
let top = Shape::rect(Vec2::new(200.0, 10.0), Vec2::new(10.0, 200.0));
// Create navigational context from the scene
let nav = NavigationContext::new([square, left, right, top, bottom].iter().flatten());
// Find a path
let start = Vec2::new(-100.0, 0.0);
let end = Vec2::new(100.0, 30.0);
let path = nav
.find_path(start, end, heuristics::euclidiean, SearchInfo::default())
.expect("Failed to find a path");
Re-exports
pub use astar::*;
Modules
Structs
Represents a single node in the binary tree. The node constitutes of a splitting plane and children behind and in front of the plane.
Defines the tree used for navigation
A two dimensional face of two vertices. Uses counterclockwise winding order to calculate a normal
Contains the graph and edges necessary for path finding
Represent the index of a crate::BSPNode
Represents the result of crate::BSPTree::locate
Represents a surface connecting two nodes
References a portal
Declares portals which are surfaces connecting two partitioning planes, crate::BSPNode.
Defines a collection of faces. This struct is not neccesary to use, but helps in constructing squares and other primitives.