From 24a7f8314d49db513eaa0a18879d96b27632cc92 Mon Sep 17 00:00:00 2001 From: GWater Date: Fri, 14 Nov 2008 16:28:13 +0100 Subject: [PATCH] Update README Thanks to Leo Schwab our README is now easier to understand, has less wrong grammar and provides an example for libv4l usage. The out-of-date list of supported webcams was removed. A link to the more up-to-date online list remains. Signed-off-by: GWater --- README | 41 +++++++++++++++++++---------------------- 1 files changed, 19 insertions(+), 22 deletions(-) diff --git a/README b/README index a42a78e..1d153f9 100644 --- a/README +++ b/README @@ -12,8 +12,8 @@ This driver currently supports Skype v2.x, Ekiga v2.x & even aMSN Warning : The Microdia USB 2.0 Webcam Driver for SN9C20x chipset based Webcams is -currently under development. Using this driver can result in damage. -Use this driver only if you know what you are doing. +currently under development. Using this driver can result in damage and data +loss to your system. Use this driver only if you know what you are doing. -------------------------------------------------------------------------------- Table of contents : @@ -66,13 +66,16 @@ Table of contents : 1.3 Decoder Most video applications do not support the image encoding SN9C20x-based - webcams offer. To convert the image stream for such applications use - "libv4l". Most distributions offer precompiled packages. If yours does not, - the sources are available here : + webcams offer. Such applications need to have the image stream converted + for them. This can be done using "libv4l", which is pre-loaded between the + application and the video resource and translates the image stream into a + usable format. + + Most distributions offer precompiled packages. If yours does not, the + sources are available here : http://freshmeat.net/projects/libv4l/ - Instructions for use of libv4l are available here (chapter "V4L library") : - http://moinejf.free.fr/gspca_README.txt + Consult libv4l's README for usage details. -------------------------------------------------------------------------------- @@ -110,11 +113,15 @@ Table of contents : $ mplayer tv:// -tv driver=v4l2:width=640:height=480:fps=25:device=/dev/video0 -vo x11 $ mplayer tv:// -tv driver=v4l2:width=640:height=480:fps=25:device=/dev/video0 -vo xv - Note: Some applications require libv4l for decoding. (see "1.3 Decoder") + Note: Some applications require libv4l for image format decoding. (see "1.3 + Decoder") Consult libv4l documentation for full usage details. Here is an + example for a common usage : + $ LD_PRELOAD=/usr/lib/libv4l/v4l2convert.so mplayer tv:// -tv \ + driver=v4l2:width=640:height=480:fps=25:device=/dev/video0 -vo xv -------------------------------------------------------------------------------- -5. Install +5. Installation $ strip -g microdia.ko And as root : @@ -125,10 +132,10 @@ Table of contents : 6. Usage - We recommend to use v4l2ucp to improve image quality. + We recommend using v4l2ucp to adjust and improve image quality. http://sourceforge.net/projects/v4l2ucp/ - We also develop our own GUI, available here : + We are also developing our own GUI, available here : http://repo.or.cz/r/guimicrodia.git -------------------------------------------------------------------------------- @@ -137,17 +144,7 @@ Table of contents : The kernel module is currently under active development. - Currently the driver supports following webcam models : - 0c45:6242 - 0c45:624e - 0c45:624f - 0c45:6253 - 0c45:6260 - 0c45:6270 - 0c45:627b - 0c45:627f - 0c45:6288 - The full list can be found here : + The full list of supported webcams can be found here : http://groups.google.com/group/microdia/web/project-status -------------------------------------------------------------------------------- -- 1.5.6.5