Manual Pages for UNIX Operating System command usage for man mlib_ImageThresh1_Fp

mediaLib Library Functions            mlib_ImageThresh1_Fp(3MLIB)



NAME
     mlib_ImageThresh1_Fp - image thresholding

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

     mlib_status mlib_ImageThresh1_Fp(mlib_image *dst, const mlib_image *src,
          const mlib_d64 *thresh, const mlib_d64 *ghigh, const mlib_d64 *glow);


DESCRIPTION
     The mlib_ImageThresh1_Fp() function compares each  pixel  in
     the floating-point 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 destina-
     tion 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_Fp(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(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