mediaLib Library Functions               mlibImageThresh5(3MLIB)



NAME
     mlibImageThresh5 - image thresholding

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

     mlibstatus mlibImageThresh5(mlibimage *dst, const mlibimage *src,
          const mlibs32 *thigh, const mlibs32 *tlow, const mlibs32 *gray);


DESCRIPTION
     The mlibImageThresh5() function compares each pixel in  the
     source image to two threshold values, tlow and thigh. If the
     pixel is in between the lower threshold value, tlow, and the
     higher  threshold  value,  thigh, (inclusive on both sides),
     then the destination pixel is set to the value gray.  Other-
     wise,  the  destination  pixel  is  set  to the value of the
     source pixel.


     It uses the following equation:

       dst[x][y][i] = src[x][y][i]  if src[x][y][i] < tlow[i]
       dst[x][y][i] = gray[i]       if tlow[i] < src[x][y][i] < thigh[i]
       dst[x][y][i] = src[x][y][i]  if src[x][y][i] > thigh[i]


PARAMETERS
     The function takes the following arguments:

     dst      Pointer to destination image.


     src      Pointer to source image.


     thigh    High  threshold  value.  thigh[i]  holds  the  high
              threshold for channel i.


     tlow     Low threshold value. tlow[i] holds the  low  thres-
              hold for channel i.


     gray     Output grayscale level. gray[i]  holds  the  output
              grayscale level for channel i.


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



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions               mlibImageThresh5(3MLIB)



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



     
           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),      mlibImageThresh3(3MLIB),
     mlibImageThresh3Fp(3MLIB),
     mlibImageThresh3FpInp(3MLIB),
     mlibImageThresh3Inp(3MLIB),      mlibImageThresh4(3MLIB),
     mlibImageThresh4Fp(3MLIB),
     mlibImageThresh4FpInp(3MLIB),
     mlibImageThresh4Inp(3MLIB),   mlibImageThresh5Fp(3MLIB),
     mlibImageThresh5FpInp(3MLIB),
     mlibImageThresh5Inp(3MLIB), attributes(5)

























SunOS 5.11           Last change: 2 Mar 2007                    2