findaface 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4f5419db2c9bb3da0a696bbe7208131b6e54949e
-  data.tar.gz: dc135c13a976842acf4304b8a4819a5ddaa5de57
+  metadata.gz: 09569130164ec8180f6c898dc045d26c98696114
+  data.tar.gz: 5f286cd6676782c964308633cc322158e1df3ab1
 SHA512:
-  metadata.gz: 6699a6fde264ec6ca2bfb9ab843980354b3e7dcaaf3ccfdd825710825508dea894c64f998e906e410a16adc1e7be6a86fff94231b24ec3fbd4a9ff6f4d1b6f3a
-  data.tar.gz: 81eca8a1ec2e65d6e1d6f518d2ce73709cc9fc72ac874e082b40056041657962e1c7f3a1517406a3a716249e19c8d6d8cf919605aecfe09cf264aa0910bdf658
+  metadata.gz: 0b6f26b1ba2d546196106a36a7f6ca3f727404e38a5f599baf6805f23b0de3d34f7517c4343132ed4b3329fcb205f64e2299065e12b0835e501bd49266913824
+  data.tar.gz: 81f60e0155dcc46af521e34a0dd386967feeace95627c49969bf61262c648a4cc227e85f54f28d7e817eb14f99447645f63c856e617f8a8a56d8ba34b33a4e55

data/.gitignore

@@ -23,3 +23,4 @@ mkmf.log
 
 spec/test_photos
 ext/findaface/findaface
+.DS_Store

data/README.md

@@ -1,26 +1,53 @@
 # Findaface
 
 When given a path to a picture, this gem attempts to determins whether it contains
-a single face and thus might be appropriate for a profile image, ID Card etc.
+faces and thus might be appropriate for a profile image. It is looking for faces bigger than 80 pixels squared.
 
-It is a modified then gemified version of George Ogata's [find-face](https://github.com/howaboutwe/find-face).
+It is a modified then gemified version of George Ogata's [find-face](https://github.com/howaboutwe/find-face). If you want a CLI that indicates where the biggest face in an image is, then use the original.
 
-If you want a CLI that indicates where the biggest face in an image is, then use [find-face](https://github.com/howaboutwe/find-face).
-If you want a ruby gem that indicates whether an image contains a single face, use this.
+This gem simply compiles an executable to detect a face then calls it externally, so you won't have to include the humongous OpenCV library into your Ruby process, which can cause memory leak / bloat or even crash. This is what [Paperclip](https://github.com/thoughtbot/paperclip) does for ImageMagick. We also support [posix-spawn](https://github.com/rtomayko/posix-spawn) to mitigate the overhead of fork-exec.
 
 ## Installation
 
-Add this line to your application's Gemfile:
+There are two steps:
+
+1. Install OpenCV
+2. Install Findaface
+
+### Install OpenCV
+
+For Mac:
 
-    gem 'findaface'
+```sh
+brew tap homebrew/science
+brew install opencv
+```
+
+For Linux (Debian/Ubuntu):
 
-And then execute:
+```sh
+apt-get install libopencv-dev
+```
 
-    $ bundle
+Linux servers don't have a camera, so you might want to fake the device to suppress the warning:
+
+```sh
+touch /dev/raw1394
+```
+
+### Install Findaface
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'findaface'
+```
 
 Or install it yourself as:
 
-    $ gem install findaface
+```sh
+$ gem install findaface
+```
 
 ## Usage
 

data/ext/findaface/findaface.cc

@@ -71,11 +71,12 @@ int main(int argc, const char** argv)
 
     // This parameter will affect the quality of the detected faces. Higher value results in less
     // detections but with higher quality. 3~6 is a good value for it.
-    int fussyness = 5;
-    cascade.detectMultiScale(small_image, faces, 1.05, fussyness, 0, Size(50, 50));
+    int fussyness = 2;
+    cascade.detectMultiScale(small_image, faces, 1.05, fussyness, 0, Size(80, 80));
 
     std::cout << faces.size() << "\tface(s) found\n";
-    if(faces.size() == 1) {
+
+    if(faces.size() >= 1) {
       return 0;
     } else {
       return 1;

data/findaface.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Andrew Nagi"]
   spec.email         = ["andrew.nagi@gmail.com"]
   spec.summary       = %q{Finds a face in an image.}
-  spec.description   = %q{This gem attempts to discern whether an image contains a clear picture of a single face. Depends on OpenCV.}
+  spec.description   = %q{This gem attempts to discern whether an image contains any faces. Depends on OpenCV.}
   spec.homepage      = ""
   spec.license       = "MIT"
 

data/lib/findaface.rb

@@ -4,7 +4,7 @@ require 'posix/spawn'
 module Findaface
   LIB_PATH = File.dirname(File.expand_path(__FILE__))
   EXECUTABLE = File.join(LIB_PATH, '../ext/findaface/findaface')
-  DEFAULT_CASCADE = File.join(LIB_PATH, 'haarcascades/haarcascade_frontalface_alt.xml')
+  DEFAULT_CASCADE = File.join(LIB_PATH, 'haarcascades/haarcascade_frontalface_alt2.xml')
 
   def self.has_face?(path)
     raise "#{path} file does not exist" unless File.exists?(path)

data/lib/findaface/version.rb

@@ -1,3 +1,3 @@
 module Findaface
-  VERSION = '0.0.3'
+  VERSION = '0.0.4'
 end

data/spec/findaface_spec.rb

@@ -14,12 +14,6 @@ describe Findaface, "has_face?" do
     end
   end
 
-  it "returns false for group photos" do
-    Dir['spec/test_photos/many_faces/*'].each do |path|
-      Findaface.has_face?(path).should be_false
-    end
-  end
-
   it "returns false for photos with small faces" do
     Dir['spec/test_photos/small_faces/*'].each do |path|
       Findaface.has_face?(path).should be_false if path == 'spec/test_photos/small_faces/small.jpg'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: findaface
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Andrew Nagi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-02 00:00:00.000000000 Z
+date: 2014-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: posix-spawn
@@ -122,8 +122,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: This gem attempts to discern whether an image contains a clear picture
-  of a single face. Depends on OpenCV.
+description: This gem attempts to discern whether an image contains any faces. Depends
+  on OpenCV.
 email:
 - andrew.nagi@gmail.com
 executables: []
@@ -168,10 +168,8 @@ files:
 - spec/findaface_spec.rb
 - spec/test_photos/has_face/.gitkeep
 - spec/test_photos/has_face/face.jpg
-- spec/test_photos/many_faces/family.jpg
 - spec/test_photos/no_face/.gitkeep
 - spec/test_photos/no_face/fruit.jpg
-- spec/test_photos/no_face/garden.jpg
 - spec/test_photos/small_faces/beach.jpg
 homepage: ''
 licenses:
@@ -201,9 +199,7 @@ test_files:
 - spec/findaface_spec.rb
 - spec/test_photos/has_face/.gitkeep
 - spec/test_photos/has_face/face.jpg
-- spec/test_photos/many_faces/family.jpg
 - spec/test_photos/no_face/.gitkeep
 - spec/test_photos/no_face/fruit.jpg
-- spec/test_photos/no_face/garden.jpg
 - spec/test_photos/small_faces/beach.jpg
 has_rdoc: