PyColorPalette

KO | EN

gitlite — search

#javascript #python #hacktoberfest #go #golang #machine-learning #rust #linux #docker #nodejs #windows #vue #security #pytorch

(★ 57)

PyColorPalette is a tool capable of pulling a list of the top colors, or the color at a specific index, from a given image via the process of K-means clustering. Images can be provided either through a direct path or from a URL. You have the option to also retreive the percentage of the image that specific color takes up.

PyColorPalette 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PyColorPalette

PyColorPalette is a Python 3 tool capable of pulling 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/Hex color value, 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)

```python
from PyColorPalette import ColorPalette

pal = ColorPalette(r"/Users/user/Pictures/my_image.png", show_clustering=False)
#Use a raw string for Windows paths.

print(pal.get_top_colors(n=5, ratio=False, rounded=True))
# [(251, 243, 230), (101, 50, 81), (59, 18, 48), (58, 17, 47), (60, 19, 49)]

print(pal.get_color(index=3, ratio=True, rounded=True))
# ((58, 17, 47), 14)

'''
Retrieve values in hex.
'''
print(pal.get_color(index=3, ratio=True, to_hex=True, rounded=False))
# ('#3a112f', 14.1953125)
```

## Examples

![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/example1.jpg)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_1_1.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_1_2.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_1_3.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_1_4.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_1_5.png)

![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/example3.jpg)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_3_1.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_3_2.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_3_3.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_3_4.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_3_5.png)

![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/example2.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_2_1.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_2_2.png)
![Alt text](https://raw.githubusercontent.com/Dilan1020/PyColorPalette/master/examples/ex_2_3.png)

## 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

```pip install PyColorPalette```

PyColorPalette

PyColorPalette 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

PyColorPalette

PyColorPalette 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README