A Transformer
applies a set of transformations to an image.
The following concrete subclasses are included in Active Storage:
ActiveStorage::Transformers::ImageProcessingTransformer: backed by ImageProcessing, a common interface for MiniMagick and ruby-vips
# File activestorage/lib/active_storage/transformers/transformer.rb, line 14 def initialize(transformations) @transformations = transformations end
# File activestorage/lib/active_storage/transformers/transformer.rb, line 21 def transform(file, format:) output = process(file, format: format) begin yield output ensure output.close! end end
Applies the transformations to the source image in file
, producing a target image in the specified format
. Yields an open Tempfile containing the target image. Closes and unlinks the output tempfile after yielding to the given block. Returns the result of the block.
# File activestorage/lib/active_storage/transformers/transformer.rb, line 34 def process(file, format:) # :doc: raise NotImplementedError end
Returns an open Tempfile containing a transformed image in the given format
. All subclasses implement this method.
© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.