Difference between revisions of "AVLD - Another Video Loopback Device"

Revision as of 16:17, 19 September 2008

AVLD is a video loopback device for GNU-Linux, written by Pierre Parent and licensed under GPL.

With AVLD you can use Elphel cameras for image acquisition in v4l (version 1) compatible applications, video conferencing, etc

Video is playing smoothly on a 2.4Ghz dual core notebook at 25fps in 1440x896,

and CPU usage is 'only' 20-25% per core

Accessing Elphel camera streams through a v4l device (eg: /dev/video0)

After loading the AVLD module, indicating the maximum frame size you will use:

modprobe avld width=1440 height=896 fps=0

You just have to feed the video device:

mencoder rtsp://192.168.0.9 -nosound -ovc raw -vf format=bgr24 -of rawvideo -o /dev/video0

(or /dev/video1 if you had already another video device driver loaded before)

And you can play the stream for testing:

mplayer tv:// -tv driver=v4l:device=/dev/video0:outfmt=rgb24 -cache 8192 -vo xv

You can change the device parameters when module is already loaded with:

echo "width=800 height=600 fps=0" > /dev/video0

Helper scripts

Note: To run those scripts you must patch avld/video_driver.c and rebuild the module before, using the patches found on the section below.

http://community.elphel.com/files/avld/avldfeed

http://community.elphel.com/files/avld/avldplay

For skype, use avldfeed options WIDTH=640 HEIGHT=480 FPS=25 FORMAT=uyvy DEPTH=24 SCALE=sntsc FILTER=none, but generally FORMAT (mencoder notation for palette) is bgr24

Usage: avldfeed [ -h ] [ <configuration_file> ] [ <OPTION=value> ... ]

OPTIONS:

      URL=<value>
      DEVICE=<value>
      WIDTH=<value>
      HEIGHT=<value>
      FPS=<-1|0|value>
      FORMAT=<bgr24|uyvy|...> (mencoder notation for v4l PALETTE)
      PALETTE=<RGB24|UYVY|...> (overriden by FORMAT)
      SCALE=<none|qntsc|qpal|ntsc|pal|sntsc|spal>
      FILTER=<none|mencoder_filter_chain>
      DEPTH=<value>

avldfeed send the specified video stream to the avld video device.

Previous parameters are saved in ~/.avldfeed so that you can
run the command again with no parameters or a subset, or with a
configuration file as first command argument (it will
replace ~/.avldfeed)

avld-0.13 patches

http://community.elphel.com/files/avld/avld_0.13-VIDIOCGWIN_null_framesize+skype_compatibility+palette_change+depth_change+more.patch

(apply with "patch -P0 < filename.patch" in the avld sourcecode directory)

Opencv v4l capture initialization method was receiving a null frame size when it was run before watching once the stream with mplayer which is using an alternative initialization method.

I found a patch for skype compatibility on http://doc.ubuntu-fr.org/webcamvirtuelle

And I did add "palette" to the list of the avld module expected arguments, it expects now a v4l palette name, as in linux/videodev.h:

v4l palette names:

       RGB24
       GREY
       HI240
       RGB565
       RGB24
       RGB32
       RGB555
       YUV422
       YUYV
       UYVY
       YUV420
       YUV411
       RAW
       YUV422P
       YUV411P
       YUV420P
       YUV410P

It could break compatibility with applications using an older module version since "palette" and "depth" are now mandatory when changing the module parameters. But it avoid scanning twice the video buffer and remove the necessity to reload the module when those parameters must be changed.

Applications that are unaware of avld and aren't changing the avld parameters themselves are not affected.

AVLD homepage: http://allonlinux.free.fr/Projets/AVLD/