Document slice ordering assumption required by avfilter_draw_slice().

The assumption depends on the corresponding assumption done by
sws_scale() and by the scale filter.


git-svn-id: file:///var/local/repositories/ffmpeg/trunk@20655 9553f0bf-9b14-0410-a0b8-cfaf0461ba5b

libavfilter/avfilter.h

@@ -558,6 +558,11 @@ void avfilter_end_frame(AVFilterLink *link);
 
 /**
  * Sends a slice to the next filter.
+ *
+ * Slices have to be provided in sequential order, either in
+ * top-bottom or bottom-top order. If slices are provided in
+ * non-sequential order the behavior of the function is undefined.
+ *
  * @param link the output link over which the frame is being sent
  * @param y    offset in pixels from the top of the image for this slice
  * @param h    height of this slice in pixels