この記事は、ImageMagickと画像加工について発表したときの資料を文章に起こして加筆修正したものです。

ImageMagickとは

  • 画像加工といえばこれという有名ライブラリ
  • メジャーからマイナーまでさまざまな画像形式に対応
    • 機能が多すぎて脆弱性もたびたび発見されるくらい…
  • Cで実装され、多くの言語でバインディングがある

インストール

Mac Homebrew

$ brew install imagemagick

Debian / Ubuntu

$ sudo apt-get install -y imagemagick

CentOS

$ sudo yum -y install ImageMagick

コマンド

  • imagemagickというコマンドはない(!)
  • 機能ごとにconvertやidentifyなどのコマンドにわかれている
    • ただし、ImageMagick 7からはすべてmagickコマンドへのシンボリックリンクになっている

ImageMagick 6 (Ubuntu 16.04)

$ ls -Alh /usr/lib/x86_64-linux-gnu/ImageMagick-6.8.9/bin-Q16
total 88K
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 animate
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 compare
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 composite
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 conjure
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 convert
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 display
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 identify
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 import
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 mogrify
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 montage
-rwxr-xr-x 1 root root 6.3K Jul 31 13:22 stream

ImageMagick 7 (Mac Homebrew)

magickコマンドへのシンボリックリンクになっていることがわかる

$ ls -Alh /usr/local/Cellar/imagemagick/7.0.7-7/bin | grep -v config
total 64
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 animate -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 compare -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 composite -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 conjure -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 convert -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 display -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 identify -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 import -> magick
-r-xr-xr-x  1 shimoju  admin    18K 10  9 18:25 magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 magick-script -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 mogrify -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 montage -> magick
lrwxr-xr-x  1 shimoju  admin     6B 10  7 21:02 stream -> magick

identify

  • 画像の情報を出力できる
  • サイズをさっと知りたいときとか、大量の画像の中からサイズが違うものを探したりとかに便利
  • フォーマット文字列はこちら参照：Format and Print Image Properties @ ImageMagick
$ identify *.jpg
original.jpg JPEG 800x533 800x533+0+0 8-bit sRGB 104823B 0.000u 0:00.000
resize.jpg JPEG 400x267 400x267+0+0 8-bit sRGB 37116B 0.000u 0:00.000

JSON形式で出力してjqに食わせる

$ identify -format '{"width": %w, "height": %h}' *.jpg | jq
{
  "width": 800,
  "height": 533
}

grep -vで指定のサイズではない画像を抽出

$ identify -format '%wx%h %f\n' *.jpg | grep -v 800x533
200x200 crop.jpg

convert

  • さまざまな画像加工を行える、ImageMagickのメインコマンド
  • 適当な画像をoriginal.jpgとして用意しておきます

回転 (rotate)

-rotateで指定した角度回転する

$ convert -rotate 90 original.jpg rotate.jpg

上下反転

$ convert -flip original.jpg flip.jpg

左右反転

$ convert -flop original.jpg flop.jpg

上下左右反転

$ convert -flip -flop original.jpg flipflop.jpg

サンプル (sample)

ピクセルを間引く

$ convert -sample 10% original.jpg sample.jpg

10%になるようにピクセルを間引いたあと、1000%になるように拡大 →元画像と同じサイズでモザイクがかかる

$ convert -sample 10% -sample 1000% original.jpg mosaic.jpg

リサイズ (resize)

デフォルトではアスペクト比を変えない：指定した幅・高さに収まるようにリサイズされる

$ convert -resize 400x400 original.jpg resize.jpg
$ identify resize.jpg
resize.jpg JPEG 400x267 400x267+0+0 8-bit sRGB 37116B 0.000u 0:00.000

!をつけるとアスペクト比を無視して指定した値にリサイズする

$ convert -resize 400x400! original.jpg resize2.jpg

幅または高さのみ指定できる

$ convert -resize 400x original.jpg resize3.jpg

エッジ検出 (edge)

不連続に変化している箇所を検出する

$ convert -edge 5 original.jpg edge.jpg

値を変化させてみよう

$ convert -edge 10 original.jpg edge2.jpg
$ convert -edge 1 original.jpg edge3.jpg

切り抜き (crop)

-gravityで基準点を指定し、-crop widthxheightで切り抜くサイズを指定

$ convert -gravity center -crop 200x200+0+0 original.jpg crop.jpg

+/-で基準点からのx,y座標を指定できる 画像右上を基準に、xに140px,yに50px移動し、その点から200x200px切り抜く

$ convert -gravity northeast -crop 200x200+140+50 original.jpg crop.jpg

塗り足し (extent)

指定したサイズになるように余白を追加する 正方形のサイズが必要なのに4:3の画像しかないときなどに便利

$ convert -background black -gravity center \
          -extent 800x800 original.jpg extent.jpg

余白の色は-backgroundで指定する PNG(透過が扱えるフォーマット)であれば、-background transparentで透過できる

$ convert -background transparent -gravity north \
          -extent 1000x1000 original.jpg extent.png

文字の画像を作る

$ convert -background transparent \
          -fill '#ff6060' -font Arial -pointsize 128 label:LGTM lgtm.png

指定サイズで作成

$ convert -size 400x200 -gravity center -background transparent \
          -fill '#ff6060' -font Arial -pointsize 128 label:LGTM lgtm.png

合成 (composite)

original.jpgの上にlgtm.pngを合成して、compose-over.jpgとして出力

$ convert original.jpg lgtm.png -gravity center \
          -compose over -composite compose-over.jpg

-geometryで基準点から移動

$ convert original.jpg lgtm.png -gravity center -geometry +150+50 \
          -compose over -composite compose-over.jpg

描画モード (blend mode)

乗算 (multiply)

$ convert original.jpg lgtm.png -gravity center -geometry +150+50 \
          -compose multiply -composite compose-multiply.jpg

オーバーレイ (overlay)

$ convert original.jpg lgtm.png -gravity center -geometry +150+50 \
          -compose overlay -composite compose-overlay.jpg

減算 (subtract)

$ convert original.jpg lgtm.png -gravity center -geometry +150+50 \
          -compose subtract -composite compose-subtract.jpg