FVWM

名前
形式
説明
COPYRIGHTS ( 原文 )
著作権 ( 日本語訳 )
ウィンドウの構造
仮想デスクトップ
初期化
コンパイルオプション
アイコン
モジュール
ICCCM 勧告への対応度
M4 による前処理
CPP による前処理
AUTO-RAISE
オプション
設定ファイル
組み込み関数
キーボードショートカット
設定例の提供
マルチスクリーンディスプレイ上での使用について
著者

名前

fvwm2 − X11 用の F(?) 仮想ウィンドウマネージャ (version 2.xx)

形式

fvwm [ options ]

説明

fvwm は X11 用のウィンドウマネージャです。これは twm を元に作られていて、メモリの消費を最小化するよう再設計され、ウィンドウの枠の 3 次元的表示と簡単な仮想デスクトップを提供します。バージョン 2.xx は、1.xx よりごくわずかに多くのメモリを使うのみですが、それはほぼ、いくつかの大域的なオプションを各ウィンドウ毎のオプションにすることを可能にするためです。

fvwm は大きな仮想デスクトップと、別々に、あるいは一緒に使用できる複数の重ならないデスクトップの両方を提供します。仮想デスクトップは、使用しているスクリーンが実際に広くなったかのように見せてくれ、そしてそのデスクトップ内のあちこちをスクロールすることが可能です。複数の重ならないデスクトップは、実際に複数のスクリーンを作業する場として持っているかのように見せてくれますが、個々のスクリーンはそれぞれ完全に独立しています。

fvwm はキーボードによる高速操作性も提供します。これにより、ウィンドウの移動やサイズの変更のような、たいていのウィンドウマネージャの機能を実行できますし、キーボードショートカットを使ってウィンドウマネージャのメニューの操作も行えます。

たいていのウィンドウマネージャが設定コマンドと組み込みコマンドとの違いを明確にしているのに対し、 fvwm はその違いをあいまいにしています。典型的には設定コマンドはフォントの設定、色の設定、メニューの内容やキー、マウスの機能割り当てなどを行います。一方、組み込みコマンドは典型的にはウィンドウの上げ下げなどを行います。 fvwm はそのような違いを持たないので、現実的な範囲で、どんなものでもいつであっても変化させることが可能になっています。

fvwm と他の X11 ウィンドウマネージャのその他の特筆すべき違いは、 SloppyFocus (だらしないフォーカス) とフォーカスをウィンドウ毎に設定することを導入している点です。 SloppyFocus は、マウスに従うフォーカス (focus-follows-mouse) ですが、マウスがウィンドウから出てルートウィンドウ (背景のウィンドウ) に入ってもそのフォーカスが消えない性質があります。 SloppyFocus がデフォルトのフォーカススタイルとして使われている場合、通常タイプ入力しないようなウィンドウ (xmag, xman, xgraph, xclock, xbiff 等) をマウスクリックに従うフォーカス (click-to-focus) にするといいでしょう。そうすれば、端末ウィンドウが不必要にフォーカスを失うことはなくなります。

COPYRIGHTS ( 原文 )

Since fvwm is derived from twm code it shares twm’s copyrights. Since nearly every line of twm code has been changed, the twm copyright has been removed from most of the individual code files. I do still recognize the influence of twm code in the overall package, so fvwm’s copyright is still considered to be the same as twm’s.

fvwm is copyright 1988 by Evans and Sutherland Computer Corporation, Salt Lake City, Utah, and 1989 by the Massachusetts Institute of Technology, Cambridge, Massachusetts, All rights reserved. It is also copyright 1993 and 1994 by Robert Nation.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the names of Evans & Sutherland and M.I.T. not be used in advertising in publicity pertaining to distribution of the software without specific, written prior permission.

ROBERT NATION, CHARLES HINES, EVANS & SUTHERLAND, AND M.I.T. DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL EVANS & SUTHERLAND OR M.I.T. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTUOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

著作権 ( 日本語訳 )

fvwm は twm のコードからの派生物なので、 fvwm は twm の著作権を共有します。 twm のほとんどすべてのコードは変更されていますので、ほとんどの個々のソースコードファイルからは twm の著作権表示は取り除かれていますが、私はパッケージ全体に渡る twm のコードの影響を今でも認識していますから、 fvwm の著作権は今でも twm のものと全く同じと考えます。

fvwm は、1988 年にエバンス & サザーランドコンピュータ株式会社 (ユタ州ソルトレーク市)、 1989 年にマサチューセッツ工科大学 (マサチューセッツ州ケンブリッジ市) による著作物で、全ての権利が保護されています。 1993 年と 1994 年にロバート・ネイション (Robert Nation) によっても作成されています。

このソフトウェア、およびその付属文書の使用、複製、改変、配布の許可は、任意の目的に対して、そして課金をしないならば、この文書により、以下の条件の元で保証されます: 上の著作権通知が全ての複製に含まれること、その著作権通知とこの許可通知の両方が付属文書に含まれること、そして、このソフトウェアの配布に関して、特に文書での許可をあらかじめ取っているのでなければ、エバンス & サザーランドと M.I.T の名前を公の広告に使用しないこと。

ロバート・ネイション、チャールズ・ハインズ、エバンス & サザーランド、そして M.I.T は、このソフトウェアに対して何の保証もしませんし、市場性や適切さに対する暗黙の保証もしません。どんな特殊な、間接的な、または結果として引き起こされた損害に対しても、または、このソフトウェアの使用や性能から引き起こされる、あるいはそれに関係した使用不能や、データの損失、利益の損失の結果としてのどんな損害に対しても、それらが契約、過失、およびその他の不正行為によってであるかそうでないかに関わらず、どんな場合でもエバンス & サザーランドと M.I.T は責任を負いません。

ウィンドウの構造

fvwm は、ほとんどのウィンドウの周囲に装飾的な境界をつけます。この境界は、上下左右の 4 方向の辺上のまっすぐな棒 (bar) と 4 つの角にある小さな "L" 字型の部品からできています。さらに、タイトルバーと呼ばれる、ウィンドウ名を表示するのに使われる棒を上辺に追加してつけることもできます。さらに、最大 10 個までのタイトルバーボタンをその中に追加することもできます。上辺や左右の辺、および底辺の棒はまとめてサイドバーと呼ばれます。角の部品はフレームと呼ばれます。

標準的な初期化ファイルを修正しなければ、タイトルバー、またはサイドバーでマウスボタン 1 を押すと、ウィンドウの移動操作を開始します。角の L 字部分でボタン 1 を押すとサイズ変更操作を開始します。境界の任意の箇所でボタン 2 を押すと、ウィンドウ操作の一覧メニューを作り出します。

タイトルバーボタンは最大 10 個まで作れます。それらの使用は完全にユーザが定義可能です。デフォルトの設定ではタイトルバーボタンは、タイトルバーの両側に 1 つずつつきます。左端のものは、ウィンドウ操作の一覧メニューを作りだすもので、右端のものは、ウィンドウのアイコン化用のものです。使用するタイトルバーボタンの数は、どれがマウス操作を割り当てられているタイトルバーボタンであるかに依存します。以下の "Mouse" 設定パラメータの節を参照してください。

仮想デスクトップ

fvwm は、複数の仮想デスクトップを使いたい人に提供します。スクリーンは、それより広くてもいい一つのデスクトップ上へのビューポート (視野) になります。いくつかの異なるデスクトップにアクセスすることができます (個々のプロジェクト用に一つのデスクトップ、あるいは表示アプリケーションが異なる場合の個々のアプリケーション用に一つのデスクトップ、といった利用を想定しています)。デスクトップ一つ一つは、物理的なスクリーンサイズよりも大きくても構わなくて、それらは m x n 個の物理スクリーンサイズのページに分割され、スクリーンよりも大きいサイズのウィンドウや、関連するたくさんのウィンドウのグループなどを簡単に見ることができます。

仮想デスクトップのサイズ (m x n; すなわちページ数) は、組み込みコマンド DeskTopSize を使っていつでも変更できます。すべてのデスクトップは同じサイズになります。デスクトップの個数は指定する必要はありませんが、全部でほぼ 40 憶個までに制限されています。デスクトップの領域内のすべてのウィンドウは Pager で見ることができますが、これはデスクトップをミニチュア表示します。この Pager は、モジュールと呼ばれる付属プログラムの一つで、ウィンドウマネージャの操作に必要不可欠なものではありません。 FvwmWinList と呼ばれる別なモジュールによって、ウィンドウの一覧を、そのそれぞれの位置に従った順で、ポップアップメニューか独立したウィンドウとしてアクセス可能できる形で、作成することができます。

"Sticky" (粘着的) ウィンドウは、「スクリーンのガラスに張りつく」ことで仮想デスクトップを越えるウィンドウです。それは常にスクリーン上に居続けます。これは、時計や xbiff (郵便受け) のようなものには便利な機能で、そのような小道具をは一つ起動するだけで済みますし、それが常にあなたと共にいます。アイコンも、望むならば、スクリーンに張りつくようにすることができます。

ウィンドウの位置や大きさの情報 (geometry) は、現在のビューポートに相対的に指定します。例えば、

     xterm -geometry +0+0

これは、常にスクリーンの表示部分の左上の角に表示されます。ウィンドウを仮想デスクトップに置くような geometry を指定することも可能ですが、スクリーンからは外れます。例えば、表示スクリーンが 1000x1000 ピクセルの大きさであって、デスクトップサイズが 3x3 (i.e. 一つのデスクトップが縦 3 行、横 3 列のスクリーンからなる) であって、現在のビューポートがそのデスクトップの左上角にあるとき、

     xterm -geometry +1000+1000

のようにすると、そのウィンドウはスクリーンの右下に外れますが、マウスをスクリーンの右下に持っていってスクリーンがスクロールされるまで待てばそのウィンドウを見つけることができます。

ウィンドウを、現在有効なデスクトップではない別のデスクトップ上に配置する方法は今のところはありませんが、もしかして知っていませんか ?

geometry を以下のように指定した場合

     xterm -geometry -5-5

一般的には、そのウィンドウの右下の角が、表示スクリーンの右下の角から 5 ピクセルの位置に置かれます。ただし、全てのアプリケーションが負の位置指定のウィンドウ geometry をサポートしているわけではありません。

xterm や xfontsel のように、標準的な Xt (X toolkit) コマンドライン引数と X リソースを解釈するようなアプリケーションに対してはユーザは、起動時のデスクをコマンドラインで指定できます:

     xterm -xrm "*Desk:1"

これは、xterm を番号 1 のデスクで起動します。しかし、全てのアプリケーションがこのオプションを認識するわけではありません。

これと同じことは、あなたの .Xdefaults ファイルに以下の行を入れることでも可能です:

     XTerm*Desk: 1

初期化

初期化の間、fvwm は設定ファイルを探します。それには、キー、マウスボタンの割り当てや、他のいくつかのことが書かれています。そのファイルの書式に関しては後で述べます。まず、fvwm は .fvwm2rc という名前 (または、コンパイル時の設定によっては .fvwmrc という名前 - デフォルトでは .fvwm2rc) のファイルを、ユーザのホームディレクトリ上で探します。それに失敗した場合、システム共通の設定ファイルである /usr/lib/X11/fvwm/.fvwm2rc ( うちの研究室では /usr/local/x11/lib/fvwm2/system.fvwm2rc) を検索します。そのファイルも見つからなかった場合、 fvwm は基本的に使いものにはならないでしょう。

		fvwm は、その子プロセスに引き継がれる環境変数を 2 つ設定します。一つは $DISPLAY で、これは fvwm が動作しているディスプレイを意味します。 $DISPLAY は unix:0.0 や :0.0 などで、これは rsh
		を通して他のマシンを使っている場合はあまりうまくは効きません。よって、$HOSTDISPLAY も設定され、これはネットワーク向きのディスプレイの記述になっています。 $HOSTDISPLAY は TCP/IP 転送プロトコルを常に使います (ローカルな接続であっても) ので、ローカルな接続には $DISPLAY を使うべきで、これは Unix ドメインソケットを使用し、こちらの方が高速です。
		fvwm には 2 つの初期化用の特別な関数、 InitFunction と
		RestartFunction を持っていて、これらはそれぞれ初期化と再起動の時に実行されます。これらはユーザの rc ファイル (初期設定ファイル) で AddToFunc の機能 (後述) を使って、モジュールや xterm、その他 fvwm の起動時に立ち上げさせたいものを何でも起動させるようにカスタマイズするようにできます。

fvwm は終了用の特別な関数名「ExitFunction」も持っています。これは (それが定義されていれば)、fvwm の終了時、あるいは本当に fvwm を終了させる前に再起動させたとき等の場合に実行されます。それを定義すれば明示的にモジュールを殺したりするのに使えます。

コンパイルオプション

fvwm は、コンパイル時にいくつかの機能の使用を制限することでメモリの使用を減らすことができるような色んな方法を用意しています。あるコマンドや機能の利用のトラブルがあれば、その機能がサポートされるようにコンパイルされたかをチェックしてください。必須でない機能は、Imake の設定ファイル Fvwm.tmpl に詳しく書かれています。

アイコン

基本的な fvwm の設定は、 twm 同様白黒のビットマップアイコンを使うようになっています。 XPM 拡張が有効な状態でコンパイルされている場合は、 ctwm, MS-Windows, Macintosh などと同様にカラーのアイコンを使うことができます。そのオプションを使うためには XPM パッケージが必要ですが、それに関しては Imake の設定ファイル Fvwm.tmpl 内に書かれています。

SHAPE と XPM オプションの両方がついてコンパイルされている場合、形のあるカラーアイコンを使うこともできますが、それはとても綺麗です。

モジュール

モジュールは fvwm とは分離した形のプログラムで、 fvwm とは分離した Unix プロセスとして動作しますが、 fvwm に実行させるコマンドを fvwm に送信します。ユーザは、fvwm それ自身の完全さに影響を与えない、あるいは fvwm を肥大化させない、不気味な、または奇妙な操作をするような自分のオリジナルのモジュールを書くことも可能です。

モジュールのプロセスは、fvwm とモジュールの双方が通信できるような 2 つのパイプをセットできるように、 fvwm によって生成される必要があります。モジュールのためのパイプは、それが起動したときに既にオープンされていて、パイプ用のファイルデスクリプタはコマンドライン引数として与えられています。

モジュールプロセスは fvwm の初期化の際にモジュールオプションによって生成されるか、または、組み込みコマンド Module を使うことによって X が動作している間の任意の時に生成されます。モジュールは、X の起動中存在し続けることもできますし、一つの仕事を行ってその後終了することもできます。 fvwm が終了するよう命令されたときにモジュールがまだ有効な場合、 fvwm は通信用のパイプを閉じてモジュールからの SIGCHLD シグナルが来るのを待ちますが、それは、パイプが閉じたことをモジュールが検出し、そして終了した、ということを示しています。モジュールがパイプが閉じたことの検出に失敗した場合、 fvwm はほぼ 30 秒後に取りあえず終了します。同時に実行できるモジュールの数は、同時に開けるファイルの最大数という OS の制限によって限定されますが、通常は 60 から 256 の間です。

モジュールは単にテキストコマンドを fvwm の組み込みコマンドエンジンに送信するだけで、このテキストコマンドとは、設定ファイル .fvwm2rc の丁度マウス割り当ての場合のような書式です。サンプルモジュール FvwmButtons の中にあるように、ある補足の情報も送信されます。モジュール FvwmButtons に関しては、そのマニュアルページに書かれています。

ICCCM 勧告への対応度

fvwm は ICCCM 1.1 への対応を試みています。さらに、ICCCM はアプリケーションが「任意の」キーストロークを受け取ることが可能であるべきだと述べていますが、しかしこれは fvwm、および他のほとんどのウィンドウマネージャで利用されているショートカットキーの手法と両立しません。

ICCCM は、以下のプロパティを所有するウィンドウ:

     WM_HINTS(WM_HINTS):
                     Client accepts input or input focus: False

は、ウィンドウマネージャがキーボードフォーカスを与えるべきではない、と言っていますが、そういったウィンドウは自分自身で入力フォーカスを取得します。多くのアプリケーションがこのプロパティを設定していて、その上ウィンドウマネージャがキーボードフォーカスを与えてくれる、と思っているのです。だから fvwm は "Lenience" (Lenience = 寛大) というウィンドウスタイルを用意し、 fvwm がこの ICCCM の規則を大目に見ることができるようにしています。

M4 による前処理

M4 による前処理は fvwm-2.0 ではモジュールとして提供されています。詳細は man FvwmM4 を見てください。簡単に言うと、fvwm にあなたのファイルを m4 で処理させたい場合、に置き変えて、 fvwm を次のように実行します:

     fvwm -cmd "FvwmM4 .fvwm2rc"

CPP による前処理

cpp は C 言語のプリプロセッサです。 fvwm-2.0 は m4 による前処理と全く同様の cpp による前処理も提供しています。それに関しては、上の M4 の項目を、"m4" の部分を "cpp" と置き変えて読んでみてください。

AUTO-RAISE

ウィンドウはそれがフォーカスを得たとき、あるいはフォーカスを得て数ミリ秒後に自動的に一番上に来るようにすることができます。それには auto-raise モジュールである FvwmAuto を使用します。

オプション

fvwm が認識するコマンドラインオプションは以下の通りです:

-f config_file

fvwm に、初期化ファイルとして、".fvwm2rc" の代わりに config_file を読み込まさせます。これは -cmd "Read config_file" と同等です。

-cmd config_command

fvwm に、初期化コマンドとして "Read .fvwm2rc" をさせる代わりに config_command を使用します (10 個までの -f と -cmd パラメータを与えることが可能、それらは指定した順に実行されること、に注意してください)。

-debug

同期モードでの X とのやりとりを出力します。動作は劇的に遅くなりますが、出力される fvwm の内部エラーメッセージが正しいものであることは保証されます。また、これは fvwm に動作中のデバッグメッセージも出力させます。

-d displayname

環境変数 $DISPLAY による名前の代わりに "displayname" の名前のディスプレイを制御します。

-s

マルチスクリーンディスプレイ上で、fvwm を環境変数 $DISPLAY、または -d オプションで与えられる名前のスクリーンのみで動作させます。通常は、マルチスクリーンディスプレイでは、 fvwm は全てのスクリーン上で起動しようとします。

-version

fvwm のバージョンを標準エラー出力に表示します。

設定ファイル

設定ファイルはキー割り当て、マウスボタン割り当て、色、仮想ディスプレイサイズ、そしてそれらに関連する項目等を記述するのに使われます。初期設定ファイルの典型的な名前は ".fvwm2rc" です。組み込み関数 "Read" を使えば、容易に別の設定ファイルをあなたのしたいように読み込ませることが可能です。

(fvwm 自身の設定コマンドではなく) モジュールの設定コマンドが含まれる行とみなされます。

fvwm の設定コマンドと組み込みコマンドとの間には特に違いはなく、組み込みコマンドの節で説明されているものはいずれも、それを一つの行に書くことでそれが設定ファイルから読み込まれるときに fvwm に実行させることも可能ですし、またはメニュー内やマウスボタンやキーボードのキーに割り当てた実行コマンドとすることも可能です。どの関数が初期化用の意味を持ち、どの関数が実行時に意味があるのか、ということを決めるのはユーザへの課題として残されています。

組み込み関数

fvwm は組み込み関数群をサポートしていて、それはキーボードやマウスボタンに割り当てることができます。 fvwm は一つのコマンドにまず組み込み関数を見つけようとして、そしてそれに失敗した場合はその指定されたコマンドが "Function (コマンドの残り)" という形なのか "Module (コマンドの残り)" のどちらであるかを調べます。これにより、設定ファイルに関してかなり透明な仕組みで、複雑な関数やモジュールを呼び出すことが可能になります。

例: ファイル .fvwm2rc が "HelpMe" という行を持つとします。 fvwm はまず "HelpMe" という名の組み込みコマンドがあるかどうかを調べますが、それはありません。次に、fvwm はユーザが定義した "HelpMe" という名前の複雑な関数があるかどうかを探します。もし、そのようなユーザ定義関数がなければ、 fvwm は "HelpMe" という名のモジュールを実行しようとします。

fvwm の以前の版では、引用符は .fvwmrc ファイル内では危険で不合理なものでした。fvwm-2 現在ではこのほとんどが解消されました。引用符は、fvwm に 2 つ以上の単語を一つの引数と思わせるときのみに必要ですが、不必要な引用符の使用も許されています。文字列内で引用符文字を使用したい場合は、バックスラッシュ (\) を頭につけてエスケープする必要があります。例えば、Window-Ops という名前のポップアップメニューに対しては、引用符を使う必要はなく、Popup Window-Ops とできますが、このダッシュ (-) をスペース ( ) で置き変えた場合は引用符が必要で、 Popup "Window Ops" とする必要があります。

AddButtonStyle button [state] [style] [ -- [!]flag ... ]

これは一つのボタンスタイルを button に割りあてます。 button は、ボタン番号か、または "All", "Left", "Right" のいずれかです。 state は、"ActiveUp", "ActiveDown", "Inactive" のいずれかです。 state を省略すると、全ての状態 (state) にそのスタイルが追加されます。ボタンスタイルとフラグがカッコでくくれば、一行に複数の状態 (state) の定義を書くことができます。追加するボタンスタイルに対するフラグは、その後の定義では変更できません。

ボタンは、定義された順に書かれます。つまり、一番最近定義された ButtonStyle に始まり、それに追加した AddButtonStyle がそれに続きます。ボタンスタイルの定義の積み重ねを消去するには、スタイルフラグを変更してください。有効なスタイルとフラグに関する詳細については、 ButtonStyle コマンドの項を参照してください。例:

     ButtonStyle 1 Pixmap led.xpm -- Top Left
     ButtonStyle 1 ActiveDown HGradient 8 grey black
     ButtonStyle All --  UseTitleStyle
     AddButtonStyle 1 ActiveUp (Pixmap a.xpm) ActiveDown (Pixmap b.xpm -- Top)
     AddButtonStyle 1 Vector 4 50x30@1 70x70@0 30x70@0 50x30@1

この例では、最初にボタンの全ての状態が一つのピクスマップ画像に設定されています。 2 行目は ActiveDown 状態をグラデーションに置きかえています (これは前の行で、全ての状態に対して同じスタイルとして割り当てたピクスマップ画像の設定を無効にします)。そして、UseTitleStyle フラグが全てのボタンに対して設定され、それはボタンを描画する前に fvwm に任意のスタイルを TitleStyle に設定させます。そして最後に AddButtonStyle を使って、 ActiveUp と ActiveDown の状態に追加のピクスマップ画像を設定し、全ての状態の一番上に、ベクトルボタンスタイルが追加されます。

AddTitleStyle [state] [style] [ -- [!]flag ... ]

これはタイトルバーにタイトルスタイルを追加します。 state は、"ActiveUp", "ActiveDown", "Inactive" のいずれかです。 state を省略すると、全ての状態 (state) にそのスタイルが追加されます。ボタンスタイルとフラグをカッコでくくれば、一行に複数の状態 (state) の定義を書くことができます。このコマンドは、AddButtonStyle コマンド (上を参照) と全く同様です。

タイトルバーは、定義された順に書かれます。つまり、一番最近定義された TitleStyle に始まり、それに追加した AddButtonStyle がそれに続きます。タイトルスタイルの定義の積み重ねを消去するには、スタイルフラグを変更してください。有効なスタイルとフラグに関する詳細については、 TitleStyle と ButtonStyle コマンドの項を参照してください。

AddToDecor decor

これは、decor という名前の装飾にコマンドを追加、転換します。装飾 (decor) とは、ボタンスタイル (ButtonStyle)、タイトルバースタイル (TitleStyle) 、ボーダースタイル (BorderStyle)、ハイライトカラー (HilightColor)、ウィンドウフォント (WindowFont) に影響を与える複数のコマンドの集合につけられた名前です。 decor が存在しなかった場合は作られますが、そうでなければ既に存在する decor が変更されます。

生成された装飾 (decor) は、任意のスタイル定義を除いたデフォルトの fvwm の装飾と丁度同じものとして出発します。与えられた装飾は、Style コマンドの UseDecor オプションにより、ウィンドウの集合に適用できます。既に存在する装飾を修正すると、現在それが割り当てられているウィンドウも影響を受けます。

AddToDecor の使用法は、AddToMenu, AddToFunc コマンドと同様で、違いはそれらのメニューや関数が ButtonStyle, AddButtonStyle, TitleStyle, AddTitleStyle, BorderStyle, HilightColor, WindowFont コマンドに変わるだけです。 AddToDecor で生成された装飾は、ChangeDecor, DestroyDecor, UpdateDecor コマンドや、Style オプションの UseDecor などで操作できます。

以下は、装飾とスタイルを生成する例で、いずれも名前は "flatness" です。同じ名前ですが、それらの実体は別ものです:

     AddToDecor flatness
     + ButtonStyle All ActiveUp (-- flat) Inactive (-- flat)
     + TitleStyle -- flat
     + BorderStyle -- HiddenHandles NoInset
     + HilightColor white navy
     Style "flatness" UseDecor flatness,Color white/grey40,HandleWidth 4

    Style "xterm" UseStyle flatness

既に存在するウィンドウの装飾は ChangeDecor、あるいは Style コマンドに続く Recapture で割り当て直すことができます。 UpdateDecor により、全てのウィンドウの装飾、または特定の装飾一つを更新できます (これは装飾を変更した後で有用で、Style オプションの変更の場合はその代わりに Recapture が必要になります)。装飾は、DestroyDecor で破壊できます。

AddToMenu

これはメニューの定義を開始、あるいはメニュー定義への追加を行います。典型的なメニュー定義は例えば以下のようになります:

     AddToMenu Utilities "Utilities"     Title
     +                   "Xterm"         Exec  xterm -e tcsh
     +                   "Rxvt"          Exec  rxvt
     +                   "Remote Logins" Popup Remote-Logins
     +                   "Top"           Exec  rxvt -T Top -n Top -e top
     +                   "Calculator"    Exec  xcalc
     +                   "Xman"          Exec  xman
     +                   "Xmag"          Exec  xmag
     +                   "emacs"         Exec  xemacs
     +                   "Mail"          MailFunction xmh "-font fixed"
     +                   ""              Nop
     +                   "Modules"       Popup Module-Popup
     +                   ""              Nop
     +                   "Exit Fvwm"     Popup Quit-Verify

このメニューは、

     Mouse 1 R       A       Menu Utilities Nop

や

     Mouse 1 R       A       Popup Utilities

のようにして呼びだすことができます。メニューの終りを表わす記号はありません。メニュー同士が .fvwm2rc ファイル内の隣接する領域で定義される必要もありません。上の例の引用符で囲まれた部分はメニューラベルで、それはユーザがメニューをポップアップした際にそこに表示されるものです。残りの部分は組み込みコマンドで、それはユーザがそのメニュー項目を選択したときに実行されるべきものです。空のメニューラベル ("") と Nop 関数は、メニューに仕切り線を入れるのに使われます。

メニューラベルが ’*’ で始まる部分文字列を含む場合、みなされ、メニューに挿入されます。例えば、


		"Calculatorxcalc.xpm"
		Exec xcalc

は、"Calculator" というラベルのついたメニュー項目を作り、その上に計算機の絵がつきます。以下の例:


		"xcalc.xpm" Exec xcalc

は、"Calculator" というラベルを省略しますが、絵は残ります。

メニューラベルが ’%’ で始まる部分文字列を含む場合、みなされ、メニューラベルの左に挿入されます。例えば、


		"Calculator%xcalc.xpm%"
		Exec xcalc

は、"Calculator" というラベルのついたメニュー項目を作り、その左に計算機の絵がつきます。以下の例:


		"%xcalc.xpm%" Exec xcalc

は、"Calculator" というラベルを省略しますが、絵は残ります。これに使用される画像は小さいものであるべきです (できれば 16x16)。

AddToFunc

これは関数の定義を開始、あるいは追加します。以下はその一例です:

     AddToFunc Move-or-Raise         "I" Raise
     +                               "M" Move
     +                               "D" Lower

この関数名は Move-or-Raise で、これはメニューやマウス、キーの割り当て (binding) で呼び出すことができます:

     Mouse 1 TS      A       Move-or-Raise

関数の引用符で囲まれた部分は、どんな種類の動作がそれに従うコマンドを起動させるかを表しています。 "I" は Immediate を意味し、これは関数が呼び出されるとすぐに実行されます。 "M" は Motion を意味し、すなわちユーザがマウスを動かし始めたとき、となります。 "C" は Click、すなわちユーザが短い時間の間 (ClickTime ミリ秒) にマウスボタンを押して離したとき、となります。 "D" はダブルクリックを意味します。どのウィンドウに従うべきか、という優先度に関する情報とともにその関数が呼ばれた場合、動作 "I" は、そのボタンが押されたところで実行されるべき動作を引き起こします。

	$w と $0 から $9 までの記号は特別な意味を持ち、複雑な関数やマクロ、またはそれらを呼び出したいどんな場所でも有効です。マクロ内では、$w はそのマクロが呼び出されたウィンドウのウィンドウ ID (例えば 0x10023c のような 16 進表記) に展開されます。$0 から $9	は、マクロの引数になりますので、よって
	Key F10	R
		A
		Function MailFunction xmh "-font fixed"

のように呼び出し、そして MailFunction が

     AddToFunc MailFunction     "I" Next [$0] Iconify -1
     +                          "I" Next [$0] focus
     +                          "I" None [$0] Exec $0 $1

のようであったとすると、関数の最後の行は以下のようになります。

     +                          "I" None [xmh] Exec xmh -font fixed

その展開は関数が実行されるときに行われますので、一つの関数をありとあらゆる種類の異なる引数に対して使うことができます。したければ、同じ .fvwm2rc ファイル内で、

Key F11

		R
		A
		Function MailFunction zmail "-bg pink"

とすることもできるわけです。$w を使った例は例えば:

     AddToFunc PrintFunction         "I" Raise
     +                               "I" Exec xdpr -id $w

$$ は $ と展開されることに注意してください。

Beep

期待される通り、これは端末のビープ音を生成します。

BorderStyle [state] [style] [ -- [!]flag ... ]

これは、ウィンドウの境界のスタイルを定義します。 state は、"Active" か "Inactive" のいずれかです。 state を省略した場合、そのスタイルは両方の状態 (state) に対して設定されます。スタイルとフラグをカッコでくくれば、一行に複数の状態 (state) の定義を書くことができます。

style は、有効な ButtonStyle の部分集合で、それは TiledPixmap (斜面の色にマッチする一様なピクスマップ画像がこれに最も良く合います) のみが可能です。任意のフラグの前に "!" をつけた場合、そのフラグの意味は否定されます。 style を指定しなければ、スタイルをリセットせずにフラグを変更できます。

フラグ "HiddenHandles" は、ウィンドウ上で線で分離されている角のハンドル (corner handle) をハンドルで隠します (このオプションは NoHandle のウィンドウには何の効果も持ちません)。デフォルトでは HiddenHandle は無効になっています。

フラグ "NoInset" は、HiddenHandles を補足します。これが指定された場合、ウィンドウの枠の内側の斜面は描画されません。 HiddenHandles が指定されない場合は、このフラグは何の効果も持ちません。

アクティブ、非アクティブなウィンドウの境界を生地のピクスマップ画像で飾るには、以下のように指定します:

     BorderStyle Active TiledPixmap marble.xpm
     BorderStyle Inactive TiledPixmap granite.xpm
     BorderStyle Active -- HiddenHandles NoInset

両方の状態にスタイルをクリアするには:

     BorderStyle Simple

一つの状態の方をクリアするには:

     BorderStyle Active Simple

与えられた状態のフラグのセットを解除するには:

     BorderStyle Inactive -- !NoInset

タイトルバーボタンは、UseBorderStyle フラグ (ButtonStyle 参照) を使って、ボーダースタイルを継承することができます。

ButtonStyle button [state] [style] [ -- [!]flag ... ]

これは、タイトルバーボタンのボタンスタイルを設定します。 button は、0 から 9 までのタイトルバーボタン番号、または "All", "Left", "Right", "Reset" のうちのいずれかです。ボタン番号については Mouse の項 (下を参照) で説明します。スタイルとフラグをカッコでくくれば、一行に複数の状態 (state) の定義を書くことができます。

state は、ボタンのどの状態にセットするのかを指示します。ボタンの状態は以下のように定義されています: 状態 "ActiveUp" と "ActiveDown" は、アクティブ (有効) なウィンドウのボタンが、それぞれ押されていない、押されている状態を、状態 "Inactive" は非アクティブ (非有効) なウィンドウのボタンを示しています。

state が ActiveUp, ActiveDown, Inactive の場合は、その特定のボタンの状態に対して設定されます。 state が省略された場合は、全ての状態に設定されます。スタイルを指定すると、現在のスタイルは破壊されます (これを避けるには AddButtonStyle を使用してください)。

style を省略すれば、現在のスタイルを破壊せずに、前のボタンスタイルに対する状態依存フラグを設定できます。例 (各行は独立に考慮されます):

     ButtonStyle Left -- flat
     ButtonStyle All ActiveUp (-- flat) Inactive (-- flat)

最初の行は全ての状態 (state) の左のボタンを平ら (flat) に設定しますが、 2 行目は、ActiveUp と Inactive な状態にだけ、その全てのボタンを平ら (flat) に設定します (フラグのみが変更され、その個々のスタイルは変更されません)。

全てのボタンをそのデフォルトにリセットしたいなら:

     ButtonStyle Reset

ボタン 1 の ActiveUp の状態をデフォルトにリセットしたいなら:

     ButtonStyle 1 ActiveUp Default

ボタン 1 の全ての状態を、ボタン番号 2 のデフォルトにリセットしたいなら:

     ButtonStyle 1 Default 2

任意のボタンに対して、スタイルとフラグをカッコでくくれば 1 行で複数の状態に対する定義を指定できます。 1 行に 1 つの定義しかしないなら、カッコは不要です。

flags は指定した state に影響を与えます。任意の flag に "!" をつけるとその振舞いは否定されます。利用できる、全てのスタイルに対する状態依存フラグは、以下に記します (次の ButtonStyle の項では状態非依存フラグを扱います)。

"Raised" は、浮び上がったレリーフパターン (浮き彫り模様) を描画します。

"Sunk" は、沈み込んだレリーフパターンを描画します。

"Flat" は、レリーフパターンの描画を抑制します。

"UseTitleStyle" は、与えられたボタン状態に対して、ボタン自身のスタイルの前に現在のタイトルスタイルを描画させます。 TitleStyle の Raised, Flat, Sunk のフラグは、この文脈では冗長であり無視されます。

"UseBorderStyle" は、ボタンに装飾された BorderStyle のオプションを継承させます。

Raised, Sunk, Flat はお互いに排他的で、最初の ButtonStyle にだけ指定できます。 UseTitleStyle と UseBorderStyle も排他的です (しかし両方を同時に無効にはできます)。デフォルトは Raised で、UseBorderStyle と UseTitleStyle はどちらも設定されていません。

ActiveDown 状態に対する 重要な注意 があります。ボタンが押された場合、そのレリーフは逆転されます。このため、ActiveDown の状態で沈みこんだ状態にするには、望んだレリーフの正反対のものを指定する必要があるのです (すなわち、盛り上がっているような、押し込まれた見た目を作るには、 ActiveDown に Sunk を指定しなければいけません)。この仕様は首尾一貫したものなのですが、最初は紛らわしく見えるかもしれません。

ボタンスタイルは、非破壊的なもの、部分的に破壊的なもの、完全に破壊的なもの、に分類されます。非破壊的なスタイルは、画像に影響を与えません。部分的に破壊的なスタイルは、下に横たわる画像 (ピクスマップ画像) を部分的、または全ての部分を覆い隠すことができます。完全に破壊的なスタイルは下に横たわる画像全体を覆い隠します (Solid またはグラデーションスタイルの一つ)。よって、AddButtonStyle (またはタイトルバーに対する AddTitleStyle) でスタイルを積み上げている場合は、それが最小限の重ね塗りになるように並べ方に注意してください。

利用できるスタイルとその引数は、以下に記します (コンパイル時の設定によって、利用できないボタンスタイルがあるかもしれません)。

"Simple" スタイルは、何もしません。これには引数もありませんし、このスタイルは非破壊的なボタンスタイルの一例です。

"Default" スタイルは、条件的に一つの引数を受け付けます: それは読み込むデフォルトのボタン番号を指定する番号です。このスタイルコマンドが ButtonStyle か AddButtonStyle で与えられると、引数は必須ではなくなります (与えた場合は現在のボタン番号に上書きします)。 ButtonStyle と AddButtonStyle 以外で使われた場合は、番号は必ず指定しなければいけません。

"Solid" スタイルは、ボタンを非透過色で塗り潰します。レリーフの境界色は影響を受けません。その色は一つの引数で指定します。このスタイルは完全に破壊的です。

"Vector" スタイルは、直線による模様を描画します。これは標準的なボタンスタイルなので、キーワード "Vector" は省略できますが、その指定は少し厄介です:

     ButtonStyle 2 Vector 4 50x30@1 70x70@0 30x70@0 50x30@1

この指定は、ボタン 2 の装飾に 4 点パターンを使用していて、影の色 (@0) の (x=50,y=30) から (70,70) への線分、そこから影の色の (30,70) への線分、最後に明るい色 (@1) の (50,30) への線分から作られています。難しすぎますか ? 2,3 の例に関しては、.fvwm2rc のサンプルを参照してください。このスタイルは部分的に破壊的です。

"VGradient", "HGradient" スタイルは、グラデーションスタイルを表します。頭の H や V は、水平方向と垂直方向を意味します。

このスタイルは次の 2 つの形式を持ちます:

1 つ目の形式は、線形グラデーションを指定します。引数: 割り当てる色の総数 (2 から 128 まで)、最初の色、最後の色。

2 つ目の形式は、非線形グラデーションの指定です。引数: 割り当てる色の総数 (2 から 128 まで) と、いくつかのパラメータブロック。各ブロックで、最初の色、増加の割合 (%)、最後の色を指定します。各ブロックは、直前のブロックの色から開始します。全ての割合 (%) の合計は 100 である必要があります。

例:

     TitleStyle VGradient 16 3 Red 20 Blue 30 Black 50 Grey

グラデーションスタイルは完全に破壊的です。

"Pixmap" スタイルは、ピクスマップ画像を表示します。ピクスマップ画像は引数として指定します。例えば、以下のものは、ボタン 2 の両方の状態に同じピクスマップ画像を与え、ボタン 4 の up, down, inactive のそれぞれに異なるピクスマップ画像を与えます。

     ButtonStyle 2 Pixmap my_pixmap.xpm
     ButtonStyle 4 ActiveUp (Pixmap up.xpm) ActiveDown (Pixmap down.xpm)
     ButtonStyle 4 Inactive Pixmap inactive.xpm

ピクスマップ画像の指定は、絶対パス、相対パスのどちらの指定も可能です (PixmapPath 参照)。ピクスマップ画像が見つかない場合、ボタンスタイルは Simple に戻ります。 Pixmap スタイル特有のフラグは "Left", "Right", "Top", "Bottom" です。これらは、ピクスマップ画像の位置合わせに使われます (デフォルトは、両方向に対する中央合わせです)。ピクスマップ画像の透過性は、色 "None" に対して使用されます。このスタイルは、部分的に破壊的です。

"MiniIcon" スタイルは、Style コマンドの MiniIcon オプションが指定されたボタン内に、ウィンドウのミニチュアのアイコンを描画します。このボタンスタイルには引数はありません。例:

     Style "*"          MiniIcon mini-bx2.xpm
     Style "xterm"      MiniIcon mini-term.xpm
     Style "Emacs"      MiniIcon mini-doc.xpm

    ButtonStyle 1 MiniIcon

"TiledPixmap" スタイルは、ボタンの背景として、ピクスマップ画像をタイル張りします。引数としてピクスマップ画像を一つ指定します。ピクスマップ画像の透過性は使えません。このスタイルは、完全に破壊的です。

ButtonStyle button - [!]flag ...

これは、指定されたボタンに対し状態に依存しないフラグを設定します。状態に依存しないフラグは、ボタンの振舞いに影響を与えます。各フラグは、スペースで区切ります。"!" をフラグにつけると、その振舞いは否定されます。 "Clear" は特別なフラグで、これは存在する任意のフラグを消去します。

以下のフラグは、通常、MWM function hint によりどのボタンが影響を受けるべきなのかを fvwm に通知するのに使われます。これは、例えば複雑な関数をボタンに割り当てられるように、自動的には行われないようになっています。

"MWMDecorMenu" は、メニューを表示するタイトルバーボタンに割り当てます。デフォルトの割り当ては最も左のボタンです。 MWMFunction スタイルオプションを持つウィンドウがこのボタンを表示しないように要求した場合、それは隠されます。

"MWMDecorMin" は、ウィンドウを最小化、あるいはアイコン化するタイトルバーボタンに割り当てます。デフォルトの割り当ては、最も右から 2 つ目のボタンです。 MWMFunction スタイルオプションを持つウィンドウがこのボタンを表示しないように要求した場合、それは隠されます。

"MWMDecorMax" は、ウィンドウを最大化するタイトルバーボタンに割り当てます。デフォルトの割り当ては最も右のボタンです。 MWMFunction スタイルオプションを持つウィンドウがこのボタンを表示しないように要求した場合、それは隠されます。

ChangeDecor decor

これは、ウィンドウの装飾を decor に変更します。 decor は "Default"、または AddToDecor で定義された装飾の名前です。 decor が有効でない場合、何もしません。ウィンドウ内、あるいはその境界上のどこかで呼び出された場合は、そのウィンドウに影響を与えます。ルートウィンドウ上で呼び出された場合は、ユーザに対象となるウィンドウを選択させます。 ChangeDecor は、AddToDecor コマンドを使って設定できる属性にのみ影響を与えます。

ChangeDecor "CustomDecor1"

ClickTime delay

これには、組み込み関数がマウスクリック動作と認識する、ボタンを押してから離すまでの最大の時間間隔 (ミリ秒単位) を指定します。デフォルトの間隔は 150 ミリ秒です。

ウィンドウがウィンドウ削除プロトコルを受けつける場合はそのメッセージをウィンドウに送り、行儀よく消えてくれるか尋ねます。ウィンドウ削除プロトコルを理解しないウィンドウの場合は、そのウィンドウを破壊します。

ColormapFocus [FollowsMouse | FollowsFocus]

デフォルトでは、fvwm はカーソルが入っているウィンドウにカラーマップを割り当てます。 ColormapFocus FollowsFocus を使うと、カラーマップは、現在キーボードフォーカスのあるウィンドウのものになります。

Current [conditions] command

これは、現在のウィンドウがすべての conditions を満たした場合、そのウィンドウ上で command を実行します。条件 (conditions) は、以下のものから成ります: "Iconic", "!Iconic", "Visible", "!Visible", "Sticky", "!Sticky", "Maximized", "!Maximized", "Transient", "!Transient", "Raised", "!Raised", "CurrentDesk", "CurrentPage", "CurrentPageAnyDesk"。さらに、条件には、マッチさせようとするウィンドウの名前を書くこともできます。ウィンドウ名には、ワイルドカード *, ? を入れることも可能です。そのマッチするものの検索のときには、ウィンドウの名前、アイコン名、クラス名、リソースが考慮されます。ウィンドウ名の最初に ! を置くこともできますが、その場合、ウィンドウ名、アイコン名、クラス、リソースがそれにマッチする任意のウィンドウ上で、command の実行を防ぎます。

CursorMove horizontal vertical

これは、マウスポインタを X 方向に horizontal ページ、 Y 方向に vertical ページ移動します。これらの指定は負の値でも構いません。 horizontal, vertical の値はいずれもページサイズに対するパーセントを意味し、よって "CursorMove 100 100" は右下に丸々 1 ページ分動かすことになります。 "CursorMove 50 25" は右に 1 ページの半分だけ、下に 1 ページの 1/4 だけ動かすことを意味します。 CursorMove 関数は popup menu では使うべきではありません。

CursorStyle context cursornum

これは、指定された状況 (context) に対する新しいマウスカーソルを定義します。以下のような状況が指定できます。

     POSITION     - ウィンドウの初期配置時に使用 (XC_top_left_corner)
     TITLE        - ウィンドウタイトルバー内で使用 (XC_top_left_arrow)
     DEFAULT      - カーソル設定のないウィンドウ内で使用 (XC_top_left_arrow)
     SYS          - タイトルバーボタン上で使用 (XC_hand2)
     MOVE         - ウィンドウの移動とリサイズ時に使用 (XC_fleur)
     WAIT         - EXEC 組込みコマンド時に使用 (XC_watch)
     MENU         - メニュー上で使用 (XC_sb_left_arrow)
     SELECT       - アイコン化などの色々な組込みコマンド用 (XC_dot)
     DESTROY      - DESTROY, CLOSE, DELETE 組込みコマンド用 (XC_pirate)
     TOP          - ウィンドウの上端の境界線上で使用 (XC_top_side)
     RIGHT        - ウィンドウの右端の境界線上で使用 (XC_right_side)
     BOTTOM       - ウィンドウの下端の境界線上で使用 (XC_bottom_side)
     LEFT         - ウィンドウの左端の境界線上で使用 (XC_left_side)
     TOP_LEFT     - ウィンドウの左上角で使用 (XC_top_left_corner)
     TOP_RIGHT    - ウィンドウの右上角で使用 (XC_top_right_corner)
     BOTTOM_LEFT  - ウィンドウの左下角で使用 (XC_bottom_left_corner)
     BOTTOM_RIGHT - ウィンドウの右下角で使用 (XC_bottom_right_corner)

cursornum は、インクルードファイル X11/cursorfont.h で定義されているカーソルの番号です。例:

             # kill カーソルを XC_gumby にする:
             CursorStyle DESTROY 56

それぞれのデフォルトは上のカッコの中に書いてあります。

Delete

これは、ウィンドウに自分で消えてくれないかと尋ねるメッセージを送りますので、通常アプリケーションは終了させられます。

Desk arg1 arg2

これは他のデスクトップ (作業場、部屋とも呼ばれる) へ切り変えます。

arg1 が 0 でなければ切り代わる先のデスクトップ番号は、現在のデスクトップ番号 + arg1 です。デスクトップ番号は負でも構いません。

arg1 が 0 ならば、切り代わる先のデスクトップ番号は arg2 です。

有効 (active) なデスクトップの個数は動的に決定します。有効なデスクトップとは、ウィンドウを含むものか、現在表示されているものを言います。デスクトップ番号は -2147483648 から 2147483647 までの間である必要があります (それで十分でしょう ?)。

DeskTopSize HorizontalxVertical

これは、物理的なスクリーンサイズを単位とした、仮想デスクトップのサイズを定義します。

Destroy

これはアプリケーションウィンドウを破壊しますが、通常それはアプリケーション (のプロセス) を壊してつぶします。

DestroyFunc

これは関数を削除し、その後のその関数への参照が無効になるようにします。これは、fvwm を動作させながら関数の内容を変更する場合に使えます。その関数は AddToFunc を使って再構成できます。

DestroyFunc "PrintFunction"

DestroyDecor decor

これは、AddToDecor で定義した decor を削除し、それにより、この後この decor への参照が無効になります。この decor を使用しているウィンドウは fvwm のデフォルトの装飾に戻ります。 "Default" という名前の装飾は削除できません。

DestroyDecor "CustomDecor1"

DestroyMenu

これはメニューを削除し、その後のそのメニューへの参照が無効になるようにします。これは、fvwm を動作させながらメニューの内容を変更する場合に使えます。そのメニューは AddToMenu を使って再構成できます。

DestroyMenu "Utilities"

DestroyModuleConfig

これはモジュール設定行を削除し、新しい設定行を代わりに入れられるようにします。これは、fvwm を動作させながら、fvwm を再起動させることなしにモジュールの動作の方法を変更するのに使えます。さらにその名前にはワイルドカードを使うこともできます。

DestroyModuleConfig FvwmFormFore
DestroyModuleConfig FvwmButtons*

Echo string

これは、メッセージを stderr に出力します。これは、多分あなたの .fvwm2rc に書かれているものをデバッグするのに有用でしょう。

             Echo Beginning style defs...

EdgeResistance scrolling moving

これは、マウスがスクリーンの端を越えて動くときにデスクトップビューポートを変更すること、及びスクリーンの端を越えてウィンドウを動かすことの困難さを fvwm に伝えます。

最初のパラメータは fvwm がビューポートを動かす前にマウスポインタが何ミリ秒、スクリーンの端にいなければいけないかを意味します。これは、"EdgeScroll 100 100" を使うが、彼らが望まないときに不意にページを自分でジャンプさせてしまうような人を想定しています。

2 つ目のパラメータは、ウィンドウの端を、それが部分的にスクリーンから離れて実際に移動する前に、スクリーンの端を越えて何ピクセル動かさなければいけないか、を意味します。

"EdgeScroll 0 0" でも、現在のスクリーンの端をまたいでウィンドウの移動や大きさの変更 (resize) がまだ可能であることに注意してください。最初のパラメータを EdgeResistance 10000 にすることで、このような移動等はできなくなります。 EdgeResistance を 10000 未満 (しかし 0 よりは大) にすると、ページを越えることは難しくはなりますが不可能ではありません。

EdgeScroll horizontal vertical

これには、カーソルがページの端に当たったときにページを何パーセントスクロールさせるかを指定します。ページの端に当たっても、何のページの切り変えもスクロールも望まない場合は、あなたの .fvwm2rc ファイルに "EdgeScroll 0 0" と書いてください。ページ全体を丸々スクロールさせたいなら "EdgeScroll 100 100" としてください。 horizontal と vertical は正の数である必要があります。

horizontal と vertical のパーセントが 1000 倍された場合、デスクトップの端でのスクロールは反対の端に戻ります (1 巻につながった形式)。例えば "EdgeScroll 100000 100000" を使用すると、 fvwm はページを丸々スクロールし、デスクトップの端では反対の端につながった形式にします。

Exec command

これは command を実行します。Exec は、command の先頭に ’exec’ とつけたり、最後に ’&’ とつけたりする必要はありません。

以下の例はルートウィンドウ上で、修飾キーなしのファンクションキー F1 を exec 関数に割り当てています。プログラム rxvt は、オプション一揃いをともなって起動されます。

     Key F1 R N Exec rxvt -fg yellow -bg blue -e /bin/tcsh

ExecUseShell [shell]

これは、Exec コマンドに、デフォルトの Bourne shell (/bin/sh) の代わりに指定した shell か、または shell を指定しなかった場合は $SHELL 環境変数で定義されているものを使わせます。

     ExecUseShell
     ExecUseShell /usr/local/bin/tcsh

FlipFocus

これは最後にフォーカスした 2 つのウィンドウのフォーカスを入れかえます。

Focus

これは、必要なときに選択されたウィンドウが見えるように、ビューポートやウィンドウを移動します。そしてキーボードフォーカスを選択されたウィンドウに設定し、見えるのに必要ならウィンドウを前面に出します。しかしマウスポインタは選択されたウィンドウにはジャンプさせません (WarpToWindow 関数参照) し、アイコン化されているウィンドウを元に戻すこともしません。

Function nctionName

これは、あらかじめ定義された関数をキー、またはマウスボタンに割り当てるのに使われます。

以下の例は、マウスボタン 1 に "Move-or-Raise" と呼ばれる関数を割り当てます。この関数の定義は、このマニュアルの上の方の例にあります。この割り当ての行われた後、fvwm は、ウィンドウタイトルバーのどこでボタン 1 が押されても move-or-rase 関数を実行することになります。

     Mouse 1 T A Function Move-or-Raise

"FunctionName" が fvwm の組み込み関数の名前と一致しない場合、キーワード "Function" は省略できます。

GlobalOpts [options]

これは、いくつかの大域的なオプションを設定するのに使われる「一時的」なオプションで、これは今後 Style パラメータとして、あるいは Style パラメータへのオプションとして扱われることになるでしょう。現在は以下のものを扱います: SmartPlacementIsReallySmart/SmartPlacementIsNormal, ClickToFocusDoesntPassClick/ClickToFocusPassesClick, ClickToFocusDoesntRaise/ClickToFocusRaises, MouseFocusClickDoesntRaise/MouseFocusClickRaises

     GlobalOpts ClickToFocusDoesntPassClick, ClickToFocusDoesntRaise

GotoPage x y

これは、デスクトップビューポートをページ (x,y) に移動します。一番左上のページが (0,0) で、右上が (M,0) です。ここで、M は DeskTopSize コマンドで指定した現在の水平ページ数 (horizontal) より 1 だけ小さい数です。左下のページは (0,N) で右下は (M,N) です。ここで、N は DeskTopSize コマンドで指定した、デスクトップの垂直方向のサイズ (vertical) より 1 だけ小さい数です。この GotoPage 関数はポップアップメニューでは使うべきではありません。

HilightColor textcolor backgroundcolor

これは、現在キーボードフォーカスを持つウィンドウの装飾の文字色と背景色を設定します。

IconFont fontname

これは fvwm に、アイコンのラベル用として fontname のフォントを使用させます。これを省略した場合、(Font 設定変数で指定される) メニューフォントが代わりに使用されます。

Iconify [ value ]

これは、アイコン化されていないウィンドウをアイコン化し、アイコン化されたウィンドウを元のサイズに戻します。省略できる引数の value が正の場合は、アイコン化のみが行われます。オプション引数が負の場合はアイコンから元のサイズへの復帰のみが行われます。

IconPath path

これには、X11 ビットマップ形式 (白黒) のアイコン画像が置かれているディレクトリのフルパス名を、’:’ 区切りで指定します。それぞれのパスは ’/’ で始まっていなければなりません。環境変数をここで使用することもできます ($HOME や ${HOME} 等)。

注意: rc ファイル (初期設定ファイル) の解釈に FvwmM4 を使用している場合、 m4 は "include" という語を消そうとしますが、それは IconPath や PixmapPath コマンドの中によく現れます。この問題を解決するには、IconPath コマンドの前に undefine(‘include’) を追加するか、またはより良い方法は、オプション ’-m4-prefix’ を使って強制的に全ての m4 命令が "m4_" という接頭辞を持つことにすることです (FvwmM4 オンラインマニュアル参照)。

Key keyname Context Modifiers Function

これは、キーボードのキーを、指定された fvwm の組み込み関数に割り当てますが、 Function が ’-’ の場合はその割り当てを削除します。定義は、マウスの割り当てとほぼ同じで、そのマウス番号がキーに変わるだけです。 keyname は、/usr/include/X11/keysymdef.h (注: Solaris では /usr/openwin/include/X11/keysymdef.h) の中に書かれている項目のうちの一つで、その先頭の XK_ を取り除いたものです。引数 Context と Modifiers はマウスの割り当て Mouse と同様です。

以下の例は、マウスポインタがどこにあっても、 Alt-Ctrl-Shift-F11 が押された場合に、組み込みウィンドウリストをポップアップメニューに割り当てます:

     Key F11  A  SCM  WindowList

あるキーをあるタイトルバーボタンに割り当てたからといって、そのボタンへのマウス割り当ても存在する場合でなければ、そのボタンを表示させることはしません。

KillModule name

これは、name という名前で呼びだされたモジュールを終了させます。 name にはワイルドカードを使うこともできます。

Lower

これでウィンドウを下 (奥) に降ろせます。

Maximize [ horizontal vertical ]

オプション引数がない場合、Maximize はウィンドウを通常のサイズとフルスクリーンサイズとに交互に切り変えます。

オプション引数の horizontal と vertical を指定した場合、これらはフルスクリーンサイズの何パーセントであるかを意味しますが、ウィンドウの新しいサイズを制御できます。 horizontal が 0 より大きい場合、ウィンドウの水平方向のサイズは、 horizontal*(スクリーン幅)/100 に設定されます。垂直方向のサイズ変更も同様です。例えば以下のようにすると、ウィンドウの垂直サイズをフルスクリーンサイズに変更するタイトルバーボタンを追加します:

     Mouse 0 4 A Maximize 0 100

以下のようにすればウィンドウの幅がいっぱいの幅に広がります:

     Mouse 0 4 A Maximize 100 0

以下のものは、縦横の両方向がスクリーンサイズの半分になったウィンドウを作成します:

     Mouse 0 4 A Maximize 50 50

100 より大きい値は用心して使ってください。

文字 "p" を各座標 (horizontal, vertical) につけると、大きさの単位はピクセル単位になります。

Menu menu-name double-click-action

これは、あらかじめ定義されたメニューを "sticky" な ( くっついた) 方式でポップアップさせます。すなわち、ユーザがメニューをドラッグではなくクリックで呼び出した場合、メニューは消えずに出続けます。コマンド double-click-action は、メニューを作り出すときにユーザがダブルクリックした場合に呼び出されるものです。

MenuStyle forecolor backcolor shadecolor font style

これは、メニュースタイルを設定します。白黒を使用している場合は色は無視されます。 shadecolor は、メニューの選択画面を描画するのに使われますが、これは、あるアプリケーションが指定した mwm-hint

によって禁止 (あるいは非推奨) されています。オプション style は "fvwm", "mwm" のいずれかで、これはメニューの見た目を変更します。

Module ModuleName

これには、初期化の際に実行されるべきモジュールを指定します。現在利用できるモジュール (fvwm に含まれるもの) は、 FvwmAudio (ウィンドウマネージャの操作とともに音を生成), FvwmAuto (自動的に前面に持ち上げる), FvwmBacker (デスクトップを変えたときに背景を変える), FvwmBanner (ちょっとした XPM 画像を表示), FvwmButtons (カスタマイズ可能なツールバーを生成), FvwmCpp (.fvwm2rc を cpp で前処理), FvwmForm (対話型ツールの生成), FvwmIconBox (mwm IconBox のようなもの), FvwmIconManx (twm のアイコンマネージャのようなもの), FvwmIdent (ウィンドウの情報を取得), FvwmM4 (.fvwm2rc を m4 で前処理), FvwmPager ( デスクトップの小型表示), FvwmSave (デスクトップの状態を .xinitrc の形式で保存), FvwmSaveDesk (デスクトップの状態を fvwm コマンドの形式で保存), FvwmScroll ( 任意のウィンドウにスクロールバーを付加), FvwmTalk (fvwm コマンドを対話的に実行), FvwmWinList ( ウィンドウの一覧) です。これらのモジュールにはそれ自身のオンラインマニュアルがあります。また、fvwm には含まれない他のモジュールも存在します。

モジュールは短命の一時的なプログラムであっても構いませんし、 FvwmButton のように X との対話中ずっとい続けることもできます。モジュールは、ウィンドウマネージャが再起動するか終了する前に、可能ならばそれによって終了させられます。モジュールを紹介している節を参照してください。 ModuleName が全ての組み込み関数名、および関数名と違っていれば、キーワード "module" は省略することができます。

ModulePath path

これには、fvwm がモジュールを読み込むときにそれを探すパスのリストを環境変数ここで使用することもできます ($HOME や ${HOME} 等)。

Mouse Button Context Modifiers Function

これは、マウス割り当てを定義しますが、 Function が ’-’ の場合は逆にマウス割り当てを削除します。 Button はボタン番号です。Button が 0 の場合は、任意のボタンで指定された関数が実行されます。 Context ( コンテキスト) は、どこに割り当てが適用されるかを記述します。有効なコンテキストは R (ルートウィンドウ)、W (アプリケーションウィンドウ)、 T (ウィンドウタイトルバー)、S (上下左右のウィンドウの境界にあるサイドバー)、 F (ウィンドウの角にある L 字型のウィンドウフレーム)、 I (アイコンウィンドウ)、0 から 9 までの数字 (タイトルバーボタン)、またはこれらの文字の任意の組み合わせです。 A は、タイトルバーを除く任意のコンテキストを意味します。例えば、FST というコンテキストは、タイトルバーボタン以外の、ウィンドウの境界全てに適用されることになります。

Modifiers (修飾キー) は、N (修飾キーなし)、C (Ctrl キー)、 S (Shift キー)、M (Meta キー)、A (任意の修飾キー) の任意の組み合わせです。例えば、SM という Modifier は Meta キーと Shift キーの両方が押された場合に適用されます。 X11 で定義される修飾キー mod1 から mod5 も、数字の 1 から 5 で表現されます。

Function には、fvwm の組み込み関数の一つを与えます。

タイトルバーボタンは、奇数番号は左に、偶数番号は右に番号づけされています。小さい番号のボタンがウィンドウの外側へ、大きい番号のボタンがウィンドウの真ん中に来るように表示されます (0 は 10 の省略形)。要するに、

     1 3 5 7 9    0 8 6 4 2

のようになります。動作が割り当てられた最も大きい奇数番号のボタンは、タイトルバーの左側に表示されるボタンの数を決定し、最も大きい偶数番号のボタンは右側に表示されるボタンの数を決定します。動作はマウスボタンにも、キーボードのキーにも割り当て可能です。

Move [ x y ]

これは、ユーザがウィンドウを動かせるようにします。ウィンドウ内部、またはその境界のどこかから呼び出された場合、そのウィンドウが移動されます。ルートウィンドウで呼び出された場合、ユーザはその後、移動するウィンドウを選択することになります。

オプション引数の x, y を指定した場合、ウィンドウはその左上の角がその場所 (x,y) になるように移動されます。 x, y の単位はスクリーンの百分率ですが、文字 "p" が各座標値に追加されるとそれはピクセル単位での指定となります。

例:

     Mouse 1 T A Move
     Mouse 2 T A Move 10 10
     Mouse 3 T A Move 10p 10p

最初の例では、対話的な移動が指示されています。 2 つ目の例は、タイトルバーが選択されたウィンドウを、その左上の角がスクリーンの左端からスクリーン幅の 10% だけ右、スクリーンの上からスクリーンの高さの 10% だけ下の位置に移動します。最後の例は、ウィンドウを (10,10) ピクセルの座標の位置に移動します。

Nop

これは何もしません。これは、メニューに空行や分離線を入れるのに使われます。メニュー項目として Nop " " を指定すると空行が挿入され、 Nop "" とすると分離線が挿入されます。これは、メニューに対するダブルクリック動作用にも使うことができます。

Next [conditions] command

これは、例えば Focus のような command を、全ての conditions (条件) を満たす次のウィンドウに実行します。条件は Current のものに加え、 CirculateSkip スタイル属性を無効にする CirculateHit、アイコン化されたウィンドウの CirculateSkipIcon スタイル属性を無効にする CirculateHitIcon が使えます。

None [conditions] command

これは、全ての conditions (条件) を満たすウィンドウが存在しない場合に command を実行します。条件は、Next のものと全く同じものが使えます。

OpaqueMoveSize percentage

これは、fvwm に、不透過型ウィンドウ変化を使うべき最大ウィンドウサイズを知らせます。 percentage は全スクリーン領域に対する百分率を意味します。 "OpaqueMove 0" の場合、全てのウィンドウが旧式のゴムひも型の外枠 (透過型ウィンドウ変化) を使って移動され、 "OpaqueMove 100" では、全てのウィンドウが、ちゃんと中身の詰まったウィンドウとして移動されます。デフォルトは "OpaqueMove 5" で、これにより小さなウィンドウは不透過的に、大きなウィンドウはゴムひもで移動することになります。

PipeRead cmd

これは、fvwm に cmd という名前のプログラムから出力されるコマンドを読み込まさせます。これは、例えば、あるディレクトリの内容に応じて動的にメニュー項目を作り上げる、といった場合に有用です。

PixmapPath path

これには、ピクスマップ形式 (カラー) のアイコン画像が置かれているディレクトリのフルパス名を、それぞれのパスは ’/’ で始まっていなければなりません。環境変数をここで使用することもできます ($HOME や ${HOME} 等)。

Popup PopupName

この組み込み関数は、2 つの目的を持っています: 一つは、メニューをキーやマウスボタンに割り当てること、もう一つは、メニューに子メニューを割り当てることです。それぞれの書式は、少し違いがあります。

あらかじめ定義されたポップアップメニューを、キーまたはマウスボタンに割り当てる方法:

次の例は、"Window Ops" と呼ばれるポップアップメニューをマウスボタン 2,3 に割り当てます。メニューは、ウィンドウフレームかサイドバー、タイトルバーで修飾キー (Shift,Ctrl,Meta) なしでボタン 2, 3 のどちらかが押された場合にポップアップします。

     Mouse 2 FST N Popup "Window Ops"
     Mouse 3 FST N Popup "Window Ops"

ポップアップメニューは、組み込み関数 Key を使って、キーに割り当てることも可能ですし、キーに割り当てればマウスなしで、上下の矢印キーとリターンキーで操作することも可能です。

あらかじめ定義されたポップアップメニューを、他のメニューに子メニューとして割り当てる方法:

以下の例は子メニュー "Quit-Verify" を定義し、それを "RootMenu" という親メニューに割り当てています:

     AddToMenu Quit-Verify   "Really Quit Fvwm?" Title
     +                       "Yes, Really Quit"  Quit
     +                       "Restart Fvwm2"     Restart fvwm2
     +                       "Restart Fvwm 1.xx" Restart fvwm
     +                       ""                  Nop
     +                       "No, Don’t Quit"    Nop

    AddToMenu RootMenu      "Root Menu"         Title
     + "Open an XTerm Window"  Popup NewWindowMenu
     + "Login as Root"         Exec xterm -fg green -T Root -n Root -e su -
     + "Login as Anyone"       Popup AnyoneMenu
     + "Remote Hosts"          Popup HostMenu
     + ""                      Nop
     + "X utilities"           Popup Xutils
     + ""                      Nop
     + "Fvwm Modules"          Popup Module-Popup
     + "Fvwm Window Ops"       Popup Window-Ops
     + ""                      Nop
     + "Previous Focus"        Prev [*] Focus
     + "Next Focus"            Next [*] Focus
     + ""                      Nop
     + "Refresh screen"        Refresh
     + "Recapture screen"      Recapture
     + ""                      Nop
     + "Reset X defaults"      Exec xrdb -load $HOME/.Xdefaults
     + ""                      Nop
     + ""                      Nop
     + "Quit"                  Popup Quit-Verify

Popup は、単なるクリックでは居続けない、という点で Menu と異なります。居続けないのは Twm スタイルのポップアップメニューですが、これはやや手首に負担となります。 Menu は、Motif、あるいは Microsoft-Windows スタイルのメニューで、単一クリック動作で居続けます。

Prev [conditions] command

これは、例えば Focus のような command を、全ての conditions (条件) を満たす前のウィンドウに実行します。条件は、Next と同じです。

	Quit		これは fvwm を終了しますが、それは通常 X の終了も引き起こします。
	Raise		これでウィンドウを上 (手前) に上げることができます。

RaiseLower

上 (下) がっているウィンドウを下 (上) に下 (上) げます。

Read filename

これは fvwm に filenameP という名前のファイルからコマンドを読み込まさせます。

Recapture

これは fvwm に、全てのウィンドウ管理をやり直させます (ウィンドウの再捕獲)。これは、直前のスタイルパラメータを確実に使用します。再捕獲の際には画面が乱されます。

Refresh

これはスクリーンの全てのウィンドウを再描画させます。

RefreshWindow

これは現在 (あるいは選択された) ウィンドウにそれ自身を再描画させます。

Resize [ x y ]

これによりウィンドウの大きさの変更 (リサイズ) が行えます。

オプション引数 x, y が与えられた場合、ウィンドウはその大きさが横 x, 縦 y であるように変更されます。 x, y の単位はスクリーンに対する百分率ですが、文字 "p" を各座標につけた場合はピクセル単位となります。

Restart WindowManagerName

これは、WindowManagerName が "fvwm2" の場合は、 fvwm を再起動させますし、 WindowManagerName が "fvwm2" 以外の場合は、その他の指定されたウィンドウマネージャに切り替えます。そのウィンドウマネージャがデフォルトの検索パスにない場合、 WindowManagerName はフルパスで指定する必要があります。

このコマンドは、後ろに & やコマンドライン引数をつけてはいけませんし、環境変数を使うようにしてもいけません。以下の例では、最初の 2 つのものは確かに失敗しますが、 3 つ目のものは OK です:

     Key F1 R N Restart fvwm &
     Key F1 R N Restart $(HOME)/bin/fvwm
     Key F1 R N Restart /home/nation/bin/fvwm

SendToModule modulename string

これは、任意の文字列 (引用符で囲む必要はありません) を、 modulename にマッチする全てのモジュールに送ります。 modulename には、ワイルドカードを使うこともできます。これは、そのモジュールが文字列を認識し処理するように作られている場合にのみ意味を持ちます。そして、これはモジュール間の通信や、モジュール内のより複雑な実装に利用することができます。

Scroll horizontal vertical

これは仮想デスクトップのビューポートを、 x-方向に horizontal ページだけ、 y 方向に vertical ページだけスクロールします。一方、あるいは両方の指定は負の値にもできます。 horizontal と vertical の両方の単位は、ページのサイズに対する百分率 (パーセント) ですから、 "Scroll 100 100" は丸々 1 ページ分だけ右下にスクロールすることを意味し、 "Scroll 50 25" は右にページの半分、下にページの 1/4 だけスクロールします。スクロール関数はポップアップメニューからは呼んではいけません。スクロールは通常そのデスクトップの端で止まります。

horizontal と vertical の百分率が 1000 倍してあると、スクロールはデスクトップの端を越えて反対側の端に戻ります。 "Scroll 100000 0" が何度も実行された場合、 fvwm は各実行で隣のデスクトップへ移動し、そしてデスクトップの端で巻き戻しされ最初のデスクトップに戻りますので、順番に全てのページに当たることになります。

文字 "p" を各座標 (horizontal や vertical) の後ろに追加すると、スクロールの単位はピクセルになります。

Stick

これは、そのウィンドウが現在 sticky でない場合は sticky にして、それが現在 sticky の場合は sticky でない状態にします。

Style windowname options

このコマンドは古い fvwm 1.xx の大域的なコマンド: NoBorder, NoTitle, StartsOnDesk, Sticky, StaysOnTop, Icon, WindowListSkip, CirculateSkip, SuppressIcons, BoundaryWidth, NoBoundaryWidth, StdForeColor, StdBackColor を、柔軟で包括的なウィンドウ毎の単一のコマンドに置き換えようとします。このコマンドは、ウィンドウの属性にデフォルトとは異なる値を設定したり、ウィンドウマネージャのデフォルトスタイルを設定したりするのに使われます。

windowname は、ウィンドウ名、ウィンドウクラス、またはリソース文字列のいずれでも構いません。これにはワイルドカード *, ? を含めることも可能ですが、これらは通常の Unix のファイル名に使われる場合と同じ意味です。これらは上に述べたことの逆順に検索され、それによりリソース文字列による Style コマンドはクラス名による Style コマンドで上書き、あるいは追加され、クラス名による Style コマンドは名前による Style コマンドで上書き、あるいは追加されます。

options は、以下のキーワードの幾つかを含む、, (コンマ) で区切られたリストです: BorderWidth, HandleWidth, NoIcon/Icon, MiniIcon, IconBox, NoTitle/Title, NoHandles/Handles, WindowListSkip/WindowListHit, CirculateSkip/CirculateHit, StaysOnTop/StaysPut, Sticky/Slippery, StartIconic/StartNormal, Color, ForeColor, BackColor, StartsOnDesk/StartsAnyWhere, IconTitle/NoIconTitle, MWMButtons/FvwmButtons, MWMBorder/FvwmBorder, MWMDecor/NoDecorHint, MWMFunctions/NoFuncHint, HintOverride/NoOverride, NoButton/Button, OLDecor/NoOLDecor, StickyIcon/SlipperyIcon, SmartPlacement/DumbPlacement, RandomPlacement/ActivePlacement, DecorateTransient/NakedTransient, SkipMapping/ShowMapping, UseStyle, NoPPosition/UsePPosition, Lenience/NoLenience, ClickToFocus/SloppyFocus/MouseFocus|FocusFollowsMouse

上のリストにおいて、いくつかのオプションはスタイルオプション/反スタイルオプションの形式になっています。反スタイルオプションが含まれている項目では、それが fvwm でのデフォルトを意味し、それは fvwm のデフォルトの振舞いを変更したい場合に利用できます。

Icon は、アイコンの白黒画像またはカラー画像として使用するファイル名を、引用符には入れない文字列引数として取ります (オプション引数)。

IconBox は数値引数を取ります:

IconBox

l t r b

ここで、l は左の座標で、同様に t は上、r は右、b は下の座標です。負の座標は、スクリーンの右下からの距離を意味します。アイコンボックスはスクリーン内のある領域で、 fvwm は他のアイコンと重ならない限りアイコンをそのウィンドウに出力しようとします。

MiniIcon は、ウィンドウに対する小型アイコンとして使用するピクスマップ画像ファイルを指定します。この小型アイコンは、タイトルバーボタンの中に描くことができます (ButtonStyle 参照) し、色々な fvwmモジュール (FvwmWinList, FvwmIconMan, FvwmTaskBar) で利用できます。これは、一つの引数としてピクスマップ画像ファイルの名前を取ります。

StartsOnDesk は、そのウィンドウが最初に置かれるべきデスクトップ番号を引数に取ります。標準的な Xt プログラムではそれをリソースを使っても指定できる (例えば "-xrm ’*Desk: 1’") ことに注意してください。

StaysOnTop は、そのウィンドウが常に他のウィンドウの一番上 (手前) にいるように努力させます。これは、時計や郵便箱のように常に見えていたいと思うようなものに対して便利です。そのウィンドウが明示的に下げられた (奥に移動された) 場合、それが明示的に上げられるまで、強制的には一番上に戻そうとはしません。 StaysPut (これがデフォルト) は、そのウィンドウが隠されて、その状態でいつづけることを許します。

BorderWidth は、リサイズハンドルを持たないウィンドウにつける境界の幅を引数として取ります。

HandleWidth は、リサイズハンドルを持つウィンドウにつける境界の幅を引数として取ります。

Button と NoButton は、タイトルバーに含まれる/取り除かれるボタンの個数を引数として取ります。

StickyIcon は、ウィンドウを、それがアイコン化されたときに sticky (くっついたもの) にするので、有効なデスクトップの上でアイコンを元のウィンドウに復元できます。

MWMButtons は、そのウィンドウが最大化されたときに、最大化ボタンを押しこまれた見た目にします。詳細は、ButtonStyle の MWMButton フラグの項を参照してください。

MWMBorder は、より mwm のものに近い 3 次元の斜面を作ります。

MWMDecor は、fvwm に、mwm の装飾ヒント情報を認識させ、考慮させようとします。ときどきそれを利用するアプリケーションがあります。

MWMFunctions は、fvwm に、mwm 禁止操作ヒント情報を認識させ、考慮させようとします。ときどきそれを利用するアプリケーションがあります。 HintOverride は fvwm に mwm が禁止する操作を隠しますが、これはあなたにとにかくその操作を行わさせます。

OLDecor は、fvwm に olwm や olvwm のヒント情報を認識させ、考慮させようとします。これらは大くの古い XView や OLIT アプリケーションが使用します。

Color は 2 つの引数を取ります。最初の引数は、ウィンドウラベル文字列色で、 2 番目のものはウィンドウの飾りの通常の背景色です。この 2 つの色はスラッシュ (/) で分離して指定します。スラッシュを使うと問題がある場合は、別々にオプション ForeColor と BackColor

を使用することもできます。

UseDecor は一つの引数を受けつけ、それは AddToDecor で生成された装飾 (decor) の名前です。 UseDecor が指定されない場合、"Default" の装飾が使用されます。ウィンドウは実際には装飾を含んでいませんが、常にその一つに結びつけられています。装飾が後で AddToDecor で変更された場合、それに結びつけられたすべてのウィンドウの見た目が変わります。あるウィンドウの装飾は、ChangeDecor で再割り当てすることができます。

UseStyle は引数を一つ取り、それは他のスタイルの名前です。この方法では無関係なウィンドウ名を使うことができますが、これにより新ためて設定し直すことなしにそれと同様の性質を継承することができます。例: ’Style "rxvt" UseStyle "XTerm"’

SkipMapping は、fvwm にそのウィンドウが最初に配置されるときに、それが乗っているデスクトップを変更しないように伝えます (StartsOnDesk で有用です)。

Lenience は、ICCCM の勧告を無視するように fvwm に指示します。これは、あるアプリケーションが wm_hints 構造体の input フィールドを False にセットした場合は、それはウィンドウマネージャがそれに入力フォーカスを渡すことを決して望まない、と述べています。私が知る、これを必要とする唯一のアプリケーションは sxpm ですが、それは簡単に修正されるばかげたバグであり、そのプログラムへの全体的な効果は全く何もありません。他にも問題を持つ古いアプリケーションがあるという噂です。

ClickToFocus は、そのウィンドウがクリックされたときにフォーカスをそのウィンドウに与えるように fvwm に指示します。デフォルトである MouseFocus (またはその別名である FocusFollowsMouse) は、マウスポインタがそのウィンドウに入ったときに直ちにフォーカスをそのウィンドウに与え、ポインタがウィンドウから出たらフォーカスも持ち去るように fvwm に指示します。 SloppyFocus も同様ですが、ポインタがウィンドウから出てもルートウィンドウや ClickToFocus ウィンドウ上を通過している間 (そこでクリックしていない場合) はフォーカスを手放しません。 ClickToFocus は、フォーカスを失わずにマウスを外に出すことを可能にします。

NoPPosition は、新しいウィンドウを追加したときに、 PPosition フィールドを無視するように fvwm に指示します。 PPosition フィールドに固執するアプリケーションもあるのですが、そういったものを持っていなければ、これは頭の痛い問題です。

RandomPlacement は、通常ユーザに配置させるウィンドウを、ごくわずかにランダムな位置に自動的に配置しようとします。最もいいのは RandomPlacement と SmartPlacement の両方を使うことです。

SmartPlacement は、通常ユーザに配置させるウィンドウを、スマートな位置、つまりそのスクリーン上の他のウィンドウとは重ならない位置に自動的に配置しようとします。そのような場所が見つからなかった場合は、最後の手段としてユーザ配置、またはもし指定されていればランダム配置 (RandomPlacement) が使用されます。最もいいのは、RandomPlacement と SmartPlacement の両方を使うことです。

例:

     # fvwm のデフォルトの挙動を、タイトルバーなしに変更
     # デフォルトのアイコンも定義
     Style "*" NoTitle,Icon unknown1.xpm, BorderWidth 4,HandleWidth 5

    # ウィンドウ毎の変更:
     Style "Fvwm*"     NoHandles,Sticky,WindowListSkip,BorderWidth 0
     Style "FvwmPager"                  StaysOnTop, BorderWidth 0
     Style "*lock"     NoHandles,Sticky,StaysOnTop,WindowListSkip
     Style "xbiff"               Sticky,           WindowListSkip
     Style "FvwmButtons" NoHandles,Sticky,WindowListSkip
     Style "sxpm"      NoHandles
     Style "makerkit"

    # タイトルバーを xterm にのみ復活
     Style "xterm"     Title, Color black/grey

    Style "rxvt"      Icon term.xpm
     Style "xterm"     Icon rterm.xpm
     Style "xcalc"     Icon xcalc.xpm
     Style "xbiff"     Icon mail1.xpm
     Style "xmh"       Icon mail1.xpm, StartsOnDesk 2
     Style "xman"      Icon xman.xpm
     Style "matlab"    Icon math4.xpm, StartsOnDesk 3
     Style "xmag"      Icon magnifying_glass2.xpm
     Style "xgraph"    Icon graphs.xpm
     Style "FvwmButtons" Icon toolbox.xpm

    Style "Maker"     StartsOnDesk 1
     Style "signal"    StartsOnDesk 3

ウィンドウに対する全ての属性は、OR で認識されることに注意してください。上の例では、"FvwmPager" はウィンドウ名が完全に一致する行により属性 StaysOnTop を取得しますが、 "Fvwm*" にもマッチするために NoHandles, Sticky, WindowListSkip も取得し、 "*" にもマッチするために NoTitle も取得します。一つのウィンドウに対して相反するスタイルが指定された場合は、最後に指定されたスタイルが使われます。

NoIcon 属性がセットされると、指定されたウィンドウはそれがアイコン化されたときに単に消えてしまいます。そのウィンドウはウィンドウリストから復帰できます。 Icon が引数なしにセットされた場合、NoIcon 属性が解除されますがアイコンは何も指定されていないことになります。 FvwmPager モジュールアイコンのみ存在することを許す例:

     Style "*" NoIcon
     Style "FvwmPager" Icon

Title

これは何もしません。これは popup や menu にタイトル行を挿入するのに使われます。

TitleStyle [justification] [height num]

これは、タイトルバーに対する属性を設定します。 justification には、"Centered", "RightJustified", "LeftJustified" を指定できます。 height は、ピクセル単位でのタイトルバーの高さを設定します。デフォルトは Centered で WindowFont の高さです。 WindowFont コマンドは、指定されたフォントに対するデフォルトに高さをリセットするので、パラメータ height はこのコマンドの後でセットする必要があります。例:

     TitleStyle LeftJustified Height 24

TitleStyle [state] [style] [ -- [!]flag ... ]

これは、タイトルバーのスタイルを設定します。 state は、"ActiveUp", "ActiveDown", "Inactive" のいずれかです。 state が省略された場合、そのスタイルはすべての状態 (state) に対して追加されます。スタイルとフラグをカッコで囲めば、複数の状態に対する定義を 1 行で指定することができます。 style は省略することができ、それにより現在のスタイルを破壊せずにフラグのみ設定することができます。

"!" が任意の flag の前に置かれた場合、その振舞いは否定されます。各状態に対する利用可能なフラグに、"Raised", "Flat", "Sunk" (これらは互いに排他的) があります。デフォルトは Raised です。状態 ActiveDown に関しては、ButtonStyle の項目の中の注意を参照してください。例:

     TitleStyle ActiveUp HGradient 16 navy black
     TitleStyle ActiveDown (Solid red -- flat) Inactive (TiledPixmap wood.xpm)
     TitleStyle ActiveUp (-- Flat) ActiveDown (-- Raised) Inactive (-- Flat)

これは、ActiveUp の状態に水平方向のグラデーションを設定し、 ActiveDown の状態にべったりした赤を、そして Inactive の状態にタイル張りの木目 (wood) のピクスマップ画像を設定します。そして最後に ActiveUp は平らな見た目に設定され、 ActiveDown は沈みこんだものに設定され (Raised のフラグは ActiveDown 状態に対しては、レリーフの逆転の仕様により、沈みこんだ形 (Sunk) になります)、 Inactive は平らに設定されます。すべての状態にフラグを設定する例:

     TitleStyle -- flat

平らな見た目を設定するには:

     TitleStyle -- flat
     ButtonStyle All ActiveUp (-- flat) Inactive (-- flat)

UpdateDecor decor

これはウィンドウの装飾を更新します。 decor はオプション引数で、これには更新する装飾を指定します。それが指定された場合、その特定の decor に結びつけられたウィンドウのみが更新されます。このコマンドは、例えば、ButtonStyle, TitleStyle, BorderStyle (多分 AddToDecor との組み合わせで使用されます) の後で有用でしょう。無効な装飾を指定すると、結果としてすべてのウィンドウが更新されます。このコマンドは Recapture ほどはかき乱しませんが、 Recapture ほどにはウィンドウスタイルオプションに影響を与えません。

WarpToWindow x y

これは、カーソルを関連づけられたウィンドウへジャンプさせます。パラメータ x, y はデフォルトでの位置で、ウィンドウの左上の角から右下への百分率で表した値です (’p’ を数字に追加した場合はピクセル単位になります)。

Wait name

この組込み関数は、fvwm 関数内でのみ使われることを意図しています。これは関数の実行を、name という名前の新しいウィンドウが現われるまで一時停止します。fvwm はその停止の間完全に機能し続けます。これは、特に InitFunction 内で、ウィンドウを指定したデスクトップ上で起動したい場合に便利です:

     AddToFunc InitFunction "I" exec xterm -geometry 80x64+0+0
     +                      "I" Wait xterm

+ "I" Desk

		0 2 + "I" Exec
		xmh -font fixed -geometry 507x750+0+0

+ "I" Wait xmh
+ "I" Desk 0 0

上の関数は、xterm を現在のデスクトップ上で起動し、それが配置されるまで待ち、そしてデスクトップ 2 に切りかえて xmh を起動します。xmh ウィンドウが現れた後で、制御をデスクトップ 0 に移します。

WindowsDesk arg1 [arg2]

これは、選択したウィンドウを他のデスクトップ (作業空間、部屋) に移動します。

arg1 が 0 でなければ、次のデスクトップ番号は、現在のデスクトップ番号 + arg1 になります。デスクトップ番号は負も使えます。

arg1 が 0 ならば、新しいデスクトップ番号は arg2 になります。

一つの引数だけが与えられた場合、これは選択したウィンドウを arg1 に移動します。

WindowFont fontname

これは、ウィンドウのタイトルバー用に、"fixed" の代わりに fontname という名前のフォントを fvwm に使わせます。

WindowId id func

WindowId 関数は、指定したウィンドウ id を探してその上で指定した func (関数)を実行する以外は、 Next や Prev 関数と同じです。

     WindowId 0x34567890 Raise
     WindowId 0x34567890 WarpToWindow 50 50

これは、主に WindowList 組込み関数で使用される関数で有用です。

WindowList [options]

これは、現在のデスクトップの個々のウィンドウのタイトルや位置情報が表示されるポップアップメニューを生成 (そしてそれをポップアップ) します。アイコン化されたウィンドウの位置情報はカッコ内に表示されます。そのウィンドウの一覧のポップアップメニューから一つの項目を選択すると、デフォルトでは、$0 として渡されるウィンドウのウィンドウ ID を与えてそれを解釈する関数 WindowListFunc を実行させます。デフォルトでは WindowListFunc は以下のようになっています:

     AddToFunc WindowListFunc "I" WindowId $0 Iconify -1
     +                        "I" WindowId $0 Focus
     +                        "I" WindowId $0 Raise
     +                        "I" WindowId $0 WarpToWindow 5p 5p

これらのデフォルトが気にいらなければ、WindowListFunc 組込み関数を破壊し、自分で作ることができます。

WindowList に渡されるオプション options は "NoGeometry", "Function <funcname>", "Desk <desknum>", "CurrentDesk", "NoIcons", "Icons", "OnlyIcons", "NoNormal", "Normal", "OnlyNormal", "NoSticky", "Sticky", "OnlySticky", "NoOnTop", "OnTop", "OnlyOnTop", "Unsorted", "UseIconName", "Alphabetic", "NotAlphabetic" です。

( 注意: Normal は、NoIcons かつ Sticky かつ OnTop を意味します)

ある関数を "Function <funname>" で渡す場合、$0 はウィンドウ ID です:

     AddToFunc IFunc "I" WindowId $0 Iconify
     WindowList Function IFunc, NoSticky, CurrentDesk, NoIcons

WindowList をアイコンマネージャとして使うには、以下のようにすれいいでしょう:

     WindowList OnlyIcons, Sticky, OnTop, Geometry

(注意: オプション "Only" は、他のものすべてを一掃します)

WindowShade [ opt ]

これは、タイトルのついたウィンドウに対するウィンドウの日陰機能を On/Off します。日陰状態にあるウィンドウは、タイトルバーのみが表示されます。 opt が与えないとウィンドウの日陰機能が On/Off されます。 opt が 1 の場合は、そのウィンドウは強制的に日陰状態にされます。 opt が 2 の場合は、そのウィンドウは強制的に日向状態にされます。最大化されたウィンドウとタイトルのないウィンドウは日陰状態にはできません。

XORvalue number

これは、ゴムひも状のウィンドウの移動やサイズ変更を行うときに、値をビット毎の XOR で変更します。この値の設定は試行錯誤で行ってください。

これは、直前に指定された装飾や関数、メニューに追加し続けるのに使われます。 AddToDecor や AddToFunc, AddToMenu での議論を参照してください。

キーボードショートカット

全て (私の考えるに) のウィンドウマネージャの操作は、キーボードから行うこともでき、マウスなしの操作が可能になっています。 Scroll 組込み関数を適当なキーに割り当てることで仮想デスクトップを巡回できるだけでなく、ポップアップ、移動、サイズ変更、その他ほとんどの組込み関数をキーに割り当てられます。その場合組込み関数が一度開始されると、マウスポインタは上下左右の矢印キーを使って移動され、その動作はリターンを打つことで終了します。シフトキーを押すとポインタの移動はより大きなステップになり、コントロールキーを押すとポインタの移動はより小さなステップになります。矢印キーの代わりに、標準的な emacs や vi のカーソル移動制御 (^n, ^p, ^f, ^b, 及び ^j, ^k, ^h, ^l) を使うこともできます。

設定例の提供

fvwm 配布物に、設定ファイル .fvwm2rc のサンプルファイルが提供されています。これには十分にコメントが書かれていて、 fvwm の設定ファイルの設定例の原本として使用できます。

マルチスクリーンディスプレイ上での使用について

コマンドライン引数 -s を指定しないと、fvwm は自動的に指定されたディスプレイの全てのスクリーン上で起動します。 fvwm が起動した後では個々のスクリーンは独立したものとして扱われ、 fvwm の再起動も、各スクリーンで別々に行わなくてはなりません。マルチスクリーンディスプレイでは、EdgeScroll 0 0 を使用することを強く推奨します。

X との対話を完全に終了するには、個々のスクリーンで終了する必要があるでしょう。

fvwm 0.99 の時点では、丁度 39.342 個の正体不明のバグがありましたが、確認されたバグはほとんど修正され、その後 9.34 個のバグが修正されました。確認されたバグ一つに対して、少なくとも 10 個のバグが存在すると仮定すると、 39.342 - 9.34 + 10 * 9.34 = 123.402 個の正体不明のバグが現在まだ残っていることになります。この理屈の論理的帰結に従えば、プログラムのバグがない状態にまでバグの個数が減少する前に、正体不明なバグの個数が無限大になってしまうことになるでしょう。しかし倍精度まで要求しなければ、これはコンピュータプログラムでの無限大 = 3.4028e+38 ですから、現在のバグ発見の割合では、 3.37e+27 年にはバグなしの状態に達する見通しです。私はこのことを引き継いでいこうと考えています。私の子供達に...

確認されているバグは、配布物のファイル BUGS、および TO-DO のリストに書かれています。

バグリポートは FVWM メーリングリストに送ることができます (FAQ を参照)。

著者

多くの人々の助力により、Tom LaStrange によって書かれた twm のコードを元に Robert Nation によって作成されました。しかし Rob は fvwm の作業からは ’引退’ したので、現在は Charles Hines がその世話と供給を保守しています。