Image Clipper Plus

This is a variation of the imageclipper program initially written by Naotoshi Seo.

I made this program so that I could draw many boxes on one image as well as boxes for different objects. For example I want to draw a box for a person's face and eyes at the same time.

Building

To build you need OpenCV and Python on your system. I created using opencv 3.0, but it doesnt use anything new from previous versions.

TODO: Remove the packages dependency on opencv

Install

Build the repo using the following command:

$ git clone <repo url>

Usage

To use the code, go to the directory that it is installed, then simply run:

$ python imageclipper_plus.py 'path/to/images/'

You can also see how to use the program and all the options with:

$ python imageclipper_plus.py --help

Once the program is run from the command line, a window will open with the first image. You will have to press tab initially for keyboard functionality. For some reason the initial tab is needed to select the canvas. The following commands and their usage are found both in the help function and summarized below:

Right Click: Draw a box
Left Click: If inside a box, moves the box; if close to the border, re-sizes the box.
Tab: Iterates through the object types.
Space: Saves all the drawn boxes for the image displayed.
./>: Go to the next image in the directory.
,/<: Go to the previous image in the directory.
Right Arrow: Move all boxes right.
Up Arrow: Move all boxes up.
Down Arrow: Move all boxes down.
Left Arrow: Move all boxes left.
Delete: Removes all drawn boxes.