[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#12558: Incorrect docstrings for color-rgb-to-hsl and color-hsl-to-rg
From: |
Julian Scheid |
Subject: |
bug#12558: Incorrect docstrings for color-rgb-to-hsl and color-hsl-to-rgb |
Date: |
Tue, 02 Oct 2012 14:43:36 +0200 |
The docstrings for `color-rgb-to-hsl' and `color-hsl-to-rgb' both state
that the HUE component is given in radians, but in fact it's in range
0..1 in both cases.
It's easy to see that the value returned by `color-rgb-to-hsl' for hue
is the result of (mod N 1.0), and `color-hsl-to-rgb' uses the same
representation:
(apply 'color-hsl-to-rgb
(color-rgb-to-hsl 0.7 0.8 0.9))
;; -> (0.7000000000000001 0.7999999999999999 0.9)
2012-10-02 Julian Scheid <julians37@gmail.com>
* color.el (color-rgb-to-hsl, color-hsl-to-rgb): Fix docstring.
=== modified file 'lisp/color.el'
*** lisp/color.el 2012-08-13 19:10:35 +0000
--- lisp/color.el 2012-10-02 11:49:04 +0000
*************** resulting list."
*** 102,110 ****
(t v1)))
(defun color-hsl-to-rgb (H S L)
! "Convert H S L (HUE, SATURATION, LUMINANCE) , where HUE is in
! radians and both SATURATION and LUMINANCE are between 0.0 and
! 1.0, inclusive to their RGB representation.
Return a list (RED, GREEN, BLUE) which each be numbers between
0.0 and 1.0, inclusive."
--- 102,110 ----
(t v1)))
(defun color-hsl-to-rgb (H S L)
! "Convert H S L (HUE, SATURATION, LUMINANCE), where H S L should
! each be numbers between 0.0 and 1.0 inclusive, to their RGB
! representation.
Return a list (RED, GREEN, BLUE) which each be numbers between
0.0 and 1.0, inclusive."
*************** inclusive."
*** 159,167 ****
RED, GREEN, and BLUE should each be numbers between 0.0 and 1.0,
inclusive.
! Return a list (HUE, SATURATION, LUMINANCE), where HUE is in radians
! and both SATURATION and LUMINANCE are between 0.0 and 1.0,
! inclusive."
(let* ((r red)
(g green)
(b blue)
--- 159,166 ----
RED, GREEN, and BLUE should each be numbers between 0.0 and 1.0,
inclusive.
! Return a list (HUE, SATURATION, LUMINANCE) which each be numbers
! between 0.0 and 1.0, inclusive."
(let* ((r red)
(g green)
(b blue)
- bug#12558: Incorrect docstrings for color-rgb-to-hsl and color-hsl-to-rgb,
Julian Scheid <=