mediaLib Library Functions           mlibImageCopyMaskFp(3MLIB)



NAME
     mlibImageCopyMaskFp - copy with mask, floating-point

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

     mlibstatus mlibImageCopyMaskFp(mlibimage *dst, const mlibimage *src,
          const mlibimage *mask, const mlibd64 *thresh);


DESCRIPTION
     The mlibImageCopyMaskFp() 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  MLIBFLOAT  or
     MLIBDOUBLE.


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



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


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










































SunOS 5.11           Last change: 2 Mar 2007                    2