content: ;
  ;	HSP help manager用 HELPソースファイル
  ;	(先頭が「;」の行はコメントとして処理されます)
  ;
  
  %type
  内蔵命令
  %ver
  3.6
  %note
  ver3.6標準命令
  %date
  2019/08/01
  %author
  onitama
  %url
  http://hsp.tv/
  %port
  Win
  Let
  
  
  
  %index
  mci
  MCIにコマンドを送る
  %group
  マルチメディア制御命令
  %prm
  "strings"
  "strings" : MCIコマンド文字列
  
  %inst
  MCI（Multimedia Control Interface）にコマンド文字列を送ります。MCIに対応したMIDI再生、ムービー再生などを行なうことができます。
  ^
  MCIコマンドの詳細については、Windows MCIの解説書をお読みください。ここでは簡単な使用法だけを紹介しておきます。
  ^p
  	mci "play filename"
  ^p
  で、"filename"のファイルを再生します。たとえば、"play aaaa.mid"ならば、"aaaa.mid" というMIDIファイルを演奏します。拡張子がaviなら動画の再生、wavならPCMの再生、その他MCIに登録されているデバイスを再生することができます。
  ^p
  	mci "open filename alias abc"
  ^p
  で、"filename"のファイルをオープンして、これ以降 "abc"という名前をエイリアスにすることができます。この後で、
  ^p
  	mci "play abc"    ; デバイスの再生
  	mci "stop abc"    ; デバイスの再生ストップ
  	mci "close abc"   ; デバイスのクローズ
  ^p
  などの指定をすることができるようになります。
  mciに命令を送った場合の結果はシステム変数 statに反映されます。
  stat が-1の場合は、mci命令を解釈する時点でエラーが出ていることを示しています。また、mciでステータスを読み出すコマンドを送った場合も、stat に結果が反映されます。
  MCIにコマンドは、Windowsプラットフォーム上でのみ動作します。HSP3Dish環境では使用できませんのでご注意ください。
  
  %portinfo
  HSPLet時は、以下の命令のみサポートされます。
  
  open file alias name 
  play name 
  seek name to position 
  status name position 
  stop name 
  close name 
  
  WAV/AIFF/AU/MIDI/MP3 をサポートしています。 MP3の再生には付属の jl1.0.jar が必要です。
  
  
  %index
  mmplay
  メディア再生
  %group
  マルチメディア制御命令
  %prm
  p1
  p1=0〜(0) : 再生するメディアバッファID
  
  %inst
  mmload命令によって読み込まれたメディアを再生します。
  p1でメディアバッファIDを指定することで、mmload命令によって読み込まれた複数のメディアから、どれを再生するかを選びます。
  ^
  mmplay命令は、 通常メディアの再生がスタートするとともにHSPは次の命令へと進みます。
  ただし、mmload命令で読み込みモード２を指定している場合は、メディアの再生が終了するまで次の命令へは進まなくなります。
  ^
  すでにメディアが再生されている状態で、さらにmmplay命令を実行すると、前のメディア再生を終了してから、新しく指定したメディアの再生を始めます。
  ただし、MIDIの再生中にPCMを再生するなど異なるデバイスの場合は、 再生が中止されることはありません。
  ^
  AVI(動画)の再生は、 mmplay命令が実行された時点で操作先となっているウインドウのカレントポジションを左上として表示されます。
  ただし、 mmload命令のモードに+16(ウィンドウ全体で再生)が指定されている場合は、ウィンドウの表示面いっぱいに再生されます。
  この場合、画面サイズや縦横の比率には関係なくウィンドウのサイズに変倍されるので、あらかじめ動画の画面サイズや縦横比を考えた上で利用して下さい。
  
  %href
  mmload
  mmstop
  
  
  
  
  %index
  mmload
  メディアファイル読み込み
  %group
  マルチメディア制御命令
  %prm
  "filename",p1,p2
  p1=0〜(0)  : 割り当てるメディアバッファID
  p2=0〜2(0) : 割り当てるモード
  
  %inst
  メディアデータのファイルを登録します。
  読み込むことができる形式は以下の通りです。
  ^p
  WAV形式  : 拡張子 WAV         : Windows標準のPCM音声データ。
  AVI形式  : 拡張子 AVI         : Windows標準の動画データ
  MID形式  : 拡張子 MID         : 標準MIDIファイルデータ。(*)
  MP3形式  : 拡張子 MP3         : MP3形式音声データ
  ASF形式  : 拡張子 ASF,WMV,WMA : Windows Media形式音声データ(*)
  MPEG形式 : 拡張子 MPG         : MPEG形式動画データ(*)
  オーディオCD : ファイル名 "CD : トラック番号" :
                 (CDの音声トラック部分が対象になります)(*)
  (*)の形式は、Windowsプラットフォーム上でのみ動作します
  ^p
  たとえば、オーディオCDのトラック3を指定する場合は、
  ^p
  	mmload "CD:3",1
  ^p
  のようにします。
  p1は、割り当てるメディアバッファIDとなります。これは、再生する時に必要となる0以上の整数値です。
  複数のメディアファイルを取り扱うには、別々のバッファ番号に割り当てをしておく必要があります。
  mmload命令は、指定されたファイルが2MB以下の音声(WAV)ファイルの場合は、メモリに内容を読み込んでおきリアルタイムに再生可能な状態にします。それ以外の場合は、ファイル名だけが登録され、実際のファイルの読み出しはメディア再生時(mmplay実行時)に行なわれることになります。
  ^
  p2はモードを設定します。以下の値を指定することができます。
  ^p
  モード0   : 指定したファイルは通常の再生を行う
  モード1   : 指定したファイルは無限ループで再生を行う
  モード2   : 指定したファイルは再生終了まで待つ
  モード3   : (CDのみ)指定されたトラック以降を再生する
  モード+16 : (AVIのみ)対象ウィンドウ全体で再生
  ^p
  モード２を指定すると、指定したファイルが再生された場合、 HSPはその再生が終了するまで次の命令を実行しなくなります。
  mmload命令はデータの情報をメモリ上にストックしておくだけで、すぐに演奏が始まるわけではありません。
  ^
  モード+16は、AVI(動画)ファイルでのみ使用できるモードです。
  モード0〜2に16を足した値を指定することで、表示対象になっているウインドウのサイズいっぱいに動画が再生されます。
  動画ファイルの判断は拡張子によって行なっています。
  ^
  MP3形式、およびASF形式はOSがサポートしている場合にのみ再生が可能です。
  (初期のWindows95、Windows98ではWindows Media Player  5.2以降がインストールされている必要があります。)
  ^
  実際の再生は、mmplay命令によって行ないます。
  
  %href
  mmplay
  mmstop
  %portinfo
  HSPLet時、WAV/AIFF/AU/MIDI/MP3 をサポートしています。 MP3の再生には付属の jl1.0.jar が必要です。
  
  
  
  %index
  mmstop
  メディア再生の停止
  %group
  マルチメディア制御命令
  %prm
  p1
  p1=0〜(-1) : メディアバッファID
  %inst
  mmplay命令によるメディア再生を停止します。
  p1でメディアバッファIDを指定することで、指定したメディアの再生を停止することができます。
  p1を省略するかマイナス値が指定された場合は、すべてのメディア再生を停止します。
  
  
  %href
  mmplay
  mmload
  
  
  %index
  mmvol
  音量の設定
  %group
  拡張マルチメディア制御命令
  %prm
  p1,p2
  p1=0〜(0) : メディアバッファID
  p2(0)     : ボリューム(音量)値(-1000〜0)
  %inst
  mmplay命令によって再生されるメディアの音量を設定します。
  ボリューム値は、0が最大の音量、-1000が無音状態となります。
  このパラメーターはデフォルトで0(最大)が設定されています。
  ※HSP3Dish環境でのみ利用できます
  ※MIDI音楽ファイルに対しては設定ができません
  ※ボリューム値は、dmmvol命令と同様にマイナス値が大きいほど無音に近づきます。
  ただし、dmmvol命令は-10000〜0までのデシベル値であるのに対して、mmvol命令は-1000〜0までのリニアな変化
  (聴感上の音量)を行なう値であることに注意してください。
  
  %href
  mmplay
  
  
  %index
  mmpan
  パンニングの設定
  %group
  拡張マルチメディア制御命令
  %prm
  p1,p2
  p1=0〜(0) : メディアバッファID
  p2(0)     : パンニング値(-1000〜1000)
  %inst
  mmplay命令によって再生されるメディアのパンニング(ステレオの左右バランス)を設定します。
  -1000が最も左の定位、1000が最も右の定位の値となります。(0が中央の定位となります)
  このパラメーターはデフォルトで0(中央)が設定されています。
  ※HSP3Dish環境でのみ利用できます
  ※WAVファイル以外に対しては設定ができません
  ※Windows上でのmp3ファイルによる音楽再生時は反映されません
  ※dmmpan命令とは値の分解能が異なるので注意してください
  
  %href
  mmplay
  
  
  %index
  mmstat
  メディアの状態取得
  %group
  拡張マルチメディア制御命令
  %prm
  p1,p2,p3
  p1 : 状態が取得される変数
  p2(0) : メディアバッファID
  p3(0) : 取得モード
  %inst
  mmplay命令によって再生されるメディアの状態を取得して、p1の変数に代入します。
  p3で取得するモードを指定することができます。
  取得モードの値は、以下の通りです。
  ^p
  	モード値  内容
  	------------------------------------------------------
  	    0     設定フラグ値
  	    1     ボリューム値
  	    2     パンニング値
  	    3     再生レート(0=オリジナル)
  	    16    再生中フラグ(0=停止中/1=再生中)
  
  ※再生中フラグはHSP3Dish環境でのみ利用できます
  ^p
  
  %href
  mmplay
  
  
  