Skip to content
This repository has been archived by the owner on May 6, 2024. It is now read-only.
/ colorweave Public archive
forked from lerela/colorweave

Extract dominant colors from an image as a palette.

Notifications You must be signed in to change notification settings

ixc/colorweave

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 

Repository files navigation

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)

About

Extract dominant colors from an image as a palette.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%