Class: ImageProcessing::MiniMagick::Processor

Inherits:
Processor
  • Object
show all
Defined in:
lib/image_processing/mini_magick.rb

Defined Under Namespace

Modules: Utils

Constant Summary collapse

SHARPEN_PARAMETERS =

Default sharpening parameters used on generated thumbnails.

{ radius: 0, sigma: 1 }

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.load_image(path_or_magick, loader: nil, page: nil, geometry: nil, auto_orient: true, inherit_fds: nil, **options) ⇒ Object

Initializes the image on disk into a MiniMagick::Tool object. Accepts additional options related to loading the image (e.g. geometry). Additionally auto-orients the image to be upright. inherit_fds names IO objects the tool inherits, so the source may be a /dev/fd/N path. The source stays a path, so loader, page and geometry still apply to it, which they would not if the caller passed a pre-built MiniMagick::Tool carrying the descriptor.



53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
 
# File 'lib/image_processing/mini_magick.rb', line 53

def self.load_image(path_or_magick, loader: nil, page: nil, geometry: nil, auto_orient: true, inherit_fds: nil, **options)
  if path_or_magick.is_a?(::MiniMagick::Tool)
    magick = path_or_magick
  else
    source_path = path_or_magick
    magick = ::ImageProcessing::MiniMagick.convert_shim(inherit_fds: inherit_fds)

    Utils.apply_options(magick, **options)

    input  = source_path
    input  = "#{loader}:#{input}" if loader
    input += "[#{page}]" if page
    input += "[#{geometry}]" if geometry

    magick << input
  end

  magick.auto_orient if auto_orient
  magick
end

.save_image(magick, destination_path, allow_splitting: false, **options) ⇒ Object

Calls the built ImageMagick command to perform processing and save the result to disk. Accepts additional options related to saving the image (e.g. quality).



77
78
79
80
81
82
83
84
 
# File 'lib/image_processing/mini_magick.rb', line 77

def self.save_image(magick, destination_path, allow_splitting: false, **options)
  Utils.apply_options(magick, **options)

  magick << destination_path
  magick.call

  Utils.disallow_split_layers!(destination_path) unless allow_splitting
end

Instance Method Details

#append(*args) ⇒ Object

Appends a raw ImageMagick command-line argument to the command.



175
176
177
178
179
180
181
 
# File 'lib/image_processing/mini_magick.rb', line 175

def append(*args)
  if args.empty?
    magick.append
  else
    magick.merge! args
  end
end

#composite(overlay = :none, mask: nil, mode: nil, gravity: nil, offset: nil, args: nil) {|magick| ... } ⇒ Object

Overlays the specified image over the current one. Supports specifying an additional mask, composite mode, direction or offset of the overlay image.

Yields:

  • (magick) 


140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
 
# File 'lib/image_processing/mini_magick.rb', line 140

def composite(overlay = :none, mask: nil, mode: nil, gravity: nil, offset: nil, args: nil, &block)
  return magick.composite if overlay == :none

  geometry = "%+d%+d" % offset if offset

  overlay_path = convert_to_path(overlay, "overlay")
  mask_path    = convert_to_path(mask, "mask") if mask

  magick << overlay_path
  magick << mask_path if mask_path

  magick.compose(mode) if mode
  define(compose: { args: args }) if args

  magick.gravity(gravity) if gravity
  magick.geometry(geometry) if geometry

  yield magick if block_given?

  magick.composite
end

#crop(*args) ⇒ Object

Crops the image with the specified crop points.



121
122
123
124
125
126
127
 
# File 'lib/image_processing/mini_magick.rb', line 121

def crop(*args)
  case args.count
  when 1 then magick.crop(*args)
  when 4 then magick.crop("#{args[2]}x#{args[3]}+#{args[0]}+#{args[1]}")
  else fail ArgumentError, "wrong number of arguments (expected 1 or 4, got #{args.count})"
  end
end

#define(options) ⇒ Object

Defines settings from the provided hash.



163
164
165
166
 
# File 'lib/image_processing/mini_magick.rb', line 163

def define(options)
  return magick.define(options) if options.is_a?(String)
  Utils.apply_define(magick, options)
end

#limits(options) ⇒ Object

Specifies resource limits from the provided hash.



169
170
171
172
 
# File 'lib/image_processing/mini_magick.rb', line 169

def limits(options)
  options.each { |type, value| magick.args.unshift("-limit", type.to_s, value.to_s) }
  magick
end

#resize_and_pad(width, height, background: :transparent, gravity: "Center", **options) ⇒ Object

Resizes the image to fit within the specified dimensions and fills the remaining area with the specified background color.



107
108
109
110
111
112
 
# File 'lib/image_processing/mini_magick.rb', line 107

def resize_and_pad(width, height, background: :transparent, gravity: "Center", **options)
  thumbnail("#{width}x#{height}", **options)
  magick.background color(background)
  magick.gravity gravity
  magick.extent "#{width}x#{height}"
end

#resize_to_cover(width, height, **options) ⇒ Object

Resizes the image to cover the specified dimensions, without cropping the excess.



116
117
118
 
# File 'lib/image_processing/mini_magick.rb', line 116

def resize_to_cover(width, height, **options)
  thumbnail("#{width}x#{height}^", **options)
end

#resize_to_fill(width, height, gravity: "Center", **options) ⇒ Object

Resizes the image to fill the specified dimensions, applying any necessary cropping.



98
99
100
101
102
103
 
# File 'lib/image_processing/mini_magick.rb', line 98

def resize_to_fill(width, height, gravity: "Center", **options)
  thumbnail("#{width}x#{height}^", **options)
  magick.gravity gravity
  magick.background color(:transparent)
  magick.extent "#{width}x#{height}"
end

#resize_to_fit(width, height, **options) ⇒ Object

Resizes the image to fit within the specified dimensions.



92
93
94
 
# File 'lib/image_processing/mini_magick.rb', line 92

def resize_to_fit(width, height, **options)
  thumbnail("#{width}x#{height}", **options)
end

#resize_to_limit(width, height, **options) ⇒ Object

Resizes the image to not be larger than the specified dimensions.



87
88
89
 
# File 'lib/image_processing/mini_magick.rb', line 87

def resize_to_limit(width, height, **options)
  thumbnail("#{width}x#{height}>", **options)
end

#rotate(degrees, background: nil) ⇒ Object

Rotates the image by an arbitrary angle. For angles that are not multiple of 90 degrees an optional background color can be specified to fill in the gaps.



132
133
134
135
 
# File 'lib/image_processing/mini_magick.rb', line 132

def rotate(degrees, background: nil)
  magick.background color(background) if background
  magick.rotate(degrees)
end