mediaLib Library Functions       mlibImageColorRGB2HSVFp(3MLIB)



NAME
     mlibImageColorRGB2HSVFp - RGB to HSV color conversion

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

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


DESCRIPTION
     The mlibImageColorRGB2HSVFp() function performs a  conver-
     sion from red/green/blue to hue/saturation/value. 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)

          S = (V - Vmin)/V

          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, 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.


RETURN VALUES




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions       mlibImageColorRGB2HSVFp(3MLIB)



     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
     mlibImageColorHSV2RGB(3MLIB),
     mlibImageColorHSV2RGBFp(3MLIB),
     mlibImageColorRGB2HSV(3MLIB), attributes(5)

































SunOS 5.11           Last change: 2 Mar 2007                    2