diff README @ 0:5f21a4dddc0c

Initial checkin

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Sun Apr 01 05:22:43 2007 +0000
@@ -0,0 +1,68 @@
+vloopback is a video4linux driver providing video pipes.
+With the driver you can use the output of a user program to feed a program that
+would normally communicate with a video4linux device.
+To achieve this a video pipe consists out of two video4linux devices:
+one for the generating program to write its data to and one for a normal
+video4linux program to read from.
+
+At the moment there are only few programs that can feed the input of the pipe:
+invert and resize, the example programs with the driver and
+motion, my motion detection program.
+
+Just type 'make' and then 'insmod vloopback'.
+If you want more pipes use 'insmod vloopback pipes=N' with N between 1 and 16.
+If you want to create spare pipes use 'spares=N'.
+
+Type 'dmesg' to see which video devices have been created as input and output.
+For example: if you have a camera on /dev/video0 the input pipe will most likely
+be /dev/video1 and the output on /dev/video2.
+e.g. if you want to watch an inverted image of the camera you would start invert
+with /dev/video0 as its input and /dev/video1 as its output.
+Then start a viewing app (such as camstream or xawtv) with as input /dev/video2
+and you can see yourself inverted.
+
+This is a very experimental device driver!
+SMP should work from 0.2 on..... but is untested!
+If it troubles you fix it or tell me how to fix it :)
+
+Using vloopback with xawtv:
+As of 0.83 xawtv will work with vloopback outputs, but you will have to specify
+the size to use. For example: 'xawtv -c /dev/video2 -geometry 320x240'
+
+Jeroen Vreeken, [e-mail]
+
+-------------------------------------------------------------------------------
+
+Module has experimental support for kernel 2.6.x .
+The current version 1.0 has been tested with kernel 2.6.x ( not with >= 2.6.16 ).
+
+To compile and install :
+
+make ; su - ; make install
+/sbin/modprobe videodev 
+/sbin/modprobe vloopback
+
+To uninstall :
+
+make uninstall ( as root ).
+
+- Problems :
+
+* If you got this message after 'insmod ./vloopback.ko' :
+
+ "insmod: error inserting './vloopback.ko': -1 Unknown symbol in module" 
+
+  Solution : You must load videodev module :
+
+ 'insmod videodev ; insmod ./vloopback.ko'
+
+* If you got this message after 'modprobe vloopback [options]' :
+
+ "FATAL: Error inserting vloopback (/lib/modules/2.6.8-1-k7/kernel/drivers/misc/vloopback.ko): Too many open files in system"
+
+ You probably used dev_offset= as a option , but the video device that vloopback was trying to register was already in use, maybe the value used for dev_offeset was too high.
+
+  Solution : Try to use a lower value for dev_offset= or even better don't use it .
+
+Angel Carpintero, [e-mail]
+Kenneth Lavrsen, [e-mail]