landmass 0.9.2

A navigation system for video game characters to walk around levels.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

use std::sync::Arc;

use slotmap::new_key_type;

use crate::{
  CoordinateSystem, ValidNavigationMesh,
  util::{BoundingBox, Transform},
};

new_key_type! {
  /// The ID of an island.
  pub struct IslandId;
}

/// An Island in an Archipelago. Each island holds a navigation mesh.
pub struct Island<CS: CoordinateSystem> {
  /// The transform from the Island's frame to the Archipelago's frame.
  pub(crate) transform: Transform<CS>,
  /// The navigation mesh for the island.
  pub(crate) nav_mesh: Arc<ValidNavigationMesh<CS>>,

  /// The bounds of `nav_mesh` after being transformed by `transform`.
  pub(crate) transformed_bounds: BoundingBox,
  /// Whether the island has been updated recently.
  pub(crate) dirty: bool,
}

impl<CS: CoordinateSystem> Island<CS> {
  /// Creates a new island.
  pub fn new(
    transform: Transform<CS>,
    nav_mesh: Arc<ValidNavigationMesh<CS>>,
  ) -> Self {
    Self {
      transformed_bounds: nav_mesh.get_bounds().transform(&transform),
      transform,
      nav_mesh,
      dirty: true,
    }
  }

  /// Gets the current transform of the island.
  pub fn get_transform(&self) -> &Transform<CS> {
    &self.transform
  }

  /// Sets the current transform of the island.
  pub fn set_transform(&mut self, transform: Transform<CS>) {
    self.transform = transform;
    self.dirty = true;

    self.transformed_bounds =
      self.nav_mesh.get_bounds().transform(&self.transform);
  }

  /// Gets the current navigation mesh used by the island.
  pub fn get_nav_mesh(&self) -> Arc<ValidNavigationMesh<CS>> {
    self.nav_mesh.clone()
  }

  /// Sets the navigation mesh of the island.
  pub fn set_nav_mesh(&mut self, nav_mesh: Arc<ValidNavigationMesh<CS>>) {
    self.nav_mesh = nav_mesh;
    self.dirty = true;

    self.transformed_bounds =
      self.nav_mesh.get_bounds().transform(&self.transform);
  }
}