summaryrefslogtreecommitdiffstats
path: root/DOCS/tech/libao2.txt
diff options
context:
space:
mode:
authorwm4 <wm4@mplayer2.org>2012-07-28 18:15:33 +0200
committerwm4 <wm4@mplayer2.org>2012-07-28 20:44:59 +0200
commit5368c46453223acf87de7ef89a35a37402c2d8eb (patch)
tree051bf39b80c5fbbb5212ecc93ef3531031194640 /DOCS/tech/libao2.txt
parentf606bb6d97cfdfb8f740259eb4ea683adddfd06b (diff)
downloadmpv-5368c46453223acf87de7ef89a35a37402c2d8eb.tar.bz2
mpv-5368c46453223acf87de7ef89a35a37402c2d8eb.tar.xz
Rename DOCS/tech/ to DOCS/OUTATED-tech/
While DOCS/tech/ contains lots of documentation about mplayer's internals, most of it seems outdated, and hasn't been touched in many years. On the other hand, there still might be useful things in there, but it's hard to tell which parts. Instead of deleting all it, rename the directory to "warn" potential developers that the documentation is completely outdated.
Diffstat (limited to 'DOCS/tech/libao2.txt')
-rw-r--r--DOCS/tech/libao2.txt56
1 files changed, 0 insertions, 56 deletions
diff --git a/DOCS/tech/libao2.txt b/DOCS/tech/libao2.txt
deleted file mode 100644
index 49cb0284f7..0000000000
--- a/DOCS/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().