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

SDL_HapticPeriodic

周期エフェクトのテンプレートの構造体

ヘッダ

SDL3/SDL_haptic.h

フィールド

ヘッダ
SDL_HapticEffectTypetypeSDL_HAPTIC_SINE, SDL_HAPTIC_SQUARE, SDL_HAPTIC_TRIANGLE, SDL_HAPTIC_SAWTOOTHUP, SDL_HAPTIC_SAWTOOTHDOWN
SDL_HapticDirectiondirection(ユーザに相対的な)エフェクトの向き
再生
Uint32length継続時間(ミリ秒)
Uint16delayエフェクトが始まるまでの待ち時間
トリガ
Uint16buttonエフェクトを引き起こすボタン
Uint16intervalエフェクトを再び引き起こす時間
周期
Uint16period波の周期
Sint16magnitudeピーク値. 負のとき180度位相がずれる
Sint16offset波の平均値
Uint16phase円の100分の1単位の水平方向のずれ
エンベロープ
Uint16attack_length立ち上がりの継続時間
Uint16attack_level立ち上がりの強さ
Uint16fade_length立ち下げの継続時間
Uint16fade_level立ち下げの強さ

詳細

この構造体は次のエフェクトを扱う:

周期エフェクトは, エフェクトを波のように何度も繰り返す. typeは波形を決め, 他のパラメータは次元を決める.

phaseは1度の100分の1単位で指定する. もし9000ならば, 位相が25%ずれる. 以下は値の例である.

例:

SDL_HAPTIC_SINE

  __      __      __      __
 /  ¥    /  ¥    /  ¥    /
/    ¥__/    ¥__/    ¥__/

SDL_HAPTIC_TRIANGLE

  /¥    /¥    /¥    /¥    /¥
 /  ¥  /  ¥  /  ¥  /  ¥  /
/    ¥/    ¥/    ¥/    ¥/

SDL_HAPTIC_SAWTOOTHUP

  /|  /|  /|  /|  /|  /|  /|
 / | / | / | / | / | / | / |
/  |/  |/  |/  |/  |/  |/  |

SDL_HAPTIC_SAWTOOTHDOWN

¥  |¥  |¥  |¥  |¥  |¥  |¥  |
 ¥ | ¥ | ¥ | ¥ | ¥ | ¥ | ¥ |
  ¥|  ¥|  ¥|  ¥|  ¥|  ¥|  ¥|

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_HapticPeriodic - SDL Wiki