mediaLib Library Functions               mlibImageThresh3(3MLIB)



NAME
     mlibImageThresh3 - image thresholding

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

     mlibstatus mlibImageThresh3(mlibimage *dst, const mlibimage *src,
          const mlibs32 *thresh, const mlibs32 *ghigh);


DESCRIPTION
     The mlibImageThresh3() function compares each pixel in  the
     source image to a threshold value. If the pixel is less than
     or equal to the threshold value, then the destination  pixel
     is  set  to  the  value of the source pixel. If the pixel is
     greater than the threshold value, then the destination pixel
     is set to the high output level.


     It uses the following equation:

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


PARAMETERS
     The function takes the following arguments:

     dst       Pointer to destination image.


     src       Pointer to source image.


     thresh    Threshold value. thresh[i] contains the  threshold
               for channel i.


     ghigh     High output level. ghigh[i] contains the high out-
               put level 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               mlibImageThresh3(3MLIB)



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


SEE ALSO
     mlibImageThresh1(3MLIB),       mlibImageThresh1Fp(3MLIB),
     mlibImageThresh1FpInp(3MLIB),
     mlibImageThresh1Inp(3MLIB),      mlibImageThresh2(3MLIB),
     mlibImageThresh2Fp(3MLIB),
     mlibImageThresh2FpInp(3MLIB),
     mlibImageThresh2Inp(3MLIB),   mlibImageThresh3Fp(3MLIB),
     mlibImageThresh3FpInp(3MLIB),
     mlibImageThresh3Inp(3MLIB),      mlibImageThresh4(3MLIB),
     mlibImageThresh4Fp(3MLIB),
     mlibImageThresh4FpInp(3MLIB),
     mlibImageThresh4Inp(3MLIB),      mlibImageThresh5(3MLIB),
     mlibImageThresh5Fp(3MLIB),
     mlibImageThresh5FpInp(3MLIB),
     mlibImageThresh5Inp(3MLIB), attributes(5)































SunOS 5.11           Last change: 2 Mar 2007                    2