BMS Viewerのコマンドライン制御について

コマンドライン仕様：

BMS VIEWERは、起動時に渡すパラメータにより各種動作を制御できます。 (一行に収まるんかい？これ‥)


BMVIEW [-S][-P][-B[+|-]][-W[+|-]][-A[+|-]][-D[+|-]][-J[+|-]][-N位置][-M倍率][-R][-Q] [ファイル名]

• -S　‥　SINGLE
  
  BMS VIEWERをシングルインスタンスモードで起動します。
  シングルインスタンスモードでは、ウィンドウを１つだけ開くことができます。
  既にシングルインスタンスモードで起動している時に、このオプションを指定すると 動作中のVIEWERの動作を外部から制御することができます。
  
  
• -P　‥　PLAY
  
  起動後、すぐに演奏を開始するよう指示します。
  またはシングルインスタンスモードのVIEWERに演奏開始を指示します。
  
  
• -B[+|-]　‥　BGM
  
  このオプションを指定すると、BGM可能モードになります。
  またはシングルインスタンスモードのVIEWERのBGM可否を制御します。
  起動後にモードを切り替えることも可能ですが、反映は次のファイルの読み込み処理まで保留されます。
  
  
• -W[+|-]　‥　WINDOW(シングルインスタンスモード かつ BGM可能モード時)
  
  このオプションを使用することで、WINDOWの表示/非表示を切り替えることができます。(+で表示/-で非表示)
  シングルインスタンスモード かつ BGM可能モード時以外では 意味がありません。
  
  
• -A[+|-]　‥　ANIME(読みこみデータが対応している場合のみ)
  
  このオプションを使用することで、ANIMEの表示/非表示を切り替えることができます。(+で表示/-で非表示)
  -W-オプション指定時でも、表示するANIMEがある場合はWINDOWを表示します。
  
  
• -D[+|-]　‥　DETAIL
  
  このオプションを指定すると詳細表示モードで起動します。
  またはシングルインスタンスモードのVIEWERに詳細表示を指示します。(+でON/-でOFF)
  
  
• -J[+|-]　‥　J-TITLE
  
  このオプションを指定するとタイトル非表示モードで起動します。(漢字タイトル対策)
  またはシングルインスタンスモードのタイトル表示を制御します。(+で漢字対策ON/-で漢字対策OFF)
  
  
• -N位置　‥　NUMBER
  
  起動時の表示位置を小節単位で制御します。
  またはシングルインスタンスモードのVIEWERに表示位置を指示します。
  数値を省略した場合、頭だしになります。
  ファイル名の再指定による再読み込み時に０に初期化されます。
  
  
• -M倍率　‥　MULDIV
  
  起動時の表示倍率を指定します。
  またはシングルインスタンスモードのVIEWERに表示倍率を指示します。
  
  
• -R　‥　リロード(シングルインスタンスモード時)
  
  BMSファイルを再度読み込ませたい場合に指定します。
  シングルインスタンスモード時以外では意味がありません。
  
  
• -Q　‥　QUIT(シングルインスタンスモード時)
  
  シングルインスタンスモードのVIEWERを終了させます。
  シングルインスタンスモード時以外では意味がありません。
  
  
  注意：倍率などに無茶な数値を指定すると変になります。
  
  

TIPS：

・パスを通しておけばDOS窓からでテストできます。
・BMSファイルは、フルパス指定するのが吉。拡張子はなんでもＯＫ。
・非BGMモード かつ シングルインスタンスモード の場合、ロストフォーカスで演奏を停止します。
凡例１：(一連の操作として読んでください。)

BMVIEW -S -P DATA.BMS	←データの読み込みと演奏開始を指示
BMVIEW -S			←演奏終了
BMVIEW -S -R -N10		←データの再読み込みと表示位置の制御
BMVIEW -S -P		←演奏開始
BMVIEW -S -D		←詳細表示ON
BMVIEW -S -P DATA2.BMS	←演奏開始
BMVIEW -S -D-		←詳細表示OFF

凡例２：(一連の操作として読んでください。)

BMVIEW -S -B -W- -P DATA.BMS	←データの読み込みと演奏開始を指示(非表示)
BMVIEW -S			←演奏終了
BMVIEW -S -P		←演奏開始(Nを指定した実績がないので、先頭より再生される)
BMVIEW -S -N5		←5小節目に移動(0から数えるので6小節目ともいう)
BMVIEW -S -P		←演奏開始(先のN5はまだ有効)
BMVIEW -S -P DATA2.BMS	←別ファイルの読み込み および 演奏開始(この場合は先頭から再生)

こんな感じでコマンドラインオプションにより簡単にBMS VIEWERの動作を外部から制御できます。

シングルインスタンスモードとは？：

シングルインスタンスモードは、実のところエディタ作成者殿向けのプレビュー表示/プレビュー演奏補完機能です。
ShellExecute()などのAPIや、エディタマクロから制御できるよう考えてあります。

C+APIでバキバキに書きたい人は、こんな感じで扱うこともできます...


	：
HWND hTargetWnd = FindWindow("BMS Viewer.SI", NULL);
if (hTargetWnd){
	COPYDATASTRUCT cds = { 0 };
	cds.lpData = lpcmd;	                // あらかじめ制御文字列をlpcmdに格納しておく。
	cds.cbData = strlen(lpcmd)+1;		// NULL終端分を+1する必要がある。
	SetForegroundWindow(hTargetWnd);	// 演奏するときはフォアグラウンドにする必要あり。
	SendMessage(hTargetWnd, WM_COPYDATA, hwnd, (LPARAM)&cds );
}
	：
	

演奏終了はタイトルバーの文字列で判断してください。(この時点でマクロ等では無理かも‥)
"IDLE"で演奏終了、"PLAY"が演奏中、"STOP.."が演奏停止要求待ち、"LOAD.."がファイル読み込み中です。
コマンドの発行は、"PLAY"または"IDLE"の期間を狙ったほうがよいかもしれません。
# 別に狙わなくてもまぁ動くはずです。(未確認)

おまけ：

エディタの他にもジュークボックスとか、ファイル整理用のツールとかも考えられますね。
そのうち -BGMオプションとか、-WINDOW作るかも？
てなことを書いてたら、某コンパネ製作者殿(笑)よりリクエストがありましたので実装しました。

きっと誰かがスクリーンセーバとか作ってくれることでしょう。(笑)

おまけ２：

Version1.5
・テンポ制御のバグを修正した版

Version1.4
・-Aオプション対応公開版。が、テンポ制御にバグを作りこんでしまったので公開中止

Version1.3
・アニメ表示対応初版(非公開)

Version1.2
・-Sオプション指定時は、ウィンドウ位置を記憶するよう修正しました。(非表示の場合を除く)

Version1.1
・-Sオプション指定時は、ファイルオープンダイアログを開かないよう仕様変更しました。
・-Wオプションでウィンドウ表示状態に復帰しないバグ修正
・WINAMP等が常駐している場合、DirectSound初期化失敗すると一般保護例外が発生するバグ修正

Version1.0
・-B/-W オプションをサポート

Version0.9
・-J/-Q オプションをサポート
・-D オプションにパラメータを渡すよう修正[+|-]

Version0.8
・-S/-D/-P/-N/-M/-R オプションを作成