paperclip-facecrop 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*
+*.gem
+Gemfile.lock
+.bundle

data/README.md

@@ -0,0 +1,50 @@
+Paperclip::FaceCrop
+====================
+`Paperclip::FaceCrop` is a [Paperclip][paperclip] processor that is aware of the faces found on the image 
+so that they aren't cropped or aren't shown too small while generating the thumbnails.
+It uses OpenCV for the facial recognition
+
+![](https://github.com/dagi3d/paperclip-facecrop/raw/master/README_example.jpg)
+
+Requirements:
+-------------
+- [OpenCV][opencv]
+- [OpenCV ruby binding][ruby-opencv]
+
+Installation:
+-------------
+- Install the gem
+          
+          `gem install paperclip-facecrop'`
+          
+- Add to `Gemfile`
+
+          gem 'paperclip-facecrop'
+
+- Write an initializer setting the path of the haarcascade filters(`initializers/paperclip.rb` for example):   
+
+          Paperclip::FaceCrop.classifiers = ["/usr/local/share/opencv/haarcascades/haarcascade_frontalface_alt_tree.xml"]
+    
+You can use more than one filter if you want in order to try more accurate searches.
+
+Usage:
+------
+Just specify your image styles as usual and set :face_crop as the processor:
+    
+    class Image < ActiveRecord::Base
+
+      has_attached_file :attachment, 
+          :styles => {:thumbnail => "200x125#"}, 
+          :processors => [:face_crop]
+    end
+    
+In case no faces were found, it will behave simply as the `Paperclip::Thumbnail` processor
+
+Credits:
+--------
+Copyright (c) 2011 Borja Martín Sánchez de Vivar <borjamREMOVETHIS@dagi3d.net> - <http://dagi3d.net>, released under the MIT license  
+The photo used as example belongs to [Jesper Rønn-Jensen](http://www.flickr.com/photos/jesper/)
+
+[paperclip]: https://github.com/thoughtbot/paperclip
+[opencv]: http://opencv.willowgarage.com/
+[ruby-opencv]: https://github.com/ser1zw/ruby-opencv

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/paperclip-facecrop.rb

@@ -0,0 +1,101 @@
+require 'opencv'
+
+class Paperclip::FaceCrop < Paperclip::Thumbnail
+  
+  cattr_accessor :classifiers
+
+  def initialize(file, options = {}, attachment = nil)
+    super(file, options, attachment)
+    
+    x_coords = []
+    y_coords = []
+    widths   = []
+    heights  = []
+    
+    raise "No classifiers were defined" if Paperclip::FaceCrop.classifiers.nil?
+    
+    image = OpenCV::IplImage.load(file.path)
+    
+    Paperclip::FaceCrop.classifiers.each do |classifier|
+      detector = OpenCV::CvHaarClassifierCascade::load(classifier)
+      detector.detect_objects(image) do |region|
+        x_coords << region.top_left.x << region.bottom_right.x
+        y_coords << region.top_left.y << region.bottom_right.y
+        widths << region.width
+        heights << region.height
+      end
+    end
+    
+    @has_faces = x_coords.size > 0
+    
+    if @has_faces
+      @top_left_x = x_coords.min
+      @top_left_y = y_coords.min
+      @bottom_right_x = x_coords.max
+      @bottom_right_y = y_coords.max
+      
+      # average faces areas
+      average_face_width  = widths.sum / widths.size
+      average_face_height = heights.sum / heights.size
+    
+      # calculating the surrounding margin of the area that covers all the found faces
+      #
+      
+      # new width
+      @top_left_x -= average_face_width / 2
+      @bottom_right_x += average_face_width / 2
+      
+      # new height
+      @top_left_y -= average_face_height / 2
+      @bottom_right_y += average_face_height / 1.6
+
+      calculate_bounds
+      
+      # if the new area is smaller than the target geometry, it's scaled so the final image isn't resampled
+      #
+      if @faces_width < @target_geometry.width
+        delta_width = (@target_geometry.width - @faces_width) / 2
+        @top_left_x -= delta_width
+        @bottom_right_x += delta_width
+        calculate_bounds
+      end
+      
+      if @faces_height < @target_geometry.height
+        delta_height = (@target_geometry.height - @faces_height) / 2
+        @top_left_y -= delta_height
+        @bottom_right_y += delta_height
+        calculate_bounds
+      end
+      
+      @current_geometry = Paperclip::Geometry.new(@faces_width, @faces_height)
+    end
+    
+  end
+
+  # calculate_bounds
+  #
+  def calculate_bounds
+    @top_left_x = 0 if @top_left_x < 0      
+    @bottom_right_x = @current_geometry.width if @bottom_right_x > @current_geometry.width
+
+    @top_left_y = 0 if @top_left_y < 0
+    @bottom_right_y = @current_geometry.height if @bottom_right_y > @current_geometry.height
+    
+    @faces_width = @bottom_right_x - @top_left_x
+    @faces_height = @bottom_right_y - @top_left_y
+  end
+  
+  
+  def transformation_command
+    return super unless @has_faces
+    
+    scale, crop = @current_geometry.transformation_to(@target_geometry, crop?)
+    faces_crop = "%dx%d+%d+%d" % [@faces_width, @faces_height, @top_left_x, @top_left_y]
+    
+    trans = []
+    trans << "-crop" << %["#{faces_crop}"] << "+repage"
+    trans << "-resize" << %["#{scale}"] unless scale.nil? || scale.empty?
+    trans << "-crop" << %["#{crop}"] << "+repage" if crop
+    trans
+  end
+end

data/lib/version.rb

@@ -0,0 +1,5 @@
+class Paperclip
+  class FaceCrop
+    VERSION = "0.0.1"
+  end
+end

data/paperclip-facecrop.gemspec

@@ -0,0 +1,17 @@
+# encoding: utf-8
+$:.push File.expand_path("../lib", __FILE__)
+require 'version'
+Gem::Specification.new do |s|
+  s.name = "paperclip-facecrop"
+  s.version = Paperclip::FaceCrop::VERSION
+  s.authors = ["Borja Martín"]
+  s.description = %q{Paperclip processor that is aware of the faces detected on the image so that they don't get cropped or aren't shown too small while generating the thumbnails}
+  s.summary = %q{Paperclip processor that is aware of the faces found on the image}
+  s.email = "borjam@dagi3d.net"
+  s.homepage = "http://github.com/dagi3d/paperclip-facecrop"
+  s.require_paths = ["lib"]
+  s.files = `git ls-files`.split("\n")
+  s.has_rdoc = false
+  s.add_runtime_dependency("paperclip")
+  s.add_runtime_dependency("opencv", "~> 0.0.6")
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: paperclip-facecrop
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- "Borja Mart\xC3\xADn"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-03 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: paperclip
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: opencv
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 0
+        - 6
+        version: 0.0.6
+  type: :runtime
+  version_requirements: *id002
+description: Paperclip processor that is aware of the faces detected on the image so that they don't get cropped or aren't shown too small while generating the thumbnails
+email: borjam@dagi3d.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.md
+- README_example.jpg
+- Rakefile
+- lib/paperclip-facecrop.rb
+- lib/version.rb
+- paperclip-facecrop.gemspec
+has_rdoc: true
+homepage: http://github.com/dagi3d/paperclip-facecrop
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Paperclip processor that is aware of the faces found on the image
+test_files: []
+