input-actions 0.1.1

An input system for binding PC & Gamepad inputs to application actions
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

use crate::{action, event, source};
use std::time::Instant;

/// The state of an active [`action`](action::Action) for a given user.
#[derive(Debug, Clone)]
pub struct State {
	kind: source::Kind,
	behavior: action::Behavior,
	/// Used to indicate if a button is pressed or released
	prev_frame_active: bool,
	active: bool,
	active_state_changed_this_frame: bool,
	value: f32,
	modified_at: Instant,
}

impl State {
	pub(crate) fn new(action: action::Action) -> Self {
		Self {
			kind: action.kind(),
			behavior: action.behavior().clone(),
			prev_frame_active: false,
			active: false,
			active_state_changed_this_frame: false,
			value: 0.0,
			modified_at: Instant::now(),
		}
	}

	pub(crate) fn process_event(&mut self, event: event::Event, time: &Instant) {
		if match event.state {
			event::State::ButtonState(btn_state) => {
				let is_active = btn_state == event::ButtonState::Pressed;
				if self.active != is_active {
					self.active = is_active;
					true
				} else {
					false
				}
			}
			event::State::MouseMove(_x, _y) => false,
			event::State::MouseScroll(_x, _y) => false,
			event::State::ValueChanged(value) => {
				if self.kind == source::Kind::Axis {
					if event.source.kind() == source::Kind::Button {
						// TODO: Handle digitial axis
					}
				}
				self.value = value;
				true
			}
		} {
			self.modified_at = *time;
		}
	}

	pub(crate) fn requires_updates(&self) -> bool {
		true //self.behavior.digital_axis().is_some()
	}

	pub(crate) fn update(&mut self, _time: &Instant) {
		self.active_state_changed_this_frame = self.active != self.prev_frame_active;
		if self.active_state_changed_this_frame {
			self.prev_frame_active = self.active;
		}
	}

	/// Returns true when a [`button binding`](crate::source::Kind::Button) is pressed,
	/// and this function is called in the same update frame as the input event which pressed the button.
	pub fn on_button_pressed(&self) -> bool {
		self.active && self.active_state_changed_this_frame
	}

	/// Returns true when a [`button binding`](crate::source::Kind::Button) is not pressed,
	/// and this function is called in the same update frame as the input event which released the button.
	pub fn on_button_released(&self) -> bool {
		!self.active && self.active_state_changed_this_frame
	}
}