---
name: "al_upload_haptic_effect"
section: "3alleg5"
platform: "linux"
package: "allegro5-doc"
version: "2:5.2.10.1+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/al_upload_haptic_effect/3alleg5"
---

# al\_upload\_haptic\_effect(3alleg5)

Allegro 5 API

## NAME

al\_upload\_haptic\_effect - Allegro 5 API

## SYNOPSIS

-

  ```
  #include <allegro5/allegro.h>
  bool al_upload_haptic_effect(ALLEGRO_HAPTIC *hap,
     ALLEGRO_HAPTIC_EFFECT *effect, ALLEGRO_HAPTIC_EFFECT_ID *id)
  ```

## DESCRIPTION

Uploads the haptic effect to the device. The haptic effect must have been filled in completely and correctly. You must also pass in a pointer to a user allocated ALLEGRO\_HAPTIC\_EFFECT\_ID(3alleg5). This `id` can be used to control playback of the effect. Returns true if the effect was successfully uploaded, false if not.

The function al\_get\_max\_haptic\_effects(3alleg5) returns how many effects can be uploaded to the device at the same time.

The same haptic effect can be uploaded several times, as long as care is taken to pass in a different ALLEGRO\_HAPTIC\_EFFECT\_ID(3alleg5).

## 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.