(ruby)(RMagick)(ImageMagick)(Imageクラスと ImageListクラスの基本)

　さてさて RMagickに関していろいろと勉強中な日々なんですが
ドキュメントやリファレンスが英語なのでなかなか捗らない笑）
高校の英語の点数が赤点間際だった私には酷な話なワケです笑）

　ということでまず断っておく事は
このRMagickの記事は『あくまで現在の所私はそういう風に思っている』
程度の認識で書いてます、嘘も平気で書いている可能性も十分にあるので
『ド素人の ruby（RMagick）奮戦記』程度の感覚で読んでください

　今回は超基本的なところで
Imageオブジェクトと ImageListオブジェクトについてです
（rubyの場合はクラスと言った方がしっくり来るのかな？）

　Imageオブジェクトとはその名の通り一枚の絵のオブジェクトですね
メソッドなどは
http://studio.imagemagick.org/RMagick/doc/index.html の
Image (attribute methods)
Image (class methods and instance methods a-d、e-o、p-w)
を参照のことです

　Imageオブジェクトに一枚の絵を読み込む場合は、 readクラスメソッドを使います
ドキュメントには Image.read(filename) [ { optional arguments } ] -> array
とされていますので

require 'RMagick'
img1 = Magick::Image.read("abcdefg.jpg")[0]

ということになりますね
何故配列なのかというとアニメーションgifファイルなどを考慮しての事だと思います

　また新規作成の状態で生成することも出来ますよね、 newクラスメソッドですね
ドキュメントには Image.new(columns, rows [, fill]) [ { optional arguments } ] -> image
とされていますので
Magick::Image.new(400, 300) などとすれば 400ｘ300 の新しい画像が生成されます

　今回は ImageListを使ってみる所まで書こうと思っているので
二枚目は img1と同サイズの背景が透明のものを生成してみます
img1 の生成から一括して書くとこうなります

require 'RMagick'
img1 = Magick::Image.read("abcdefg.jpg")[0]
img2 = Magick::Image.new(img1.columns, img1.rows){self.background_color = "none"}

これで img1 に abcdefg.jpgがロードされ、 img2 に img1と同サイズの透明な画像が生成されます

　ここから ImageListの話になります
ImageListとはその名の通り ImageをListしたものです笑）
実は PhotoShopなどで言うレイヤーと同じような概念で捉えることが出来ます
Imageを ImageListに詰め込んでいくと上にどんどん重ね上げていく事に等しくなるようです

　ImageList のアトリビュートやメソッドは
http://studio.imagemagick.org/RMagick/doc/index.html の
ImageList （http://studio.imagemagick.org/RMagick/doc/ilist.html）を参照のことです

　ImageList の新規作成は newクラスメソッドですね
Magick::ImageList.new [ { optional arguments } ] -> imagelist となっていますので
imglst = Magick::ImageList.new() と書く事になるわけですね

　ではさっきの img1 と img2 を ImageListに詰め込むまでの処理です

require 'RMagick'
img1 = Magick::Image.read("abcdefg.jpg")[0]
img2 = Magick::Image.new(img1.columns, img1.rows){self.background_color = "none"}
imglst = Magick::ImageList.new()
imglst[0] = img1
imglst[1] = img2

　これで ImageListの中身は

最上層	imglst[1]	透明な画像
最下層	imglst[0]	abcdefg.jpgの画像

となっているはずです
もしきちんとレイヤーのようになっているのなら
imglst[1] に何かを描き込め、と命令すれば imglst[1]にそれが描かれるはずです
（もちろん imglst[0]には影響を与えない）

　ということで今回は Drawオブジェクトを使って角の丸い四角形を描いてみます
Draw の詳しい説明はまた後日という事でコードだけを書くと

Magick::Draw.new{
  self.fill = "white"
}.roundrectangle(30, 30, imglst[1].columns-30, imglst[1].rows-30, 20, 20).draw(imglst[1])

imglst[1] よりも縦横60px小さい角丸四角形が imglst[1] に白色で描き込まれます

最上層	imglst[1]	透明な背景に白い角丸四角形が描かれた物
最下層	imglst[0]	abcdefg.jpgの画像

　では思惑通り abcdefg.jpg の上に白い角丸四角形が描かれた物になっているのかの確認をします
レイヤーを統合して書き出すには
imglst.flatten_images.write("xxxx.png")
とします、 flatten_imagesでレイヤーを統合し、 writeで書き出すわけですね

　ではここまでの流れをまとめます

require 'RMagick'

img1 = Magick::Image.read("abcdefg.jpg")[0]
img2 = Magick::Image.new(img1.columns, img1.rows){self.background_color = "none"}

imglst = Magick::ImageList.new()
imglst[0] = img1
imglst[1] = img2

Magick::Draw.new{
  self.fill = "white"
}.roundrectangle(30, 30, imglst[1].columns-30, imglst[1].rows-30, 20, 20).draw(imglst[1])

imglst.flatten_images.write("xxxx.png")

　これで abcdefg.jpg の上に角丸四角形が描かれた xxxx.pngという画像が出来上がります

　もちろんいちいち img1 や img2 に一旦代入しなくても
ダイレクトに ImageListに Imageオブジェクトを投げ込むことも出来ますね

require 'RMagick'

imglst = Magick::ImageList.new()
imglst[0] = Magick::Image.read("abcdefg.jpg")[0]
imglst[1] = Magick::Image.new(imglst[0].columns, imglst[0].rows){self.background_color = "none"}

Magick::Draw.new{
  self.fill = "white"
}.roundrectangle(30, 30, imglst[1].columns-30, imglst[1].rows-30, 20, 20).draw(imglst[1])

imglst.flatten_images.write("xxxx.png")