Struct NavObstacle3D 

pub struct NavObstacle3D {
    pub center: Vec3,
    pub half_extents: Vec3,
    pub carve: bool,
}

World-space axis-aligned blocking box component; no Transform3D is needed.

use ponko::*;
let obstacle = NavObstacle3D::new(Vec3::ZERO, Vec3::ONE);
assert_eq!(obstacle.center, Vec3::ZERO);

Fields

center: Vec3

Center in world space.

assert_eq!(NavObstacle3D::new(Vec3::Y, Vec3::ONE).center, Vec3::Y);

half_extents: Vec3

Nonnegative half sizes along world X,Y,Z.

assert_eq!(NavObstacle3D::new(Vec3::ZERO, Vec3::ONE).half_extents, Vec3::ONE);

carve: bool

Rebuild cached heightfield layers to cut a real hole. Default false. Needs a mesh baked with NavBakeSettings::carving; otherwise this blocks like any other obstacle.

assert!(!NavObstacle3D::new(Vec3::ZERO, Vec3::ONE).carve);

Implementations

impl NavObstacle3D

pub fn new(center: Vec3, half_extents: Vec3) -> Self

Creates an axis-aligned world box. Invalid values block the entire mesh.

let obstacle = NavObstacle3D::new(Vec3::Y, Vec3::ONE);
assert_eq!(obstacle.half_extents.y, 1.0);

Examples found in repository

examples/navmesh3d.rs (line 32)

fn main() {
    // ANCHOR: query
    let nav = navigation();
    let start = nav.sample_position(vec3(-8.0, 1.0, 0.0), 2.0).unwrap();
    let destination = vec3(8.0, 0.0, 0.0);
    let corners = nav.find_path(start, destination).unwrap();
    assert!(corners.len() >= 3);
    // ANCHOR_END: query

    // ANCHOR: agents
    let mut world = Game::new("Navigation server", 1, 1)
        .fixed_hz(60)
        .sim_system(step_navmesh3d)
        .run_headless(600, |ctx| {
            ctx.world.insert_resource(nav);
            let mut agent = NavAgent3D::default();
            agent.destination = Some(destination);
            ctx.world.spawn((Transform3D::at(start), agent));
            // World-space AABB; move its center or despawn it to reopen polygons.
            ctx.world
                .spawn((NavObstacle3D::new(vec3(0.0, 1.0, 8.0), vec3(1.0, 1.0, 1.0)),));
        });
    let position = world.query::<&Transform3D>().iter().next().unwrap().position;
    assert!(position.distance(destination) < 0.3);
    // ANCHOR_END: agents
}

Trait Implementations

impl Clone for NavObstacle3D

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for NavObstacle3D

impl Debug for NavObstacle3D

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

Formats the value using the given formatter.

impl PartialEq for NavObstacle3D

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for NavObstacle3D