Metadata-Version: 2.1
Name: PyColorPalette
Version: 1.2.2
Summary: UNKNOWN
Home-page: https://github.com/Dilan1020/PyColorPalette
Author: Dilan Ozkaynak
Author-email: DilanJames10@gmail.com
License: UNKNOWN
Description: # PyColorPalette
        
        PyColorPalette is a Python 3 tool that is able to pull a list of the top colors, or the color at a specific index, from a given image through the process of K-means clustering. Images can be provided either through a direct path or from a URL. Along with the RGB color you have the option to also retreive the percentage of the image that specific color takes up. 
        
        _**See examples below!**_
        
        ## Usage
        
        PyColorPalette derives a color palette using K-means clustering to create a cluster map. To see the cluster map use ```show_clustering=True```. ([Thank you, ZeevG](https://github.com/ZeevG/python-dominant-image-colour))
        
        ```python
        from PyColorPalette import ColorPalette
        
        pal = ColorPalette("/Users/user/Pictures/my_image.png", show_clustering=False)
        
        print(pal.get_top_colors(n=5, ratio=False, rounded=True))
        # [(251.0, 243.0, 230.0), (101.0, 50.0, 81.0), (59.0, 18.0, 48.0), (58.0, 17.0, 47.0), (60.0, 19.0, 49.0)]
        
        print(pal.get_color(index=3, ratio=True, rounded=True))
        # ((58.0, 17.0, 47.0), 0.1953125)
        
        '''
        Retrieve values in hex.
        '''
        print(pal.get_color(index=3, ratio=True, to_hex=True))
        # ('#3a112f', 0.1953125)
        ```
        
        ## Examples
        
        ![Alt text](/examples/example1.jpg)
        ![Alt text](/examples/ex_1_1.png?raw=true  "")
        ![Alt text](/examples/ex_1_2.png?raw=true  "")
        ![Alt text](/examples/ex_1_3.png?raw=true  "")
        ![Alt text](/examples/ex_1_4.png?raw=true  "")
        ![Alt text](/examples/ex_1_5.png?raw=true  "")
        
        ![Alt text](/examples/example3.jpg)
        ![Alt text](/examples/ex_3_1.png?raw=true  "")
        ![Alt text](/examples/ex_3_2.png?raw=true  "")
        ![Alt text](/examples/ex_3_3.png?raw=true  "")
        ![Alt text](/examples/ex_3_4.png?raw=true  "")
        ![Alt text](/examples/ex_3_5.png?raw=true  "")
        
        ![Alt text](/examples/example2.png)
        ![Alt text](/examples/ex_2_1.png?raw=true  "")
        ![Alt text](/examples/ex_2_2.png?raw=true  "")
        ![Alt text](/examples/ex_2_3.png?raw=true  "")
        
        ## Dependencies
        
        PyColorPalette uses the Python Imaging Library (PIL) and numpy.
        To Install:
        ```
        pip install Pillow 
        pip install numpy
        ```
        (Pillow and PIL cannot co-exist in the same environment. Before installing Pillow, please uninstall PIL if previosuly installed.)
        
        ## Installation
        
        Place "PyColorPalette" folder in your project directory.
Platform: UNKNOWN
Description-Content-Type: text/markdown
