diff options
Diffstat (limited to 'DOCS/OUTDATED-tech/libao2.txt')
-rw-r--r-- | DOCS/OUTDATED-tech/libao2.txt | 56 |
1 files changed, 0 insertions, 56 deletions
diff --git a/DOCS/OUTDATED-tech/libao2.txt b/DOCS/OUTDATED-tech/libao2.txt deleted file mode 100644 index 49cb0284f7..0000000000 --- a/DOCS/OUTDATED-tech/libao2.txt +++ /dev/null @@ -1,56 +0,0 @@ -6. libao2: this control audio playing - - As in libvo (see 5.) also here are some drivers, based on the same API: - -static int control(int cmd, int arg); - This is for reading/setting driver-specific and other special parameters. - Not really used for now. - -static int init(int rate,int channels,int format,int flags); - The init of driver, opens device, sets sample rate, channels, sample format - parameters. - Sample format: usually AFMT_S16_LE or AFMT_U8, for more definitions see - dec_audio.c and linux/soundcards.h files! - -static void uninit(void); - Guess what. - Ok I help: closes the device, not (yet) called when exit. - -static void reset(void); - Resets device. To be exact, it's for deleting buffers' contents, - so after reset() the previously received stuff won't be output. - (called if pause or seek) - -static int get_space(void); - Returns how many bytes can be written into the audio buffer without - blocking (making caller process wait). MPlayer occasionally checks the - remaining space and tries to fill the buffer with play() if there's free - space. The buffer size used should be sane; a buffer that is too small - could run empty before MPlayer tries filling it again (normally once per - video frame), a buffer that is too big would force MPlayer decode the file - far ahead trying to find enough audio data to fill it. - -static int play(void* data,int len,int flags); - Plays a bit of audio, which is received throught the "data" memory area, with - a size of "len". It has to copy the data, because they can be overwritten - after the call is made. Doesn't have to use all the bytes; it has to - return the number of bytes used used (copied to buffer). If - flags|AOPLAY_FINAL_CHUNK is true then this is the last audio in the file. - The purpose of this flag is to tell aos that round down the audio played - from "len" to a multiple of some chunksize that this "len" should not be - rounded down to 0 or the data will never be played (as MPlayer will never - call play() with a larger len). - -static float get_delay(void); - Returns how long time it will take to play the data currently in the - output buffer. Be exact, if possible, since the whole timing depends - on this! In the worst case, return the maximum delay. - -!!! Because the video is synchronized to the audio (card), it's very important -!!! that the get_delay function is correctly implemented! - -static void audio_pause(void); - Pause playing but do not delete buffered data if possible. - -static void audio_resume(void); - Continue playing after audio_pause(). |