
	Yet Another お座りマルチ for X11　第１版
								'98/11/25 by なかなか

* 概要 --------------------------------------------------------

ウィンドウのタイトルバー上に、可愛らしい「マルチ」が座ります。
このソフトは、MS-Windows 版「お座りマルチ（ヨッシー氏作）」を
UNIX X11-Window に移植したものです。

メール到着をお知らせするBiff機能が付いており、
ちょっとだけ役に立つようになっています :-)

オリジナル「お座りマルチ」 for MS-Windows は
	http://www.vc-net.or.jp/~yoshy/
で入手することができます。

* 動作環境 ----------------------------------------------------

X-Window 汎用です。
Shape Extention を使用しているので X11R4 以降になります。
プログラムには基本的な Xlib 以外は使用していないので、
大抵の環境で動作すると思います。

いまのところ２５６色以上のディスプレイのみに対応しています。
モノクロ、グレイスケールには未対応です。

いまのところ以下のＯＳで動作しています。
	FreeBSD 2.2.2 + twm
	HP-UX 10.20
	Turbo Linux 2.0

* コンパイル方法 ----------------------------------------------

 1: 日本語メッセージが環境に合ったコードになっていることを確認する。
	
	メッセージデータは message.c の中に書かれている。
	これがＥＵＣ（あるいは環境に合った）コードになっているかどうか確かめる。
	オリジナルのソースファイルはＥＵＣコードで書かれているので、
	通常は問題ないでしょう。
	
 2: メイクを行う。
	
	> make
	
	環境によっては Makefile 中のインクルードパス、ライブラリパスなどを
	適宜修正する必要がある。
	
	* 修正ポイント１ --- インクルードパス、ライブラリパス
	
		# INC_DIR    = -I/*****
		# LIB_DIR    = -L/*****
	
	という行のコメント(#)を外し、適切なディレクトリに書き換える。
	
	* 修正ポイント２ --- メール・スプールディレクトリ 
	
	MAIL_SPOOL に、自分の環境に合ったメール・スプールディレクトリを設定する。
	
		MAIL_SPOOL	= '"/usr/spool/mail"'
		# MAIL_SPOOL	= '"/usr/mail"'
		# MAIL_SPOOL	= '"/var/mail"'
	
	という個所を適宜修正する。
	詳しくは後述「Ｂｉｆｆ機能について」を参照してください。
	
 3: メイクがよくわからん、という人は以下の方法で手動でコンパイルする。
	
	> cc -O xosmulti.c image.c biff.c message.c \
		-I/**** -L/**** \
		-DMAILBOX_DIRECTORY='"****"' \
		-o xosmulti -lX11 -lXext
	
	-I/**** の所はインクルードパス、-L/**** の所はライブラリーパス、
	-DMAILBOX_DIRECTORY='"****"' の所はメール・スプールディレクトリ、
	環境に合わせて適切なディレクトリを書く。
	
	例えば、FreeBSD + X11R6 の場合
		-I/usr/X11R6/include/ -L/usr/X11R6/lib
		-DMAILBOX_DIRECTORY='"/var/mail"'
	などと書く。
	
	また、一部の Sun-OS では
		-lsocket -lnsl 
	というオプションを追加する必要がある。

* 起動方法 ----------------------------------------------------

	> xosmulti	で起動する。
	
	「なでなで」と「ふにふに」ができます (*^-^*)
	終了操作は、マウスの第３ボタン -> 第１ボタンです。
	
	メールが届くと、お知らせします。
	メールのお知らせを隠すには「なでなで」してください。

* 起動オプション ----------------------------------------------

	> xosmulti [-font <fontname>] [-fg <color>] [-bg <color>] \
					[-x <xpos>] [-y <ypos>]
	
	-font ふきだしのフォント名指定。
	　　　1byteフォントなら英語、2byteフォントなら日本語が表示される。
	　　　（フォント指定がなければ、デフォルトフォント
	 　　　　　日本語: jis fixed 16ポイント
		 　　  英語: adobe courier 18ポイント
		  が使われます。）
	
	-fg   ふきだしの文字色指定。
	
	-bg   ふきだしの背景色指定。
	
	-x    マルチの座る横位置。
	　　　窓の上の左端を０、右端を１００として、０〜１００の間で指定する。
	
	-y    上下位置の微調整。
	　　　正数(+)で上方向、負数(-)で下方向に座る位置が変わる。
	　　　ウィンドウのタイトルバーの高さに合わせて調整して下さい。
	
* うまく動かなかったとき --------------------------------------

	ERROR: Can't find proper default fonts.
		-font オプションを使って使用フォントを指定して下さい。
	
	ERROR: Internal Color Allocate Error!
		色を確保することができないということ。
		何かカラーパレットを占有するプログラムを走らせていませんか？
		あったらそれを終了しましょう（^^;）
		
		xosmulti は色が確保できなかったとき、
		まず近似色で画像を表示しようと試みます。
		「なんか色がおかしい？」というときにも、
		まずカラーパレットを占有するプログラムを終了させてみましょう。
		
		どうしてもうまくいかない場合は、xosmulti.c 中の
			#define	PRIVATE_CMAP	0
		という個所を
			#define	PRIVATE_CMAP	1
		に書き換えて再コンパイルしてみて下さい。
	
	Ｂｉｆｆ機能がうまく動作しない
		後述「Ｂｉｆｆ機能について」を参照してください。
	
	その他のエラー
		作者の元までご連絡ください。

* Ｂｉｆｆ機能について -----------------------------------------

電子メールはサーバーに届いてから受取人が見るまでの間、
「スプールディレクトリ」と呼ばれる場所に保管されています。
 xosmulti は、このスプールディレクトリにあるファイルのサイズを
定期的にチェックし、サイズ変更があれば「メールが届いた」と判断しています。
ここで問題となるのは、システムによってスプールディレクトリの
位置が異なることです。

xosmulti は、スプールディレクトリが
	"/usr/spool/mail"
にあるものとして作成されています。

しかし、スプールディレクトリが
	"/var/mail"
	"/usr/mail"
などに存在するシステムもあります。

もし自分のシステムのスプールディレクトリが当初の設定と合わなければ、
コンパイル・オプションの修正を行う必要があります。

Makefile をエディタで開いて

MAIL_SPOOL	= '"(自分の環境に合ったディレクトリ)"'

に設定してください。
（クォーテーションは ' " の２つが要ります。）

なんだかよくわからない？！　という人は
	１：周囲の詳しそうな人に聞くか、
	２：作者の元にメールで尋ねるか、
	３：Biff機能はあきらめましょう (^^;)

（Ｂｉｆｆ機能がうまく動作しなくても、
メモリーの無駄以外さしたる悪影響はありません。）

* なぜ Yet Another なのか？ ------------------------------------

X11上の「お座りマルチ」には、実はもっと素晴らしい
「xmulti」というものがあります。

	http://cclub.tutcc.tut.ac.jp/~go/xmulti/

私は当初この存在を知らず、ただマルチを仕事場の Unix環境に
出したい一心で本ソフトを作ったのです。
後からすでにあることに気付いて Yet Another となったわけですね・・・
名前も重複しないように「xosmulti」としました。

* 版権 --------------------------------------------------------

このソフトはＰＤＳです。
ただし、グラフィックデータの版権はヨッシー氏、カトキムチ氏が有します。
マルチのキャラクター版権はＬｅａｆ(c)が有しています。

* 履歴 --------------------------------------------------------
	'98/09/17	とりあえず動いた
	'98/09/22	日本語ベータ版
	'98/10/01	フルカラー対応ベータ版(1)
	'98/10/16	Biff機能付きベータ版(2)
	'98/11/25	動作の軽量化を図り、第１版とした

* 謝辞 --------------------------------------------------------

ヨッシー氏　＆　カトキムチ氏
	オリジナル「お座りマルチ」の開発者です。
	快くデータを譲って頂き、感謝しています。
 		E-mail: yoshy@vc-net.or.jp
 
Ｍ.Ｋ助教授（早稲田大学 理工学部 情報学科）
 	デバッグ時に多大なる支援を頂きました。
 
Ｌｅａｆの皆様
 	「マルチ」のような素晴らしいキャラクターを生み出したこと、
 	２次版権を認めて頂いたことに感謝！

動作報告、バグ報告を頂いた方々
	作者の手元にない環境での動作報告はたいへん貴重です。
	ご協力頂いた方、どうもありがとうございました。

* 連絡先 ------------------------------------------------------

Ｂｕｇレポート、サポート、意見、感想、マルチへの愛の告白などは
下記連絡先「なかなか」までお願いします。

	E-mail: nakanita@ka2.so-net.ne.jp

最新版は、以下に随時アップロードする予定です。

	http://www01.u-page.so-net.ne.jp/ka2/nakanita/

* おしまい ---------------------------------------------------
