prg_color_to_hls()
Abstract
Determines an HLS specification corresponding to a color object.
Syntax
prg_color_to_hls (color, h_ptr, l_ptr, s_ptr)
| Argument | Type | Description |
|---|---|---|
color |
PrgT_Color |
Color object to be converted to an HLS specification. |
h_ptr |
double * |
Area to hold value for hue, from 0.0 to 1.0 (see Details). |
l_ptr |
double * |
Area to hold value for lightness, from 0.0 (black) to 1.0 (white). |
s_ptr |
double * |
Area to hold value for saturation, from 0.0 (unsaturated) to 1.0 (most saturated). |
Return Type
PrgT_Compcode
PrgC_Compcode_Failure if an HLS specification cannot be created; PrgC_Compcode_Success otherwise.
Header
prg_color.h
Details
This function determines an HLS (hue, lightness, saturation) specification corresponding to color.
The hue value is a point on a continuous color wheel, where 0.0 and 1.0 both represent pure red, 1/3 (0.333…) represents pure green, and 2/3 (0.666…) represents pure blue.