virtualenv/FFmpeg
1
0
Fork 0
mirror of https://github.com/FFmpeg/FFmpeg.git synced 2024-12-23 12:43:46 +02:00
Code Issues Releases Activity

avcodec: fix avcodec_encode_audio() documentation.

Browse Source 
the previous documentation indicated how many bytes are read from the input,
not how many samples are read.
This commit is contained in:
Justin Ruggles 2011-12-30 19:35:45 -05:00
parent 15f073ee6d
commit 07837e4158
1 changed files with 8 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
libavcodec/avcodec.h
View File

@ -4200,9 +4200,9 @@ void avsubtitle_free(AVSubtitle *sub);
* Encode an audio frame from samples into buf. * Encode an audio frame from samples into buf.
* *
* @note The output buffer should be at least FF_MIN_BUFFER_SIZE bytes large. * @note The output buffer should be at least FF_MIN_BUFFER_SIZE bytes large.
* However, for PCM audio the user will know how much space is needed * However, for codecs with avctx->frame_size equal to 0 (e.g. PCM) the user
* because it depends on the value passed in buf_size as described * will know how much space is needed because it depends on the value passed
* below. In that case a lower value can be used. * in buf_size as described below. In that case a lower value can be used.
* *
* @param avctx the codec context * @param avctx the codec context
* @param[out] buf the output buffer * @param[out] buf the output buffer
@ -4210,8 +4210,11 @@ void avsubtitle_free(AVSubtitle *sub);
* @param[in] samples the input buffer containing the samples * @param[in] samples the input buffer containing the samples
* The number of samples read from this buffer is frame_size*channels, * The number of samples read from this buffer is frame_size*channels,
* both of which are defined in avctx. * both of which are defined in avctx.
* For PCM audio the number of samples read from samples is equal to * For codecs which have avctx->frame_size equal to 0 (e.g. PCM) the number of
* buf_size * input_sample_size / output_sample_size. * samples read from samples is equal to:
* buf_size * 8 / (avctx->channels * av_get_bits_per_sample(avctx->codec_id))
* This also implies that av_get_bits_per_sample() must not return 0 for these
* codecs.
* @return On error a negative value is returned, on success zero or the number * @return On error a negative value is returned, on success zero or the number
* of bytes used to encode the data read from the input buffer. * of bytes used to encode the data read from the input buffer.
*/ */