Skip to main content

Find human-readable color names for hex values

Project description

Provides a utility for retrieving the closest known “human readable” name for a color specified as a hex string. It does this by using an algorithm ported from ntc.js ( http://chir.ag/projects/ntc ).

There are 3 different sets of color definitions to choose from:

Resene ( http://people.csail.mit.edu/jaffer/Color/resenecolours.txt ) html4 ( http://www.w3.org/TR/css3-color/#html4 ) css3 ( http://www.w3.org/TR/css3-color/#svg-color )

css3 is a superset of html4.

The user can also supply their own colorfile to use. It should be comma separated hex,name pairs, and should include the leading #. Commas are allowed in names.

Currently two output formats are supported – json, and raw.

Usage:

As a command-line utility:

$ namethatcolor aabbcc {“hex_value”: “#B0C4DE”, “name”: “lightsteelblue”} $ namethatcolor –color-set resene aabbcc {“hex_value”: “#ADBED1”, “name”: “Casper”}

#same as above $ namethatcolor -s resene aabbcc

#specify your own color file $ namethatcolor -c path/to/color/file aabbcc

As a library:

>>> from namethatcolor import NameThatColor
>>> Namer = NameThatColor()
>>> Namer.name('aabbcc')
Match('#B0C4DE', 'lightsteelblue', False, '#AABBCC')
>>> resene_filename = NameThatColor.color_sets['resene']
>>> resene_colors = NameThatColor.get_color_file(resene_filename)
>>> Namer = NameThatColor(color_file=resene_colors)
>>> Namer.name('aabbcc')
Match('#ADBED1', 'Casper', False, '#AABBCC')

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

NameThatColor-1.0.3.tar.gz (26.2 kB view details)

Uploaded Source

File details

Details for the file NameThatColor-1.0.3.tar.gz.

File metadata

  • Download URL: NameThatColor-1.0.3.tar.gz
  • Upload date:
  • Size: 26.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for NameThatColor-1.0.3.tar.gz
Algorithm Hash digest
SHA256 87f520ce37513324e5ebf3c12b66a5b978757cd8f6a11591f20f8e0e6d1db99f
MD5 b793bc4931f6b405b7c04cec16ee09b0
BLAKE2b-256 13c380fa2b202de232fcbfee031ed61107f3cdf053250c7724f738a961e452c1

See more details on using hashes here.

Supported by

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