класс ActiveStorage::Variation

Родитель:: Объект

Набор преобразований, которые могут быть применены к блобу для создания варианта. Этот класс экспонируется через метод ActiveStorage::Blob::Representable#variant и редко используется напрямую.

В случае необходимости непосредственного использования, он создаётся с помощью хэша преобразований, где ключ — команда, а значение — аргументы. Пример:

ActiveStorage::Variation.new(resize: "100x100", monochrome: true, trim: true, rotate: "-90")

Вы также можете объединить несколько преобразований в одном шаге, например, для центрально-взвешенного обрезания:

ActiveStorage::Variation.new(combine_options: {
  resize: "100x100^",
  gravity: "center",
  crop: "100x100+0+0",
})

Список всех возможных преобразований доступен по адресу www.imagemagick.org/script/mogrify.php.

Атрибуты

transformations[R]

Публичные методы класса

decode(key) Показать исходный код

# File activestorage/app/models/active_storage/variation.rb, line 39
def decode(key)
  new ActiveStorage.verifier.verify(key, purpose: :variation)
end

Возвращает экземпляр Variation с преобразованиями, которые были закодированы encode.

encode(transformations) Показать исходный код

# File activestorage/app/models/active_storage/variation.rb, line 45
def encode(transformations)
  ActiveStorage.verifier.generate(transformations, purpose: :variation)
end

Возвращает подписанный ключ для transformations, который можно использовать для ссылки на определённый вариант в URL или комбинированном ключе (например, ActiveStorage::Variant#key).

new(transformations) Показать исходный код

# File activestorage/app/models/active_storage/variation.rb, line 50
def initialize(transformations)
  @transformations = transformations
end

wrap(variator) Показать исходный код

# File activestorage/app/models/active_storage/variation.rb, line 27
def wrap(variator)
  case variator
  when self
    variator
  when String
    decode variator
  else
    new variator
  end
end

Возвращает экземпляр Variation на основе заданного вариатора. Если вариатор — Variation, он возвращается без изменений. Если это строка (String), она передаётся в ::decode. В противном случае предполагается, что это хэш преобразований (Hash) и передаётся непосредственно в конструктор.

Публичные методы экземпляра

key() Показать исходный код

# File activestorage/app/models/active_storage/variation.rb, line 73
def key
  self.class.encode(transformations)
end

Возвращает подписанный ключ для всех transformations, с которыми был создан этот вариант.

transform(image) Показать исходный код

# File activestorage/app/models/active_storage/variation.rb, line 56
def transform(image)
  ActiveSupport::Notifications.instrument("transform.active_storage") do
    transformations.each do |name, argument_or_subtransformations|
      image.mogrify do |command|
        if name.to_s == "combine_options"
          argument_or_subtransformations.each do |subtransformation_name, subtransformation_argument|
            pass_transform_argument(command, subtransformation_name, subtransformation_argument)
          end
        else
          pass_transform_argument(command, name, argument_or_subtransformations)
        end
      end
    end
  end
end

Принимает открытый экземпляр изображения MiniMagick, подобный возвращаемому MiniMagick::Image.read(io), и выполняет transformations над ним. Затем возвращается преобразованный экземпляр изображения.