GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GET_AUDIO_STREAM_BUFFER (3)

NAME

get_audio_stream_buffer - Tells you if you need to fill the audiostream or not. Allegro game programming library.

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

#include <allegro.h>

void *get_audio_stream_buffer(AUDIOSTREAM *stream);

DESCRIPTION

You must call this function at regular intervals while an audio stream is playing, to provide the next buffer of sample data (the smaller the stream buffer size, the more often it must be called). This function should not be called from a timer handler. Example:

   void *mem_chunk;
   ...
   while (TRUE) {
      ...
      mem_chunk = get_audio_stream_buffer(buffer);
      if (mem_chunk != NULL) {
         /* Refill the stream buffer. */
      }
   }

RETURN VALUE

If it returns NULL, the stream is still playing the previous lot of data, so you don’t need to do anything. If it returns a value, that is the location of the next buffer to be played, and you should load the appropriate number of samples (however many you specified when creating the stream) to that address, for example using an fread() from a disk file. After filling the buffer with data, call free_audio_stream_buffer() to indicate that the new data is now valid.

SEE ALSO

play_audio_stream(3), free_audio_stream_buffer(3), exstream(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro GET_AUDIO_STREAM_BUFFER (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.