ITK Release 4/Video/HowToBuildVideoModules

There are five video modules in ITKv4 at the moment: Core, Filtering, IO, BridgeOpenCV and BridgeOpenVXL.

The first three modules(Core, Filtering and IO) do not depend on third party libraries. By default (when ITK_BUILD_ALL_MODULES is ON), the three modules are included in the build tree.

However, if you want to use BridgeOpenCV and BridgeOpenVXL, Make sure you have the newer versions of OpenCV and VXl installed on your system with the following instructions:

Build BridgeOpenCV

1. Build OpenCV: We recommend to use opencv 2.4.2 or later. Get the source code using Git:

       git clone git@github.com:Itseez/opencv.git
       git checkout 2.4.2

Use CMake to build opencv with the following configuration:

       BUILD_EXAMPLES = OFF
       BUILD_TESTS = OFF
       WITH_FFMPEG = ON

2. Enable BridgeOpenCV module when configuring ITK in CMake:

        Module_ITKVideoBridgeOpenCV = ON (need to manually toggle this option ON)

Then, set system library Paths for OpenCV accordingly:

        OpenCV_DIR = <the path where you build the OpenCV>
        

Build BridgeVXL

1. Build VXL:

       svn co https://vxl.svn.sourceforge.net/svnroot/vxl/trunk vxl

The revision number tested is 34805 ( 2012-04-23). Later version should work (not validated). Use CMake to build opencv with the following configuration:

       BUILD_EXAMPLES = OFF
       BUILD_DOCUMENTATION = OFF

The minimum libraries needed in VXL configuration to build ITKVideoBridgeVXL are:

       BUILD_CORE_VIDEO = ON
       BUILD_CORE_UTILITIES = ON (contains vil)
       BUILD_CORE_IMAGING = ON (contains vul)
       BUILD_CORE_NUMERICS = ON (contains vnl)

Also make sure you have FFMPEG installed that the following paths were found:

       FFMPEG_avcodec_LIBRARY
       FFMPEG_avformat_LIBRARY
       FFMPEG_avutil_LIBRARY
       FFMPEG_swscale_LIBRARY

2. Enable BridgeOpenVXL when configuring ITK in CMake:

        Module_ITKVideoBridgeVXL = ON  (need to manually toggle this option ON)

Then, set system library Paths for VXL accordingly :

        VXL_DIR = <the path where you build the VXL>