shuangyumelody / inpaint

:pencil2: Inpaint is a C++ library providing image inpainting algorithms

Inpaint

Inpaint is a C++ library providing implementations of image inpainting and image completion methods. Image inpainting is the process of recovering or restoring image regions in a way that is non-detectable for an observer who does not know the original image.

While inpainting refers to restoring rather small regions such as scratches and other video artefacts, image completion deals with removal / restoring of large image parts.

Inpaint focuses on the task of object removal and is therefore optimized to work with large areas of reconstruction. Below is a side-by-side view of two images. On the left the original image, on the right the modified image as produced by Inpaint, after the user selected the rope to be removed.

Original	Inpainted

Building from source

To build Inpaint from source you need the following prerequisites

• CMake - for generating cross plattform build files
• OpenCV - for image processing related functions

Although Inpaint should build accross multiple platforms and architectures, tests are carried out on these systems

• Windows 7/8/10 MSVC10/MSVC14 x86/x64 OpenCV 2.x/3.x

If the build should fail for a specific platform, don't hestitate to create an issue. I'm also happy to accept any pull requests.

Inpainting images

After building you might want to try out inpaint_image_criminisi

1. Launch inpaint_image_criminisi <image>.
2. Use the sliders on top of the UI to adjust patch and stencil size. Patch size refers to the size of texels that will be used during inpainting. It should be roughly the size of minimum texture feature size you intend to inpaint. Stencil size refers to radius of the interactive drawing tools explained in the following 2 steps.
3. While holding your left mouse button pressed, move your mouse to mark the target area to be inpainted.
4. While holding your right mouse button pressed, move your mouse to mark the source area from which samples can be copied to target area. If you skip this step, the entire image without source region is used as source area.
5. Press e to toggle between editing / inpaint mode.
6. Press x to quit.

License

   Copyright Christoph Heindl 2014-2017

   Inpaint is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation, either version 3 of the License, or
   (at your option) any later version.
   
   Inpaint is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
   
   You should have received a copy of the GNU General Public License
   along with Inpaint.  If not, see <http://www.gnu.org/licenses/>.