ruby_hid 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f77ff9705448676fcba81e4d570be6735fb76e83
-  data.tar.gz: b2662f69540b32c1d96b14e7933b3e8501189197
+  metadata.gz: a1cf90fc54fd1ef00cade61b8475261c0431c92e
+  data.tar.gz: f0e981ea75d5a796b94a57c032d851a636021b34
 SHA512:
-  metadata.gz: f1b5529b242fe09f9e78dcc1b539f9688bb127260d1c2bf78c7478441ed42b9259c9c473c0ef0f7c40741c43db306ad66eb8411f2289fb9c13d020f3d455e62e
-  data.tar.gz: 404875e0fa3ffd3e22f599fb8845bda9895725d15a306a378635c6510cd427461947faa65c73fcc6ab4f938450509f45bc7e4e643deb82dca44205ecc9aaf42c
+  metadata.gz: ac3382ef3c8a2d01924a5e07dae57cec44f21449e6e1b259dc30198df946e340d88c0b450ce6bdf35d190fcd650364d0f262482fcda62dd9769982a97efda2d2
+  data.tar.gz: d0e75d621165fcaccac43348916c0790bf7b0d34f15bb959c985e7477141605f3f520912dfb1d9184e301d4c0310945d082a86bc702ff2cc523874e782efc72e

data/README.md

@@ -319,6 +319,43 @@ loop do
 end
 ```
 
+You can access specific named attribute of the store like so:
+
+```ruby
+store.left_x
+store.left_y
+store.dpad_x
+store.dpad_y
+store.btn_1
+```
+
+This returns raw values, as they are returned by the controller.
+
+You can also access the controller values in a normalised form,
+where all values range from 0 to 1.
+
+
+```ruby
+require 'ruby_hid'
+
+store = RubyHid::Store.new
+
+loop do
+  puts store.normalised_hash
+  sleep 0.1
+end
+```
+
+You can access specific normalised attribute of the store like so:
+
+```ruby
+store.normalise(:left_x)
+store.normalise(:left_y)
+store.normalise(:dpad_x)
+store.normalise(:dpad_y)
+store.normalise(:btn_1)
+```
+
 Helping Out
 ===========
 

data/lib/ruby_hid/axis.rb

@@ -32,6 +32,8 @@ module RubyHid
       17 => :dpad_y
     }
 
+    DPAD_KEYS = [:dpad_x, :dpad_y]
+
     #
     # Quick summary of the button
     #

data/lib/ruby_hid/store.rb

@@ -10,6 +10,41 @@ module RubyHid
       init_device
     end
 
+    def normalise(key)
+      value = @table[key]
+      if value
+        if Store.is_button?(key)
+          value
+        else # it's an axis
+          range = Store.value_range(key)
+          (value - range.min).to_f / range.size
+        end
+      else
+        0
+      end
+    end
+
+    def normalised_hash
+      @table.keys.inject({}) do |result, key|
+        result[key] = normalise(key)
+        result
+      end
+    end
+
+    private
+
+    def self.value_range(key)
+      if Axis::DPAD_KEYS.include?(key)
+        -1...1
+      else
+        0...255
+      end
+    end
+
+    def self.is_button?(key)
+      Button::EVENTS.values.include?(key)
+    end
+
     def init_device
       if device.nil?
         self.device = Device.new(

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_hid
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Andrew Faraday