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
93
94
95
96
97
98
|
# coding: utf-8
# Copyright 2019 DragonRuby LLC
# MIT License
# directional_input_helper_methods.rb has been released under MIT (*only this file*).
module GTK
# This is a module that contains normalization of behavior related to `up`|`down`|`left`|`right` on keyboards and controllers.
module DirectionalInputHelperMethods
def self.included klass
key_state_methods = [:key_held, :key_down]
directional_methods = [:up, :down, :left, :right]
method_results = (directional_methods + key_state_methods).map {|m| [m, klass.instance_methods.include?(m)] }
error_message = <<-S
* ERROR
The GTK::DirectionalKeys module should only be included in objects that respond to the following api hierarchy:
- (#{ directional_methods.join("|") })
- key_held.(#{ directional_methods.join("|") })
- key_down.(#{ directional_methods.join("|") })
#{klass} does not respond to all of these methods (here is the diagnostics):
#{method_results.map {|m, r| "- #{m}: #{r}"}.join("\n")}
Please implement the methods that returned false inthe list above.
S
unless method_results.map {|m, result| result}.all?
raise error_message
end
end
# Returns a signal indicating left (`-1`), right (`1`), or neither ('0').
#
# @return [Integer]
def left_right
return -1 if self.left
return 1 if self.right
return 0
end
# Returns a signal indicating up (`1`), down (`-1`), or neither ('0').
#
# @return [Integer]
def up_down
return 1 if self.up
return -1 if self.down
return 0
end
# Returns a normal vector (in the form of an Array with two values). If no directionals are held/down, the function returns nil.
#
# The possible results are:
#
# - ~nil~ which denotes that no directional input exists.
# - ~[ 0, 1]~ which denotes that only up is being held/pressed.
# - ~[ 0, -1]~ which denotes that only down is being held/pressed.
# - ~[-0.707, 0.707]~ which denotes that right and up are being pressed/held.
# - ~[-0.707, -0.707]~ which denotes that left and down are being pressed/held.
#
# @gtk
def directional_vector
lr, ud = [self.left_right, self.up_down]
if lr == 0 && ud == 0
return nil
elsif lr.abs == ud.abs
return [45.vector_x * lr.sign, 45.vector_y * ud.sign, ud.sign]
else
return [lr, ud]
end
end
def directional_angle
return nil unless directional_vector
Math.atan2(up_down, left_right).to_degrees
end
def method_missing m, *args
# combine the key with ctrl_
if m.to_s.start_with?("ctrl_")
other_key = m.to_s.split("_").last
define_singleton_method(m) do
return self.key_up.send(other_key.to_sym) && self.key_up.control
end
return send(m)
else
# see if the key is either held or down
define_singleton_method(m) do
self.key_down.send(m) || self.key_held.send(m)
end
return send(m)
end
end
end
end
|
