Manual Pages for UNIX Operating System command usage for man mlib_ImageThresh1

mediaLib Library Functions               mlib_ImageThresh1(3MLIB)



NAME
     mlib_ImageThresh1 - image thresholding

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

     mlib_status mlib_ImageThresh1(mlib_image *dst, const mlib_image *src,
          const mlib_s32 *thresh, const mlib_s32 *ghigh, const mlib_s32 *glow);


DESCRIPTION
     The mlib_ImageThresh1() 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 high output level.


     The data type of the destination image can  be  MLIB_BIT  or
     can be the same as the data type of the source image.


     It uses the following equation:

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


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






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions               mlib_ImageThresh1(3MLIB)



RETURN VALUES
     The function returns MLIB_SUCCESS if  successful.  Otherwise
     it returns MLIB_FAILURE.

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     mlib_ImageThresh1_Fp(3MLIB),
     mlib_ImageThresh1_Fp_Inp(3MLIB),
     mlib_ImageThresh1_Inp(3MLIB),      mlib_ImageThresh2(3MLIB),
     mlib_ImageThresh2_Fp(3MLIB),
     mlib_ImageThresh2_Fp_Inp(3MLIB),
     mlib_ImageThresh2_Inp(3MLIB),      mlib_ImageThresh3(3MLIB),
     mlib_ImageThresh3_Fp(3MLIB),
     mlib_ImageThresh3_Fp_Inp(3MLIB),
     mlib_ImageThresh3_Inp(3MLIB),      mlib_ImageThresh4(3MLIB),
     mlib_ImageThresh4_Fp(3MLIB),
     mlib_ImageThresh4_Fp_Inp(3MLIB),
     mlib_ImageThresh4_Inp(3MLIB),      mlib_ImageThresh5(3MLIB),
     mlib_ImageThresh5_Fp(3MLIB),
     mlib_ImageThresh5_Fp_Inp(3MLIB),
     mlib_ImageThresh5_Inp(3MLIB), attributes(5)




















SunOS 5.11           Last change: 2 Mar 2007                    2