al_set_haptic_gain(3)

🌸 NAME 🌸

al_set_haptic_gain — Allegro 5 API. This is the Allegro 5 API manual page for setting a haptic device’s gain, bestie. 💖

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

bool al_set_haptic_gain(ALLEGRO_HAPTIC *hap, double gain)

💅 DESCRIPTION 💅

Okay so al_set_haptic_gain sets the gain of the haptic device — but only if the device supports it. Gain is much like volume for sound: it’s as if every effect’s intensity is multiplied by it. Gain is a value between 0.0 and 1.0. It returns true if set successfully, false if not. 🫶

It only works if al_get_haptic_capabilities(3) returns a value that has ALLEGRO_HAPTIC_GAIN(3)ALLEGRO_HAPTIC_CONSTANTS(3) set. If not, this function returns false, and all effects will be played without any gain influence. No cap, that’s just the vibe. 😭

🦋 SINCE 🦋

5.1.8

[Unstable API]: this might get simplified, because support for all the exposed features is limited across all of the platforms, and the team is awaiting feedback from users. 🙈

---

source/version: Allegro reference manual — date: not listed on this footer, bestie. 💜