NAME

       al_get_haptic_gain - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              double al_get_haptic_gain(ALLEGRO_HAPTIC *hap)

DESCRIPTION

       Returns  the  current gain of the device.  Gain is much like volume for sound, it is as if
       every effect's intensity is multiplied by it.  Gain is a value between 0.0 and 1.0.   Only
       works   correctly   if   al_get_haptic_capabilities(3alleg5)  returns  a  value  that  has
       ALLEGRO_HAPTIC_GAIN(3alleg5)ALLEGRO_HAPTIC_CONSTANTS(3alleg5) set.  If this  is  not  set,
       this  function  will  simply  return  1.0  and all effects will be played without any gain
       influence.

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.