image_processing 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ffdeedc6dde0dbff761a5185ebbc0316ab9d70bd
-  data.tar.gz: 42409b4d185f80c1462ee7aebe46e89daf2141ae
+  metadata.gz: 68f6d4b9e19542234865363bc7191ce501845e17
+  data.tar.gz: f71a5a4156182b2998e699d5d98f71ec03abca59
 SHA512:
-  metadata.gz: 5da67c6c7794556ae3976acb86aaffe91f4fda1ae0363c2a179ce68d1a89b58bcc9c3b952d65d3dd9ca62c800a710b3e993b1e65da4ada0283541b250971f232
-  data.tar.gz: 1c870e3254d44fea11e201a602df454bcb0201f9f0c668d18b551a838f9b720ee19da90ba043bd2a55f641bcb1664e0b197c2556ed0dba90080695a22503e9ca
+  metadata.gz: a410c6436c2f8a89d7b32298bd9dbb4e98a344a291a0d7282f35485bbe1139c31a5f834807b4ff872bf273e179ca9420c4a243f0da70fa8eeaa504573e3ef398
+  data.tar.gz: 4c2cb93dd82c915b1dcd7507e928f37d86db467ab908324006e7d7876b6e20a10b85afac0a732b0eba77767f9fd443fbf4497bd6dbacfcf746f41be091b52370

data/README.md

@@ -12,6 +12,7 @@ Refile each having their own.
 
 ```ruby
 gem 'image_processing'
+gem 'mini_magick', '>= 4.3.5'
 ```
 
 ## Usage
@@ -43,32 +44,64 @@ image = File.open("path/to/image.jpg")
 ImageProcessing::MiniMagick.resize_to_fit(image, 400, 400)
 ```
 
-The following is the list of helper methods that ImageProcessing provides:
+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
+auto_orient(file)
+auto_orient!(file)
+
 # Converts file to the specified format.
-convert(file, format)  # nondestructive
-convert!(file, format) # destructive
+convert(file, format)
+convert!(file, format)
 
 # Resizes image to fit the specified dimensions (shrinks if larger, enlarges if
 # smaller, but keeps the aspect ratio).
-resize_to_fit(file, width, height)  # nondestructive
-resize_to_fit!(file, width, height) # destructive
+resize_to_fit(file, width, height)
+resize_to_fit!(file, width, height)
 
 # Resizes image in limit of the specified dimensions (shrinks if larger, keeps
 # if smaller, but keeps the aspect ratio).
-resize_to_limit(file, width, height)  # nondestructive
-resize_to_limit!(file, width, height) # destructive
+resize_to_limit(file, width, height)
+resize_to_limit!(file, width, height)
 
 # Resizes image to fill the specified dimensions (shrinks if larger,
 # enlarges if smaller, crops the longer side).
-resize_to_fill(file, width, height, gravity: "Center")  # nondestructive
-resize_to_fill!(file, width, height, gravity: "Center") # destructive
+resize_to_fill(file, width, height, gravity: "Center")
+resize_to_fill!(file, width, height, gravity: "Center")
 
 # Resizes image to the specified dimensions and pads missing space (shrinks if
 # larger, enlarges if smaller, fills the shorter side with specified color).
-resize_and_pad(file, width, height, background: "transparent", gravity: "Center")  # nondestructive
-resize_and_pad!(file, width, height, background: "transparent", gravity: "Center") # destructive
+resize_and_pad(file, width, height, background: "transparent", gravity: "Center")
+resize_and_pad!(file, width, height, background: "transparent", gravity: "Center")
+
+# Resamples the image to a different resolution
+resample(file, horizontal, vertical)
+resample!(file, horizontal, vertical)
+```
+
+If you want to do custom MiniMagick processing, each of the above optionally
+yields an instance of `MiniMagick::Tool`, so you can use it for additional
+processing:
+
+```rb
+convert(file, "png") do |cmd|
+  cmd.background("none")
+end
+```
+
+There is also a helper method for doing MiniMagick processing directly:
+
+```rb
+processed = with_minimagick(file) do |image|
+  image #=> #<MiniMagick::Image ...>
+  image.combine_options do |cmd|
+    # ...
+  end
+end
+
+processed #=> #<File ...>
 ```
 
 ## Contributing

data/lib/image_processing/mini_magick.rb

@@ -12,6 +12,7 @@ module ImageProcessing
       define_method(name) do |image, *args, &block|
         send(original, _copy_to_tempfile(image), *args, &block)
       end
+      module_function name
     end
 
     module_function
@@ -180,7 +181,9 @@ module ImageProcessing
     def with_minimagick(image)
       image = ::MiniMagick::Image.new(image.path, image)
       yield image
-      image.instance_variable_get("@tempfile")
+      tempfile = image.instance_variable_get("@tempfile")
+      tempfile.open if tempfile.is_a?(Tempfile) # for aws-sdk
+      tempfile
     end
 
     # Creates a copy of the file and stores it into a Tempfile. Works for any

data/lib/image_processing/version.rb

@@ -1,3 +1,3 @@
 module ImageProcessing
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: image_processing
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Janko Marohnić
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-04 00:00:00.000000000 Z
+date: 2015-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest