Oven logo

Oven

hsluv5.0.4

Published

Human-friendly HSL

pip install hsluv

Package Downloads

Weekly DownloadsMonthly Downloads

Requires Python

>=3.7

Dependencies

    Build Status Package Version

    A Python implementation of HSLuv (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