Manual Pages for UNIX Operating System command usage for man mlib_ImageColorRGB2HSV_Fp

mediaLib Library Functions       mlib_ImageColorRGB2HSV_Fp(3MLIB)



NAME
     mlib_ImageColorRGB2HSV_Fp - RGB to HSV color conversion

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

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


DESCRIPTION
     The mlib_ImageColorRGB2HSV_Fp() 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 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.


RETURN VALUES




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions       mlib_ImageColorRGB2HSV_Fp(3MLIB)



     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_ImageColorHSV2RGB(3MLIB),
     mlib_ImageColorHSV2RGB_Fp(3MLIB),
     mlib_ImageColorRGB2HSV(3MLIB), attributes(5)

































SunOS 5.11           Last change: 2 Mar 2007                    2