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

SDL_HapticPeriodic

周期効果のテンプレートの構造体

フィールド

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

詳細

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

ボタン         period
押下           |     |
  ||      __    __    __    __    __    _
  ||     |  |  |  |  |  |  |  |  |  |   magnitude
  \/     |  |__|  |__|  |__|  |__|  |   _
    -----
      |            offset?
    delay          phase?

-------------------------------------
              length
===================================================
                      interval

typeは次のうちの1つである.
SDL_HAPTIC_SINE 
  __      __      __      __
 /  \    /  \    /  \    /
/    \__/    \__/    \__/
SDL_HAPTIC_TRIANGLE 
  /\    /\    /\    /\    /\
 /  \  /  \  /  \  /  \  /
/    \/    \/    \/    \/
SDL_HAPTIC_SAWTOOTHUP 
  /|  /|  /|  /|  /|  /|  /|
 / | / | / | / | / | / | / |
/  |/  |/  |/  |/  |/  |/  |
SDL_HAPTIC_SAWTOOTHDOWN 
\  |\  |\  |\  |\  |\  |\  |
 \ | \ | \ | \ | \ | \ | \ |
  \|  \|  \|  \|  \|  \|  \|

phaseは1度の100分の1単位で指定する. もし9000ならば, 位相が25%ずれる. 以下は値の例である.
0位相のずれなし
9000位相が25%ずれる
18000位相が50%ずれる
27000位相が75%ずれる
36000位相が100%ずれる. 0と同じだが, 0が推奨される

関連項目(構造体)

SDL_HapticDirection

関連項目(関数)

SDL_HapticNewEffect

SDL Wikiへのリンク

SDL_HapticPeriodic - SDL Wiki