Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Determination of the primary colors in an image file.

Project description

Determination of the primary colors in an image file.

Requirements

  • python (>=2.7.0)
  • six
  • scipy
  • numpy
  • Pillow

Installation:

$ sudo pip install primarycolors

Usage:

>>> from primarycolors import PrimaryColors
>>>
>>> # `image` - a path to image,
>>> # `max_colors` - the maximum number of colors in the resulting.
>>> im = PrimaryColors(image='Lenna.png', max_colors=5)
>>>
>>> #  The primary colors in the RGB hexadecimal list.
>>> im.hex
['621b43', '9e4257', 'e5bca5', 'd6877b', 'cb6161']
>>> im.web
['#621b43', '#9e4257', '#e5bca5', '#d6877b', '#cb6161']

>>> #  The primary colors in the RGB integer list.
>>> im.rgb
[[ 98,  27,  67], [158,  66,  87], [229, 188, 165], [214, 135, 123], [203,  97,  97]]
>>>
>>> #  An array of primary colors with the frequency coefficients.
>>> im.sorted_colors
[('cb6161', 0.24160000000000001),
 ('d6877b', 0.2412),
 ('621b43', 0.2016),
 ('9e4257', 0.1908),
 ('e5bca5', 0.12479999999999999)]
>>> im.hsl
[(326, 56.799999999999997, 24.509803921568629),
 (346, 41.071428571428569, 43.921568627450981),
 (21, 55.172413793103459, 77.254901960784323),
 (7, 52.601156069364166, 66.078431372549019),
 (0, 50.47619047619046, 58.823529411764696)]

Like command line tool

$ pcolor -i Lenna.png -w
#d68578 #c66162 #9d4459 #e3b7a2 #69234a
$ cat Lenna.png | pcolor -r
[157, 68, 89] [227, 183, 162] [214, 133, 120] [105, 35, 74] [198, 97, 98]

License:

primarycolors is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

primary colors is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with primarycolors. If not, see http://www.gnu.org/licenses/.

Project details


Release history Release notifications

This version
History Node

0.6.3

History Node

0.6.2

History Node

0.6.1

History Node

0.6

History Node

0.5

History Node

0.4

History Node

0.3

History Node

0.2

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
primarycolors-0.6.3-py2.py3-none-any.whl (5.4 kB) Copy SHA256 hash SHA256 Wheel 2.7 Jun 5, 2015
primarycolors-0.6.3.tar.gz (4.6 kB) Copy SHA256 hash SHA256 Source None Jun 5, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page