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

# SDL_HapticPeriodic

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

## フィールド

ヘッダ
Uint16 | type | 波形 (詳細を参照すること)
SDL_HapticDirection | direction | (ユーザに相対的な)効果の向き
再生
Uint32 | length | 継続時間(ミリ秒)
Uint16 | delay | 効果が始まるまでの待ち時間
トリガ
Uint16 | button | 効果を引き起こすボタン
Uint16 | interval | 効果を再び引き起こす時間
周期
Uint16 | period | 波の周期
Sint16 | magnitude | ピーク値
Sint16 | offset | 波の平均値
Uint16 | phase | 円の100分の1単位の水平方向のずれ (詳細を参照すること)
エンベロープ
Uint16 | attack_length | 立ち上がりの継続時間
Uint16 | attack_level | 立ち上がりの強さ
Uint16 | fade_length | 立ち下げの継続時間
Uint16 | fade_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