mmload

メディアファイル読み込み

mmload "filename",p1,p2

p1=0~(0)  : 割り当てるメディアバッファID
p2=0~2(0) : 割り当てるモード

解説

メディアデータのファイルを登録します。
読み込むことができる形式は以下の通りです。

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プラットフォーム上でのみ動作します

たとえば、オーディオCDのトラック3を指定する場合は、

	mmload "CD:3",1

のようにします。
p1は、割り当てるメディアバッファIDとなります。これは、再生する時に必要となる0以上の整数値です。
複数のメディアファイルを取り扱うには、別々のバッファ番号に割り当てをしておく必要があります。
mmload命令は、指定されたファイルが2MB以下の音声(WAV)ファイルの場合は、メモリに内容を読み込んでおきリアルタイムに再生可能な状態にします。それ以外の場合は、ファイル名だけが登録され、実際のファイルの読み出しはメディア再生時(mmplay実行時)に行なわれることになります。

p2はモードを設定します。以下の値を指定することができます。

モード0   : 指定したファイルは通常の再生を行う
モード1   : 指定したファイルは無限ループで再生を行う
モード2   : 指定したファイルは再生終了まで待つ
モード3   : (CDのみ)指定されたトラック以降を再生する
モード+16 : (AVIのみ)対象ウィンドウ全体で再生

モード2を指定すると、指定したファイルが再生された場合、 HSPはその再生が終了するまで次の命令を実行しなくなります。
mmload命令はデータの情報をメモリ上にストックしておくだけで、すぐに演奏が始まるわけではありません。

モード+16は、AVI(動画)ファイルでのみ使用できるモードです。
モード0~2に16を足した値を指定することで、表示対象になっているウインドウのサイズいっぱいに動画が再生されます。
動画ファイルの判断は拡張子によって行なっています。

MP3形式、およびASF形式はOSがサポートしている場合にのみ再生が可能です。
(初期のWindows95、Windows98ではWindows Media Player  5.2以降がインストールされている必要があります。)

実際の再生は、mmplay命令によって行ないます。

関連項目

mmplayメディア再生
mmstopメディア再生の停止

サンプル逆引き (6)

aviplay.hsp
battle.hsp
drop.hsp
sample16.hsp
shoot.hsp
tamane_jump.hsp

情報

バージョン3.6
作成日2019/08/01
著作者onitama
URLhttp://hsp.tv/
備考ver3.6標準命令
タイプ内蔵命令
グループマルチメディア制御命令
対応環境
  • Windows 版 HSP
  • HSPLet
移植のヒントHSPLet時、WAV/AIFF/AU/MIDI/MP3 をサポートしています。 MP3の再生には付属の jl1.0.jar が必要です。
hs ファイルhsphelp\i_mmedia.hs