easyimg_utils 0.6.4 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e12a8d7ad03689334172c8068730efef5acd22474b4f3b3a0d0f73994fa6f0c3
-  data.tar.gz: a2e24819dc0efd620fa16797286034f0cce333d1ef360eb6bb2e6a4b106ca36e
+  metadata.gz: c09e7c063bbd8a5c1060c74338346317b3432f46e53a0e3cdc6e0d4a64553520
+  data.tar.gz: 8d73c424b106e51dea74394557e601b8ea78bfca66fd43bf80a10088527ba726
 SHA512:
-  metadata.gz: 2d5acd5bfef69e8cec1dc304f92e440070be9412d189fee2ce6d6c2b884593d9776b1bf04978dd572d62aea372fc0f636c6bf68c5dfd5338dcafbb9742647620
-  data.tar.gz: 4ea3afa5a48559a84d38e7806cf7ab27b3827ffcd1f6d2ef9cfbe0240f0d06e71987e9b2ef9316a2b510f8584ad605c67aa0512e41bd973c745d9c82ede407b1
+  metadata.gz: 602af329751d96be2d89a4b6487d35d9c1920a4e56fb8d5330014e8e924b0edb44db1f74bd926224bcf3ee62435cba1b3b209ccea1f2301b0618a299534702b9
+  data.tar.gz: abd50555f42ad809647180e58325578951b653f545fc7411c8b58e3132625ff90e82666509d1933ecf75d48409437b27dad9718fa60a4183c4d0174bc85e0fa5

data/lib/easyimg_utils.rb

@@ -7,6 +7,7 @@ require 'x4ss'
 require 'rmagick'
 require 'webp_ffi'
 require 'rxfhelper'
+require 'detectfaces'
 
 # requirements:
 #
@@ -19,6 +20,8 @@ require 'rxfhelper'
 # webp-ffi dependencies
 # apt-get install libjpeg-dev libpng-dev libtiff-dev libwebp-dev
 #
+# detectfaces dependencies
+# apt-get install libopencv-dev
 
 
 
@@ -54,6 +57,7 @@ class EasyImgUtils
 * add_svg # adds an SVG transparency overlay. usage: add_svg('/tmp/image1.svg')
 * add_text # e.g. add_text('some text')
 * animate Creates an animated gif e.g. animate('/tmp/a%d.png', '/tmp/b.gif')
+* best_viewport # returns the best viewing region on the y-axis
 * blur # e.g. blur(x: 231, y: 123, w: 85, h: 85)
 * capture_screen # takes a screenshot of the desktop
 * calc_resize # e.g. calc_resize '640x480' #=> 640x491
@@ -63,6 +67,7 @@ class EasyImgUtils
 * convert # convert from 1 img format to another
 * crop # e.g. crop(x: 231, y: 123, w: 85, h: 85)
 * fax_effect # Produces a high-contrast, two colour image
+* faces # Returns an array of bounding boxes for detected faces
 * greyscale # Reduces the image to 256 shades of grey
 * info # returns the dimension of the image in a Hash object
 * make_thumbnail # similar to resize but faster for sizes less than 10% of original image 
@@ -88,12 +93,21 @@ class EasyImgUtils
   end
   
   # e.g. calc_resize '1449x1932', '640x480' #=> 480x640
+  # e.g. calc_resize '518x1024', '*518x500' #=> "518x1024" 
+  # the asterisk denotes a guaranteed the image will be resized using x or y
   #
-  def self.calc_resize(s, s2)
+  def self.calc_resize(geometry, new_geometry, force: false)
     
-    a = s.split('x',2).map(&:to_i)
-    a2 = s2.split('x',2).map(&:to_i)
-    i = a.index a.max
+    xy = geometry.split('x',2)
+    xy2 = new_geometry.split('x',2)
+
+    # find any locked geometry which guarantees the resize on either x or y
+    lock = xy2.find {|x| x =~ /^\*/}
+
+    a = xy.map {|x| x[/\d+/].to_i}
+    a2 = xy2.map {|x| x[/\d+/].to_i}
+
+    i = lock ? a2.index(lock[1..-1].to_i) : a.index(a.max)
 
     factor = a2[i] / a[i].to_f
 
@@ -162,6 +176,41 @@ class EasyImgUtils
     
   end    
   
+  # Used where images are perhaps cropped using CSS to a letterbox size image.
+  # Works best with portrait mode photos of selfies or natural 
+  #   landscapes with a lot of sky
+  #
+  # Returns the starting y pos as a percentage of the image using face 
+  # detection and high contrast detection on the y-axis
+  #
+  def best_viewport()
+    
+    percentage = 0
+    
+    read() do |img|
+
+      found = faces()
+      
+      index = if found.any? then
+        
+        # find the top y
+        box = found.max_by {|x, y, width, height| y}
+        box[1]
+        
+      else
+        
+        y_maxcontrast(img)
+        
+      end
+            
+      percentage = (100 / (img.rows / index.to_f)).round
+      
+    end    
+    
+    return percentage
+    
+  end
+  
   def blur(x: 0, y: 0, w: 80, h: 80, strength: 8, quality: nil)
     
     width, height = w, h
@@ -295,6 +344,10 @@ class EasyImgUtils
     
   end
   
+  def faces()
+    DetectFaces.new(@file_in).faces
+  end
+  
   def fax_effect(threshold: 0.55, quality: nil)
 
     read() do |img|
@@ -343,8 +396,10 @@ class EasyImgUtils
 
   # defines the maximum size of an image while maintaining aspect ratio
   #
-  def resize(geometry='320x240', quality: nil)
+  def resize(raw_geometry='320x240', quality: nil)
     
+    geometry = calc_resize(raw_geometry
+                             )
     read() do |preview|
     
       preview.change_geometry!(geometry) do |cols, rows, img|
@@ -464,7 +519,7 @@ class EasyImgUtils
     
   end
   
-  alias feathered_around vignette
+  alias feathered_around vignette 
 
   private
   
@@ -534,5 +589,31 @@ class EasyImgUtils
       
     end
   end
+  
+  # returns the y index of the pixel containing the most contrast using the 
+  # y-axis center of the image
+  #
+  def y_maxcontrast(img)
 
+    rows, cols = img.rows, img.columns
+    center = (cols / 2).round
+    pixels = img.get_pixels(center,0,1,rows)
+    
+    rgb = []
+    px = pixels[0]
+    rgb = [px.red, px.green, px.blue].map { |v| 255*(v/65535.0) }
+
+    a = pixels[1..-1].map do |pixel,i|
+
+      c = [pixel.red, pixel.green, pixel.blue].map { |v| 255*(v/65535.0) }
+      rgb[0] - c[0]
+      rgb.map.with_index {|x,i| (x - c[i]).abs.to_i}
+
+    end
+
+    a2 = a.map(&:sum)
+    a2.index(a2.max) + 1
+    
+  end  
+  
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easyimg_utils
 version: !ruby/object:Gem::Version
-  version: 0.6.4
+  version: 0.7.2
 platform: ruby
 authors:
 - James Robertson
@@ -35,7 +35,7 @@ cert_chain:
   KY48n99T12IOioQ4ghCO1L/UAg2taLOcZbMv4WpV1p9bXKhnrow81zeogZjjiNGS
   OmTAjCfyGFPC/1eXnSV5Smv8
   -----END CERTIFICATE-----
-date: 2021-03-20 00:00:00.000000000 Z
+date: 2021-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rmagick
@@ -117,6 +117,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: detectfaces
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 description: 
 email: digital.robertson@gmail.com
 executables: []