123456789_123456789_123456789_123456789_123456789_

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

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, ::ActiveStorage::Analyzer::ImageAnalyzer, ::ActiveStorage::Analyzer
Instance Chain:
self, ::ActiveStorage::Analyzer::ImageAnalyzer, ::ActiveStorage::Analyzer
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

.accept?

::ActiveStorage::Analyzer - Inherited

.accept?

Implement this method in a concrete subclass.
.new

Instance Attribute Summary

::ActiveStorage::Analyzer - Inherited

#blob

Instance Method Summary

::ActiveStorage::Analyzer::ImageAnalyzer - Inherited

#metadata

::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