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

Revision as of 16:47, 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 accepts now a v4l palette name or a v4l palette number, as in linux/videodev.h:

v4l palette names:

       1  RGB24
       2  GREY
       3  HI240
       4  RGB565
       5  RGB24
       6  RGB32
       7  RGB555
       8  YUV422
       9  YUYV
       10 UYVY
       11 YUV420
       12 YUV411
       13 RAW
       14 YUV422P
       15 YUV411P
       16 YUV420P
       17 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/