イメージの扱い(Imlib)

Ruby/Gtk 0.21 以降では Imlib がインストールされていればその機能が使えるようになっています。

Imlib のソースは、 GNOME の各 ftp ミラーサイトの sources/imlib から入手できます。 Imlib のインストール方法は、Imlib 付属のドキュメントを参照してください。

Imlib がインストールされていれば、 Ruby/Gtk は extconf.rb 実行時に自動的に検出します。

Ruby/Gtk(0.21 以降)には、 Imlib を利用するサンプルプログラムが付いてきます。 以下の sample1.rb は、

% ruby sample1.rb 画像ファイル名

として起動すると、その画像を単に表示するというものです。 使用できる画像形式は PPM, PGM, TIFF, PNG, XPM, JPEG, EIM などいろいろありますが、詳しくは Imlib のドキュメントを参照してください。

プログラム sample1.rb:

#!/usr/local/bin/ruby

require 'gtk'

#
# Ruby/Gtk + Imlib : view demo
#

if(ARGV.size != 1)
  print $0, " filename\n"
  exit
end
filename = ARGV.shift

window = Gtk::Window.new(Gtk::WINDOW_TOPLEVEL)
window.set_title(filename)
window.signal_connect('destroy'){ exit }
window.signal_connect('delete_event'){ exit }

vbox = Gtk::VBox.new(false, 0)
window.add(vbox)
vbox.show

im = GdkImlib::Image.new(filename)
im.render(im.rgb_width, im.rgb_height)
pixd, maskd = im.get_pixmap
pixmap = Gtk::Pixmap.new(pixd, maskd)
pixmap.show
vbox.pack_start(pixmap, true, true, 0)

window.show
Gtk.main

プログラムの説明

• im = GdkImlib::Image.new(filename)
  Imlib 関係のクラスは GdkImlib モジュールの下で定義されています。 ここではまず最初に、画像を取り扱うための GdkImlib::Image オブジェクトを、画像ファイルから生成します。 基本的に画像形式は自動認識されます。
• im.render(im.rgb_width, im.rgb_height)
  Image オブジェクトから、(内部的に)pixmap 画像データを生成します。 render メソッドは引数として生成するデータの横幅と高さを指定します。 im.rgb_width で元画像の幅、 im.rgb_height で元画像の高さを得ることができるので、 ここでは元画像本来の大きさの pixmap データが生成されることになります。 render の引数に任意の幅、高さを指定することにより、 画像の拡大/縮小ができます。
• pixd, maskd = im.get_pixmap
  get_pixmap メソッドにより、 pixmap 形式のデータとマスク用のビットマップを取り出します。
• pixmap = Gtk::Pixmap.new(pixd, maskd)
  Gtk::Pixmap ウィジェットを生成します。
• pixmap.show
  
• vbox.pack_start(pixmap, true, true, 0)
  pixmap ウィジェットを show して vbox にパックします。

Ruby/Gtk スナップショットの配布ファイル中の sample/gdkimlib 以下に、 前出の sample1.rb 以外にも以下の各種サンプルプログラムがあります。

• sample2.rb
  画像の拡大/縮小のサンプル。 ボタンを押すと画像の拡大/縮小ができる。
• sample3.rb
  回転のサンプル。
• sample4.rb
  明るさ、コントラスト、ガンマ補正のサンプル。
• sample5.rb
  画像ビューア。 ファイルセレクションダイアログで選択した画像を表示する。