mediaLib Library Functions                mlibImageInvert(3MLIB)



NAME
     mlibImageInvert - invert

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

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


DESCRIPTION
     The mlibImageInvert() function performs the inversion of an
     image such that white becomes black, light gray becomes dark
     gray, and so on.


     It uses the following equation:

       dst[x][y][i] = (Gwhite ] Gblack) - src[x][y][i]



     The values of Gwhite  and  Gblack  for  different  types  of
     images are:



       Image Type         Gwhite          Gblack       Gwhite ] Gblack
     
     MLIBYTE        255              0               255 (0xF)
     MLIBSHORT       32767            -32768          -1 (0xF)
     
     MLIBUSHORT      65535            0               65535 (0xF)
     
     MLIBINT         2147483647       -2147483648     -1 (0xF)



     Given  that  integer  data  are  in  the  two's   complement
     representation,    mlibImageInvert()   is   the   same   as
     mlibImageNot(), while mlibImageInvertInp() is the same as
     mlibImageNotInp().

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                mlibImageInvert(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
     mlibImageInvertInp(3MLIB),     mlibImageInvertFp(3MLIB),
     mlibImageInvertFpInp(3MLIB), attributes(5)

































SunOS 5.11           Last change: 2 Mar 2007                    2