virtualenv/FFmpeg
1
0
Fork 0
mirror of https://github.com/FFmpeg/FFmpeg.git synced 2025-01-13 21:28:01 +02:00
Code Issues Releases Activity

extend description of avcodec_decode_audio3:

Browse Source 
- clarify when 0 is returned
- explain that decode_audio3 has to be called multiple times when there
  are multiple frames in a single packet

Originally committed as revision 20215 to svn://svn.ffmpeg.org/ffmpeg/trunk
This commit is contained in:
Sascha Sommer 2009-10-12 19:50:31 +00:00
parent 90aa6ace63
commit 933e866735
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
libavcodec/avcodec.h
View File

@ -3228,9 +3228,11 @@ attribute_deprecated int avcodec_decode_audio2(AVCodecContext *avctx, int16_t *s
/** /**
* Decodes the audio frame of size avpkt->size from avpkt->data into samples. * Decodes the audio frame of size avpkt->size from avpkt->data into samples.
* Some decoders may support multiple frames in a single AVPacket, such * Some decoders may support multiple frames in a single AVPacket, such
* decoders would then just decode the first frame. * decoders would then just decode the first frame. In this case,
* avcodec_decode_audio3 has to be called again with an AVPacket that contains
* the remaining data in order to decode the second frame etc.
* If no frame * If no frame
* could be decompressed, frame_size_ptr is zero. Otherwise, it is the * could be outputted, frame_size_ptr is zero. Otherwise, it is the
* decompressed frame size in bytes. * decompressed frame size in bytes.
* *
* @warning You must set frame_size_ptr to the allocated size of the * @warning You must set frame_size_ptr to the allocated size of the
@ -3260,7 +3262,7 @@ attribute_deprecated int avcodec_decode_audio2(AVCodecContext *avctx, int16_t *s
* data and size, some decoders might in addition need other fields. * data and size, some decoders might in addition need other fields.
* All decoders are designed to use the least fields possible though. * All decoders are designed to use the least fields possible though.
* @return On error a negative value is returned, otherwise the number of bytes * @return On error a negative value is returned, otherwise the number of bytes
* used or zero if no frame could be decompressed. * used or zero if no frame data was decompressed (used) from the input AVPacket.
*/ */
int avcodec_decode_audio3(AVCodecContext *avctx, int16_t *samples, int avcodec_decode_audio3(AVCodecContext *avctx, int16_t *samples,
int *frame_size_ptr, int *frame_size_ptr,