mediaLib Library Functions       mlibImageColorHSL2RGBFp(3MLIB)



NAME
     mlibImageColorHSL2RGBFp - HSL to RGB color conversion

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

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


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


     It uses the following equations:

          L' = L          if L < 1/2
          L' = 1 - L      if L > 1/2

          V = L ] S*L'
          P = L - S*L'
          Q = L ] S*L'*(1 - 2*fraction(H*6))
          T = L - S*L'*(1 - 2*fraction(H*6))

          R, G, B = V, T, P    if 0   < H < 1/6
          R, G, B = Q, V, P    if 1/6 < H < 2/6
          R, G, B = P, V, T    if 2/6 < H < 3/6
          R, G, B = P, Q, V    if 3/6 < H < 4/6
          R, G, B = T, P, V    if 4/6 < H < 5/6
          R, G, B = V, P, Q    if 5/6 < H < 1



     where 0 < H < 1 and 0 < S, L, L', V, P, Q, T, R, G, B < 1.


     For MLIBFLOAT and MLIBDOUBLE images, the  above  equations
     are followed verbatim. Input H component values must be lim-
     ited to the [0.0, 1.0) range. Input S and L 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: 12 Sep 2007                    1






mediaLib Library Functions       mlibImageColorHSL2RGBFp(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),
     mlibImageColorRGB2HSL(3MLIB),
     mlibImageColorRGB2HSLFp(3MLIB), attributes(5)
































SunOS 5.11          Last change: 12 Sep 2007                    2