■ arX MusicPlayer スクリプト仕様書
 ―――――――――――――――――――――――――――――――――――――


 □ 概要

 ・「スクリプト」とはプレイヤーに様々な処理を行わせることができる独自の言語
 　のことです。HSPで開発されたため、書式はHSPライクになっています(笑

 ・具体的には、

 　　・プレイヤーの右クリックメニュー > その他ファイル... > スクリプト
 　　　で読み込める(*.xs)ファイル
 　　・スキン
 　　・プラグイン

 　で、スクリプトが使われます。

 ・書式を確認した後、プラグインを作成したい方は xmp_plugin.html を、
 　スキンを作成したい方は xmp_skin.html をご覧下さい。

 ・右クリックメニューで読み込める(*.xs)ファイルは単なるテキストファイルです。
 　メモ帳でファイルを新規作成し、一行目に

	.Script.ver=401

 　と書いた後二行目からスクリプトを書いて行って作成します。
 　させたい処理を書き終えたら保存して、プレイヤーから読み込んでみて下さい。
 　拡張子を txt から xs に変えるのをお忘れなく。

 □ 書式

 ・一行に一つの命令を記述します。

 　(ex)	最小化
	setxwin=minimize
 
 ・複数行にわたって命令を書くことができ、その場合は上から下へ順番に実行されて行きます。

 　(ex)	最小化の後、すぐに元に戻す
	setxwin=minimize
	setxwin=restore

 ・命令は、
 　　[命令]=[パラメータ(1)]*[パラメータ(2)]*...
 　のようになっています。
 　パラメータは、どのように命令を実行するかを決定します。

 　(ex) メイン画面をディスプレイ左上に移動
	winposi=0*0

 ・コメント行を挟む事も出来ます。

 　(ex) 
	setxwin=minimize
	::: 行頭が ":::" だとコメントと見なされます。
	::: ↓右クリックメニューを表示
	setmenu=popup

 ・スキンで音楽情報を表示したい場合等、パラメータ中にプレイヤーの情報を入れ
 　たいと思ったら、以下の文字列をパラメータとして書いて下さい。

	―――――――――――――――――――――――――――――――――
	・%p.****%		（音楽情報を表示）
	―――――――――――――――――――――――――――――――――
		**** : 音楽情報の種類
		―――――――――――――――――――――――――――――
		fpth : 再生中のファイルのフルパス
		file : 　　　　〃　　　のファイル名
		indx : 　　　　〃　　　がリストで何番目(0〜)のファイルか
		posi : 　　　　〃　　　の再生位置(HH時間MM分SS秒)
		posh : 　　　　〃　　　の再生位置(HH)
		posm : 　　　　〃　　　の再生位置(MM)
		poss : 　　　　〃　　　の再生位置(SS)
		lgth : 　　　　〃　　　の長さ(HH時間MM分SS秒)
		lgth : 　　　　〃　　　の長さ(HH)
		lgtm : 　　　　〃　　　の長さ(MM)
		lgts : 　　　　〃　　　の長さ(SS)
		auth : 　　　　〃　　　の著作者
		titl : 　　　　〃　　　のタイトル
		atit : 　　　　〃　　　が含まれるアルバムのタイトル
		rele : 　　　　〃　　　の発売日
		comm : 　　　　〃　　　についてのコメント
		form : 　　　　〃　　　のファイル形式
		stat : 音楽の再生状態
		mode : 再生モード
		alias: MCIのエイリアス名
	―――――――――――――――――――――――――――――――――
	・%s.****%		（システム情報を表示）
	―――――――――――――――――――――――――――――――――
		**** : システム情報の種類
		―――――――――――――――――――――――――――――
		user : プレイヤーのユーザー名
		titl : メイン画面の現在のタイトル
		col  : ボタン表面の色(RRR*GGG*BBB)
		cols : ボタン影の色(RRR*GGG*BBB)
		repmode : 再生リストを繰り返し再生する設定(O N/OFF) NEW!! v.402.04〜
		windowtop : メイン画面の最前面表示の設定(O N/OFF) NEW!! v.402.04〜
	―――――――――――――――――――――――――――――――――
	・%o.****%		（オブジェクトIDを表示）
	―――――――――――――――――――――――――――――――――
		**** : オブジェクトの種類
		（種類に何があるかについては xmp_script_ref.html の
		 objxset 命令の項をご覧下さい。）
	―――――――――――――――――――――――――――――――――
	・%v.****%		（スキン変数の中身を表示）
	―――――――――――――――――――――――――――――――――
		**** : スキン変数ID
	―――――――――――――――――――――――――――――――――

 □ その他

 ・スクリプトの機能を使用した結果いかなる事態に陥ってもArc@ARCISは保証しません。
 ・作成したスキン、プラグイン、スクリプトは自由に配布して構いません。


 ―――――――――――――――――――――――――――――――――――――
						    (c) arc@arcis 2002-2003