[Mplayer-cvslog] CVS: main/DOCS/tech libmpcodecs.txt,1.8,1.9

[Diego Biurrun CVS]

Update of /cvsroot/mplayer/main/DOCS/tech
In directory mail:/var/tmp.root/cvs-serv9772

Modified Files:
	libmpcodecs.txt 
Log Message:
Merged video filter description from vop.txt.


Index: libmpcodecs.txt
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/tech/libmpcodecs.txt,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- libmpcodecs.txt	22 Mar 2003 12:02:25 -0000	1.8
+++ libmpcodecs.txt	26 Mar 2003 00:53:15 -0000	1.9
@@ -111,7 +111,30 @@
    filter have to implement the whole filter api.
    Leaf filters are now: vf_vo.c (wrapper over libvo) and ve_XXX.c (video
    encoders used by mencoder).
+
    
+Video Filters
+=============
+
+Video filters are plugin-like code modules implementing the interface
+defined in vf.h.
+
+Basically it means video output manipulation, i.e. these plugins can
+modify the image and the image properties (size, colorspace etc) between
+the video decoders (vd.h) and the output layer (libvo or video encoders).
+
+The actual API is a mixture of the video decoder (vd.h) and libvo
+(video_out.h) APIs.
+
+main differences:
+- vf plugins may be "loaded" multiple times, with different parameters
+  and context - it's new in MPlayer, old APIs weren't reentrant.
+- vf plugins don't have to implement all functions - all functions have a
+  'fallback' version, so the plugins only override these if wanted.
+- Each vf plugin has its own get_image context, and they can interchange
+  images/buffers using these get_image/put_image calls.
+
+
 The VIDEO FILTER API:
 =====================
 filename: vf_FILTERNAME.c
@@ -347,6 +370,7 @@
 btw, u should avoid using global or static variables, to store filter instance 
 specific stuff, as filters might be used multiple times & in the future even
 multiple streams might be possible
+
 
 The AUDIO path:
 ===============