Metadata-Version: 2.1
Name: pillow-snippet
Version: 0.0.4
Summary: some useful snippet for image
Home-page: https://github.com/ramwin/pillow_snippet
Author: Xiang Wang
Author-email: ramwin@qq.com
License: UNKNOWN
Description: # pillow_snippet
        some useful snippet and utils using pillow to handle image
        
        # Requirements
        * Pillow
        
        # Install
        ```
        pip install pillow-snippet
        ```
        
        # Documentation
        ## Tutorial
        * origin image  
        ![originimage](./colorful_example.png)
        * origin image2  
        ![originimage2](./colorful_image.png)
        * convert an Image to a circled Image
        ```
        from pillow_snippet import convert
        origin_image = Image.open('colorful_example.png')
        image = origin_image.resize((200, 200))
        circle_image = convert.circle_image(image)
        circle_image.save("test_result/circle_image.png")
        ```
        ![circle-image](./test_result/circle_image.png)
        
        * delete the white pixel from an image  
            **it seems there is still white but if fact it is transparent. You can open the image in new tab to see more details**
        ```
        mask = Mask(image)
        exclude_white_image = mask.get_exclude_white_image(tolerance=8)
        exclude_white_image.save("test_result/exclude_white_image.png")
        ```
        ![no white image](./test_result/exclude_white_image.png)
        
        * convert the image to only contains red color according it's brightness
        ```
        mask = Mask(image)
        change_to_red_image = mask.convert_to_single_color("#ff0000ff")
        change_to_red_image.save("test_result/change_to_red_image.png")
        ```
        ![only red image](./test_result/change_to_red_image.png)
        
        * convert the imge to only contains green color according it's opacity instead of it's brightness
        ```
        mask2 = Mask(origin_image2)
        change_to_green_image = mask2.convert_to_single_color("#00ff00ff", mode="L")
        change_to_green_image.save("test_result/change_to_green_image_L.png")
        change_to_green_image = mask2.convert_to_single_color("#00ff00ff", mode="opacity")
        change_to_green_image.save("test_result/change_to_green_image_opacity.png")
        ```
        compare difference mode  
            * mode = "L"  
            ![img](./test_result/change_to_green_image_L.png)
            * mode = "opacity"  
            ![img](./test_result/change_to_green_image_opacity.png)
        
        
        
        # Contribution
        1. clone the code
        2. make your commit
        3. make test
        ```
        sudo pip install .
        python3 test.py
        ```
        4. create a pull request
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
