SDL_HapticPeriodic

A structure containing a template for a Periodic effect.

The struct handles the following effects:

- SDL_HAPTIC_SINE - SDL_HAPTIC_SQUARE - SDL_HAPTIC_TRIANGLE - SDL_HAPTIC_SAWTOOTHUP - SDL_HAPTIC_SAWTOOTHDOWN

A periodic effect consists in a wave-shaped effect that repeats itself over time. The type determines the shape of the wave and the parameters determine the dimensions of the wave.

Phase is given by hundredth of a degree meaning that giving the phase a value of 9000 will displace it 25% of its period. Here are sample values:

- 0: No phase displacement. - 9000: Displaced 25% of its period. - 18000: Displaced 50% of its period. - 27000: Displaced 75% of its period. - 36000: Displaced 100% of its period, same as 0, but 0 is preferred.

Members

Variables

attack_length
Uint16 attack_length;

Duration of the attack.

attack_level
Uint16 attack_level;

Level at the start of the attack.

button
Uint16 button;

Button that triggers the effect.

delay
Uint16 delay;

Delay before starting the effect.

direction
SDL_HapticDirection direction;

Direction of the effect.

fade_length
Uint16 fade_length;

Duration of the fade.

fade_level
Uint16 fade_level;

Level at the end of the fade.

interval
Uint16 interval;

How soon it can be triggered again after button.

length
Uint32 length;

Duration of the effect.

magnitude
Sint16 magnitude;

Peak value; if negative, equivalent to 180 degrees extra phase shift.

offset
Sint16 offset;

Mean value of the wave.

period
Uint16 period;

Period of the wave.

phase
Uint16 phase;

Positive phase shift given by hundredth of a degree.

type
SDL_HapticEffectType type;

SDL_HAPTIC_SINE, SDL_HAPTIC_SQUARE SDL_HAPTIC_TRIANGLE, SDL_HAPTIC_SAWTOOTHUP or SDL_HAPTIC_SAWTOOTHDOWN

Examples

SDL_HAPTIC_SINE
    __      __      __      __
/  \    /  \    /  \    /
/    \__/    \__/    \__/

SDL_HAPTIC_SQUARE
__    __    __    __    __
|  |  |  |  |  |  |  |  |  |
|  |__|  |__|  |__|  |__|  |

SDL_HAPTIC_TRIANGLE
    /\    /\    /\    /\    /\
/  \  /  \  /  \  /  \  /
/    \/    \/    \/    \/

SDL_HAPTIC_SAWTOOTHUP
    /|  /|  /|  /|  /|  /|  /|
/ | / | / | / | / | / | / |
/  |/  |/  |/  |/  |/  |/  |

SDL_HAPTIC_SAWTOOTHDOWN
\  |\  |\  |\  |\  |\  |\  |
\ | \ | \ | \ | \ | \ | \ |
    \|  \|  \|  \|  \|  \|  \|

\since This struct is available since SDL 3.2.0.

\sa SDL_HAPTIC_SINE \sa SDL_HAPTIC_SQUARE \sa SDL_HAPTIC_TRIANGLE \sa SDL_HAPTIC_SAWTOOTHUP \sa SDL_HAPTIC_SAWTOOTHDOWN \sa SDL_HapticEffect

Meta