mediaLib Library Functions              mlibImageCopyMask(3MLIB)



NAME
     mlibImageCopyMask - copy with mask

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

     mlibstatus mlibImageCopyMask(mlibimage *dst, const mlibimage *src,
          const mlibimage *mask, const mlibs32 *thresh);


DESCRIPTION
     The  mlibImageCopyMask()  function  copies  one  image   to
     another image via a mask image by using it as a yes/no indi-
     cator. The  data  type  of  the  images  can  be  MLIBYTE,
     MLIBSHORT, MLIBUSHORT, or MLIBINT.


     It uses the following equation:

       dst[x][y][i] = src[x][y][i]  if mask[x][y][i] < thresh[i]
       dst[x][y][i] = dst[x][y][i]  if mask[x][y][i] > thresh[i]


PARAMETERS
     The function takes the following arguments:

     dst       Pointer to destination image.


     src       Pointer to source image.


     mask      Pointer to mask image.


     thresh    Threshold for the mask image.  thresh[i]  contains
               the threshold for channel i.


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              mlibImageCopyMask(3MLIB)



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


SEE ALSO
     mlibImageCopy(3MLIB),            mlibImageCopyArea(3MLIB),
     mlibImageCopyMaskFp(3MLIB), mlibImageCopySubimage(3MLIB),
     attributes(5)










































SunOS 5.11           Last change: 2 Mar 2007                    2