gooey-rs 0.12.1

Tile-based UI library with audio support
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

//! A widget for audio playback.
//!
//! Requires only an Sfx view and can be parented to any other widget. Implements a
//! state machine where control functions `play`, `loop_` (note: `loop` is a keyword in
//! Rust), and `ready` correspond to the possible states and will set the state
//! immediately in the Sfx component.

use crate::prelude::*;

/// Widget for controlling playback of an Sfx component
// TODO: since this only relies on one component (view), the playback *widget* doesn't
// need to be downcast to; eventually these playback controls may need to be generalized
// to other kinds of view components or possibly controller and model components (e.g. a
// controller mixer component)
pub type Playback <'element> =
  Widget <'element, ControllerComponent, ModelComponent, Sfx>;

pub fn new (sound : Option <Sound>) -> Element {
  log::trace!("new...");
  let view = {
    use view::component::{sfx, Sfx};
    let playback = sound.map (|id| (id, sfx::State::Ready));
    view::Component::from (Sfx { playback }).into()
  };
  let out = Element::new (
    "Playback".to_string(), Controller::default(), Model::default(), view);
  log::trace!("...new");
  out
}

//
//  controls
//

/// Builtin button control ID `PlaybackPlay`
pub fn play (
  _             : &controls::button::Release,
  _elements     : &Tree <Element>,
  node_id       : &NodeId,
  action_buffer : &mut Vec <(NodeId, Action)>
) {
  log::trace!("play...");
  action_buffer.push ((node_id.clone(), Action::ModifyView (
    Box::new (|view : &mut View|{
      use view::component::{sfx, Sfx};
      let sfx = Sfx::try_ref_mut (&mut view.component).unwrap();
      let (_, state) = sfx.playback.as_mut().unwrap();
      *state = sfx::State::Play;
    })
  )));
  log::trace!("...play");
}

/// Builtin button control ID `PlaybackLoop`.
///
/// NOTE: `loop` is a keyword in Rust.
pub fn loop_ (
  _             : &controls::button::Release,
  _elements     : &Tree <Element>,
  node_id       : &NodeId,
  action_buffer : &mut Vec <(NodeId, Action)>
) {
  log::trace!("loop...");
  action_buffer.push ((node_id.clone(), Action::ModifyView (
    Box::new (|view : &mut View|{
      use view::component::{sfx, Sfx};
      let sfx = Sfx::try_ref_mut (&mut view.component).unwrap();
      let (_, state) = sfx.playback.as_mut().unwrap();
      *state = sfx::State::Loop;
    })
  )));
  log::trace!("...loop");
}

/// Builtin button control ID `PlaybackReady`
pub fn ready (
  _             : &controls::button::Release,
  _elements     : &Tree <Element>,
  node_id       : &NodeId,
  action_buffer : &mut Vec <(NodeId, Action)>
) {
  log::trace!("ready...");
  action_buffer.push ((node_id.clone(), Action::ModifyView (
    Box::new (|view : &mut View|{
      use view::component::{sfx, Sfx};
      let sfx = Sfx::try_ref_mut (&mut view.component).unwrap();
      let (_, state) = sfx.playback.as_mut().unwrap();
      *state = sfx::State::Ready;
    })
  )));
  log::trace!("...ready");
}