Manual Pages for UNIX Operating System command usage for man mlib_ImageColorRGB2HSL_Fp

mediaLib Library Functions       mlib_ImageColorRGB2HSL_Fp(3MLIB)



NAME
     mlib_ImageColorRGB2HSL_Fp - RGB to HSL color conversion

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

     mlib_status mlib_ImageColorRGB2HSL_Fp(mlib_image *dst,
          const mlib_image *src);


DESCRIPTION
     The mlib_ImageColorRGB2HSL_Fp() 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 MLIB_FLOAT and MLIB_DOUBLE 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       mlib_ImageColorRGB2HSL_Fp(3MLIB)



RETURN VALUES
     The function returns MLIB_SUCCESS if  successful.  Otherwise
     it returns MLIB_FAILURE.

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     mlib_ImageColorHSL2RGB(3MLIB),
     mlib_ImageColorHSL2RGB_Fp(3MLIB),
     mlib_ImageColorRGB2HSL(3MLIB), attributes(5)
































SunOS 5.11           Last change: 2 Mar 2007                    2