Set3DSoundListenerVelocity

3Dサウンドのリスナーの移動速度を設定する

Set3DSoundListenerVelocity Velocity

VECTOR Velocity : リスナーの移動速度( 秒速 )

(プラグイン / モジュール : 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:成功

情報

プラグイン / モジュール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