motion-colortools 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YzdjMDIxMWEwNWJhZjI2NDM3ZDQyYTFhYjZiNWYxZWVlMzFmYjQ3ZA==
+  data.tar.gz: !binary |-
+    YTEyZjJmNzRhZmMxYTMzMjk0YzVlMzY3OTk5MDZiNTdmMjUyNWUwNA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    Y2QwMDQ5ODQwZTkzMjIzMzA2MmY5ZTg5NjdiNDdlODZlNzIzZjRkZjk2MDY5
+    ZGE3NjQyZmM4YzFmMDYzNDNlYWZjYmE5OTgyMTQzODJiNGNhZmVkM2U4M2U1
+    NGI1MTViZTk1OGExMjE2ZDM1MWFhZDJiMjAzN2I0MGI0MGU5ODU=
+  data.tar.gz: !binary |-
+    NDFlOGViYzFkODg5OGNjYWM5MzgwYTlhOWFhYzJiM2MxYWZlNDJjYzFmNTFk
+    MmQ1YjVjZjIxOGM2NmExODQwMjliOTg4N2NiNWFlYzFlZjFlY2U0N2IzNzBm
+    YjkwOGQxZDY4MjBhOWUxNDAxMmY5YTJlYWViODNhYWYwNTIzYmM=

data/LICENSE

@@ -0,0 +1,18 @@
+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/README.md

@@ -0,0 +1,108 @@
+# motion-colortools
+
+This gem provides some methods for manipulating UIColors in Rubymotion.
+
+Examples:
+
+`lighten` and `darken`:
+```ruby
+test_color = UIColor.colorWithHue(0.5, saturation:0.5, brightness:0.5, alpha:1.0)
+
+# Each of these methods takes one float between 0.0 and 1.0 
+
+# increase brightness by 0.2 
+test_color.lighten(0.2) # new brightness value of 0.7
+
+# or darken it by 0.2 
+test_color.darken(0.2) # new brightness value of 0.3
+```
+
+
+
+
+`scale_lighten` and `scale_darken`:
+```ruby
+
+# scale_lighten and scale_darken each take a float between 0.0 and 1.0 as a percentage.
+# scale_lighten lightens a color by 50% of the difference between the color's current brightness and 1.0, so:  
+test_color = UIColor.colorWithHue(0.5, saturation:0.5, brightness:0.8, alpha:1.0)
+test_color.scale_lighten(0.5) # new brightness value of 0.9 
+
+#scale_darken does the inverse:
+test_color = UIColor.colorWithHue(0.5, saturation:0.5, brightness:0.8, alpha:1.0)
+test_color.scale_darken(0.5) # new brightness value of 0.4
+```
+
+
+
+
+`saturate` and `desaturate`:
+```ruby
+# saturate and desaturate work much line lighten and darken.
+
+test_color = UIColor.colorWithHue(0.5, saturation:0.5, brightness:0.5, alpha:1.0)
+test_color.saturate(0.3) # new saturation value of 0.8
+test_color.desaturate(0.3) # new saturation value of 0.2
+```
+
+
+
+
+`tint` and `shade`:
+```ruby
+# rather than just adjusting brightness, tint and shade mix white and black into the 
+# color, respectively. They each take a float between 0.0 and 1.0, representing
+# the percentage of white or black to mix in. 
+# tint decreases saturation while increasing brightness, shade does the inverse:
+
+test_color = UIColor.colorWithHue(0.5, saturation:0.5, brightness:0.5, alpha:1.0)
+test_color.tint(0.2)	
+# new values: hue=>0.5, :saturation=>0.35, :brightness=>0.69, :alpha=>1.0
+
+# shade does the inverse:
+test_color.shade(0.2)
+# new values: hue=>0.5, :saturation=>0.83, :brightness=>0.29, :alpha=>1.0
+```
+
+
+
+
+There are also some methods that make it easier to work with UIColors:
+```ruby
+UIColor.blueColor.rgb # returns rgb values in a hash:
+=> {:red=>0.0, :green=>0.0, :blue=>1.0, :alpha=>1.0}
+
+UIColor.blueColor.hsb # returns hsb values in a hash:
+=> {:hue=>0.666666507720947, :saturation=>1.0, :brightness=>1.0, :alpha=>1.0} 
+
+UIColor.blueColor.grayscale? # tests if a color is grayscale or not
+=> false
+UIColor.whiteColor.grayscale?
+=> true
+
+UIColor.whiteColor.grayscale # returns grayscale values in a hash
+=> {:white=>1.0, :alpha=>1.0}
+```
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'motion-colortools'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install motion-colortools
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/lib/motion-colortools.rb

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

data/lib/project/motion-colortools.rb

@@ -0,0 +1,3 @@
+module MotionColorTools
+    Version = "0.1.0"
+end

data/lib/project/uicolor.rb

@@ -0,0 +1,148 @@
+class UIColor
+
+  def hsb
+    get_hsb
+  end
+
+  def rgb
+    get_rgb
+  end
+
+  def grayscale
+    get_grayscale
+  end
+
+  def lighten(amount)
+    if components == 4
+      color_values = hsb
+      new_brightness = color_values[:brightness] + amount
+      options = {brightness: new_brightness}
+      adjust_hsb(options)
+    else
+      self.tint(amount)
+    end
+  end
+
+  def scale_lighten(amount)
+    if components == 4
+      color_values = hsb
+      diff = 1.0 - color_values[:brightness]
+      new_brightness = color_values[:brightness] + (diff * amount)
+      options = {brightness: new_brightness}
+      adjust_hsb(options)
+    else
+      color_values = grayscale
+      diff = 1.0 - color_values[:white]
+      new_brightness = color_values[:white] + (diff * amount)
+      UIColor.colorWithWhite(new_brightness, alpha:(color_values[:alpha]))
+    end
+  end
+
+  def darken(amount)
+    if components == 4
+      color_values = hsb
+      new_brightness = color_values[:brightness] - amount
+      options = {brightness: new_brightness}
+      adjust_hsb(options)
+    else
+      self.shade(amount)
+    end
+  end
+
+  def scale_darken(amount)
+    if components == 4
+      color_values = hsb
+      new_brightness = color_values[:brightness] - (color_values[:brightness] * amount)
+      options = {brightness: new_brightness}
+      adjust_hsb(options)
+    else
+      color_values = grayscale
+      new_brightness = color_values[:white] - (color_values[:white] * amount)
+      UIColor.colorWithWhite(new_brightness, alpha:(color_values[:alpha]))
+    end
+  end
+
+  def desaturate(amount)
+    return self if components == 2
+    color_values = hsb
+    new_saturation = color_values[:saturation] - amount
+    options = {saturation: new_saturation}
+    adjust_hsb(options)
+  end
+
+  def saturate(amount)
+    return self if components == 2
+    color_values = hsb
+    new_saturation = color_values[:saturation] + amount
+    options = {saturation: new_saturation}
+    adjust_hsb(options)
+  end
+
+  def tint(amount)
+    if components == 4
+      color_values = rgb
+      UIColor.colorWithRed((color_values[:red] + amount), green:(color_values[:green] + amount), blue:(color_values[:blue] + amount), alpha:color_values[:alpha])
+    else
+      color_values = grayscale
+      UIColor.colorWithWhite((color_values[:white] + amount), alpha:(color_values[:alpha]))
+    end
+  end
+
+  def shade(amount)
+    if components == 4
+      color_values = rgb
+      UIColor.colorWithRed((color_values[:red] - amount), green:(color_values[:green] - amount), blue:(color_values[:blue] - amount), alpha:color_values[:alpha])
+    else
+      color_values = grayscale
+      UIColor.colorWithWhite((color_values[:white] - amount), alpha:(color_values[:alpha]))
+    end
+
+  end
+  
+  def grayscale?
+    components == 2
+  end
+
+  def cg
+    self.CGColor
+  end
+
+
+  private
+
+  def components
+    CGColorGetNumberOfComponents(self.cg)
+  end
+
+  def get_grayscale
+    white = Pointer.new :float
+    alpha = Pointer.new :float
+    self.getWhite(white, alpha:alpha)
+    {white: white[0], alpha: alpha[0] }
+  end
+
+  def get_hsb
+    hue        = Pointer.new :float
+    saturation = Pointer.new :float
+    brightness = Pointer.new :float
+    alpha      = Pointer.new :float
+    self.getHue(hue, saturation:saturation, brightness:brightness, alpha:alpha)
+    { hue: hue[0], saturation: saturation[0], brightness: brightness[0], alpha: alpha[0] }
+  end
+
+  def get_rgb
+    red   = Pointer.new :float
+    green = Pointer.new :float
+    blue  = Pointer.new :float
+    alpha = Pointer.new :float
+    self.getRed(red, green:green, blue:blue, alpha:alpha)
+    { red: red[0], green: green[0], blue: blue[0], alpha: alpha[0] }
+  end
+
+  def adjust_hsb(options)
+    defaults = hsb
+    new_values = defaults.merge(options)
+      UIColor.colorWithHue(new_values[:hue], saturation:new_values[:saturation], brightness:(new_values[:brightness]), alpha:new_values[:alpha])
+  end
+
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: motion-colortools
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kevin McGladdery
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A set of methods for UIColor to darken, lighten, tint, shade, saturate
+  and desaturate existing colors.
+email:
+- kevin.mcgladdery@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/motion-colortools.rb
+- lib/project/motion-colortools.rb
+- lib/project/uicolor.rb
+homepage: http://github.com/runkmc/motion-colortools
+licenses: []
+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.0.3
+signing_key: 
+specification_version: 4
+summary: A set of utility methods added to the UIColor class for manipulating colors.
+test_files: []