easyimg_utils 0.6.6 → 0.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d9ac6449342efa070a858c26d96378947ca77231bcdc97339321b5dac0a316b
-  data.tar.gz: 22617abf8420c0cf4276e2198e02cae542aa29555d8579fcd66c60127e70afbe
+  metadata.gz: 491f7066a8af2e40049a6986c894498d507d99b2b02caf4321f59abb25a05dd1
+  data.tar.gz: e6d42410ed62a4a0829c648b5622b28845930fa18853202e6ac507d0e7e34186
 SHA512:
-  metadata.gz: 947e70b56bfeb36bf1c4d0e51bf5ba02bca9124083d46c27a55dd2669fcc3b06dbbfc48c9e2b0acfc6f42db89d6c71df1a125e30b6ff0d1f8431a5c535234828
-  data.tar.gz: a19e9e5da426cf4ab50f7040419158c30fede078f8545c6f6fa7e4fb4a3d3b2dfdcd3e41ebdce4ee3e43e6dfba2f8d75a76262e516190f7e8ee2ee0f45c4e41d
+  metadata.gz: 57a595c6b1b171e44600bcdd043a36f90ce89453fc5d57e40fd8016a5f6518be8753c247bd613b2e5318ee6db05ababb9735a0c47b928775b96a4ef5bd99dac0
+  data.tar.gz: aa6f56c7307732c2f4f93f2298d32d0e2de8d164a2cee099f5ebdc18e433bccb162e43c5b3bd2e4ad9d2c87d0398c131531d10dcceb8099bbce4873d19d5fd19

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 
@@ -89,20 +94,35 @@ class EasyImgUtils
   
   # 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
+  # the asterisk denotes a guarantee the image will be resized to a 
+  # minimum size on either dimension
   #
-  def self.calc_resize(geometry, new_geometry, force: false)
+  # e.g. calc_resize '1920x1088', '*518x*500' #=> "882x500" 
+  # 2 asterisks denotes a guaranteed minumum size on both dimensions
+  #
+  def self.calc_resize(geometry, new_geometry)
     
     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 =~ /^\*/}
+    locks = xy2.select {|x| x =~ /^\*/}        
 
     a = xy.map {|x| x[/\d+/].to_i}
     a2 = xy2.map {|x| x[/\d+/].to_i}
+    
+    i = if locks.length > 1 then
 
-    i = lock ? a2.index(lock[1..-1].to_i) : a.index(a.max)
+      a.index(a.min)
+      
+    elsif locks.any? 
+      
+      lock = locks.first
+      a2.index(lock[1..-1].to_i)
+      
+    else      
+      a.index(a.max)
+    end
 
     factor = a2[i] / a[i].to_f
 
@@ -171,6 +191,42 @@ 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}
+        y, height = box.values_at 1, 3
+        y - (height / 2)
+        
+      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
@@ -304,6 +360,10 @@ class EasyImgUtils
     
   end
   
+  def faces()
+    DetectFaces.new(@file_in).faces
+  end
+  
   def fax_effect(threshold: 0.55, quality: nil)
 
     read() do |img|
@@ -475,7 +535,7 @@ class EasyImgUtils
     
   end
   
-  alias feathered_around vignette
+  alias feathered_around vignette 
 
   private
   
@@ -545,5 +605,37 @@ 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)
+    puts 'a2: ' + a2.inspect if @debug
+    #a2.index(a2.max) + 1
+    # attempt to detect the 1st occurrence of contrast
+    r = a2.detect {|x| x > 600}
+    # otherwise select any occurrence of high contrast
+    r = a2.max unless r
+    a2.index(r) + 1
+    
+  end  
+  
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easyimg_utils
 version: !ruby/object:Gem::Version
-  version: 0.6.6
+  version: 0.7.4
 platform: ruby
 authors:
 - James Robertson
@@ -35,7 +35,7 @@ cert_chain:
   KY48n99T12IOioQ4ghCO1L/UAg2taLOcZbMv4WpV1p9bXKhnrow81zeogZjjiNGS
   OmTAjCfyGFPC/1eXnSV5Smv8
   -----END CERTIFICATE-----
-date: 2021-03-22 00:00:00.000000000 Z
+date: 2021-03-30 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: []