joakimsoderberg / imageclipper

An imageclipper intended for using when creating OpenCV haar cascade sample images.

Image Clipper

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

This fork was made initially for myself to be able to compile the program on OSX. Since I used CMake it was easy to make one build that works on all platforms.

From the original description:

It is often required to crop images manually fast for computer vision researchers to gather training and testing image sets, e.g., cropping faces in images.

This simple multi-platform (Windows, OSX and Linux were verified) software helps you to clip images manually fast.

Building

To build you need CMake, OpenCV and Boost on your system

Linux & OSX

Install requirements using your favorite package system or download the sources yourself.

$ sudo apt-get install cmake libopencv-dev libboost-all-dev

Using MacPorts.

$ sudo port install cmake boost opencv

And then build:

$ git clone <repo url>
$ cd imageclipper
$ mkdir build && cd build
$ cmake ..                                     # This should work in most cases.

# (Optional) Or specifying your own builds of OpenCV or Boost.
$ cmake -DOpenCV_DIR=/path/to/opencv/build/ -DBOOST_ROOT=/path/to/boost ..

$ cmake --build .                              # Builds the program.

Windows

On windows you need to download Visual Studio for Windows Desktop, CMake and git.

Boost

Has been tested with this verison on Windows 7, but should work with whatever you like: Boost 1.55.0 32-bit MSVC12 The default unpack location is c:\local\boost_1_55_0, if you change it you need to know the path when building.

OpenCV

Download and unpack OpenCV and remember the path.

From the git bash console: (use cmd.exe if you prefer)

$ git clone <repo url>
$ cd imageclipper
$ mkdir build && cd build
$ cmake -DOpenCV_DIR=/path/to/opencv/build/ -DBOOST_ROOT=/c/local/boost_1_55_0/ ..
$ cmake --build . --config Release 
$ start imageclipper.sln # If you want to open in Visual Studio instead.

The executable can then be found under build/bin/Release/imageclipper.exe

imageclipper's Issues

Building failed

I have done everything according to instructions plus tried different sources for installing cmake, opencv and boost. Still, it always comes back to this cmake build error below. Is anyone else getting this or am I missing something? Tried doing it in Ubuntu and OS X and the same result in both case.

$ cmake --build . 
[ 50%] Building CXX object CMakeFiles/imageclipper.dir/src/imageclipper.cpp.o
/Users/xxx/code/imageclipper/src/imageclipper.cpp:61:16: error: redefinition of 'CvCallbackParam'
typedef struct CvCallbackParam {
               ^
/Users/xxx/code/imageclipper/src/Global.h:13:16: note: previous definition is here
typedef struct CvCallbackParam {
               ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:80:16: error: redefinition of 'ArgParam'
typedef struct ArgParam {
               ^
/Users/xxx/code/imageclipper/src/Global.h:52:16: note: previous definition is here
typedef struct ArgParam {
               ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:152:2: error: use of undeclared identifier 'printUsage'
        printUsage();
        ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:182:5: error: use of undeclared identifier 'printHelpInfo'
                                printHelpInfo(arg);
                                ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:189:5: error: use of undeclared identifier 'printHelpInfo'
                                printHelpInfo(arg);
                                ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:201:5: error: use of undeclared identifier 'printHelpInfo'
                                printHelpInfo(arg);
                                ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:222:4: error: use of undeclared identifier 'printHelpInfo'
                        printHelpInfo(arg);
                        ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:232:4: error: use of undeclared identifier 'printHelpInfo'
                        printHelpInfo(arg);
                        ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:242:3: error: use of undeclared identifier 'printHelpInfo'
                printHelpInfo(arg);
                ^
/Users/xxx/code/imageclipper/src/imageclipper.cpp:709:4: error: use of undeclared identifier 'printHelpInfo'
                        printHelpInfo(arg);
                        ^
10 errors generated.
make[2]: *** [CMakeFiles/imageclipper.dir/src/imageclipper.cpp.o] Error 1
make[1]: *** [CMakeFiles/imageclipper.dir/all] Error 2
make: *** [all] Error 2

size of the image

Hello,
I am using v0.99 on W8.1 x64 bit machine and I can see just left upper corner of the image

full image has 4608x3072 pixels

I can not move or shink the picture, I probably skipped some basic point of the instructions.
Many thanks for your help!

Windows binary

Hi,
Is there a windows binary already built I could find ?

Thanks

Fails to build: ‘CV_RGB’ was not declared in this scope

Needs to add
#include <opencv2/imgproc.hpp>

on cvdrawwatershed.h

boost::filesystem::filesystem_error

when i try to save the cropped image i get the following error (Ubunutu 14.10)

terminate called after throwing an instance of 'boost::filesystem::filesystem_error'
what(): boost::filesystem::create_directory: File exists: "./imageclipper"
[3] 13127 abort (core dumped) ./imageclipper

Missed make after the cmake .. step

Running imageclipper

I'm a student and beginner in this kind of study, I have installed correctly the instructions for linux & osx. Now how do I run the imageclipper?

Cropping selects wrong region

I downloaded and compiled the latest master branch, after the first image it seems to save the wrong region of the photo

Request: Ability to skip existing files (or delete files as going along)

I've a collection of around 6,000 images I need to clip (yes, for haar classifier training) and I obviously don't want to do this in one go. I've started imageclipper (on Linux) and done a few files and then needed a break: however, I can't easily find where I was (as imageclipper doesn't "pre-sort" the files).

Could you add an option to skip "pre-clipped" files (i.e. if the output filename -0 ignoring the %x/%y/%w/%h etc settings already exist), add a "checkpoint" option (recording which files have already been seen) or an option to delete the original files as you progress through them (maybe a warning in this case).

Thanks for an otherwise excellent tool.

Added to AUR

As a note, I have added imageclipper to the AUR:

https://aur.archlinux.org/packages/imageclipper-git

Might want to add that to the README. Might save someone the trouble of building it!

Assertion at matrix_wrap.cpp:807 when saving image if imageclipper was compiled with OpenCV 3.4.1

Fails for me because of bug in OpenCV C API: opencv/opencv#11076:

Key pressed: 115
OpenCV(3.4.1) Error: Assertion failed ((flags & FIXED_TYPE) != 0) in type, file /home/jek/work/src/opencv/deb/build-area/opencv-3.4.1/modules/core/src/matrix_wrap.cpp, line 807
terminate called after throwing an instance of 'cv::Exception'
what(): OpenCV(3.4.1) /home/jek/work/src/opencv/deb/build-area/opencv-3.4.1/modules/core/src/matrix_wrap.cpp:807: error: (-215) (flags & FIXED_TYPE) != 0 in function type

Why didn't you start from the latest Naotoshi Seo commit?

I also made a private fork of imageclipper some time ago and now looking if it's possible to rebase it on top of your fork and contribute some code. But it turned out that you did not use the latest sources from https://code.google.com/p/imageclipper (so some functionality is lost) and did not preserve the history. Why didn't you just import http://imageclipper.googlecode.com/svn/trunk into git using git svn before publishing on github?

libc++abi.dylib: terminating with uncaught exception of type boost::filesystem::filesystem_error: boost::filesystem::create_directory: File exists: "./imageclipper"

System Mac OS Sierra 10.12.6 . I compiled using cmake as was written in the instruction and got imageclipper binary file. Then moved it into image folder and executed ./imageclipper . So, new window opened and dropped an Error when I cropped an object and pressed "f" or "space". What it can be and how to fix it?

libc++abi.dylib: terminating with uncaught exception of type boost::filesystem::filesystem_error: boost::filesystem::create_directory: File exists: "./imageclipper"

The answer is just to move binary iamgeclipper binary out of folder because it tries to create folder with the same name

Segmentation fault: 11?

Hi,

Im trying to use image clipper - i've installed package prerequisites using OSX and conda. Im getting the following error "Segmentation fault: 11" when i try running ./imageclipper from the file containing the images i need to clip. The executable file is in the folder containing the images.

As an error its a bit cryptic!

Linker error

Hello!

I'm trying to build imageclipper on MacOS 10.9, OpenCV with TBB support and this error occurs:

Linking CXX executable bin/imageclipper
ld: library not found for -ltbb
clang: error: linker command failed with exit code 1 (use -v to see invocation)

Window spans over multiple virtual desktop

I'm using multiple virtual desktops on ubuntu 15.10 and opencv 3.0.0.

When I start imageclipper the view spans over all the desktops and it is not possible to resize it.

It seems to be related to those lines:

    cvNamedWindow( param->w_name, CV_WINDOW_AUTOSIZE );
    cvNamedWindow( param->miniw_name, CV_WINDOW_AUTOSIZE );

Opencv API specifies that:

CV_WINDOW_NORMAL or CV_WINDOW_AUTOSIZE: CV_WINDOW_NORMAL enables you to resize the window, whereas CV_WINDOW_AUTOSIZE adjusts automatically the window size to fit the displayed image (see imshow() ), and you cannot change the window size manually.

I could not find any direct call to imshow, my guess is that is is hidden in cvShowxxx functions.

Using:

    cvNamedWindow( param->w_name, CV_WINDOW_NORMAL );
    cvNamedWindow( param->miniw_name, CV_WINDOW_NORMAL );

Fixed my problem, but it could be better since weird effect (kind of zooming and cropping that stop uppon selecting another window and coming back to it) occur when resizing the window...

Cropping selects wrong region - suggested fixes included too

As many other open issues have stated, the issue is that when you crop, sometimes it can show the wrong portion of the image. Through some testing I've concluded that it's because you're not resizing the image properly after each image window refresh.

An easy way to fix this is to resize the image window to the img.shape attributes (at least in Python). You could call the function that's triggered by -(key num 45) after each f (key num 102) or
{space} (key num 115).

USERS - You can fix this easily just by hitting the "-" key every image, which resizes the window to the right dimensions.