NAME

       al_set_sample - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_audio.h>

              bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data)

DESCRIPTION

       Change the sample data that a sample instance plays.  This can be quite an involved process.

       First, the sample is stopped if it is not already.

       Next, if data is NULL, the sample is detached from its parent (if any).

       If  data  is  not  NULL,  the  sample may be detached and reattached to its parent (if any).  This is not
       necessary if the old sample data and  new  sample  data  have  the  same  frequency,  depth  and  channel
       configuration.  Reattaching may not always succeed.

       On  success,  the  sample  remains stopped.  The playback position and loop end points are reset to their
       default values.  The loop mode remains unchanged.

       Returns true on success, false on failure.  On failure, the sample will be stopped and detached from  its
       parent.

SEE ALSO

       al_get_sample(3alleg5)