[FFmpeg-devel] [PATCH] avutil/frame: document alignment and padding requirements

[Michael Niedermayer]

Signed-off-by: Michael Niedermayer <michaelni at gmx.at>
---
 libavutil/frame.h |    8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/libavutil/frame.h b/libavutil/frame.h
index 8fc5814..2330840 100644
--- a/libavutil/frame.h
+++ b/libavutil/frame.h
@@ -78,6 +78,11 @@ typedef struct AVFrame {
     /**
      * pointer to the picture/channel planes.
      * This might be different from the first allocated byte
+     *
+     * Some decoders access areas outside 0,0 - width,height, please
+     * see avcodec_align_dimensions2(). Some filters can read upto 16 bytes
+     * beyond the planes, if these filters are to be used, then 16 extra
+     * bytes must be allocated.
      */
     uint8_t *data[AV_NUM_DATA_POINTERS];
 
@@ -87,6 +92,9 @@ typedef struct AVFrame {
      *
      * For audio, only linesize[0] may be set. For planar audio, each channel
      * plane must be the same size.
+     *
+     * For video the linesizes should be multiplies of the CPUs alignment
+     * preferrance. This is 16 or 32 for modern desktop CPUs
      */
     int linesize[AV_NUM_DATA_POINTERS];
 
-- 
1.7.9.5