mindpowered-colorconverter


Namemindpowered-colorconverter JSON
Version 0.0.6 PyPI version JSON
download
home_pagehttps://mindpowered.dev/
SummaryConverter to convert between various color systems such as RGB, CIELAB, CMYK, HEX, RGB, and XYZ
upload_time2021-02-03 07:34:44
maintainer
docs_urlNone
authorMind Powered Corporation
requires_python
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
colorconverter
==============
Converter to convert between various color systems such as RGB, CIELAB, CMYK, HEX, RGB, and XYZ

![Build Status](https://mindpowered.dev/assets/images/github-badges/build-passing.svg)

Contents
========

* [Source Code and Documentation](#source-code-and-documentation)
* [About](#about)
* [Requirements](#requirements)
* [Installation](#installation)
* [Usage](#usage)
* [Support](#support)
* [Licensing](#licensing)

# Source Code and Documentation
- Source Code: [https://github.com/mindpowered/color-converter-python](https://github.com/mindpowered/color-converter-python)
- Documentation: [https://mindpowered.github.io/color-converter-python](https://mindpowered.github.io/color-converter-python)

# About
Defining a color is difficult. The first challenge is finding a way to describe a color. One way is to describe color based on constituent colors. We can describe constituent colors by adding them, like in RGB, or subtracting them, like in CMYK. Gamut is the range of all colors that are representable in a color system. RGB trades a limited gamut for performance. LAB trades performance for the full gamut of visible colors. CMYK represents the gamut used in color printing.

The second challenge to defining a color is that it depends on the observer. Viewing the same color will look different when:
- printed on paper or displayed on a screen
- seen in daylight or under fluorescent lighting
- positioned at a close or far distance
Standard references such as the Pantone Matching System refer to specific colors. We lose information when converting from a reference color to a color system. Printing or rendering an RGB or CMYK color equivalent to a reference color may not match. We can avoid information loss during conversion by using an unlimited gamut such as LAB. We must also take into account the effect of the observer and illumination.

This package aims to provide tools to perform:
- Color conversion between color systems
- A way of searching for similar standardized reference colors

# Requirements
- Requires Python 3.x. Due to security fixes and new features Python 3.7 or later is recommended.
- pip


Third-party dependencies may have additional requirements.

# Installation
You can retrieve the colorconverter package from the Python Package Index https://pypi.org/ using pip. First make sure you have python3 and python3-pip installed. Then you can start by making a `requirements.txt` file in your working directory with the colorconverter requirement in it. You can add any other packages to your requirements here, each as a separate line.

requirements.txt:
```
mindpowered-colorconverter>0
```
Now you can use pip to install the colorconverter package: `python3 -m pip install -r requirements.txt`
If you would like to update the package, simply run the above command again.


# Usage
```python
from mindpowered_colorconverter import *

cc = ColorConverter()
colors = cc.FromHEX("#336699")

```


# Support
We are here to support using this package. If it doesn't do what you're looking for, isn't working, or you just need help, please [Contact us][contact].

There is also a public [Issue Tracker][bugs] available for this package.

# Licensing
This package is released under the MIT License.



[bugs]: https://github.com/mindpowered/color-converter-python/issues
[contact]: https://mindpowered.dev/support/?ref=color-converter-python/
[docs]: https://mindpowered.github.io/color-converter-python/
[licensing]: https://mindpowered.dev/?ref=color-converter-python
[purchase]: https://mindpowered.dev/purchase/



            

Raw data

            {
    "_id": null,
    "home_page": "https://mindpowered.dev/",
    "name": "mindpowered-colorconverter",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "",
    "author": "Mind Powered Corporation",
    "author_email": "support@mindpowered.dev",
    "download_url": "",
    "platform": "",
    "description": "\ncolorconverter\n==============\nConverter to convert between various color systems such as RGB, CIELAB, CMYK, HEX, RGB, and XYZ\n\n![Build Status](https://mindpowered.dev/assets/images/github-badges/build-passing.svg)\n\nContents\n========\n\n* [Source Code and Documentation](#source-code-and-documentation)\n* [About](#about)\n* [Requirements](#requirements)\n* [Installation](#installation)\n* [Usage](#usage)\n* [Support](#support)\n* [Licensing](#licensing)\n\n# Source Code and Documentation\n- Source Code: [https://github.com/mindpowered/color-converter-python](https://github.com/mindpowered/color-converter-python)\n- Documentation: [https://mindpowered.github.io/color-converter-python](https://mindpowered.github.io/color-converter-python)\n\n# About\nDefining a color is difficult. The first challenge is finding a way to describe a color. One way is to describe color based on constituent colors. We can describe constituent colors by adding them, like in RGB, or subtracting them, like in CMYK. Gamut is the range of all colors that are representable in a color system. RGB trades a limited gamut for performance. LAB trades performance for the full gamut of visible colors. CMYK represents the gamut used in color printing.\n\nThe second challenge to defining a color is that it depends on the observer. Viewing the same color will look different when:\n- printed on paper or displayed on a screen\n- seen in daylight or under fluorescent lighting\n- positioned at a close or far distance\nStandard references such as the Pantone Matching System refer to specific colors. We lose information when converting from a reference color to a color system. Printing or rendering an RGB or CMYK color equivalent to a reference color may not match. We can avoid information loss during conversion by using an unlimited gamut such as LAB. We must also take into account the effect of the observer and illumination.\n\nThis package aims to provide tools to perform:\n- Color conversion between color systems\n- A way of searching for similar standardized reference colors\n\n# Requirements\n- Requires Python 3.x. Due to security fixes and new features Python 3.7 or later is recommended.\n- pip\n\n\nThird-party dependencies may have additional requirements.\n\n# Installation\nYou can retrieve the colorconverter package from the Python Package Index https://pypi.org/ using pip. First make sure you have python3 and python3-pip installed. Then you can start by making a `requirements.txt` file in your working directory with the colorconverter requirement in it. You can add any other packages to your requirements here, each as a separate line.\n\nrequirements.txt:\n```\nmindpowered-colorconverter>0\n```\nNow you can use pip to install the colorconverter package: `python3 -m pip install -r requirements.txt`\nIf you would like to update the package, simply run the above command again.\n\n\n# Usage\n```python\nfrom mindpowered_colorconverter import *\n\ncc = ColorConverter()\ncolors = cc.FromHEX(\"#336699\")\n\n```\n\n\n# Support\nWe are here to support using this package. If it doesn't do what you're looking for, isn't working, or you just need help, please [Contact us][contact].\n\nThere is also a public [Issue Tracker][bugs] available for this package.\n\n# Licensing\nThis package is released under the MIT License.\n\n\n\n[bugs]: https://github.com/mindpowered/color-converter-python/issues\n[contact]: https://mindpowered.dev/support/?ref=color-converter-python/\n[docs]: https://mindpowered.github.io/color-converter-python/\n[licensing]: https://mindpowered.dev/?ref=color-converter-python\n[purchase]: https://mindpowered.dev/purchase/\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Converter to convert between various color systems such as RGB, CIELAB, CMYK, HEX, RGB, and XYZ",
    "version": "0.0.6",
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "728e23af98526d6a86ab4e496a3a784a",
                "sha256": "02c7dc7fce280798910cf2ace7f6ba2aab0cd4b760d05dcceff0086404ea4337"
            },
            "downloads": -1,
            "filename": "mindpowered_colorconverter-0.0.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "728e23af98526d6a86ab4e496a3a784a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 38436,
            "upload_time": "2021-02-03T07:34:44",
            "upload_time_iso_8601": "2021-02-03T07:34:44.249373Z",
            "url": "https://files.pythonhosted.org/packages/3e/3e/18abc3b6303caaf682556b8e968e6d147a7921fc94102d368541e76bb410/mindpowered_colorconverter-0.0.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2021-02-03 07:34:44",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "mindpowered-colorconverter"
}
        
Elapsed time: 0.18239s