sugarcube 0.13.7 → 0.14.0

data/README.md

@@ -475,6 +475,10 @@ image.tileable
 image.tileable(insets)
 image.stretchable
 image.stretchable(insets)
+
+# Apply a mask to an image.  The mask should be a grayscale image.  White areas
+# will be made transparent, and black opaque.
+image.masked(mask_image)
 ```
 
 UIAlertView

data/lib/sugarcube/nsdata.rb

@@ -19,4 +19,4 @@ class NSData
     end
   end
 
-end
+end

data/lib/sugarcube/symbol.rb

@@ -64,6 +64,9 @@ class Symbol
 
     attr_accessor :ca_timingfunctions
 
+    attr_accessor :cg_linecapstyles
+    attr_accessor :cg_linejoinstyles
+
     attr_accessor :gesture_recognizer_states
   end
 
@@ -415,6 +418,18 @@ class Symbol
     default:           KCAMediaTimingFunctionDefault,
   }
 
+  @cg_linecapstyles = {
+    butt: KCGLineCapButt,
+    round: KCGLineCapRound,
+    square: KCGLineCapSquare,
+  }
+
+  @cg_linejoinstyles = {
+    miter: KCGLineJoinMiter,
+    round: KCGLineJoinRound,
+    bevel: KCGLineJoinBevel,
+  }
+
   @gesture_recognizer_states = {
     possible:   UIGestureRecognizerStatePossible,
     began:      UIGestureRecognizerStateBegan,
@@ -583,6 +598,16 @@ class Symbol
   end
   alias catiming catimingfunction
 
+  def cglinecap
+    look_in(Symbol.cg_linecapstyles)
+  end
+  alias cglinecapstyle cglinecap
+
+  def cglinejoin
+    look_in(Symbol.cg_linejoinstyles)
+  end
+  alias cglinejoinstyle cglinejoin
+
   def uigesturerecognizerstate
     look_in(Symbol.gesture_recognizer_states)
   end

data/lib/sugarcube/uicolor.rb

@@ -21,7 +21,22 @@ class UIColor
     _sugarcube_colors && _sugarcube_colors[:alpha]
   end
 
+  # returns the closest css name
+  def css_name
+    found = Symbol.css_colors.map { |key, val| [key, _sugarcube_color_compare(self, val.uicolor)] }.inject{|c1,c2| c1[1] < c2[1] ? c1 : c2 }
+    threshold = 0.03
+    if found[1] > 0.03
+      nil
+    else
+      found[0]
+    end
+  end
+
 private
+  def _sugarcube_color_compare(c1, c2)
+    return (c1.red - c2.red).abs + (c1.green - c2.green).abs + (c1.blue - c2.blue).abs
+  end
+
   def _sugarcube_colors
     @color ||= begin
       red = Pointer.new(:float)

data/lib/sugarcube/uiimage.rb

@@ -197,4 +197,27 @@ class UIImage
     imageWithAlignmentRectInsets(insets)
   end
 
+  ##|
+  ##|  CGImageCreateWithMask
+  ##|
+  ## The mask image cannot have ANY transparency.
+  ## Instead, transparent areas must be white or some value between black and white.
+  ## The closer towards black a pixel is the less transparent it becomes.
+  def masked(mask_image)
+    mask_image = mask_image.CGImage
+
+    width = CGImageGetWidth(mask_image)
+    height = CGImageGetHeight(mask_image)
+    component_bits = CGImageGetBitsPerComponent(mask_image)
+    pixel_bits = CGImageGetBitsPerPixel(mask_image)
+    row_bytes = CGImageGetBytesPerRow(mask_image)
+    data_provider = CGImageGetDataProvider(mask_image)
+
+    mask = CGImageMaskCreate(width, height, component_bits,
+      pixel_bits, row_bytes, data_provider,nil, false)
+
+    masked = CGImageCreateWithMask(self.CGImage, mask)
+    UIImage.imageWithCGImage(masked)
+  end
+
 end

data/lib/sugarcube/version.rb

@@ -1,3 +1,3 @@
 module SugarCube
-  Version = '0.13.7'
+  Version = '0.14.0'
 end

data/sugarcube.gemspec

@@ -5,7 +5,7 @@ Gem::Specification.new do |gem|
   gem.name          = 'sugarcube'
   gem.version       = SugarCube::Version
 
-  gem.authors = ['Colin T.A. Gray', 'Thom Parkin', 'Katsuyoshi Ito', 'Fusionbox']
+  gem.authors = ['Colin T.A. Gray', 'Thom Parkin', 'Katsuyoshi Ito', 'Michael Erasmus', 'Fusionbox']
   gem.email   = ['colinta@gmail.com']
   gem.summary     = %{Extensions for Ruby to make Rubymotion development more enjoyable, and hopefully more rubyesque!}
   gem.description = <<-DESC

metadata

@@ -1,18 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: sugarcube
 version: !ruby/object:Gem::Version
-  version: 0.13.7
+  version: 0.14.0
   prerelease: 
 platform: ruby
 authors:
 - Colin T.A. Gray
 - Thom Parkin
 - Katsuyoshi Ito
+- Michael Erasmus
 - Fusionbox
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-11 00:00:00.000000000 Z
+date: 2013-01-15 00:00:00.000000000 Z
 dependencies: []
 description: ! '== Description