Skip to main content

Extract dominant colors from an image as a palette. Also get names of the colors extracted either using CSS3 standard or CSS2.1.

Project description

Extract dominant colors from an image as a palette. Also get names of the colors extracted either using CSS3 standard or CSS2.1.

Usage

Retrieve dominant colors from an image URL:

>> from colorweave import palette
>> print palette(url="image_url")

The palette method takes the image from the URL and returns the hex codes of the dominant colors as a list.

Retrive dominant colors from a local image:

>> print palette(path="path_to_image")

Specify number of colors to be returned:

>> print palette(url="image_url", n=6)

Return the palette as a JSON object:

>> print palette(url="image_url", n=6, output="json")

Select different modes of output:

>> print palette(url="image_url", n=6)
# Returns the list of dominant color hex codes
>> print palette(url="image_url", n=6, format="css21")
# Returns a dictionary with each dominant color mapped to its CSS21 color name
>> print palette(url="image_url", n=6, format="css3")
# Returns a dictionary with each dominant color mapped to its CSS3 color name
>> print palette(url="image_url", n=6, format="full")
# Returns the nested structure of each CSS3 color mapped to its parent CSS21 color along with hex codes
>> print palette(url="image_url", n=6, format="fullest")
# Returns everything above together

Use k-means Clustering for extracting dominant colors:

>> print palette(url="image_url", n=6, mode="kmeans")
# Returns the list of dominant colors using k-means clustering algorithm (bit slower than the default method)

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

colorweave.tar.gz (5.7 kB view hashes)

Uploaded Source

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