#scene-graph #hierarchy #ecs #specs

specs-hierarchy

Scene graph type hierarchy abstraction for use with specs

16 unstable releases (5 breaking)

Uses old Rust 2015

0.6.0 Feb 12, 2020
0.5.1 Jul 23, 2019
0.4.0 Jul 9, 2019
0.3.0 Nov 6, 2018
0.2.0 Jul 11, 2018

#865 in Data structures

Download history 1089/week @ 2024-06-15 1032/week @ 2024-06-22 370/week @ 2024-06-29 317/week @ 2024-07-06 1244/week @ 2024-07-13 908/week @ 2024-07-20 981/week @ 2024-07-27 761/week @ 2024-08-03 1654/week @ 2024-08-10 973/week @ 2024-08-17 999/week @ 2024-08-24 979/week @ 2024-08-31 955/week @ 2024-09-07 906/week @ 2024-09-14 1056/week @ 2024-09-21 1087/week @ 2024-09-28

4,119 downloads per month
Used in 67 crates (6 directly)

MIT/Apache

29KB
509 lines

specs-hierarchy

Build Status Crates.io Gitter MIT/Apache Docs.rs LoC

Scene graph type hierarchy abstraction for use with specs.

Builds up a Hierarchy resource, by querying a user supplied Parent component. Requires the component to be Tracked.

Will send modification events on an internal EventChannel. Note that Removed events does not mean the Parent component was removed from the component storage, just that the Entity will no longer be considered to be a part of the Hierarchy. This is because the user may wish to either remove only the component, the complete Entity, or something completely different. When an Entity that is a parent gets removed from the hierarchy, the full tree of children below it will also be removed from the hierarchy.

Usage

# Cargo.toml
[dependencies]
specs-hierarchy = "0.5.1"

Example

use specs::prelude::{Component, DenseVecStorage, Entity, FlaggedStorage};
use specs_hierarchy::{Hierarchy, Parent as HParent};

/// Component for defining a parent entity.
///
/// The entity with this component *has* a parent, rather than *is* a parent.
#[derive(Debug, Clone, Eq, Ord, PartialEq, PartialOrd)]
pub struct Parent {
    /// The parent entity
    pub entity: Entity,
}

impl Component for Parent {
    type Storage = FlaggedStorage<Self, DenseVecStorage<Self>>;
}

impl HParent for Parent {
    fn parent_entity(&self) -> Entity {
        self.entity
    }
}

License

Licensed under either of

at your option.

Contribution

We are a community project that welcomes contribution from anyone. If you're interested in helping out, you can contact us either through GitHub, or via gitter.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~4.5MB
~92K SLoC