No project description provided
Project 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)
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
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for PyColorPalette-1.2.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 89462eb54ecc356fc64af44cf53d5d4644da921c5c0d8f28028d2e5c6392f2f3 |
|
MD5 | 9522735cc767032073f6107e37ec915d |
|
BLAKE2b-256 | 165d8986172b29a319de1e123d2b29a5f31e7aa5328d89851cc85625fc6bba06 |