{ "info": { "author": "Lars Yencken", "author_email": "lars@yencken.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: ISC License (ISCL)", "Natural Language :: English", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4" ], "description": "colorific\n=========\n\n.. image:: https://badge.fury.io/py/colorific.png\n :target: http://badge.fury.io/py/colorific\n\n.. image:: https://travis-ci.org/99designs/colorific.png?branch=master\n :target: https://travis-ci.org/99designs/colorific\n\n.. image:: https://pypip.in/d/colorific/badge.png\n :target: https://crate.io/packages/colorific?version=latest\n\nImage palette detection in Python modelled after Paul Annesley's color detector\nin PHP. colorific determines what the most important colors used in your image\nare, and if one of them is a background color.\n\n*by Dennis Hotson & Lars Yencken*\n\nInstallation\n------------\n\nThe easiest way to install colorific is with Python's pip and virtualenv::\n\n $ virtualenv colorific-sandbox\n $ ./colorific-sandbox/bin/pip install colorific\n\nYou can then run colorific from ``./colorific-sandbox/bin/colorific``.\n\nUsage\n-----\n\ncolorific is meant to run in a streaming manner. You can run it on a single image by echo'ing in the image::\n\n $ echo myimage.png | colorific\n myimage.png #3e453f,#2ea3b7,#bee6ea,#51544c,#373d38 #ffffff\n\nEach input line should be a filename. Each output line will be a tab-delimited string containing the filename, major colors in order, and (optionally) a detected background color.\n\nTo run on an entire directory tree of images::\n\n $ find . -name '*.jpg' | colorific\n\nFor a small amount of images, colorific can also be invoked with the image file names provided as arguments::\n\n $ colorific myimage.png\n myimage.png #3e453f,#2ea3b7,#bee6ea,#51544c,#373d38 #ffffff\n\nYou can also get a rendered palette with hex codes for each image with the ``-o`` argument::\n\n $ colorific -o myimage.png\n myimage.png #3e453f,#2ea3b7,#bee6ea,#51544c,#373d38 #ffffff\n $ ls\n myimage.png myimage_palette.png\n\nYou can use an experimental multiprocessing mode with the ``-n`` argument. For example, to run the same example using 8 processes::\n\n $ find . -name '*.jpg' | colorific -p 8\n\nYou can also get usage information by running ``colorific --help``.\n\nExample\n-------\n\nHere's a concrete example of use. This is the NASA Ares logo:\n\n.. image:: http://media.quietlyamused.org.s3.amazonaws.com/palette/500px-NASA-Ares-logo.svg.png\n\nLet's run palette detection on it::\n\n $ echo 500px-NASA-Ares-logo.svg.png | colorific\n 500px-NASA-Ares-logo.svg.png #0065b9,#bbd6ec,#ff0000\n\nThese correspond to the colors:\n\n.. image:: http://media.quietlyamused.org.s3.amazonaws.com/palette/ares-palette.png\n\nNote that black and white have been stripped away, and minor colors introduced\nthrough antialiasing are not present.\n\nChangelog\n---------\n\n0.3.0\n~~~~~\n\n- Python 3 support\n- Bump colormath version to 2.0.2\n\n0.2.2\n~~~~~\n\n- Use the recent 1.7.8 Pillow release instead of the master branch\n- Pin the colormath to 1.0.9 or earlier, given API changes in newer code\n\n0.2.1\n~~~~~\n\n- Project renamed to ``colorific``\n- Tuning around quantization and color merging\n- Use patched Pillow dependency to avoid segmentation fault bug\n- Support for outputting a palette file per image\n\n0.2.0\n~~~~~\n\n- Tuning around background color, similarity thresholds for merging, and minimum saturation\n- Make an importable module\n\n0.1.0\n~~~~~\n\n- Functional palette detection", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/99designs/colorific", "keywords": null, "license": "ISC", "maintainer": null, "maintainer_email": null, "name": "colorific", "package_url": "https://pypi.org/project/colorific/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/colorific/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/99designs/colorific" }, "release_url": "https://pypi.org/project/colorific/0.3/", "requires_dist": null, "requires_python": null, "summary": "Automatic color palette detection", "version": "0.3" }, "last_serial": 1283059, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "a3d138914e5322e6fd761a0247422d69", "sha256": "86b2523d3653c633dc26fa3fac2c0eba0b90065168d52ebdae02881a5e8ed898" }, "downloads": -1, "filename": "colorific-0.2.0.tar.gz", "has_sig": true, "md5_digest": "a3d138914e5322e6fd761a0247422d69", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5097, "upload_time": "2012-05-04T05:38:26", "url": "https://files.pythonhosted.org/packages/8d/0f/45b1f8fe9d3aab8d567afbbde882df8256403038f71efbbe8255b2599ae5/colorific-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "d8248e8ba23484fc9b7678fe3fe7be88", "sha256": "0f1e5d85aecbbfbe9895f3eb43f72379c3862db95284e600ff680d0ea75025bb" }, "downloads": -1, "filename": "colorific-0.2.1.tar.gz", "has_sig": true, "md5_digest": "d8248e8ba23484fc9b7678fe3fe7be88", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5688, "upload_time": "2012-10-15T23:19:48", "url": "https://files.pythonhosted.org/packages/03/23/fa02ee60b87a1520fbf65ff4ac0c27841722ee794e34d176896ab55a68e9/colorific-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "3b5f6d673fdf0f7d9acf9b5aa06df982", "sha256": "c49e204fe899e3de5d949e343bf84d41515faf4e9684a2ee188ff47b957f93de" }, "downloads": -1, "filename": "colorific-0.2.2-py2-none-any.whl", "has_sig": true, "md5_digest": "3b5f6d673fdf0f7d9acf9b5aa06df982", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 11085, "upload_time": "2014-05-07T04:37:20", "url": "https://files.pythonhosted.org/packages/dd/d2/a3471093e898bc0a4ed6ff872914c7001dcc2518f7c466d7142faa8c9d62/colorific-0.2.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b49527f70a897a770b701369aa3176c4", "sha256": "f89c1a0626c22b15dc9d368b26234a0f73c76a1671afa6fd7d02c68ee3445365" }, "downloads": -1, "filename": "colorific-0.2.2.tar.gz", "has_sig": true, "md5_digest": "b49527f70a897a770b701369aa3176c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8378, "upload_time": "2014-05-07T04:37:11", "url": "https://files.pythonhosted.org/packages/40/e9/b672211af4e9b0aa2c352ce9bcbf455c61273dac8497ef3c9341cee70397/colorific-0.2.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "a91210f537b551731654563ae532a9b8", "sha256": "3ac0fb8a8612f3d023e40b2f0f93d36e2bddaa72fb0445a0d73299f19c6c8d0d" }, "downloads": -1, "filename": "colorific-0.3-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "a91210f537b551731654563ae532a9b8", "packagetype": "bdist_wheel", "python_version": "3.4", "requires_python": null, "size": 10357, "upload_time": "2014-10-26T10:16:34", "url": "https://files.pythonhosted.org/packages/a6/7e/21931149d33a9e464c12969795e01b8a7879278f2b19f2327895cb945006/colorific-0.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ad082577b91fa846ff38c801c566111f", "sha256": "2e47771e8b49d4a71c642c9d2ff6112467cecbc0ba00c6e579fbce8e7a6d265d" }, "downloads": -1, "filename": "colorific-0.3.tar.gz", "has_sig": true, "md5_digest": "ad082577b91fa846ff38c801c566111f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8685, "upload_time": "2014-10-26T10:16:14", "url": "https://files.pythonhosted.org/packages/7b/07/8d9903f03e01805771cc1735b8e3584fde2b2c9dcb62f51eb0e9aae8ca16/colorific-0.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a91210f537b551731654563ae532a9b8", "sha256": "3ac0fb8a8612f3d023e40b2f0f93d36e2bddaa72fb0445a0d73299f19c6c8d0d" }, "downloads": -1, "filename": "colorific-0.3-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "a91210f537b551731654563ae532a9b8", "packagetype": "bdist_wheel", "python_version": "3.4", "requires_python": null, "size": 10357, "upload_time": "2014-10-26T10:16:34", "url": "https://files.pythonhosted.org/packages/a6/7e/21931149d33a9e464c12969795e01b8a7879278f2b19f2327895cb945006/colorific-0.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ad082577b91fa846ff38c801c566111f", "sha256": "2e47771e8b49d4a71c642c9d2ff6112467cecbc0ba00c6e579fbce8e7a6d265d" }, "downloads": -1, "filename": "colorific-0.3.tar.gz", "has_sig": true, "md5_digest": "ad082577b91fa846ff38c801c566111f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8685, "upload_time": "2014-10-26T10:16:14", "url": "https://files.pythonhosted.org/packages/7b/07/8d9903f03e01805771cc1735b8e3584fde2b2c9dcb62f51eb0e9aae8ca16/colorific-0.3.tar.gz" } ] }