Set3DVelocitySoundMem

メモリに読み込んだ音データの3Dサウンド用の移動速度を設定する

Set3DVelocitySoundMem Velocity, SoundHandle

VECTOR Velocity : 音の移動速度( 秒速 )
int SoundHandle : 音が聞こえる距離を変更する音の識別番号( サウンドハンドル )

(プラグイン / モジュール : DxLibW)

解説

SetCreate3DSoundFlag を使用して3Dサウンドとして読み込まれた音データの移動速度を設定します。

音の移動速度を設定、というと、時間経過とともに音の再生位置が変化しそうですが、変化しません。

この関数で設定する移動速度は、所謂ドップラー効果を再現するためだけに使用されるので、音の位置には影響を与えないのです。

引数 Velocity で渡す速度の値は「秒速」となります。なので、例えば秒間60フレームで動作するプログラムの場合は、
1フレームで移動した距離を60倍した値を引数に渡せば良いということになります。

( 秒間60フレームのプログラムの1フレームで経過する時間は60分の1秒、渡す値は秒速( 1秒間辺りの移動距離 )なので、1フレームで移動した距離を60倍すれば1秒間に移動する距離になる )


<注意>

ドップラー効果は XAudio2 が使用できる環境で、且つ DxLib_Init の前で SetEnableXAudioFlag に TRUE を渡して XAudio2 を使用する設定にしていた場合のみ発生します。
XAudio2 が使用できない環境や、使用できる環境でも SetEnableXAudioFlag を使用して XAudio2 を使用する設定にしていない場合はこの関数は何も効果がありませんので注意してください。

戻り値:
  0:成功

関連項目

LoadSoundMem音ファイルをメモリに読みこむ(DxLibW)
PlaySoundMemメモリに読みこんだ音データを再生する(DxLibW)
StopSoundMemメモリに読み込んだ音データの再生を止める(DxLibW)
DeleteSoundMemメモリに読みこんだ音データを削除する(DxLibW)
CheckSoundMemメモリに読みこんだ音データが再生中か調べる(DxLibW)
SetVolumeSoundMemサウンドハンドルのボリュームを設定する( 100分の1デシベル単位 0 ~ 10000 )(DxLibW)
InitSoundMemメモリに読みこんだ音データをすべて消去する(DxLibW)

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib サウンド
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs