1al_upload_and_play_haptic_effect(3) al_upload_and_play_haptic_effect(3)
2
3
4
6 al_upload_and_play_haptic_effect - Allegro 5 API
7
9 #include <allegro5/allegro.h>
10
11 bool al_upload_and_play_haptic_effect(ALLEGRO_HAPTIC *hap,
12 ALLEGRO_HAPTIC_EFFECT *effect, ALLEGRO_HAPTIC_EFFECT_ID *id, int loop)
13
15 Uploads the haptic effect to the device and starts playback immediate‐
16 ly. Returns true if the upload and playback were successful, false if
17 either failed.
18
19 In case false is returned, the haptic effect will be automatically re‐
20 leased as if al_release_haptic_effect(3) had been called, so there is
21 no need to call it again manually in this case. However, if true is
22 returned, it is necessary to call al_release_haptic_effect(3) when the
23 effect isn’t needed anymore, to prevent the amount of available effects
24 on the haptic devicefrom running out.
25
27 5.1.8
28
29 [Unstable API]: Perhaps could be simplified due to limited sup‐
30 port for all the exposed features across all of the platforms.
31 Awaiting feedback from users.
32
34 al_upload_haptic_effect(3), al_play_haptic_effect(3)
35
36
37
38Allegro reference manual al_upload_and_play_haptic_effect(3)