.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_upload_haptic_effect" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_upload_haptic_effect - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

bool al_upload_haptic_effect(ALLEGRO_HAPTIC *hap,
   ALLEGRO_HAPTIC_EFFECT *effect, ALLEGRO_HAPTIC_EFFECT_ID *id)
\f[R]
.fi
.SH DESCRIPTION
.PP
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 \f[V]id\f[R] can be used to control playback of the effect.
Returns true if the effect was successfully uploaded, false if not.
.PP
The function al_get_max_haptic_effects(3alleg5) returns how many effects
can be uploaded to the device at the same time.
.PP
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).
.SH SINCE
.PP
5.1.8
.RS
.PP
\f[I][Unstable API]:\f[R] Perhaps could be simplified due to limited
support for all the exposed features across all of the platforms.
Awaiting feedback from users.
.RE