CppMT Replay

Robert Haines, University of Manchester, UK

Synopsis

Combine CppMT object tracking data with the original video for verification and further use.

Usage

This program takes a video and associated object tracking data output from CppMT (using the --output-file switch) and combines the two, overlaying the bounding box outline and centre point in the output video.

$ cmt-replay <video-input> <data-input> [output-directory]

The output video file is named automatically using the input video filename to ensure that a combination of codec and container that OpenCV can write to is used. For example, an input video file named video.mp4 will produce an output video file named video_out.avi. OpenCV can read the mp4 container but cannot write to it.

If the output-directory parameter is supplied the output video file will be written to that directory, otherwise it will be written to the same directory as the input video file.

Dependencies

CppMT-replay requires OpenCV version 2.4 to build and run. It is built using CMake version 2.6 or later.

Building

With CMake you build software "out of source", that is you leave the source code tree clean and build in a different directory.

1. From an empty directory point cmake at the source for CppMT-replay:

$ cmake /path/to/CppMT-replay

1. Provided that your OpenCV installation can be found, all you need to do now is call make in the same directory:

$ make

And cmt-replay will be ready to use.

See the CMake documentation for more information and instructions for Windows and MacOS X.

Acknowledgements

CppMT-replay was developed in the IDInteraction project, funded by the Engineering and Physical Sciences Research Council, UK through grant agreement number EP/M017133/1.

Licence

Copyright (c) 2015 The University of Manchester, UK.

BSD Licenced. See LICENCE for details.