1HLSRGB(3NCARG)                   NCAR GRAPHICS                  HLSRGB(3NCARG)
2
3
4

NAME

6       HLSRGB - Converts a color specification given as Hue, Lightness, and
7       Saturation (HLS) values to Red, Green, and Blue (RGB) intensity values.
8

SYNOPSIS

10       CALL HLSRGB ( H, L, S, R, G, B )
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_hlsrgb (float h, float l, float s, float *r,
16       float *g, float *b)
17

DESCRIPTION

19       H           (REAL, input, range [0.,360.) ) represents the hue of the
20                   input color in HLS color space. H=0.  corresponds to blue.
21
22       L           (REAL, input, range [0.,100.])  represents the lightness
23                   value of the input color in HLS color space.  Lightness is
24                   a measure of the quantity of light - a lightness of 0. is
25                   black, and a lightness of 100.  gives white. The pure hues
26                   occur at lightness value 50.
27
28       S           (REAL, input, range [0.,100.])  represents the saturation
29                   value of the input color in HLS color space.  Saturation is
30                   a measure of how much white light is mixed with the color.
31                   Colors having a saturation value of 0. represent grays with
32                   a gray intensity value equal to the lightness L.  Colors
33                   with a saturation value of 100. are fully saturated colors.
34                   The hue is undefined when S=0.  The fully saturated pure
35                   hues occur when S=100.  and L=50.
36
37       R           (REAL, output, range [0.,1.])  represents the red intensity
38                   component of the output color in RGB color space.
39
40       G           (REAL, output, range [0.,1.])  represents the green
41                   intensity component of the output color in RGB color space.
42
43       B           (REAL, output, range [0.,1.])  represents the blue
44                   intensity component of the output color in RGB color space.
45

C-BINDING DESCRIPTION

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

EXAMPLES

51       Use the ncargex command to see the following relevant examples:
52       ccpcldm, ccplbam, ccpllb, ccplll, ccpllw, colcon, fcce02.
53

ACCESS

55       To use HLSRGB or c_hlsrgb, load the NCAR Graphics libraries ncarg,
56       ncarg_gks, and ncarg_c, preferably in that order.
57

MESSAGES

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

SEE ALSO

63       Online: colconv, hlsrgb, hsvrgb, rgbhls, rgbhsv, rgbyiq, yiqrgb,
64       ncarg_cbind.
65
66       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
67

69       Copyright (C) 1987-2007
70       University Corporation for Atmospheric Research
71
72       This documentation is free software; you can redistribute it and/or
73       modify it under the terms of the GNU General Public License as
74       published by the Free Software Foundation; either version 2 of the
75       License, or (at your option) any later version.
76
77       This software is distributed in the hope that it will be useful, but
78       WITHOUT ANY WARRANTY; without even the implied warranty of
79       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
80       General Public License for more details.
81
82       You should have received a copy of the GNU General Public License along
83       with this software; if not, write to the Free Software Foundation,
84       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
85
86
87
88UNIX                              March 1993                    HLSRGB(3NCARG)
Impressum