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

HSLuv implementation for Emacs ELisp (revision 4)
https://github.com/hsluv/hsluv-emacs

Last synced: 13 days ago
JSON representation

HSLuv implementation for Emacs ELisp (revision 4)

• Host: GitHub
• URL: https://github.com/hsluv/hsluv-emacs
• Owner: hsluv
• License: mit
• Created: 2018-11-16T07:30:23.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2018-11-30T16:08:14.000Z (almost 6 years ago)
• Last Synced: 2024-08-07T18:31:08.915Z (3 months ago)
• Language: Emacs Lisp
• Homepage: https://www.hsluv.org/
• Size: 538 KB
• Stars: 12
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# hsluv-emacs

## Introduction

This package provides an Elisp implementation of the HSLUV colorspace

conversions as created by Alexei Boronine (@boronine), and documented on

http://www.hsluv.org/

HSLuv is a human-friendly alternative to HSL.

CIELUV is a color space designed for perceptual uniformity based on human

experiments. When accessed by polar coordinates, it becomes functionally

similar to HSL with a single problem: its chroma component doesn't fit into

a specific range.

HSLuv extends CIELUV with a new saturation component that allows you to span

all the available chroma as a neat percentage.

The reference implementation is written in Haxe and released under

the MIT license. It can be found at https://github.com/hsluv/hsluv

The math is available under the public domain.

## Installation

The recommended way is to use [MELPA](http://melpa.org/). If either is in your `package-archives`, do

    M-x package-install RET hsluv RET

or you could use something like [use-package](https://github.com/jwiegley/use-package):

```elisp

(use-package hsluv)

```

No further configuration is needed.

## Using

The following functions provide the conversions

from RGB to/from HSLUV and HPLUV:

```elisp

(hsluv-hsluv-to-rgb (list H S Luv))

(hsluv-hpluv-to-rgb (list H P Luv))

(hsluv-rgb-to-hsluv (list R G B))

(hsluv-rgb-to-hpluv (list R G B))

```

## Testing

If you want to run the tests, checkout this repository. Then, on a command-line near you, do:

```sh

$ make clean test

```

which will run the tests defined in `test/hsluv-test.el`.

Test results will be collected in the file `test-results.log`