Metadata-Version: 2.1
Name: pypoi
Version: 0.3.0
Summary: "Py"thon program for "Poi"sson Image Editing
Home-page: https://github.com/fbessho/PyPoi
Author: Fumihiro Bessho (Ben)
Author-email: fumihiro.bessho@gmail.com
License: Apache License 2.0
Description: # PyPoi
        
        [![PyPI](https://img.shields.io/pypi/v/pypoi.svg)](https://pypi.org/project/pypoi/)
           
        An image processing GUI application written in Python under Apache
        License 2.0. PyPoi stands for "<b>Py</b>thon Program for <b>Poi</b>sson Image Editing".
        
        It enables you to try the Poisson Image Editing method interactively.
        Some examples are already ready for you, but you can also load arbitrary images and try it.
        
        ![demo gif](https://github.com/fbessho/PyPoi/raw/master/images/demo.gif)
        
        ## Installation
        ```
        pip install pypoi
        ```
        Run `pypoi` command to open the GUI.
        
        
        ## What is Poisson Image Editing?
        Poisson Image Editing is a technique to blend two images _seamlessly_.
        
        This method is firstly introduced by Patrick Pérez and others in ACM SIGGRAPH 2003.
        The original theses is available
        [here (pdf)](http://www.cs.princeton.edu/courses/archive/fall10/cos526/papers/perez03.pdf).
        
        ### Resources
        There are many resources about Poisson Image Editing and I'll leave explanations to them.
        
        * **English**
          * [Original theses (pdf)](http://www.cs.princeton.edu/courses/archive/fall10/cos526/papers/perez03.pdf)
          * [Simple introduction and examples](http://cs.brown.edu/courses/csci1950-g/results/proj2/pdoran/index.html)
          * [Detailed introduction by Chris Tralie](http://www.ctralie.com/Teaching/PoissonImageEditing/)
            * **With many funny examples**.
            * Hot discussion including technical details at the bottom too.
            * Also contains Java implementation. Please see the chapter below.
        * **Japanese**
          * [Introduction in Japanese 1 (pdf)](https://www.hal.t.u-tokyo.ac.jp/paper/2010/Journal_12.pdf)
          * [Introduction in Japanese 2 in OpenCV.jp](http://opencv.jp/opencv2-x-samples/poisson-blending)
          * [Introduction in Japanese 3](http://blog.takuti.me/2013/12/poisson-image-blending/)
        
        ### Implementation in other languages
        There have already been several implementation in other language.
        * [**Java** by Chris Tralie](http://www.ctralie.com/Teaching/PoissonImageEditing/#tryit)
        * [**Python** by parosky](https://github.com/parosky/poissonblending/)
          *  As of v0.1.0, core calculation is the copy of this implementation.
        * [**JavaScript** by takuti](http://takuti.me/dev/poisson/demo/)
          * [Introduction in Japanese is available too](http://blog.takuti.me/2013/12/poisson-image-blending/)
        * [**MATLAB and C** by Toshihiko Yamasaki (pdf)](https://www.hal.t.u-tokyo.ac.jp/paper/2010/Journal_12.pdf)
        
        ## Found issues?
        Please raise an issue from [github issue page](https://github.com/fbessho/PyPoi/issues).
        
        ## What's next?
        I know there are a lot of space to improve.
        Main enhancements are listed in [the issue tracker](https://github.com/fbessho/PyPoi/issues), for example,
        * [#8  Gradient mixture support](https://github.com/fbessho/PyPoi/issues/8)
        * [#3  Add tests](https://github.com/fbessho/PyPoi/issues/3)
        * [#12 Calculation speed improvement](https://github.com/fbessho/PyPoi/issues/12)
        
        It's more than welcome if you can pick up one/some of them.
        
        ## License
        PyPoi is provided under Apache License 2.0. Please refer to [LICENSE](License)
        
        ## Acknowledgement
        The core function is from [parosky/poissonblending/](https://github.com/parosky/poissonblending/)
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: MacOS X
Classifier: Environment :: Win32 (MS Windows)
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
