123456789_123456789_123456789_123456789_123456789_

Class: ActiveStorage::Analyzer::ImageAnalyzer::Vips

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
Instance Chain:
Inherits: ActiveStorage::Analyzer::ImageAnalyzer
Defined in: activestorage/lib/active_storage/analyzer/image_analyzer/vips.rb

Overview

This analyzer relies on the third-party ruby-vips gem. Ruby-vips requires the / libvips system library.

Constant Summary

Class Attribute Summary

::ActiveStorage::Analyzer - Inherited

.analyze_later?

Implement this method in concrete subclasses.

Class Method Summary

::ActiveStorage::Analyzer::ImageAnalyzer - Inherited

::ActiveStorage::Analyzer - Inherited

.accept?

Implement this method in a concrete subclass.

.new

Instance Attribute Summary

Instance Method Summary

::ActiveStorage::Analyzer::ImageAnalyzer - Inherited

::ActiveStorage::Analyzer - Inherited

#metadata

Override this method in a concrete subclass.

#download_blob_to_tempfile

Downloads the blob to a tempfile on disk.

#instrument, #logger, #tmpdir

Constructor Details

This class inherits a constructor from ActiveStorage::Analyzer

Class Method Details

.accept?(blob) ⇒ Boolean

[ GitHub ]

  
# File 'activestorage/lib/active_storage/analyzer/image_analyzer/vips.rb', line 7

def self.accept?(blob)
  super && ActiveStorage.variant_processor == :vips
end

Instance Method Details

#read_image (private)

[ GitHub ]

  
# File 'activestorage/lib/active_storage/analyzer/image_analyzer/vips.rb', line 12

def read_image
  begin
    require "ruby-vips"
  rescue LoadError
    logger.info "Skipping image analysis because the ruby-vips gem isn't installed"
    return {}
  end

  download_blob_to_tempfile do |file|
    image = instrument("vips") do
      # ruby-vips will raise Vips::Error if it can't find an appropriate loader for the file
      ::Vips::Image.new_from_file(file.path, access: :sequential)
    rescue ::Vips::Error
      logger.info "Skipping image analysis because Vips doesn't support the file"
      nil
    end

    if image
      yield image
    else
      {}
    end
  rescue ::Vips::Error => error
    logger.error "Skipping image analysis due to an Vips error: #{error.message}"
    {}
  end
end

#rotated_image?(image) ⇒ Boolean (private)

[ GitHub ]

  
# File 'activestorage/lib/active_storage/analyzer/image_analyzer/vips.rb', line 41

def rotated_image?(image)
  ROTATIONS === image.get("exif-ifd0-Orientation")
rescue ::Vips::Error
  false
end