euv-engine 0.31.1

A high-performance 2D game engine built on the euv framework, featuring ECS, fixed-timestep game loop, canvas rendering, physics, collision detection, sprite animation, and audio.
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

use super::*;

/// The fundamental entity in the engine, combining a transform with
/// a collection of behavior-defining components.
#[derive(Clone, Data, New)]
pub struct Entity {
    /// The unique identifier of this entity.
    ///
    /// `get_id` is public because tests/entity/fn.rs, tests/pool/fn.rs reads this field from
    /// outside this crate. `get_mut` / `set` stay crate-internal.
    #[get_mut(pub(crate))]
    #[get(type(copy))]
    #[set(pub(crate))]
    pub id: u64,
    /// The human-readable name of this entity.
    ///
    /// `get_name` is public because tests/entity/fn.rs, tests/pool/fn.rs, tests/remaining/fn.rs reads this field from
    /// outside this crate. `get_mut` / `set` stay crate-internal.
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub name: String,
    /// The world-space transform (position, rotation, scale).
    ///
    /// `get_transform` is public because tests/entity/fn.rs, tests/pool/fn.rs reads this field from
    /// outside this crate. `get_mut` / `set` stay crate-internal.
    #[get_mut(pub(crate))]
    #[get(type(copy))]
    #[set(pub(crate))]
    pub transform: Transform2D,
    /// Whether this entity is active and should receive updates.
    ///
    /// `get_active` / `set_active` are public because tests/entity/fn.rs, tests/pool/fn.rs reads this field from
    /// outside this crate. `get_mut` / `set` stay crate-internal.
    #[get_mut(pub(crate))]
    #[get(type(copy))]
    pub active: bool,
    /// The list of components attached to this entity.
    ///
    /// `get_components` is public because tests/entity/fn.rs, tests/pool/fn.rs reads this field from
    /// outside this crate. `get_mut` / `set` stay crate-internal.
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub components: Vec<ComponentRc>,
    /// Optional tags for grouping and querying entities.
    ///
    /// `get_tags` is public because tests/entity/fn.rs, tests/pool/fn.rs reads this field from
    /// outside this crate. `get_mut` / `set` stay crate-internal.
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub tags: Vec<String>,
}

/// A publish-subscribe event bus for decoupled inter-entity communication.
///
/// Entities and game systems can subscribe to named event channels and
/// emit events that are dispatched to all registered handlers.
#[derive(Clone, Data, New)]
pub struct EventBus {
    /// The map from event name to the list of registered handler closures.
    #[get_mut(pub(crate))]
    #[new(skip)]
    #[get(pub(crate))]
    #[set(pub(crate))]
    pub(crate) handlers: EventHandlers,
}