image_processing 0.2.5 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f50a933d3b59293412c8f598a646d4db0a756f6c
-  data.tar.gz: 778e9010cc777117535ad0b229f84e27a2d05ce6
+  metadata.gz: af4532e0d6a06a00ac95a2c5f7190e4df6a4e891
+  data.tar.gz: 3a639bcbaa104a55a5d2387d4c4cfdeaaf5149ae
 SHA512:
-  metadata.gz: 2b5d7eabf7b3e3a9733dc16e55c8e11a7cf49657b08b4313d09ce2e9481f8bc1ee5b424b067e9f2976219876569b7d3bfb121def6a5d6ffb2c0a78201e4dc140
-  data.tar.gz: e51e778aff0a128b0bff398a4e79ec6cfc438091f7a3dee5c5afd927f41f1d55b721642ed113ebb9068b9deef6e756f0ec1ca944f55a9d2472d32726dc384e22
+  metadata.gz: 279b62385e8c5b7edb4baa3c749063dd8e40a03ceaee7216f6a9db3377287337c63b301935f95a3ca715b30f52fadff642484e42100a60acd7c5c1bff79a075e
+  data.tar.gz: 876bc51156893cd604d17ab8b1d2954f92136fea590b93e809575f44ba98ef6c1509bb6657ba2f6797ce32816aa7da0201710a5c620b56e64af1a61134bfbae4

data/README.md

@@ -3,10 +3,12 @@
 Provides higher-level helper methods for image processing in Ruby using
 ImageMagick.
 
-This methods were extracted from Refile, and were made generic so that they can
-be used in any project. The goal is to have a centralized place where image
-processing helper methods are maintained, instead of CarrierWave, Dragonfly and
-Refile each having their own.
+These methods were extracted from [refile-mini_magick], and were made generic so
+that they can be used in any project. The goal of image_processing is to have a
+centralized place where helper methods for image processing are maintained,
+instead of CarrierWave, Dragonfly and Refile each implementing their own.
+
+It's been tested with MRI 2.x, JRuby and Rubinius.
 
 ## Installation
 
@@ -48,7 +50,7 @@ The following is the list of helper methods that ImageProcessing provides (each
 one has both a destructive and a nondestructive version):
 
 ```rb
-# Adjust an image so that its orientation is suitable for viewing
+# Adjust an image so that its orientation is suitable for viewing.
 auto_orient(file)
 auto_orient!(file)
 
@@ -56,6 +58,10 @@ auto_orient!(file)
 convert(file, format)
 convert!(file, format)
 
+# Crop image to the defined area.
+crop(file, width, height, x_offset, y_offset, gravity: "NorthWest")
+crop!(file, width, height, x_offset, y_offset, gravity: "NorthWest")
+
 # Resizes image to fit the specified dimensions (shrinks if larger, enlarges if
 # smaller, but keeps the aspect ratio).
 resize_to_fit(file, width, height)
@@ -122,3 +128,5 @@ $ rake test
 ## License
 
 [MIT](LICENSE.txt)
+
+[refile-mini_magick]: https://github.com/refile/refile-mini_magick

data/image_processing.gemspec

@@ -3,12 +3,14 @@ require File.expand_path('../lib/image_processing/version', __FILE__)
 Gem::Specification.new do |spec|
   spec.name          = "image_processing"
   spec.version       = ImageProcessing::VERSION
-  spec.authors       = ["Janko Marohnić"]
-  spec.email         = ["janko.marohnic@gmail.com"]
+
+  spec.required_ruby_version = ">= 2.0"
 
   spec.summary       = "Set of higher-level helper methods for image processing."
   spec.description   = "Set of higher-level helper methods for image processing."
   spec.homepage      = "https://github.com/janko-m/image_processing"
+  spec.authors       = ["Janko Marohnić"]
+  spec.email         = ["janko.marohnic@gmail.com"]
   spec.license       = "MIT"
 
   spec.files         = Dir["README.md", "LICENSE.txt", "lib/**/*", "image_processing.gemspec"]

data/lib/image_processing/mini_magick.rb

@@ -176,6 +176,27 @@ module ImageProcessing
     end
     nondestructive_alias :resample, :resample!
 
+    # Crops the image to be the defined area.
+    #
+    # @param [#to_s] width                the width of the cropped image
+    # @param [#to_s] height               the height of the cropped image
+    # @param [#to_s] x_offset             the x coordinate where to start cropping
+    # @param [#to_s] y_offset             the y coordinate where to start cropping
+    # @param [string] gravity             which part of the image to focus on
+    # @yield [MiniMagick::Tool::Mogrify, MiniMagick::Tool::Convert]
+    # @return [File, Tempfile]
+    # @see http://www.imagemagick.org/script/command-line-options.php#crop
+    def crop!(image, width, height, x_offset = 0, y_offset = 0, gravity: "NorthWest")
+      with_minimagick(image) do |img|
+        img.combine_options do |cmd|
+          yield cmd if block_given?
+          cmd.gravity gravity
+          cmd.crop "#{width}x#{height}+#{x_offset}+#{y_offset}"
+        end
+      end
+    end
+    nondestructive_alias :crop, :crop!
+
     # Convert an image into a MiniMagick::Image for the duration of the block,
     # and at the end return a File object.
     def with_minimagick(image)

data/lib/image_processing/version.rb

@@ -1,3 +1,3 @@
 module ImageProcessing
-  VERSION = "0.2.5"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: image_processing
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.3.0
 platform: ruby
 authors:
 - Janko Marohnić
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-24 00:00:00.000000000 Z
+date: 2016-05-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -104,7 +104,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="