https://github.com/hsluv/hsluv-python

Python implementation of HSLuv (revision 4)
https://github.com/hsluv/hsluv-python

color-palettes colors colorspace colorspaces hpluv hsl hsluv python

Last synced: 6 days ago
JSON representation

Python implementation of HSLuv (revision 4)

• Host: GitHub
• URL: https://github.com/hsluv/hsluv-python
• Owner: hsluv
• License: mit
• Created: 2012-10-10T02:36:23.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2024-10-28T22:41:54.000Z (16 days ago)
• Last Synced: 2024-10-28T23:27:19.695Z (16 days ago)
• Topics: color-palettes, colors, colorspace, colorspaces, hpluv, hsl, hsluv, python
• Language: Python
• Homepage: https://pypi.org/project/hsluv/
• Size: 1.82 MB
• Stars: 139
• Watchers: 13
• Forks: 15
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
[![Build Status](https://github.com/hsluv/hsluv-python/actions/workflows/test.yml/badge.svg)](https://github.com/hsluv/hsluv-python/actions/workflows/test.yml)

[![Package Version](https://img.shields.io/pypi/v/hsluv.svg)](https://pypi.python.org/pypi/hsluv/)

A Python implementation of [HSLuv](https://www.hsluv.org) (revision 4).

## Installation

`pip install hsluv`

Python 2 users: `pip install hsluv==5.0.0`

## Usage

> This library does not hide (clamp) floating point error, e.g. you might receive a value outside

> of the expected range. If you wish to display the outputs of this library, consider rounding them 

> for your purpose. The floating point error has not been quantified, but at least 10 decimal digits 

> should be free of it.

### `hsluv_to_hex([hue, saturation, lightness])`

`hue` is a float between 0 and 360, `saturation` and `lightness` are floats between 0 and 100. This 

function returns the resulting color as a hex string.

### `hsluv_to_rgb([hue, saturation, lightness])`

Like above, but returns a list of 3 floats between 0 and 1, for each RGB channel.

### `hex_to_hsluv(hex)`

Takes a hex string and returns the HSLuv color as a list of floats as defined above.

### `rgb_to_hsluv([red, green, blue])`

Like above, but `red`, `green` and `blue` are passed as floats between 0 and 1.

For HPLuv (the pastel variant), use `hpluv_to_hex`, `hpluv_to_rgb`, `hex_to_hpluv` and `rgb_to_hpluv`.

## Testing

Run `python setup.py test`.

## Authors

* Robert McGinley ([mcginleyr1](https://github.com/mcginleyr1))

* Alexei Boronine ([boronine](https://github.com/boronine))