colorweave's Introduction

colorweave

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)

Recommend Projects