adjust_sample(3alleg4) [mojave man page]

adjust_sample(3alleg4)						  Allegro manual					    adjust_sample(3alleg4)

NAME

       adjust_sample - Alters the parameters of a sample while it is playing. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       void adjust_sample(const SAMPLE *spl, int vol, int pan, int freq, int loop);

DESCRIPTION

       Alters  the  parameters	of  a  sample while it is playing (useful for manipulating looped sounds). You can alter the volume, pan, and fre-
       quency, and can also clear the loop flag, which will stop the sample when it next reaches the end of its loop. The values of the parameters
       are  just  like	those  of  play_sample().  If there are several copies of the same sample playing, this will adjust the first one it comes
       across. If the sample is not playing it has no effect.

SEE ALSO

       play_sample(3alleg4), exsample(3alleg4)

Allegro 							   version 4.4.2					    adjust_sample(3alleg4)

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)