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)