{
    "info": {
        "author": "CairX",
        "author_email": "lazycairx@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 3 - Alpha",
            "Environment :: Console",
            "Intended Audience :: Developers",
            "License :: OSI Approved :: MIT License",
            "Natural Language :: English",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.4",
            "Topic :: Multimedia :: Graphics",
            "Topic :: Software Development :: Libraries :: Python Modules",
            "Topic :: Utilities"
        ],
        "description": "=================\nextract-colors-py\n=================\nCommand-line tool to extract colors from an image.\nThe result will presented in two formats, text and image.\n\nThe text result will provide the usage of each color in the number of pixels and percentage.\nWhile the image will provide a palette for a visual representation.\n\n.. contents:: Table of Contents\n.. section-numbering::\n\n\n------------\nInstallation\n------------\n+++++++\nPackage\n+++++++\n::\n\n    $ pip install extcolors\n\n++++++++\nManually\n++++++++\n1. Download repository as zip.\n2. Unpack zip into folder.\n3. Enter folder.\n4. Run the following command: ::\n\n        $ pip install .\n\n-----\nUsage\n-----\n+++++++++++++++\nInput - Console\n+++++++++++++++\nTo use the application provide a path to the image that the application should extract colors from.\nIn the following example the image is in the folder we are executing the command and the name of the image is ``gameboy.png``:\n\n::\n\n    $ extcolors gameboy.png\n\nIn this example ``gameboy.png`` refers to the following `image <https://dribbble.com/shots/1056595-Gameboy-Free-PSD>`_\ncreated by `Rebecca Machamer <https://dribbble.com/rebeccamachamer>`_.\n\n.. image:: http://cairns.se/extcolors/gameboy.png\n\n++++++++++++++\nInput - Script\n++++++++++++++\nTo use the application provide a path to the image that the application should extract colors from.\nIn the following example the image is in the folder we are executing the command and the name of the image is ``gameboy.png``:\n\n.. code:: python\n\n    >>> import extcolors\n    >>> colors, pixel_count = extcolors.extract(\"gameboy.png\")\n    >>> print(colors)\n    [((0, 172, 170), 385938), ((245, 245, 245), 59971), ((82, 90, 92), 17564), ((102, 184, 52), 15096), ((236, 27, 111), 1270), ((255, 180, 0), 121), ((252, 94, 158), 40)]\n\n+++++++++++++\nOutput - Text\n+++++++++++++\nWhen the application is done it will output information about the execution.\nProbably the most relevant information is the ``[RESULT]``-section that contains the extracted colors\nin RGB values and their occurrence rate presented in percentages.\n\nOutput based on ``gameboy.png``: ::\n\n    Extracted colors:\n    (245, 245, 245):  12.49% (59971)\n    (82, 90, 92)   :   3.66% (17564)\n    (102, 184, 52) :   3.15% (15096)\n    (236, 27, 111) :   0.26% (1270)\n    (255, 180, 0)  :   0.03% (121)\n    (252, 94, 158) :   0.01% (40)\n\n    Pixels in output: 480000 of 480000\n\n++++++++++++++\nOutput - Image\n++++++++++++++\nWhen the application is done it will also create an image in the directory where the command was executed.\nThe image will contain the colors that where extracted sorted based on their occurrence rate, wrapping from  from left to right.\nThe image will use the name of the original image appended with a time stamp of when the execution took place.\n\nOutput based on ``gameboy.png``:\n\n.. image:: http://cairns.se/extcolors/gameboy-result-default.png\n\n\n------------------\nAdditional Options\n------------------\nGenerated output from the command-line argument ``extcolors --help``.\n\n::\n\n    usage: extcolors [-h] [--version] [-t [N]] [-l [N]] [-o {all,image,text}] PATH\n\n    Extract colors from a specified image. Colors are grouped based on visual\n    similarities using the CIE76 formula.\n\n    positional arguments:\n      PATH\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      --version             show program's version number and exit\n      -t [N], --tolerance [N]\n                            Group colors to limit the output and give a better\n                            visual representation. Based on a scale from 0 to 100.\n                            Where 0 won't group any color and 100 will group all\n                            colors into one. Tolerance 0 will also bypass all\n                            conversion. Defaults to 32.\n      -l [N], --limit [N]   Upper limit to the number of extracted colors\n                            presented in the output.\n      -o {all,image,text}, --output {all,image,text}\n                            Format(s) that the extracted colors should presented\n                            in.\n\n\n------------\nKnown Issues\n------------\n+++++++++++\nPerformance\n+++++++++++\nWhen an image contains a large amount of different colors, which most do, the performance slows to a halt.\nIf the grouping of colors is not desired/required then a workaround is to set the tolerance levels to zero.\nSetting the tolerance to specifically zero will make the application skip any comparisons from being made and\nbecome a simple counter resulting in much greater speeds.\n\nExample, an image (3840x2160) containing about 340k unique colors will take two hours to complete\nwith a tolerance level of 32 (the default value). However with a tolerance level of zero it will take ten seconds.\n\n\n",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/CairX/extract-colors-py",
        "keywords": "extract colors image",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "extcolors",
        "package_url": "https://pypi.org/project/extcolors/",
        "platform": "",
        "project_url": "https://pypi.org/project/extcolors/",
        "project_urls": {
            "Homepage": "https://github.com/CairX/extract-colors-py"
        },
        "release_url": "https://pypi.org/project/extcolors/0.1.3/",
        "requires_dist": [
            "Pillow"
        ],
        "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
        "summary": "Extract colors from an image. Colors are grouped based on visual similarities using the CIE76 formula.",
        "version": "0.1.3"
    },
    "last_serial": 5865544,
    "releases": {
        "0.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6c8bedd0509b97c7029b75f844a26a86",
                    "sha256": "f8d99b357a5a3af5f074b87297c8317cd160b4fec3132839d0971060be968f75"
                },
                "downloads": -1,
                "filename": "extcolors-0.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "6c8bedd0509b97c7029b75f844a26a86",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6014,
                "upload_time": "2017-08-14T16:45:54",
                "url": "https://files.pythonhosted.org/packages/c5/ff/d6bfd98c9b709eec7380bca2e1e9a17ef70dec21c2a032a31498413be31b/extcolors-0.1.0.tar.gz"
            }
        ],
        "0.1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "3111914af9632434260e4c41f9bfd911",
                    "sha256": "ef1f24325740b562b809f9a37524dd48413ede7ce2f1323694ab7e70bf5e5a92"
                },
                "downloads": -1,
                "filename": "extcolors-0.1.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "3111914af9632434260e4c41f9bfd911",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
                "size": 7354,
                "upload_time": "2019-01-04T12:12:18",
                "url": "https://files.pythonhosted.org/packages/f0/b6/09d7b06f53b2591da599f0e4f37c7ee3ca83f7e29468a4756b8f6618bcda/extcolors-0.1.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "3fe08b23ac5b1d0621942b4bf2f3c389",
                    "sha256": "d26c39676a3c1c9da8bcc40925bca241f4cb3067ea08f8fd4b1f0fa235677dd1"
                },
                "downloads": -1,
                "filename": "extcolors-0.1.1.tar.gz",
                "has_sig": false,
                "md5_digest": "3fe08b23ac5b1d0621942b4bf2f3c389",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
                "size": 6074,
                "upload_time": "2019-01-04T12:12:19",
                "url": "https://files.pythonhosted.org/packages/c7/99/8d1b2661c9915f0b31eb15f034dc6a93b0806a4519f27110bd23a41ec28f/extcolors-0.1.1.tar.gz"
            }
        ],
        "0.1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f685aadc288cf28913279efd3ea7f0fd",
                    "sha256": "f03a31f1d06198d00a65b86b3b1b47d7f502d772614358cd3ddda71d270d7f21"
                },
                "downloads": -1,
                "filename": "extcolors-0.1.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "f685aadc288cf28913279efd3ea7f0fd",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
                "size": 7417,
                "upload_time": "2019-01-04T13:31:53",
                "url": "https://files.pythonhosted.org/packages/b5/9f/5b7248c3d8a0e543875a33fc88518bfc2649d3b4fc61b8d75fc8e5b90eae/extcolors-0.1.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "9a49f73a8e6d03590c79c9ee86fa9815",
                    "sha256": "86c82b6ceb5c3e518da913651448655274783914d119571268db64cd9248b97b"
                },
                "downloads": -1,
                "filename": "extcolors-0.1.2.tar.gz",
                "has_sig": false,
                "md5_digest": "9a49f73a8e6d03590c79c9ee86fa9815",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
                "size": 6142,
                "upload_time": "2019-01-04T13:31:54",
                "url": "https://files.pythonhosted.org/packages/00/bc/a8361469c0f2f962ca646aad6b3548297c856e16ab5da85cb64af657908d/extcolors-0.1.2.tar.gz"
            }
        ],
        "0.1.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "fc3608d692dd4c7144509bf6eecefda9",
                    "sha256": "5f6c5cd64b238bddb7b14da643e0e34e1dc359f306e293d811b1f04b3bf87f19"
                },
                "downloads": -1,
                "filename": "extcolors-0.1.3-py2-none-any.whl",
                "has_sig": false,
                "md5_digest": "fc3608d692dd4c7144509bf6eecefda9",
                "packagetype": "bdist_wheel",
                "python_version": "py2",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
                "size": 9440,
                "upload_time": "2019-09-21T08:29:02",
                "url": "https://files.pythonhosted.org/packages/33/3d/f9c795f107201f8f183db8e7e05a7106c1041d50a1f66768fd55d76cd4c0/extcolors-0.1.3-py2-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "d4d0a0061f57e508136359592d8522b4",
                    "sha256": "d1af61b38a6f0a46f54c2f0ea32a555d7608c71e5b8a0e71f8bb0cd000a5d833"
                },
                "downloads": -1,
                "filename": "extcolors-0.1.3.tar.gz",
                "has_sig": false,
                "md5_digest": "d4d0a0061f57e508136359592d8522b4",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
                "size": 6144,
                "upload_time": "2019-09-21T08:29:04",
                "url": "https://files.pythonhosted.org/packages/77/71/0c22724d39a8f7998396b393fc28d17c49c431f7057566ebd77fc2405dd9/extcolors-0.1.3.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "fc3608d692dd4c7144509bf6eecefda9",
                "sha256": "5f6c5cd64b238bddb7b14da643e0e34e1dc359f306e293d811b1f04b3bf87f19"
            },
            "downloads": -1,
            "filename": "extcolors-0.1.3-py2-none-any.whl",
            "has_sig": false,
            "md5_digest": "fc3608d692dd4c7144509bf6eecefda9",
            "packagetype": "bdist_wheel",
            "python_version": "py2",
            "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
            "size": 9440,
            "upload_time": "2019-09-21T08:29:02",
            "url": "https://files.pythonhosted.org/packages/33/3d/f9c795f107201f8f183db8e7e05a7106c1041d50a1f66768fd55d76cd4c0/extcolors-0.1.3-py2-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "d4d0a0061f57e508136359592d8522b4",
                "sha256": "d1af61b38a6f0a46f54c2f0ea32a555d7608c71e5b8a0e71f8bb0cd000a5d833"
            },
            "downloads": -1,
            "filename": "extcolors-0.1.3.tar.gz",
            "has_sig": false,
            "md5_digest": "d4d0a0061f57e508136359592d8522b4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
            "size": 6144,
            "upload_time": "2019-09-21T08:29:04",
            "url": "https://files.pythonhosted.org/packages/77/71/0c22724d39a8f7998396b393fc28d17c49c431f7057566ebd77fc2405dd9/extcolors-0.1.3.tar.gz"
        }
    ]
}