Template:RGBtoHSL.H/doc

This template computes the hue value in degrees [0..360) in the HSL color space (as defined in standard CSS3), from a color specified in the sRGB color space. The returned value is rounded to one decimal (which preserves the precision of RGB colors whose components are specified in the standard range [0..255].

Syntax

{{RGBtoHSL.H|r|g|b}}

The range of the three parameters is [0..255] ; they can be any numeric expressions.

{{subst:RGBtoHSL.H|r|g|b|subst=subst:}}

To remplace the template invokation by the computed value when saving an article Wiki source.

Algorithm used

if r = g and g = b then

H = 0;

else if g >= r and g >= b then

if r > b

then H = 120 - 60 * (r - b) / (g - b);

else H = 120 + 60 * (b - r) / (g - r);

else if b >= r and b >= g then

if g > r

then H = 240 - 60 * (g - r) / (b - r);

else H = 240 + 60 * (r - g) / (b - g);

else

if b > g

then H = 360 - 60 * (b - g) / (r - g);

else H = 60 * (g - b) / (r - b);

return H round 1;

Examples

• "{{RGBtoHSL.H|0|0|0}}" returns "0".
• "{{RGBtoHSL.H|255|255|255}}" returns "0".
• "{{RGBtoHSL.H|255|0|0}}" returns "0".
• "{{RGBtoHSL.H|255|1|0}}" returns "0.2".
• "{{RGBtoHSL.H|255|127.5|0}}" returns "30".
• "{{RGBtoHSL.H|255|255|0}}" returns "60".
• "{{RGBtoHSL.H|127.5|255|0}}" returns "90".
• "{{RGBtoHSL.H|0|255|0}}" returns "120".
• "{{RGBtoHSL.H|0|255|127.5}}" returns "150".
• "{{RGBtoHSL.H|0|255|255}}" returns "180".
• "{{RGBtoHSL.H|0|127.5|255}}" returns "210".
• "{{RGBtoHSL.H|0|0|255}}" returns "240".
• "{{RGBtoHSL.H|127.5|0|255}}" returns "270".
• "{{RGBtoHSL.H|255|0|255}}" returns "300".
• "{{RGBtoHSL.H|255|0|127.5}}" returns "330".
• "{{RGBtoHSL.H|255|0|1}}" returns "359.8".
• example for "sandybrown" = "#F4A460" = "rgb(244, 164, 96)" = "hsl(27.6, 0.871, 0.667)"

"{{RGBtoHSL.H|244|164|96}}" returns "27.6".

• same example using subst

"{{subst:RGBtoHSL.H|244|164|96|subst=subst:}}" returns "27.6".

See also

• Template:RGBtoHSL.H, Template:RGBtoHSL.S, Template:RGBtoHSL.L
• Template:HSLtoRGB.R, Template:HSLtoRGB.G, Template:HSLtoRGB.B
• Template:RGBtoHSV.H, Template:RGBtoHSV.S, Template:RGBtoHSV.V

(By definition, Template:RGBtoHSL.H and Template:RGBtoHSV.H should give the same Hue value for any color. As of Jan 2021, this has not been tested yet.)