xplaybeep Version 1.2

○説明

X上でビープ音を使い音楽を演奏するソフトです。


○インストール方法

% xmkmf -a
% make

で、xplaybeep というバイナリが出来ます。
スーパーユーザーになれるのなら、suして、

% make install

でインストールできます。


○使用方法

play [-toolkitopyion..][-/+fixed][-/+force] [filename]

  -fixed
	ボリューム制御を行いません。ボリューム制御のできないXサーバ
	(XFree86ではできないようです)の時に指定します。

  +fixed
	ボリューム制御を行います。

  -force
	ボリューム制御を行わない時、起動時にボリュームをサーバデフォルト
	(-1)に設定します。

  +force
	ボリューム制御を行わない時、サーバのボリューム設定値が0のときは
	ボリュームをサーバデフォルト(-1)に設定しません。


	デフォルトはリソースの設定に依ります。
	ボリューム制御のできないXサーバ(XFee86はできないようです)の時は、
	-fixedを指定します。その時、ビープを止めている(xset b 0 など)
	ときでも音がでるようにするには、-forceも指定します。

ファイルの読み込み

filenameからMMLを読み込み演奏します。
filenameを指定しない時は標準入力から読み込みます。

X toolkitのオプションを理解しますが、ウインドウは開かないので、
設定できるのはディスプレイ位でしょう。


○MML(Music Macro Language)の書式

大文字、小文字は区別しません。[ ]は省略可能。

A-G [+-][長さ] 音符、+はシャープ、-はフラットを表す
R   [長さ]     休符
.              長さを1.5倍にする(複数個使用可能)

O   数値       オクターブ設定(０−１５、初期値は４)
L   数値       音符、休符のデフォルトの長さ指定(初期値は４)
T   数値       テンポ設定
V   数値       ヴォリューム設定(０−１５、初期値は８)
Q   数値       音符の長さ指定(０−８、初期値は６)
               実際に鳴る長さは、音符の長さ＊Q/8になる。
>              オクターブ上げる
<              オクターブ下げる
#              コメント(行末まで捨てる)


○リソース

以下のリソースが指定可能です。

XPlayBeep*fixedVolume
	TRUEの時は -fixedオプションをつけた状態、FALSEの時は +fixed
	オプションをつけた状態になります。
	デフォルトはFALSEです。

XPlayBeep*playWhenSilent
	TRUEの時は -forceオプションをつけた状態、FALSEの時は +force
	オプションをつけた状態になります。
	デフォルトはFALSEです。

リソースよりオプション指定が優先されます。


○バグ

ビープ音の制御はXサーバーの機能なので、サーバーによっては
正常に動作しない可能性があります。

オクターブの下限は２か３位です。それ以下だと、音が狂う場合があります。


○制限

このソフトによって生じたあらゆる損害に関して、作者は責任をとりません。


(c) 1997,1998 皇族的熊猫
