NAME

       RGBHLS - Converts a color specification given in the Red, Green, Blue (RGB) color space to
       color values in the Hue, Lightness, Saturation (HLS) color space.

SYNOPSIS

       CALL RGBHLS (R, G, B, H, L, S)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_rgbhls (float r, float g, float b, float *h,
       float *l, float *s)

DESCRIPTION

       R           (REAL, input, range [0.,1.])  represents the red intensity component of the
                   input point in RGB color space.

       G           (REAL, input, range [0.,1.])  represents the green intensity component of the
                   input point in RGB color space.

       B           (REAL, input, range [0.,1.])  represents the blue intensity component of the
                   input point in RGB color space.

       H           (REAL, output, range [0.,360.) ) represents the hue of the input point in HLS
                   color space. A value of (0.,0.,B) in the input space will result in a hue of
                   0. in the output space.

       L           (REAL, output, range [0.,100.])  represents the lightness value of the input
                   point in HLS color space.  Lightness is a measure of the quantity of light - a
                   lightness of 0. is black, and a lightness of 100.  gives white. The pure hues
                   occur at lightness value 50.

       S           (REAL, output, range [0.,100.])  represents the saturation value of the input
                   point in HLS color space.  Saturation is a measure of how much white light is
                   mixed with the color. Saturation values of 0.  represent grays (with a gray
                   value equal to the lightness value L). Saturation values of 100. are fully
                   saturated colors. The hue is undefined when S=0.  The fully saturated pure
                   hues occur when S=100. and L=50.  The saturation value should be thought of as
                   a percentage.

EXAMPLES

       Use the ncargex command to see the following relevant examples: tcolcv, fcce02.

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

ACCESS

       To use RGBHLS or c_rgbhls, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c,
       preferably in that order.

MESSAGES

       See the colconv man page for a description of all Colconv error messages and/or
       informational messages.

SEE ALSO

       Online: colconv, hlsrgb, hsvrgb, rgbhsv, rgbyiq, yiqrgb, ncarg_cbind.

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.