目次 - SDL 3.0 API(機能別) - 力覚フィードバック - SDL_RunHapticEffect

SDL_RunHapticEffect

ハプティックデバイスのエフェクトを再生する

ヘッダ

SDL3/SDL_haptic.h

構文

bool SDL_RunHapticEffect(SDL_Haptic *haptic, SDL_HapticEffectID effect, Uint32 iterations);

引数

SDL_Haptic *hapticエフェクトを再生するハプティックデバイス
SDL_HapticEffectIDeffect再生するエフェクトのID
Uint32iterationsエフェクトを再生する回数. SDL_HAPTIC_INFINITYで無限

戻り値

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

詳細

もしエフェクトを永久に繰り返したいならば, iterationsをSDL_HAPTIC_INFINITYにすること. (毎回エンベロープ(立ち上げと立ち下げ)を繰り返す.) 1つのエフェクトのインスタンスを無期限に続ける(立ち下がらない)ようにするには, 代わりにエフェクトの構造体のlengthメンバをSDL_HAPTIC_INFINITYにすること.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_RunHapticEffect - SDL Wiki