isabella232 / poisson-image-editing

Poisson image editing for seamless cloning and other operations

About this library

Poisson Image Editing is a small C++ library providing implementations of image editing methods based on gradient domains.

Seamless Cloning

Seamless image cloning attempts to copy an image region from a foreground image onto a background image subject to removal of visual seams. Visual seams occur because of the color mismatch between the two images. In gradient domain methods one fixes the colors of the boundary (taken from the background image) and provides a vector field that defines the structure of the image to be copied (taken from the foreground and / or a mixture from foreground and background). The result image is generated by minimizing the squared error terms between the gradient of the result image and the guidance vector field.

The function blend::seamlessClone implements the method described in [1] providing different options for various guidance field computations. The table below shows a comparison between naively copying foreground over background and seamless copying as implemented by this library.

Naive Cloning	Seamless Cloning

References

[1] Pérez, Patrick, Michel Gangnet, and Andrew Blake. "Poisson image editing." ACM Transactions on Graphics (TOG). Vol. 22. No. 3. ACM, 2003.

Building from source

To build Poisson Image Editing from source you need the following prerequisites

• CMake - for generating cross platform build files
• OpenCV - for image processing related functions
• Eigen - for sparse linear system solving

Although Poisson Image Editing should build across multiple platforms and architectures, tests are carried out on these systems

• Windows 7/8 MSVC10 x86
• OS X 10.10 XCode 6.2

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

License

   Copyright Christoph Heindl 2015

   Poisson Image Editing 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.
   
   Poisson Image Editing 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 Poisson Image Editing.  If not, see <http://www.gnu.org/licenses/>.