al_play_haptic_effect(3alleg5)

al_play_haptic_effect3alleg5

Allegro 5 api

Usage

#include <allegro5/allegro.h>
bool al_play_haptic_effect(ALLEGRO_HAPTIC_EFFECT_ID *id, int loop)

Overview

Plays back a previously uploaded haptic effect. The play_id must be a valid ALLEGRO_HAPTIC_EFFECT_ID(3alleg5) obtained from al_upload_haptic_effect(3alleg5), al_upload_and_play_haptic_effect(3alleg5) or al_rumble_haptic(3alleg5).

The haptic effect will be played back loop times in sequence. If loop is less than or equal to 1, then the effect will be played once only.

This function returns immediately and doesn’t wait for the playback to finish. It returns true if the playback was started successfully or false if not.

Since

5.1.8

[Unstable API]: Perhaps could be simplified due to limited support for all the exposed features across all of the platforms. Awaiting feedback from users.

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13

From allegro5-doc 2:5.2.10.1+dfsg-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.