Active StorageのVariantの指定方法いろいろ

静岡市でWeb開発しているフリーランスのkazuomatzです。

Rails 5.2で利用可能になったファイルアップロードに利用できるActive Storageを使ってみました。

これまでは画像のアップロードにはPaperclipを使っていました。Paperclipにはアップロードした時に、自動的に画像サイズを変更して、何パターンかの画像を保存する機能がありました。正方形にクリップしたサムネイル画像もアップロード時に作成できるので、無駄に大きな画像をサムネイル表示するようなページを回避できるので重宝していました。

# Paperclipでの実装

```ruby:app/models/user.rb
class User < ApplicationRecord
    has_attached_file :avatar,
    styles: { m: '1024x1024>', s: '800x800>',thumb: '640x640#' }
end
```

```erb:app/views/users/show.html.erb
<div>
    <span>長辺を1024pxにしてリサイズされた画像を表示</span>
    <%= image_tag @user.avatar(:m)%>
</div>

<div>
    <span>長辺を800pxにしてリサイズされた画像を表示</span>
　　 <%= image_tag @user.avatar(:s)%>
</div>

<div>
    <span>サムネイル画像(W:640 x H:640にクロップされた画像)を表示</span>
    <span><%= image_tag @user.avatar(:thumb)%></span>
</div>

```
このように、あらかじめ必要とされる画像サイズを決めておけば、用途用途で使い分けることができるのでとても便利です。

しかし、Webサイトを長いこと運用していると、のちのち、横幅1920pxの画像を表示したい、というようなケースが出てきて困ったことになりました。

Modelに新しいサイズを再定義したとしても、これまで登録された画像はそのサイズで保存されていないので、再生成するようなプログラムを書いてまわすみないなことをやればいいですが、それも面倒です。

そのような時にActive Storageの Variantを使うととっても便利です。Variantを使うと新しい画像サイズが欲しくなった時に、オンデマンドで画像が生成されます。

# Active Storageの準備
先ほどのPaperclipの実装をActive Storageを使って書き換えてみます。Variantを利用する場合には、ImageMagickがシステムにインストールされていることと、[MiniMagick](https://github.com/minimagick/minimagick) gemのロードが必要です。

```ruby:Gemfile
# Use ActiveStorage variant
gem 'mini_magick', '~> 4.8'
```

```bash:実行
# Active Storageのインストール
$ rake active_storage:install

# DBマイグレーション
$ rake db:migrate
```
これで、development環境ではローカルディスクをアップロード先としてActive Storageが利用可能になります。
アップロード先をAWS S3やAzure Storage Service、Google Cloud Storage Serviceなどにし指定することもできますが、詳しくは、[本家のリファレンス](https://railsguides.jp/active_storage_overview.html)を参照してください。

では、先ほどのPaperclipの実装をActive Storageを使った実装に変更してみます。

# Active Storageでの実装

```ruby:app/models/user.rb

class User < ApplicationRecord
    has_one_attached :avatar
end
```

まず、Model側の定義はこれだけです。
has_one_attachedはモデルに１つのファイルを紐付けます。has_many_attachedを用いるとモデルに複数のファイルを紐付けることが可能になります。

便利なのはここからです。Viewを見てみましょう。

```erb:app/views/users/show.html.erb
<div>
    <span>長辺を1024pxにしてリサイズされた画像を表示</span>
    <%= image_tag @user.avatar.variant(resize:'1024x1024').processed %>
</div>

<div>
    <span>長辺を800pxにしてリサイズされた画像を表示</span>
    <%= image_tag @user.avatar.variant(resize:'800x800').processed %>
</div>
<div>
    <span>サムネイル画像(W:640 x H:640にクロップされた画像)を表示</span>
    <span><%= image_tag @user.avatar.variant(combine_options:{gravity: :center, resize:"640x640^",crop:"640x640+0+0"}).processed%></span>
</div>

```

Paperclipがあらかじめサイズを決めておいて、その中からどのサイズを使うのかを指定するという方式なのに対して、Variantでは、View側で使用したいサイズをその都度指定できるのが大きな違いです。

Active StorageではVariantが呼び出されると、保存された元画像データを指定されたサイズに変換しそのURLを返します。

processedをつけることで、すでにそのサイズで保存されて画像があれば、変換処理は行われず、即時にURLが返されますので、最初の呼び出しだけ多少時間がかかりますが、それ以降の呼び出しでは時間がかかることはありません。

<img src="https://qiita-image-store.s3.amazonaws.com/0/39570/be359eec-b593-2c46-cc92-bc036586a13e.jpeg" width="300">

Paperclipの場合、thumb:'640x640#' と指定すると画像の中心をクリップした640pxの正方形の画像を生成してくれましたが、Variantを使う場合は、以下のように書きます。

```ruby:正方形にくりぬく
@user.avatar.variant(combine_options:{gravity: :center, resize:"640x640^", crop:"640x640+0+0"}).processed
```
<img src="https://qiita-image-store.s3.amazonaws.com/0/39570/46a067d5-c918-594e-53b9-e491cc0bd15d.jpeg" width="200">

Variantの指定は、ImageMagickのコマンドが利用可能です。
まず、gravity:'center'を指定し、resize:'640x640^'を指定し、画像の縦横の短辺の長さを640pxになるようリサイズします。そして、crop:'640x640+0+0'で、画像の中心点からW:640xH:640のサイズで画像を切り抜きます。
リサイズ＋切り抜きといった操作をまとめて行う場合は、combine_optionsを指定する必要があります（参考：[What Options Can Be Passed to the Active Storage variant Method?](http://www.carlosramireziii.com/what-options-can-be-passed-to-the-active-storage-variant-method.html)）。

~~以下の例だと、正しい位置からクロップできませんでした(gravityが効いていない）。~~
Rails 6になってから、combine_optionsを使用しなくても、下記のコードで動作するようになっているようです。

```ruby:正方形にくりぬく
@user.avatar.variant(gravity: :center, resize:"640x640^", crop:"640x640+0+0").processed
```

また、Rails 6.1からはcombine_optionsは利用できなくなるとのことです。

[参考記事1](https://qiita.com/tatsuhiko-nakayama/items/14324668e4b85e9271ee#_reference-c95863f7a08c8bc5b5bf)
[参考記事2](https://qiita.com/jnchito/items/7142fd9562751494bd7e)

<img src="https://qiita-image-store.s3.amazonaws.com/0/39570/f04027ba-6c60-ae51-5413-2f070ac4a4b8.jpeg" width="200">

もし、後から横幅1920pxサイズの画像が欲しくなった場合も簡単に対応できます。

```erb:app/views/users/show.html.erb
<div>
    <span>長辺を1920pxにしてリサイズされた画像を表示</span>
    <%= image_tag @user.avatar.variant(resize:'1920x1920').processed %>
</div>
```


Webサイトの運営上、ページのリデザインを行う場合などに、簡単に適正サイズの画像が生成できるのは大きなメリットだと思います。大きな画像をレンダリングの際にスタイルシートでwidth/heightを指定して縮小（拡大）表示することはよくあることですが、レンダリングスピードや転送速度を考慮するとあまりよいことでありません。

その辺りを考慮すると、Active Storageを使うメリットは大きいと思います。

# おまけ

VariantはImageMagickのコマンドを受け付けますので、以下のようなことも簡単にできてしまいます。ご利用は計画的に!


```ruby:GrayScale表示
@user.avatar.variant(resize:'200x200',type: :grayscale).processed
```

<img src="https://qiita-image-store.s3.amazonaws.com/0/39570/c68ceffc-e636-3c15-2798-f77ab15c8946.jpeg" width="300">

```ruby:反転
@user.avatar.variant(resize:'200x200',flop:true).processed
```
<img src="https://qiita-image-store.s3.amazonaws.com/0/39570/0430cea7-78e5-2b17-689d-940f76ea7b36.jpeg" width="300">

パラメータが必要のないオプションはtrueを指定します。

```ruby:ぼかし
@user.avatar.variant(resize:'200x200',blur:50).processed
```
<img src="https://qiita-image-store.s3.amazonaws.com/0/39570/3d23b01b-397e-bb32-2422-895e6d2310c4.jpeg" width="300">

```ruby:回転
@user.avatar.variant(resize:'200x200',rotate:30).processed
```
<img src="https://qiita-image-store.s3.amazonaws.com/0/39570/2d45fe6e-4abf-af8f-3753-83707c02efe8.jpeg" width="300">

```ruby:ボーダーをつける
@user.avatar.variant(combine_options:{resize:'200x200',border:'5',bordercolor:'red'}).processed
```
<img src="https://qiita-image-store.s3.amazonaws.com/0/39570/b0097dca-843b-f439-dc84-f4970520bcf1.jpeg" width="300">