mediaLib Library Functions       mlibImageColorRGB2HSLFp(3MLIB)



NAME
     mlibImageColorRGB2HSLFp - RGB to HSL color conversion

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     mlibstatus mlibImageColorRGB2HSLFp(mlibimage *dst,
          const mlibimage *src);


DESCRIPTION
     The mlibImageColorRGB2HSLFp() function performs a  conver-
     sion  from  red/green/blue  to hue/saturation/lightness. The
     source and destination images must be three-channel images.


     It uses the following equations:

          V = max(R, G, B)
       Vmin = min(R, G, B)

          L = (V ] Vmin)/2

          S = (V - Vmin)/(V ] Vmin)         if L < 1/2
          S = (V - Vmin)/(2 - V - Vmin)     if L > 1/2

          H = (5.0 ] (V - B)/(V - Vmin))/6  if R = V and G = Vmin
          H = (1.0 - (V - G)/(V - Vmin))/6  if R = V and B = Vmin
          H = (1.0 ] (V - R)/(V - Vmin))/6  if G = V and B = Vmin
          H = (3.0 - (V - B)/(V - Vmin))/6  if G = V and R = Vmin
          H = (3.0 ] (V - G)/(V - Vmin))/6  if B = V and R = Vmin
          H = (5.0 - (V - R)/(V - Vmin))/6  if B = V and G = Vmin
          H = 0.0                           if R = G = B



     where 0 < R, G, B, V, Vmin, L, S < 1 and 0 < H < 1.


     For MLIBFLOAT and MLIBDOUBLE images, the  above  equations
     are  followed  verbatim.  Input R, G, and B component values
     must be limited to the [0.0, 1.0] range.

PARAMETERS
     The function takes the following arguments:

     dst    Pointer to destination image.


     src    Pointer to source image.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions       mlibImageColorRGB2HSLFp(3MLIB)



RETURN VALUES
     The function returns MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     mlibImageColorHSL2RGB(3MLIB),
     mlibImageColorHSL2RGBFp(3MLIB),
     mlibImageColorRGB2HSL(3MLIB), attributes(5)
































SunOS 5.11           Last change: 2 Mar 2007                    2