MCISEQ
MCISEQ コマンド集
MCI コマンドの構文は次の形になります。
コマンド デバイス名 (パラメータ)
例
play music from 0
このページのコマンド使用例ではファイル "music.mid" が music というエイリアスで開かれているものと仮定しています。
open
open コマンドは、デバイスを初期化します。
パラメータ
alias エイリアス | デバイスのエイリアス (別名) を与えます。以後の MCI コマンドでは、エイリアスがデバイス名と同等に扱われます。
|
使用例
music というエイリアスでファイル music.mid を開きます。
mci "open music.mid alias music"
close
close コマンドは、指定のデバイスをクローズします。
使用例
music というエイリアスのデバイスをクローズします。
mci "close music"
play
play コマンドは、シーケンサの再生を開始します。一時停止後の再生再開としてもつかえます。
パラメータを省略すると、前に停止した位置から再生が開始されます。
移動先の位置を指定する場合、時刻形式は
set コマンドで設定されたものを使います。
パラメータ
from ポジション | 再生開始位置を指定します。指定する再生開始位置の時刻表示形式はあらかじめ set コマンドで設定しておきます。
|
to ポジション | 停止位置を指定します。指定する停止位置の時刻表示形式はあらかじめ set コマンドで設定しておきます。
|
使用例
set コマンドで時刻形式をミリ秒に設定し、musicの10秒から15秒までの間を再生します。
mci "open music.mid alias music"
mci "set music time format milliseconds"
mci "play music from 10000 to 15000"
stop
stop コマンドは、シーケンサの再生を停止します。一時停止としても使えます。
使用例
エイリアス music のデバイスの再生を停止します。
mci "stop music"
seek
seek コマンドは、ファイル内の指定位置まで移動します。
移動先の位置を指定する場合、時刻形式は
set コマンドで設定されたものを使います。
パラメータ
to ポジション | シーク先の位置を指定します。
|
to start | シーケンスの先頭にシークします。
|
to end | シーケンスの終端にシークします。
|
使用例
music を 60 秒の時点へシークさせます。時刻形式は、
set コマンドでミリ秒に設定されているものとします。
mci "seek music to 60000"
set
set コマンドは、ドライバの制御の設定を行います。
パラメータ
time format milliseconds | 時刻形式をミリ秒に設定します。 以降、位置を示す値を使うすべてのコマンドは、時刻形式としてミリ秒を使用します。milliseconds は、ms と略すこともできます。
|
tempo テンポ | 再生のテンポを設定します。
|
使用例
music の時刻形式を ms (ミリ秒) に設定します。
mci "set music time format ms"
music を 500bpm のテンポで再生します。
mci "set music tempo 500"
mci "play music"
status
status コマンドは、デバイスのステータス情報を取得します。
取得した情報はHSPのシステム変数
stat および
refstr から取り出せます。
パラメータ
length | 現在の時刻形式でのシーケンスの長さを返します。
|
mode | デバイスの現在のモードを示す、次の値のいずれかを返します。 not ready, paused, playing, seeking, stoped
|
port | シーケンスに割り当てられたMIDIポート番号を返します。
|
position | 現在の時刻形式でシーケンスの現在の位置を返します。
|
ready | デバイスの準備ができていれば、TRUEを返します。
|
tempo | 現在のテンポを返します。
|
time format | 現在の時刻形式を返します。
|
使用例
music のテンポを返します。
mci "status music tempo"
mes refstr
info
info コマンドは、デバイスのテキスト情報を取得します。
取得した情報はHSPのシステム変数
refstr から取り出せます。
パラメータ
file | MIDIファイル名を返します。
|
copyright * | MIDIファイルの著作権情報を返します。 *
|
name * | MIDIファイルの曲名を返します。 *
|
* 取得できないことがあるらしい
使用例
music のファイル名を表示します。
mci "info music file"
mes refstr