play_sample(3alleg4) [linux man page]
play_sample(3alleg4) Allegro manual play_sample(3alleg4) NAME
play_sample - Plays a sample. Allegro game programming library. SYNOPSIS
#include <allegro.h> int play_sample(const SAMPLE *spl, int vol, int pan, int freq, int loop); DESCRIPTION
Triggers a sample at the specified volume, pan position, and frequency. The parameters `vol' and `pan' range from 0 (min/left) to 255 (max/right). Frequency is relative rather than absolute: 1000 represents the frequency that the sample was recorded at, 2000 is twice this, etc. If `loop' is not zero, the sample will repeat until you call stop_sample(), and can be manipulated while it is playing by call- ing adjust_sample(). Example: /* Scream from the left speaker, twice the freq. */ int sound = play_sample(scream, 255, 0, 2000, 0); RETURN VALUE
Returns the voice number that was allocated for the sample or negative if no voices were available. SEE ALSO
install_sound(3alleg4), load_sample(3alleg4), adjust_sample(3alleg4), stop_sample(3alleg4), exsample(3alleg4), exsprite(3alleg4) Allegro version 4.4.2 play_sample(3alleg4)
Check Out this Related Man Page
play_sample(3alleg4) Allegro manual play_sample(3alleg4) NAME
play_sample - Plays a sample. Allegro game programming library. SYNOPSIS
#include <allegro.h> int play_sample(const SAMPLE *spl, int vol, int pan, int freq, int loop); DESCRIPTION
Triggers a sample at the specified volume, pan position, and frequency. The parameters `vol' and `pan' range from 0 (min/left) to 255 (max/right). Frequency is relative rather than absolute: 1000 represents the frequency that the sample was recorded at, 2000 is twice this, etc. If `loop' is not zero, the sample will repeat until you call stop_sample(), and can be manipulated while it is playing by call- ing adjust_sample(). Example: /* Scream from the left speaker, twice the freq. */ int sound = play_sample(scream, 255, 0, 2000, 0); RETURN VALUE
Returns the voice number that was allocated for the sample or negative if no voices were available. SEE ALSO
install_sound(3alleg4), load_sample(3alleg4), adjust_sample(3alleg4), stop_sample(3alleg4), exsample(3alleg4), exsprite(3alleg4) Allegro version 4.4.2 play_sample(3alleg4)