目次 - SDL 3.0 API(機能別) - ゲームパッド - SDL_RumbleGamepad

SDL_RumbleGamepad

ゲームパッドの振動を開始する

ヘッダ

SDL3/SDL_gamepad.h

構文

bool SDL_RumbleGamepad(SDL_Gamepad *gamepad, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble, Uint32 duration_ms);

引数

SDL_Gamepad *gamepadゲームパッド
Uint16low_frequency_rumble低周波数(左)振動モーターの強度. 0から0xFFFF
Uint16high_frequency_rumble高周波数(右)振動モーターの強度. 0から0xFFFF
Uint32duration_ms振動効果のミリ秒単位の時間

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

この関数の呼び出しのたびに以前の振動は取り消されるため, 強度を0として呼び出すと振動を止めることができる.

この関数はSDLイベント処理が行われるか, SDL_UpdateJoysticks()を呼んで振動を更新する必要がある.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_RumbleGamepad - SDL Wiki