mediaLib Library Functions               mlibImageThresh2(3MLIB)



NAME
     mlibImageThresh2 - image thresholding

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

     mlibstatus mlibImageThresh2(mlibimage *dst, const mlibimage *src,
          const mlibs32 *thresh, const mlibs32 *glow);


DESCRIPTION
     The mlibImageThresh2() 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 low output level. If the pixel is greater than
     the threshold value, then the destination pixel  is  set  to
     the value of the source pixel.


     It uses the following equation:

       dst[x][y][i] = glow[i]       if src[x][y][i] < thresh[i]
       dst[x][y][i] = src[x][y][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.


     glow      Low output level. glow[i] contains the low  output
               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               mlibImageThresh2(3MLIB)



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


SEE ALSO
     mlibImageThresh1(3MLIB),       mlibImageThresh1Fp(3MLIB),
     mlibImageThresh1FpInp(3MLIB),
     mlibImageThresh1Inp(3MLIB),   mlibImageThresh2Fp(3MLIB),
     mlibImageThresh2FpInp(3MLIB),
     mlibImageThresh2Inp(3MLIB),      mlibImageThresh3(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