>tabstop >Program >自作プログラム >Ruby/GtkEmbedMoz--

Ruby/GtkEmbedMoz--

Untitled

はじめに

これは、Ruby/GtkEmbedMoz プロジェクトで開発されているモジュールに、 skipstone,Galeonのソースコードから適当な関数を見付けて付け加えたものです。自分の使いたい機能を実現することを優先しているため変更が汚く、仕様も定まっていないのでこのモジュールをそのまま使うのは控えた方が良いかもしれませんが、このようなことがrubyでできると言う参考にしてもらえるとありがたいと思っています。

必要な環境

Mozilla ver. 1.1以上 (Gtk+ 1.2もしくはGtk+ 2.0を用いたビルド): Unix環境などで、gtk+を用いたMozillaが必要です。コンパイラのバージョンなどによって動作する／しないが変わってくる(可能性がある)ので、できるだけ自分でビルドしたものを使うことをお薦めします。Mozilla 1.0での動作は確認していません。
Ruby ver. 1.6以上: 1.6より前のバージョンでの動作は確認していません。
ruby-gnome-0.30 もしくは ruby-gtk2-0.1モジュールとそのソースコード: Mozillaがgtk+1、gtk+2のどちらでコンパイルされているかによって決まります。 2002/12/29現在では、gtk+2でコンパイルされたバイナリは公式には出回っていません。

作者は

RedHat Linux 8.0 + Mozilla 1.2.1 + ruby-gnome-0.30
Vine Linux 2.6r1 + Mozilla 1.2.1 + ruby-gnome-0.30
Vine Linux 2.6r1 + Mozilla 1.3(gtk2) + ruby-gtk2-0.1
Vine Linux 2.6r1 + Mozilla 1.1 + ruby-gnome-0.30

の環境で動作を確認しています。

ダウンロード

最新版は20030315です。

インストール方法

Mozillaの開発用のヘッダをインストールします。rpmを使う場合は、
- mozilla-nspr-devel
- mozilla-nss-devel
- mozilla-devel
パッケージが必要になります。
環境変数 LD_LIBRARY_PATH に mozilla のインストールされているディレクトリを指定します。(これがないとうまくコンパイルできない場合があるようです。)

例えば
```
% export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/mozilla-x.y.z
```
とします。
extconf.rbを実行してMakefileを作成します。
```
% ruby extconf.rb         --with-mozilla-include-dir=wwww         --with-mozilla-lib-dir=xxxx         --with-ruby-glib-src-dir=yyyy         --with-ruby-gtk-src-dir=zzzz
```
各オプションは次のような意味を持ちます。

--with-mozilla-include-dir=<dir>

Mozillaのヘッダファイルがあるディレクトリを指定します。

--with-mozilla-lib-dir=<dir>

Mozillaの共有ライブラリファイルがあるディレクトリを指定します。

--with-ruby-glib-src-dir=<dir>

gtk2を使う場合に, ruby-gtk2のソースコードを展開したディレクトリ中の glibディレクトリの位置を指定します。

--with-ruby-gtk-src-dir=<dir>

ruby-gnome(またはruby-gtk2)のソースコードを展開したディレクトリ中の gtkディレクトリの位置を指定します。

--enable-gtk2

ruby-gtk2を使ってコンパイルをします。

例えば、次のようにオプションを指定します。

% ruby extconf.rb 	--with-mozilla-include-dir=/usr/include/mozilla-1.2.1/ 	--with-mozilla-lib-dir=/usr/lib/mozilla-1.2.1/ 	--with-ruby-glib-src-dir=../ruby-gnome-all-0.30/gtk/src/ 	--with-ruby-gtk-src-dir=../ruby-gnome-all-0.30/gtk/src/

makeコマンドを用いてコンパイルおよびインストールを行います。

% make
% su
--rootになる--
# make install

テスト

テストプログラムを実行するには、環境変数LD_PRELOADを設定する必要があります。

% export LD_PRELOAD=libpthread.so	#bash他の場合
% setenv LD_PRELOAD libpthread.so	#tcshの場合

sampleディレクトリにあるtest.rbを実行します。引数に適当な URLを指定しないとエラーになるので気をつけて下さい。

% test.rb http://www.yahoo.com/

これでyahooのサイトが表示されれば成功です。

Ruby/GtkEmbedMozとの差分

いくつかのメソッドの追加

Gtk::EmbedMoz.dom_key_press { |moz, key, mod, type, image, link, link_text| ...}

GtkMozEmbedのdom_key_pressイベントが起こった場合にイテレータを評価します。単純にsignal_connectしたのではイベントのkey, modなどの値を直接求めることができないのでこのようなメソッドを用います。

Gtk::EmbedMoz.dom_mouse_click { |moz, button, type, image, link, link_text| ...}

GtkMozEmbedのdom_key_pressイベントが起こった場合にイテレータを評価します。このメソッドもGtk::EmbedMoz.dom_key_pressと同じ理由で追加されています。

Gtk::EmbedMoz.new_window { |moz| ... }

GtkMozEmbedのnew_windowイベントが起こった場合にイテレータを評価します。イテレータの返した値を新しく生成されたWindowとして扱います。

Gtk::EmbedMoz.preference_set(pref_name, value)

pref_nameで指定された設定項目に、valueで指定された値をセットします。

Gtk::EmbedMoz.preference_get_i(pref_name)

pref_nameで指定された設定項目の値を整数値として取得します。

Gtk::EmbedMoz.preference_get_b(pref_name)

pref_nameで指定された設定項目の値をBool値として取得します。

Gtk::EmbedMoz.preference_get_s(pref_name)

pref_nameで指定された設定項目の値を文字列として取得します。

Gtk::EmbedMoz.save_prefs

変更のあった設定項目をprefs.jsファイルに書き込みます。

Gtk::EmbedMoz.scroll_up(lines)

表示領域をlines行だけ上側にスクロールします。

Gtk::EmbedMoz.scroll_down(lines)

表示領域をlines行だけ下側にスクロールします。

Gtk::EmbedMoz.scrollby(w, h)

表示領域を水平方向にwピクセル,垂直方向にhピクセル分だけスクロールします。

Gtk::EmbedMoz.find(expr, [case_cmp, [back, [wrap, [search_entire, [search_in_frame, [did_find]]]]]])

ドキュメント内の文字列を検索します。
Gtk+2.0でのコンパイル

ruby-gtk2モジュールを使ってコンパイルできるようにしました。

Ruby/GtkEmbedMoz--

はじめに

必要な環境

ダウンロード

インストール方法

テスト

Ruby/GtkEmbedMozとの差分

何に使うのか

ToDo

ライセンス