motion-meter 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a73dbc2e89c3dc3e86692b1ea7439ae35f1f8180
+  data.tar.gz: 7146eb4a49718dc49102d61a8a0dea75683bf331
+SHA512:
+  metadata.gz: 60c8e04a162e98c5e5f0977f2cf61bc435b158f5ab32c1bc2e88a2a39f1d8c503a5511c82b3138c286c8104245c06187aa9455183f1baa200dd87ca081169347
+  data.tar.gz: e9900b8c2a860d8ebd5a199d77f973c50946274b0c9f3e6890c91ecbb242e05db139aa04193d1152bfa8aadeb832045bcab4caaf4aff1a3866cf857626f2d22e

data/README.md

@@ -0,0 +1,73 @@
+# motion-meter
+
+A simple bar meter control with color based thresholds, useful for displaying a value such as an audio level according to whatever threshold and color rules you want to setup.
+
+## Requirements
+
+* RubyMotion
+* RubyGems
+
+## Setup
+
+Add to your Gemfile:
+
+``` shell
+gem 'motion-meter'
+```
+
+Or install manually:
+
+* gem install motion-meter
+
+## Usage
+
+To setup the control, you can do the following:
+
+```ruby
+@audio_level = Motion::Meter::ThresholdMeter.alloc.initWithFrame([[0, @mainWindow.contentView.bounds.size.height / 2.0], [@mainWindow.contentView.bounds.size.width, 30]])
+@audio_level.add_threshold(-20, -5, NSColor.greenColor)
+@audio_level.add_threshold(-5, 3, NSColor.yellowColor)
+@audio_level.add_threshold(3, 10, NSColor.redColor)
+@audio_level.min_value = -20
+@audio_level.max_value = 10
+@mainWindow.contentView.addSubview(@audio_level)
+```
+
+You can then simple update the value to see it change in real-time:
+
+```ruby
+@audio_level.value = value
+```
+
+## TODO
+
+* Optionally displaying the value
+* Optionally displaying the values of the thresholds along the top or bottom
+* Additional display options/controls for meters, such as a needle display or something more fancy
+
+## Contributors
+
+* Elliott Draper
+
+## License
+
+Copyright 2015 Elliott Draper <el@kickcode.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/motion-meter.rb

@@ -0,0 +1,7 @@
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+Motion::Project::App.setup do |app|
+  app.files = [Dir.glob(File.join(File.dirname(__FILE__), "motion/**/*.rb")), app.files].flatten
+end

data/lib/motion/meter/threshold_meter.rb

@@ -0,0 +1,36 @@
+class Motion::Meter::ThresholdMeter < NSView
+  Threshold = Struct.new(:start, :finish, :color)
+
+  attr_accessor :min_value, :max_value, :value, :thresholds
+
+  def add_threshold(start, finish, color)
+    self.thresholds ||= []
+    self.thresholds << Threshold.new(start, finish, color)
+  end
+
+  def range
+    self.max_value - self.min_value
+  end
+
+  def draw_width
+    (self.bounds.size.width / self.range.to_f) * ((self.value || 0) - self.min_value)
+  end
+
+  def value=(value)
+    @value = value
+    self.needsDisplay = true
+  end
+
+  def drawRect(frame)
+    frame.size = [self.draw_width, frame.size.height]
+
+    if (self.thresholds || []).any?
+      threshold = self.thresholds.detect { |threshold| threshold.start < (self.value || 0) && threshold.finish > (self.value || 0) }
+      color = threshold.color unless threshold.nil?
+    end
+
+    (color || NSColor.greenColor).setFill
+
+    NSRectFill(frame)
+  end
+end

data/lib/motion/meter/version.rb

@@ -0,0 +1,5 @@
+module Motion
+  module Meter
+    VERSION = 1.0
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: motion-meter
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Elliott Draper
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-07 00:00:00.000000000 Z
+dependencies: []
+description: motion-meter is a simple bar meter control with color based thresholds,
+  useful for displaying a value such as an audio level according to whatever threshold
+  and color rules you want to setup.
+email: el@kickcode.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/motion-meter.rb
+- lib/motion/meter/threshold_meter.rb
+- lib/motion/meter/version.rb
+homepage: 
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Simple visual meter control with color based thresholds
+test_files: []