easyimg_utils 0.6.5 → 0.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 931f6444de27b1df65cfe7e9f4b3c296e2f826f42cdb58f5bb6dc2c5f597e284
-  data.tar.gz: 119ef63fee91fd0ac7fc8402b6be7ff362a65b567279819c739449730af5d0d8
+  metadata.gz: 2b1dfaea58127ef88f5b78e46e00146d925b9cc9e05c7c8836d9d934a9cb87b5
+  data.tar.gz: d54061b87a0864110935762bfcd8558552fdaf0e925b3446aa1c22667a8ef41f
 SHA512:
-  metadata.gz: 18e8ec2efe4c0c7f0c0ada668f78bc5952c90b44ae7b85d9c10f121375f5752f8ddfe74709e5fdc8ff516dddd43325c084241048cd7c36d904fdae0b613fec79
-  data.tar.gz: f4e5176eb71d1aaf6e3898ec68fd823568ea4d73bcf51cf3ce176ff57f0c71ecf9678e719f1cb422ebcd0eb47663c4a005060c82c2eee4d50ec9f976ef48abed
+  metadata.gz: c66d8a62d782f4a1535df8351984c05701c6bfb0868cc42c266983054de86b70dc1238888108aa0492bd689d27b3485058fee7c1fe57175c495bc4bcad884c92
+  data.tar.gz: c1ddf021ed6e85154dc13d3b1dbcc59c47d8bac8066acbd8502d5f4704aa7296b3d713e0b9171c796e6bbe4e4530684d1e3c8d1bfe83c73aac055535cb6e6304

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 
@@ -171,6 +176,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 +345,10 @@ class EasyImgUtils
     
   end
   
+  def faces()
+    DetectFaces.new(@file_in).faces
+  end
+  
   def fax_effect(threshold: 0.55, quality: nil)
 
     read() do |img|
@@ -352,8 +397,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|
@@ -473,7 +520,7 @@ class EasyImgUtils
     
   end
   
-  alias feathered_around vignette
+  alias feathered_around vignette 
 
   private
   
@@ -543,5 +590,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.5
+  version: 0.7.3
 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-24 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: []