OpenCV Module in Slicer3

Steps to Build and Use OpenCV Module

My operating system

The following Linux system is my desktop where this tutorial is based on:
Ubuntu 8.04 - the Hardy Heron - released in April 2008.
Linux brainlab-desktop 2.6.24-23-generic #1 SMP Mon Jan 26 00:13:11 UTC 2009 i686 GNU/Linux

Test camera

1. My camera is Logitech QuickCam Pro for Noteboks
2. If you don't have a tool called "luvcview," you can get it using this command "sudo apt-get install luvcview"
3. Plug in the camera to any usb port on your computer
4. Run luvcview

In a few seconds you should see video displayed in luvcview

Compile Slicer3

• To include OpenCV module into your Slicer3 build, open this file:

Slicer3/slicer_variables.tcl
and set ::USE_OPENCV to "ON"

• The compiling process will automatically download and build OpenCV 1.0 from http://sourceforge.net/projects/opencvlibrary/files/.

Test the system

Video from a camera is displayed in the second window of OpenCV module in Slicer3.

1. Plug in your camera into any usb port
2. Bring Slicer up
3. Go to the modules list in Slicer3 interface
4. Pick OpenCV module
5. Press the button "second window on"

You should see video from the camera in a few seconds.

Future Work

1. OpenCV 1.0 library is now built automatically as one of the external libraries in Slicer3 if we turn it on. OpenCV module in Slicer3 is then built on top of the OpenCV l.0 library. If we want to use OpenCV 1.1 in the future, we need figure out why our module fails to compile with OpenCV 1.1.
2. More testing of the functionality in OpenCV module.

Bug Fixes

• There is a bug in OpenCV related to V4L2 devices:
  • Here is the bugtrac with information: [[1]]
    • Somehow this is related to bttv 878 cards. OpenCV seem not to be able to handle all output of the card correctly
  • Here is the fix [[2]]
    • Apply the changes of revision 1609 to the file # opencv/src/highgui/cvcap_v4l.cpp