# HG changeset patch
# User reimar
# Date 1346864561 0
# Node ID b371a630600cb5275fdc1e65cd17487d6874e3b7
# Parent  66f91ad84f3a3713b74304b38f108139adf5d5d1
Update description of MP_IMGFLAG_READABLE.

diff -r 66f91ad84f3a -r b371a630600c libmpcodecs/mp_image.h
--- a/libmpcodecs/mp_image.h	Tue Sep 04 21:08:50 2012 +0000
+++ b/libmpcodecs/mp_image.h	Wed Sep 05 17:02:41 2012 +0000
@@ -28,7 +28,14 @@
 //--- buffer content restrictions:
 // set if buffer content shouldn't be modified:
 #define MP_IMGFLAG_PRESERVE 0x01
-// set if buffer content will be READ for next frame's MC: (I/P mpeg frames)
+// set if buffer content will be READ.
+// This can be e.g. for next frame's MC: (I/P mpeg frames) -
+// then in combination with MP_IMGFLAG_PRESERVE - or it
+// can be because a video filter or codec will read a significant
+// amount of data while processing that frame (e.g. blending something
+// onto the frame, MV based intra prediction).
+// A frame marked like this should not be placed in to uncachable
+// video RAM for example.
 #define MP_IMGFLAG_READABLE 0x02
 
 //--- buffer width/stride/plane restrictions: (used for direct rendering)