under-os-crop 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 959af2e74aa93432122b4fd46402818a414f53bf
+  data.tar.gz: fa0ebb332fb43498c11de8c2f3c4ba67ac795158
+SHA512:
+  metadata.gz: d3f40c0cd23bd720bbf6769b8311cb2c5c4e216189cbb50e77b86c0e26a9c35167a76ba5597e6edad800b496b94324cb16a4331a06a30b1c0e966f5c259ebc40
+  data.tar.gz: 55c6742e4e0fa43ea4e384ce00a3a167fae0b1dd1aae0e554c8e1943e64dd71dc317527f2d4b7513b84d5650bed5a275065cdd5905ed6d70516e5a08602b880a

data/.gitignore

@@ -0,0 +1,2 @@
+.repl_history
+build/

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+gem 'under-os-ui'
+gemspec

data/README.md

@@ -0,0 +1,75 @@
+# UnderOS Crop
+
+This is a nice image crop plugin for the [under-os](http://under-os.com) project.
+
+## Usage
+
+Add it to your `Gemfile`
+
+```ruby
+gem `under-os`
+gem `under-os-crop`
+```
+
+Then you can either use it as a `CROP` element in your HTML markup
+
+```html
+<page title="Image crop">
+  <crop id="the-crop"></crop>
+</page>
+```
+
+Or spawn it programmatically in your `UOS::Page` controller
+
+```ruby
+class CropPage < UOS::Page
+  def initialize
+    @crop = UOS::Crop.new
+  end
+end
+```
+
+Either way the `UOS::Crop` class is a subclass of the `UOS::UI::View` so
+all the normal under-os rules apply.
+
+## Cropping images
+
+Once you've got an instance of the `UOS::Crop` class, you can give it an
+instance of a `UIImage` class as the image that needs to be cropped and
+then read it the same way from the same `#src` property
+
+```ruby
+# set a new image to crop
+@crop.src = UIImage.alloc.initWithImage("test.png")
+
+# whenever the user is done, you can read it back
+@crop.src # -> the cropped image
+```
+
+## Setting Aspect Ratio
+
+You can set an aspect ratio for the crop widget as well through the `#ratio` property
+
+```ruby
+@crop.ratio = "3:4"
+@crop.ratio = "1:1"
+@crop.ratio = nil # no ratio
+```
+
+## Tilting & Turning
+
+You also can set the image tilt programmatically (say from a slider in UI) or turn
+the image 90 degrees with the `#turn` and `#tilt` methods
+
+```ruby
+@crop.turn Math::PI / 4  # turn 90 degrees
+@crop.tilt Math::PI / 12 # tilt image by 30 degrees
+```
+
+## Copyright & License
+
+All the code in this repository is released under the terms of the MIT license
+
+Copyright (C) 2014 Nikolay Nemshilov
+
+

data/lib/assets/uos-crop.css

@@ -0,0 +1,30 @@
+.crop {
+  border-radius: 0;
+}
+.crop scroll {
+  width:    100%;
+  height:   100%;
+  overflow: hidden;
+}
+
+.crop .overlay {
+  background: #000;
+  opacity:    0.7;
+  z-index:    1;
+}
+
+.crop .window {
+  z-index:       2;
+  border-width:  1px;
+  border-color:  rgba(200,200,200,0.5);
+}
+
+.crop .window .bar {
+  background: rgba(255,255,255,0.3);
+}
+.crop .window .bar.horizontal {
+  height: 1px;
+}
+.crop .window .bar.vertical {
+  width:  1px;
+}

data/lib/under-os-crop.rb

@@ -0,0 +1 @@
+UnderOs.extend __FILE__

data/lib/under_os/crop.rb

@@ -0,0 +1,96 @@
+#
+# An image crop UI
+#
+module UnderOs
+  class Crop < UnderOs::UI::View
+    tag :crop
+
+    attr_reader :ratio, :image
+
+    def initialize(options={})
+      super options.merge(class: 'crop')
+
+      append @scroll = Scroll.new
+      append @window = Window.new
+
+      @processor = Processor.new
+      self.ratio = nil
+    end
+
+    def ratio=(ratio)
+      ratio = ratio.to_s
+      ratio = "#{@original.size.width}:#{@original.size.height}" if ratio == 'true'
+
+      if m = ratio.match(/^([\d\.+]+):([\d\.]+)$/)
+        @ratio = m[1].to_f / m[2].to_f
+      else
+        @ratio = nil
+      end
+
+      @window.expand @ratio if self.size.x > 0
+    end
+
+    def repaint(*args)
+      super(*args).tap{ @window.expand @ratio if @window }
+    end
+
+    def src
+      @processor.render *original_crop_rectangle
+    end
+
+    def src=(image)
+      @processor.image = image
+      @original = @processor.image # fixed original
+      reset
+    end
+
+    def reset
+      @scroll.resetting!
+      render { @processor.reset }
+    end
+
+    def turn(angle)
+      render { @processor.turn(angle) }
+    end
+
+    def tilt(angle)
+      render { @processor.tilt(angle) }
+    end
+
+  protected
+
+    def render(&block)
+      return if @_working; @_working = true
+
+      Dispatch::Queue.new("uos.gems.crop.tilt").async do
+        new_image = block.call
+
+        Dispatch::Queue.main.async do
+          @scroll.image = new_image
+          @_working = false
+        end
+      end
+    end
+
+    def original_crop_rectangle
+      content_size    = @scroll.contentSize / @scroll.scale
+      crop_offset     = @scroll.contentOffset / @scroll.scale + @window.position / 2 + 1
+      crop_frame      = @window.size / @scroll.scale
+
+      crop_offset.x   = 0 if crop_offset.x < 0 # tall image
+      crop_offset.y   = 0 if crop_offset.y < 0 # wide image
+
+      crop_frame.x    = content_size.x if crop_frame.x > content_size.x
+      crop_frame.y    = content_size.y if crop_frame.y > content_size.y
+
+      original_is_h   = @original.size.width / @original.size.height > 1
+      content_is_h    = content_size.x / content_size.y > 1
+      original_scale  = @original.size.width / content_size.__send__(original_is_h == content_is_h ? :x : :y)
+
+      original_offset = crop_offset * original_scale
+      original_frame  = crop_frame * original_scale
+
+      [original_offset.x, original_offset.y, original_frame.x, original_frame.y]
+    end
+  end
+end

data/lib/under_os/crop/processor.rb

@@ -0,0 +1,94 @@
+class UnderOs::Crop::Processor
+
+  def initialize
+    @tilt_filter = CIFilter.filterWithName("CIStraightenFilter")
+    @turn_filter = CIFilter.filterWithName("CIAffineTransform")
+    @crop_filter = CIFilter.filterWithName("CICrop")
+    @context     = begin
+      gl_context = EAGLContext.alloc.initWithAPI(KEAGLRenderingAPIOpenGLES2)
+      options    = {KCIContextWorkingColorSpace => nil}
+      CIContext.contextWithEAGLContext(gl_context, options:options)
+    end
+  end
+
+  def image
+    @original
+  end
+
+  def image=(image)
+    @original = fix_orientation(image)
+
+    resize(@original).tap do |ui_image|
+      @resized_original = ui_image
+    end
+  end
+
+  def reset
+    @resized_original.tap do |ui_image|
+      @working = CIImage.alloc.initWithImage(ui_image)
+    end
+  end
+
+  def turn(angle)
+    transform = NSValue.valueWithCGAffineTransform(CGAffineTransformMakeRotation(angle))
+    @turn_filter.setValue(transform, forKey:"inputTransform")
+    reset
+    apply(@turn_filter).tap{ |image| @working = CIImage.alloc.initWithImage(image)  }
+    apply(@tilt_filter)
+  end
+
+  def tilt(angle)
+    @tilt_filter.setValue(angle, forKey:"inputAngle")
+    apply @tilt_filter
+  end
+
+  def crop(x, y, width, height)
+    img_size  = UIImage.alloc.initWithCIImage(@working).size
+    y         = img_size.height - y - height # this filter counts from the bottom
+    rectangle = CIVector.vectorWithX(x, Y:y, Z:width, W:height)
+    @crop_filter.setValue(rectangle, forKey:'inputRectangle')
+    apply @crop_filter
+  end
+
+  def render(*crop_rect)
+    @_working_image = @working
+
+    @working = CIImage.alloc.initWithImage(@original)
+    @working = CIImage.alloc.initWithImage(apply(@turn_filter))
+    @working = CIImage.alloc.initWithImage(apply(@tilt_filter))
+
+    crop(*crop_rect).tap{ |i| @working = @_working_image }
+  end
+
+protected
+
+  def apply(filter)
+    filter.setValue(@working, forKey: 'inputImage')
+
+    image    = filter.outputImage
+    cg_image = @context.createCGImage(image, fromRect:image.extent)
+    image    = UIImage.imageWithCGImage(cg_image)
+
+    CGImageRelease(cg_image)
+    filter.setValue(nil, forKey: 'inputImage')
+
+    image
+  end
+
+  def fix_orientation(image)
+    resize(image, image.size.width)
+  end
+
+  def resize(image, max_width=nil)
+    max_width ||= UOS::Screen.size.x * 4 # double the retina for zoom
+    ratio     = max_width / image.size.width
+    new_size  = CGSizeMake(max_width, image.size.height * ratio)
+
+    UIGraphicsBeginImageContext(new_size)
+    image.drawInRect(CGRectMake(0,0,new_size.width,new_size.height))
+    new_image = UIGraphicsGetImageFromCurrentImageContext()
+    UIGraphicsEndImageContext()
+
+    new_image
+  end
+end

data/lib/under_os/crop/scroll.rb

@@ -0,0 +1,37 @@
+class UnderOs::Crop < UnderOs::UI::View
+class Scroll < UOS::UI::Scroll
+  attr_reader :image
+
+  def initialize(options={})
+    super options
+
+    UnderOs::App.history.current_page._.automaticallyAdjustsScrollViewInsets = false
+
+    self.minScale = 1.0
+    self.maxScale = 3.0
+    @_.decelerationRate = 0.2
+
+    append @image = UOS::UI::Image.new
+
+    self.zoomItem = @image
+    self.on(:zoom) { centerContent }
+  end
+
+  def image=(src)
+    @image.src = src
+    self.scale = 1.0 and @resetting = nil if @resetting
+
+    scale      = [self.size.x / src.size.width, self.size.y / src.size.height].min
+    @new_size  = {x: src.size.width * scale * self.scale, y: src.size.height * scale * self.scale}
+
+    @image.size      = @new_size
+    self.contentSize = @new_size
+
+    centerContent
+  end
+
+  def resetting!
+    @resetting = true
+  end
+end
+end

data/lib/under_os/crop/window.rb

@@ -0,0 +1,77 @@
+class UnderOs::Crop::Window < UnderOs::UI::View
+  def initialize(options={})
+    super class: 'window'
+
+    @_.userInteractionEnabled = false
+
+    append @over_1 = Overlay.new
+    append @over_2 = Overlay.new
+
+    append @bar_h1 = Bar.new('horizontal')
+    append @bar_h2 = Bar.new('horizontal')
+
+    append @bar_v1 = Bar.new('vertical')
+    append @bar_v2 = Bar.new('vertical')
+  end
+
+  def expand(ratio)
+    parent_size  = parent.size
+    parent_ratio = parent_size.x / parent_size.y
+    ratio      ||= parent_ratio
+    new_size     = {x: parent_size.x, y: parent_size.y}
+
+    if ratio > parent_ratio
+      new_size[:y] = parent_size.x / ratio
+    else
+      new_size[:x] = parent_size.y * ratio
+    end
+
+    self.size = {x: new_size[:x] + 2, y: new_size[:y] + 2}
+  end
+
+  def size=(new_size)
+    super new_size
+
+    self.position = {
+      x: parent.size.x / 2 - size.x / 2,
+      y: parent.size.y / 2 - size.y / 2
+    }
+
+    move_bars
+    move_overlays
+  end
+
+  def move_bars
+    @bar_h1.position.y = size.y / 3
+    @bar_h2.position.y = size.y / 3 * 2
+    @bar_v1.position.x = size.x / 3
+    @bar_v2.position.x = size.x / 3 * 2
+
+    @bar_h1.size.x = size.x
+    @bar_h2.size.x = size.x
+    @bar_v1.size.y = size.y
+    @bar_v2.size.y = size.y
+  end
+
+  def move_overlays
+    if position.x > position.y # vertical
+      @over_1.style = {width: position.x, height: size.y, top: 0, left:  -position.x}
+      @over_2.style = {width: position.x, height: size.y, top: 0, right: -position.x}
+    else # horizontal
+      @over_1.style = {width: size.x, height: position.y, left: 0, top:    -position.y}
+      @over_2.style = {width: size.x, height: position.y, left: 0, bottom: -position.y}
+    end
+  end
+
+  class Bar < UnderOs::UI::View
+    def initialize(orientation)
+      super class: "bar #{orientation}"
+    end
+  end
+
+  class Overlay < UnderOs::UI::View
+    def initialize(options={})
+      super class: 'overlay'
+    end
+  end
+end

data/lib/under_os/styles.rb

@@ -0,0 +1,2 @@
+$stylesheets ||= []
+$stylesheets << "uos-crop.css"

data/under-os-crop.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |gem|
+  gem.name          = "under-os-crop"
+  gem.version       = '1.0.0'
+
+  gem.authors       = ["Nikolay Nemshilov"]
+  gem.email         = ['nemshilov@gmail.com']
+  gem.description   = "The images crop UI for UnderOS"
+  gem.summary       = "The images crop UI for UnderOS. Like totes"
+  gem.license       = 'MIT'
+
+  gem.files         = `git ls-files`.split($/).reject{|f| f.slice(0,5) == 'gems/'}
+  gem.executables   = gem.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+
+  gem.add_runtime_dependency 'under-os-ui'
+
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: under-os-crop
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Nikolay Nemshilov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: under-os-ui
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: The images crop UI for UnderOS
+email:
+- nemshilov@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- lib/assets/uos-crop.css
+- lib/under-os-crop.rb
+- lib/under_os/crop.rb
+- lib/under_os/crop/processor.rb
+- lib/under_os/crop/scroll.rb
+- lib/under_os/crop/window.rb
+- lib/under_os/styles.rb
+- resources/Default-568h@2x.png
+- under-os-crop.gemspec
+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: The images crop UI for UnderOS. Like totes
+test_files: []