mediaLib Library Functions           mlibImageThresh4Inp(3MLIB)



NAME
     mlibImageThresh4Inp - image thresholding

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

     mlibstatus mlibImageThresh4Inp(mlibimage *srcdst,
          const mlibs32 *thigh, const mlibs32 *tlow, const mlibs32 *ghigh,
          const mlibs32 *glow);


DESCRIPTION
     The mlibImageThresh4Inp() function compares each pixel  in
     the source image to two threshold values, tlow and thigh. If
     the pixel is less than the lower threshold value, tlow, then
     the  destination  pixel  is  set  to the lower output level,
     glow. If the pixel is  greater  than  the  higher  threshold
     value,  thigh,  then  the  destination  pixel  is set to the
     higher output level, ghigh. Otherwise, the destination pixel
     is set to the value of the source pixel.


     It uses the following equation:

       srcdst[x][y][i] = glow[i]   if srcdst[x][y][i] < tlow[i]
       srcdst[x][y][i] = ghigh[i]  if srcdst[x][y][i] > thigh[i]


PARAMETERS
     The function takes the following arguments:

     srcdst    Pointer to source and destination 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.


     ghigh     High output grayscale level.  ghigh[i]  holds  the
               high output grayscale level for channel i.


     glow      Low output grayscale level. glow[i] holds the  low
               output grayscale level for channel i.






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions           mlibImageThresh4Inp(3MLIB)



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

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),   mlibImageThresh5(3MLIB),
     mlibImageThresh5Fp(3MLIB),
     mlibImageThresh5FpInp(3MLIB),
     mlibImageThresh5Inp(3MLIB), attributes(5)





















SunOS 5.11           Last change: 2 Mar 2007                    2