Skip to main content

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

Alt text Alt text Alt text Alt text Alt text Alt text

Alt text Alt text Alt text Alt text Alt text Alt text

Alt text Alt text Alt text Alt text

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyColorPalette-1.2.2.tar.gz (4.9 kB view hashes)

Uploaded Source

Built Distribution

PyColorPalette-1.2.2-py3-none-any.whl (5.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page