changeset 5244:d8fd45a16beb

a bit update to libvo1.5, i think we should make a seperate documentation

--- a/DOCS/tech/general.txt	Thu Mar 21 16:44:15 2002 +0000
+++ b/DOCS/tech/general.txt	Thu Mar 21 17:11:38 2002 +0000
@@ -204,26 +204,48 @@
 	 we have to change to the desired bpp. If the hardware doesn't support,
 	 we have to change to the one closest to it, and do conversion!
 
-    control()  -  sends control requests to the device
-	 VOCTRL_QUERY_VAA  -  this is used by the vidix extension
-		this is used by the vidix extension to fill a vo_vaa_t struct,
-		I do not know how this works since I'm not the author of this
-		      
+    preinit():
+	init the video system (to support querying for supported formats)
+	THIS IS CALLED ONLY ONCE
+
+    control():
+      Current controls:
 	 VOCTRL_QUERY_FORMAT  -  queries if a given pixelformat is supported.
 		return value:   flags:
 		    0x1	 -  supported
 		    0x2  -  supported without conversion (define 0x1 too!)
 		    0x4  -  sub/osd supported (has draw_alpha)
 		    0x8  -  hardware handles subpics
-		    0x100  -  driver/hardware handles timing (blocking)
-		
+		    0x100  -  driver/hardware handles timing (blocking)		
+	 VOCTRL_GET_IMAGE
+		libmpcodecs Direct Rendering interface
+		You need to set mpi (mp_image.h) structure, for example,
+		look at vo_x11, vo_sdl, vo_xv or mga_common.
 	 VOCTRL_RESET  -  reset the video device
 		This is sent on seeking and similar and is useful if you are
 		using a device which prebuffers frames that need to flush them
 		before refilling audio/video buffers.
+	 VOCTRL_PAUSE
+	 VOCTRL_RESUME
+	 VOCTRL_GUISUPPORT
+		return true only if driver supports co-operation with
+		MPlayer's GUI (not yet used by GUI)
+	 VOCTRL_QUERY_VAA  -  this is used by the vidix extension
+		this is used by the vidix extension to fill a vo_vaa_t struct,
+		I do not know how this works since I'm not the author of this
+		      
+    config():	
+      Set up the video system. You get the dimensions and flags.
+      Flags:
+        0x01	- fullscreen (-fs)
+	0x02	- mode switching (-vm)
+	0x04	- software scaling (-zoom)
+	0x08	- flipping (-flip) -- REQUIRED to support this
+      Also these flags you can get from vo_flags too and they're
+      defined as VOFLAG_* (see libvo/video_out.h)
 
-    init()  -  this is called before displaying of the first frame -
-	 initializing buffers, etc.
+    uninit():
+      Uninit the whole system, this is on the same "level" as preinit.
 
     draw_slice(): this displays YV12 pictures (3 planes, one full sized that
 	 contains brightness (Y), and 2 quarter-sized which the colour-info