vout: document the priority rules

diff --git a/modules/video_output/Makefile.am b/modules/video_output/Makefile.am
index a309c12b403a845462be26f9b6b5a04780053ced..8c8e5559312c9aab1654ee8e8807bf6a14974979 100644 (file)
--- a/modules/video_output/Makefile.am
+++ b/modules/video_output/Makefile.am
@@ -1,6 +1,8 @@
 voutdir = $(pluginsdir)/video_output
 vout_LTLIBRARIES =
 
+EXTRA_DIST += video_output/README
+
 if HAVE_DECKLINK
 libdecklinkoutput_plugin_la_SOURCES = video_output/decklink.cpp
 libdecklinkoutput_plugin_la_CXXFLAGS = $(AM_CFLAGS) $(CPPFLAGS_decklinkoutput)

diff --git a/modules/video_output/README b/modules/video_output/README
new file mode 100644 (file)
index 0000000..c4feb1a
--- /dev/null
+++ b/modules/video_output/README
@@ -0,0 +1,19 @@
+Video output display plugins
+=============================
+
+Priority rules
+---------------
+
+The priorities ranges are as follows since February 2011:
+
+ - less than  20: console (text)
+ - less than  50: plain frame buffers
+ - less than 100: no embedded windowing
+ - less than 150: SW scaling
+ - less than 200: SW chroma conversion
+ - rest: good stuff :-)
+
+No more than one plugin with a given non-zero riority.
+
+On Windows, native outputs are now priorized over XCB (as there now is
+a Win32 port of XCB).