[FFmpeg-cvslog] lavu/samplefmt: fix/clarify documentation for av_samples_fill_arrays()
Stefano Sabatini
git at videolan.org
Sun Sep 9 11:42:07 CEST 2012
ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Sat Sep 8 01:18:09 2012 +0200| [eab438eabbefb44b35d2db05f233509bec0c3502] | committer: Stefano Sabatini
lavu/samplefmt: fix/clarify documentation for av_samples_fill_arrays()
In particular, avoid improper use of the term "channels" in place of
"planes", and fix erroneous documentation for the linesize parameter.
> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=eab438eabbefb44b35d2db05f233509bec0c3502
---
libavutil/samplefmt.h | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/libavutil/samplefmt.h b/libavutil/samplefmt.h
index d802810..2a7de20 100644
--- a/libavutil/samplefmt.h
+++ b/libavutil/samplefmt.h
@@ -158,16 +158,16 @@ int av_samples_get_buffer_size(int *linesize, int nb_channels, int nb_samples,
enum AVSampleFormat sample_fmt, int align);
/**
- * Fill channel data pointers and linesize for samples with sample
+ * Fill plane data pointers and linesize for samples with sample
* format sample_fmt.
*
- * The pointers array is filled with the pointers to the samples data:
+ * The audio_data array is filled with the pointers to the samples data planes:
* for planar, set the start point of each channel's data within the buffer,
* for packed, set the start point of the entire buffer only.
*
- * The linesize array is filled with the aligned size of each channel's data
- * buffer for planar layout, or the aligned size of the buffer for all channels
- * for packed layout.
+ * The value pointed to by linesize is set to the aligned size of each
+ * channel's data buffer for planar layout, or to the aligned size of the
+ * buffer for all channels for packed layout.
*
* The buffer in buf must be big enough to contain all the samples
* (use av_samples_get_buffer_size() to compute its minimum size),
More information about the ffmpeg-cvslog
mailing list