COMPUTER VISION APPLICATIONS FOR DIGITAL CINEMA POST-PRODUCTION
AQUINCUM INSTITUTE OF TECHNOLOGY
BUDAPEST, HUNGARY
SPRING 2017

Final Project: Video Stabilization
Grant Sorbo and Ionatan Kuperwajs

**See runme.sh for example commands for processing video files**

USAGE OVERVIEW
==============

1. Use ffmpeg to convert a video file to a JPEG image sequence
2. Run imgpro with the -stabilize command (and any arbitrary value as input)
	-input: the first jpg image in the sequence
	-output: location and naming convention of the first image
3. Imgpro will process translation data throughout your image sequence, outputting new frames to eliminate motion
4. Use ffmpeg to convert the output image sequence back to a video file

FEATURES
========

-RANSAC elimination: calculates accurate tracks by eliminating outliers for the current and future frames
-Automatic large motion recovery: if too many tracking points disappear, the program will re-track new points to continue providing accurate translation data

FILE STRUCTURE
==============

There are several files, but you should mainly change src/R2Image.cpp.

  src/ - Directory with source code
    Makefile - Unix/Mac makefile for building the project with "make". 
    imagepro.[vcproj/sln/suo] - Project file for Visual Studio 2005 on Windows
    imgpro.cpp - Main program, parses the command line arguments, and calls the appropriate image functions
    R2Image.[cpp/h] - Image class with processing functions (this is the only file that you need to edit)
    R2Pixel.[cpp/h] - Pixel class 
    R2/ - A library of useful 2D geometric primitives
    jpeg/ - A library for reading/writing JPEG files
  input/ - Contains example input images. 
  output/ - Es empty to start -- it will contain the images produced by your program (see below)
  runme.bat - a script (for Windows) that you will fill in to demonstrate execution of your program
  runme.sh - same as <code>runme.bat, but for Mac OS X

COMPILATION
===========

If you are developing on a Windows machine and have Visual Studio
installed, use the provided project solution file (assn1.sln) in the
src/ directory to build the program. If you are developing on a Mac or
Linux machine, cd into the src/ directory and type "make". In either
case, an executable called imgpro (or imgpro.exe) will be created in
the src/ directory.