|
Size: 4413
Comment: Added Related Functions with SDL_HapticNewEffect.
|
Size: 4451
Comment: Updated with descriptions recently changed in header file, removed old comment.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 22: | Line 22: |
| ||Sint16||'''magnitude'''||peak value /* (units?) (like amplitude?) */ || | ||Sint16||'''magnitude'''||peak value; if negative, equivalent to 180 degrees extra phase shift /* (units?) (like amplitude?) */ || |
| Line 24: | Line 24: |
| ||Uint16||'''phase'''||horizontal shift given by hundredths of a cycle; see [[#phase|Remarks]] for details /* (what is being shifted? Is this what creates the flat tops? What is the definition of a cycle, 1 sec?) */ || | ||Uint16||'''phase'''||positive phase shift given by hundredth of a degree; see [[#phase|Remarks]] for details /* (Is this what creates the flat tops? What is the definition of a cycle, 1 sec?) */ || |
| Line 40: | Line 40: |
| A periodic effect consists of a wave-shaped effect that repeats itself over time. The type determines the shape of the wave and the other parameters determine the dimensions of the wave. | A periodic effect consists of a wave-shaped effect that repeats itself over time. The type determines the shape of the wave and the other parameters determine the dimensions of the wave. |
DRAFT |
SDL_HapticPeriodic
A structure that contains a template for a periodic effect.
Data Fields
Header |
||
Uint16 |
type |
the shape of the waves; see Remarks for details |
direction |
direction of the effect (relative to the user) |
|
Replay |
||
Uint32 |
length |
duration of the effect |
Uint16 |
delay |
delay before starting the effect |
Trigger |
||
Uint16 |
button |
button that triggers the effect |
Uint16 |
interval |
how soon it can be triggered again after button |
Periodic |
||
Uint16 |
period |
period of the wave |
Sint16 |
magnitude |
peak value; if negative, equivalent to 180 degrees extra phase shift |
Sint16 |
offset |
mean value of the wave |
Uint16 |
phase |
positive phase shift given by hundredth of a degree; see Remarks for details |
Envelope |
||
Uint16 |
attack_length |
duration of the attack |
Uint16 |
attack_level |
level at the start of the attack |
Uint16 |
fade_length |
duration of the fade |
Uint16 |
fade_level |
level at the end of the fade |
Code Examples
You can add your code example here
Remarks
A periodic effect consists of a wave-shaped effect that repeats itself over time. The type determines the shape of the wave and the other parameters determine the dimensions of the wave.
button period
press | |
|| __ __ __ __ __ _
|| | | | | | | | | | | magnitude
\/ | |__| |__| |__| |__| | _
-----
| offset?
delay phase?
-------------------------------------
length
===================================================
interval
type may be one of the following:
SDL_HAPTIC_SINE |
__ __ __ __ |
SDL_HAPTIC_SQUARE |
__ __ __ __ __ |
SDL_HAPTIC_TRIANGLE |
/\ /\ /\ /\ /\ |
SDL_HAPTIC_SAWTOOTHUP |
/| /| /| /| /| /| /| |
SDL_HAPTIC_SAWTOOTHDOWN |
\ |\ |\ |\ |\ |\ |\ | |
phase is given by hundredths of a cycle, 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 |
Related Structures
