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
66
67
68
69
70
71

use super::*;

/// A wrapper around the Web Audio API `AudioContext` providing
/// game engine audio playback and volume management.
#[derive(Clone, Data, New)]
pub struct GameAudioContext {
    /// The underlying Web Audio API context.
    #[set(pub(crate))]
    #[get_mut(pub(crate))]
    #[get(pub(crate))]
    pub(crate) context: AudioContext,
    /// The master gain node controlling overall volume.
    ///
    /// The gain node's own `AudioParam` is the single source of truth for the
    /// master level. There is deliberately no `master_volume` field beside it:
    /// a second copy of the level could drift from the node it mirrors, and
    /// nothing in the engine ever read it. Volume changes go through
    /// [`GameAudioContext::apply_master_volume`].
    #[set(pub(crate))]
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    pub(crate) master_gain: GainNode,
}

/// An audio clip wrapping a decoded `AudioBuffer` with playback control.
#[derive(Clone, Data, New)]
pub struct AudioClip {
    /// The decoded audio data buffer.
    #[set(pub(crate))]
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    pub(crate) buffer: AudioBuffer,
    /// The current playback state.
    ///
    /// `get_state` is public because tests/audio_clip/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 state: AudioPlayState,
    /// Whether the clip should loop when it reaches the end.
    ///
    /// `get_looping` is public because tests/audio_clip/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 looping: bool,
    /// The volume level in the range 0.0 to 1.0.
    ///
    /// `get_volume` is public because tests/audio_clip/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 volume: f64,
    /// The playback rate multiplier (1.0 = normal speed).
    ///
    /// `get_playback_rate` is public because tests/audio_clip/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 playback_rate: f64,
    /// The currently active source node, if the clip is playing.
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    #[new(skip)]
    #[get(pub(crate))]
    pub(crate) source_node: Option<AudioBufferSourceNode>,
}