mediaLib Library Functions              mlibImageMulShift(3MLIB)



NAME
     mlibImageMulShift - multiplication

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

     mlibstatus mlibImageMulShift(mlibimage *dst, const mlibimage *src1,
          const mlibimage *src2, mlibs32 shift);


DESCRIPTION
     The  mlibImageMulShift()  function  multiplies  the   pixel
     values  of  the two source images. It scales the result by a
     right shift and writes the result to the  destination  image
     on a pixel-by-pixel basis.


     It uses the following equation:

       dst[x][y][i] = src1[x][y][i] * src2[x][y][i] * 2**(-shift)


PARAMETERS
     The function takes the following arguments:

     dst      Pointer to destination image.


     src1     Pointer to first source image.


     src2     Pointer to second source image.


     shift    Right shifting factor. 0 < shift < 31.


RETURN VALUES
     The function returns MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.

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










SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions              mlibImageMulShift(3MLIB)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     mlibImageMulShiftInp(3MLIB), attributes(5)












































SunOS 5.11           Last change: 2 Mar 2007                    2